diff --git a/docs/command/atlas-api-accessTracking-getGroupDbAccessHistoryCluster.txt b/docs/command/atlas-api-accessTracking-getGroupDbAccessHistoryCluster.txt new file mode 100644 index 0000000000..1bbebe1e45 --- /dev/null +++ b/docs/command/atlas-api-accessTracking-getGroupDbAccessHistoryCluster.txt @@ -0,0 +1,122 @@ +.. _atlas-api-accessTracking-getGroupDbAccessHistoryCluster: + +======================================================= +atlas api accessTracking getGroupDbAccessHistoryCluster +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the access logs of one cluster identified by the cluster's name. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdbaccesshistorycluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api accessTracking getGroupDbAccessHistoryCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --authResult + - + - false + - Flag that indicates whether the response returns the successful authentication attempts only. + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --end + - int + - false + - Date and time when to stop retrieving database history. If you specify **end**, you must also specify **start**. This parameter uses UNIX epoch time in milliseconds. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupDbAccessHistoryCluster + * - --ipAddress + - string + - false + - One Internet Protocol address that attempted to authenticate with the database. + * - --nLogs + - int + - false + - Maximum number of lines from the log to return. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --start + - int + - false + - Date and time when MongoDB Cloud begins retrieving database history. If you specify **start**, you must also specify **end**. This parameter uses UNIX epoch time in milliseconds. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-accessTracking-getGroupDbAccessHistoryCluster-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-accessTracking-getGroupDbAccessHistoryProcess.txt b/docs/command/atlas-api-accessTracking-getGroupDbAccessHistoryProcess.txt new file mode 100644 index 0000000000..d17112eb86 --- /dev/null +++ b/docs/command/atlas-api-accessTracking-getGroupDbAccessHistoryProcess.txt @@ -0,0 +1,122 @@ +.. _atlas-api-accessTracking-getGroupDbAccessHistoryProcess: + +======================================================= +atlas api accessTracking getGroupDbAccessHistoryProcess +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the access logs of one cluster identified by the cluster's hostname. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdbaccesshistoryprocess. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api accessTracking getGroupDbAccessHistoryProcess [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --authResult + - + - false + - Flag that indicates whether the response returns the successful authentication attempts only. + * - --end + - int + - false + - Date and time when to stop retrieving database history. If you specify **end**, you must also specify **start**. This parameter uses UNIX epoch time in milliseconds. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupDbAccessHistoryProcess + * - --hostname + - string + - true + - Fully qualified domain name or IP address of the MongoDB host that stores the log files that you want to download. + * - --ipAddress + - string + - false + - One Internet Protocol address that attempted to authenticate with the database. + * - --nLogs + - int + - false + - Maximum number of lines from the log to return. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --start + - int + - false + - Date and time when MongoDB Cloud begins retrieving database history. If you specify **start**, you must also specify **end**. This parameter uses UNIX epoch time in milliseconds. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-accessTracking-getGroupDbAccessHistoryProcess-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-accessTracking-listAccessLogsByClusterName.txt b/docs/command/atlas-api-accessTracking-listAccessLogsByClusterName.txt deleted file mode 100644 index e4fd0badd0..0000000000 --- a/docs/command/atlas-api-accessTracking-listAccessLogsByClusterName.txt +++ /dev/null @@ -1,122 +0,0 @@ -.. _atlas-api-accessTracking-listAccessLogsByClusterName: - -==================================================== -atlas api accessTracking listAccessLogsByClusterName -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the access logs of one cluster identified by the cluster's name. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listaccesslogsbyclustername. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api accessTracking listAccessLogsByClusterName [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --authResult - - - - false - - Flag that indicates whether the response returns the successful authentication attempts only. - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --end - - int - - false - - Date and time when to stop retrieving database history. If you specify **end**, you must also specify **start**. This parameter uses UNIX epoch time in milliseconds. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAccessLogsByClusterName - * - --ipAddress - - string - - false - - One Internet Protocol address that attempted to authenticate with the database. - * - --nLogs - - int - - false - - Maximum number of lines from the log to return. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --start - - int - - false - - Date and time when MongoDB Cloud begins retrieving database history. If you specify **start**, you must also specify **end**. This parameter uses UNIX epoch time in milliseconds. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-accessTracking-listAccessLogsByClusterName-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-accessTracking-listAccessLogsByHostname.txt b/docs/command/atlas-api-accessTracking-listAccessLogsByHostname.txt deleted file mode 100644 index 23929130e9..0000000000 --- a/docs/command/atlas-api-accessTracking-listAccessLogsByHostname.txt +++ /dev/null @@ -1,122 +0,0 @@ -.. _atlas-api-accessTracking-listAccessLogsByHostname: - -================================================= -atlas api accessTracking listAccessLogsByHostname -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the access logs of one cluster identified by the cluster's hostname. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listaccesslogsbyhostname. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api accessTracking listAccessLogsByHostname [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --authResult - - - - false - - Flag that indicates whether the response returns the successful authentication attempts only. - * - --end - - int - - false - - Date and time when to stop retrieving database history. If you specify **end**, you must also specify **start**. This parameter uses UNIX epoch time in milliseconds. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAccessLogsByHostname - * - --hostname - - string - - true - - Fully qualified domain name or IP address of the MongoDB host that stores the log files that you want to download. - * - --ipAddress - - string - - false - - One Internet Protocol address that attempted to authenticate with the database. - * - --nLogs - - int - - false - - Maximum number of lines from the log to return. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --start - - int - - false - - Date and time when MongoDB Cloud begins retrieving database history. If you specify **start**, you must also specify **end**. This parameter uses UNIX epoch time in milliseconds. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-accessTracking-listAccessLogsByHostname-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-accessTracking.txt b/docs/command/atlas-api-accessTracking.txt index 68e725ffd7..6649574b5e 100644 --- a/docs/command/atlas-api-accessTracking.txt +++ b/docs/command/atlas-api-accessTracking.txt @@ -54,13 +54,13 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-accessTracking-listAccessLogsByClusterName` - `Public Preview: please provide feedback `_: Returns the access logs of one cluster identified by the cluster's name. -* :ref:`atlas-api-accessTracking-listAccessLogsByHostname` - `Public Preview: please provide feedback `_: Returns the access logs of one cluster identified by the cluster's hostname. +* :ref:`atlas-api-accessTracking-getGroupDbAccessHistoryCluster` - `Public Preview: please provide feedback `_: Returns the access logs of one cluster identified by the cluster's name. +* :ref:`atlas-api-accessTracking-getGroupDbAccessHistoryProcess` - `Public Preview: please provide feedback `_: Returns the access logs of one cluster identified by the cluster's hostname. .. toctree:: :titlesonly: - listAccessLogsByClusterName - listAccessLogsByHostname + getGroupDbAccessHistoryCluster + getGroupDbAccessHistoryProcess diff --git a/docs/command/atlas-api-alertConfigurations-createAlertConfiguration.txt b/docs/command/atlas-api-alertConfigurations-createAlertConfiguration.txt deleted file mode 100644 index 53e5b47fc1..0000000000 --- a/docs/command/atlas-api-alertConfigurations-createAlertConfiguration.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-alertConfigurations-createAlertConfiguration: - -====================================================== -atlas api alertConfigurations createAlertConfiguration -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one alert configuration for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createalertconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alertConfigurations createAlertConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createAlertConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-alertConfigurations-createGroupAlertConfig.txt b/docs/command/atlas-api-alertConfigurations-createGroupAlertConfig.txt new file mode 100644 index 0000000000..97f7565b16 --- /dev/null +++ b/docs/command/atlas-api-alertConfigurations-createGroupAlertConfig.txt @@ -0,0 +1,100 @@ +.. _atlas-api-alertConfigurations-createGroupAlertConfig: + +==================================================== +atlas api alertConfigurations createGroupAlertConfig +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one alert configuration for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupalertconfig. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alertConfigurations createGroupAlertConfig [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupAlertConfig + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-alertConfigurations-deleteAlertConfiguration.txt b/docs/command/atlas-api-alertConfigurations-deleteAlertConfiguration.txt deleted file mode 100644 index 44e11138f1..0000000000 --- a/docs/command/atlas-api-alertConfigurations-deleteAlertConfiguration.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-alertConfigurations-deleteAlertConfiguration: - -====================================================== -atlas api alertConfigurations deleteAlertConfiguration -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one alert configuration from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletealertconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alertConfigurations deleteAlertConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --alertConfigId - - string - - true - - Unique 24-hexadecimal digit string that identifies the alert configuration. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteAlertConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-alertConfigurations-deleteAlertConfiguration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-alertConfigurations-deleteGroupAlertConfig.txt b/docs/command/atlas-api-alertConfigurations-deleteGroupAlertConfig.txt new file mode 100644 index 0000000000..0ab3eead70 --- /dev/null +++ b/docs/command/atlas-api-alertConfigurations-deleteGroupAlertConfig.txt @@ -0,0 +1,105 @@ +.. _atlas-api-alertConfigurations-deleteGroupAlertConfig: + +==================================================== +atlas api alertConfigurations deleteGroupAlertConfig +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one alert configuration from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupalertconfig. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alertConfigurations deleteGroupAlertConfig [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --alertConfigId + - string + - true + - Unique 24-hexadecimal digit string that identifies the alert configuration. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupAlertConfig + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-alertConfigurations-deleteGroupAlertConfig-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-alertConfigurations-getAlertConfiguration.txt b/docs/command/atlas-api-alertConfigurations-getAlertConfiguration.txt deleted file mode 100644 index 6f2c38be7a..0000000000 --- a/docs/command/atlas-api-alertConfigurations-getAlertConfiguration.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-alertConfigurations-getAlertConfiguration: - -=================================================== -atlas api alertConfigurations getAlertConfiguration -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the specified alert configuration from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getalertconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alertConfigurations getAlertConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --alertConfigId - - string - - true - - Unique 24-hexadecimal digit string that identifies the alert configuration. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAlertConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-alertConfigurations-getAlertConfiguration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-alertConfigurations-getGroupAlertAlertConfigs.txt b/docs/command/atlas-api-alertConfigurations-getGroupAlertAlertConfigs.txt new file mode 100644 index 0000000000..c3332a0fee --- /dev/null +++ b/docs/command/atlas-api-alertConfigurations-getGroupAlertAlertConfigs.txt @@ -0,0 +1,117 @@ +.. _atlas-api-alertConfigurations-getGroupAlertAlertConfigs: + +======================================================= +atlas api alertConfigurations getGroupAlertAlertConfigs +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all alert configurations set for the specified alert. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupalertalertconfigs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alertConfigurations getGroupAlertAlertConfigs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --alertId + - string + - true + - Unique 24-hexadecimal digit string that identifies the alert. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupAlertAlertConfigs + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-alertConfigurations-getGroupAlertAlertConfigs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-alertConfigurations-getGroupAlertConfig.txt b/docs/command/atlas-api-alertConfigurations-getGroupAlertConfig.txt new file mode 100644 index 0000000000..a7aae887d5 --- /dev/null +++ b/docs/command/atlas-api-alertConfigurations-getGroupAlertConfig.txt @@ -0,0 +1,105 @@ +.. _atlas-api-alertConfigurations-getGroupAlertConfig: + +================================================= +atlas api alertConfigurations getGroupAlertConfig +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the specified alert configuration from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupalertconfig. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alertConfigurations getGroupAlertConfig [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --alertConfigId + - string + - true + - Unique 24-hexadecimal digit string that identifies the alert configuration. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupAlertConfig + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-alertConfigurations-getGroupAlertConfig-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-alertConfigurations-listAlertConfigMatcherFieldNames.txt b/docs/command/atlas-api-alertConfigurations-listAlertConfigMatcherFieldNames.txt new file mode 100644 index 0000000000..d29887ea47 --- /dev/null +++ b/docs/command/atlas-api-alertConfigurations-listAlertConfigMatcherFieldNames.txt @@ -0,0 +1,87 @@ +.. _atlas-api-alertConfigurations-listAlertConfigMatcherFieldNames: + +============================================================== +atlas api alertConfigurations listAlertConfigMatcherFieldNames +============================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Get all field names that the matchers.fieldName parameter accepts when you create or update an Alert Configuration. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can successfully call this endpoint with any assigned role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigmatcherfieldnames. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alertConfigurations listAlertConfigMatcherFieldNames [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listAlertConfigMatcherFieldNames + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-alertConfigurations-listAlertConfigurationMatchersFieldNames.txt b/docs/command/atlas-api-alertConfigurations-listAlertConfigurationMatchersFieldNames.txt deleted file mode 100644 index 7e15c686b3..0000000000 --- a/docs/command/atlas-api-alertConfigurations-listAlertConfigurationMatchersFieldNames.txt +++ /dev/null @@ -1,87 +0,0 @@ -.. _atlas-api-alertConfigurations-listAlertConfigurationMatchersFieldNames: - -====================================================================== -atlas api alertConfigurations listAlertConfigurationMatchersFieldNames -====================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Get all field names that the matchers.fieldName parameter accepts when you create or update an Alert Configuration. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can successfully call this endpoint with any assigned role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigurationmatchersfieldnames. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alertConfigurations listAlertConfigurationMatchersFieldNames [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listAlertConfigurationMatchersFieldNames - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-alertConfigurations-listAlertConfigurations.txt b/docs/command/atlas-api-alertConfigurations-listAlertConfigurations.txt deleted file mode 100644 index ba26f6986d..0000000000 --- a/docs/command/atlas-api-alertConfigurations-listAlertConfigurations.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-alertConfigurations-listAlertConfigurations: - -===================================================== -atlas api alertConfigurations listAlertConfigurations -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all alert configurations for one project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -These alert configurations apply to any component in the project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigurations. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alertConfigurations listAlertConfigurations [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAlertConfigurations - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-alertConfigurations-listAlertConfigurations-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-alertConfigurations-listAlertConfigurationsByAlertId.txt b/docs/command/atlas-api-alertConfigurations-listAlertConfigurationsByAlertId.txt deleted file mode 100644 index d4a76aa046..0000000000 --- a/docs/command/atlas-api-alertConfigurations-listAlertConfigurationsByAlertId.txt +++ /dev/null @@ -1,117 +0,0 @@ -.. _atlas-api-alertConfigurations-listAlertConfigurationsByAlertId: - -============================================================== -atlas api alertConfigurations listAlertConfigurationsByAlertId -============================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all alert configurations set for the specified alert. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigurationsbyalertid. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alertConfigurations listAlertConfigurationsByAlertId [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --alertId - - string - - true - - Unique 24-hexadecimal digit string that identifies the alert. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAlertConfigurationsByAlertId - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-alertConfigurations-listAlertConfigurationsByAlertId-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-alertConfigurations-listGroupAlertConfigs.txt b/docs/command/atlas-api-alertConfigurations-listGroupAlertConfigs.txt new file mode 100644 index 0000000000..1294310500 --- /dev/null +++ b/docs/command/atlas-api-alertConfigurations-listGroupAlertConfigs.txt @@ -0,0 +1,113 @@ +.. _atlas-api-alertConfigurations-listGroupAlertConfigs: + +=================================================== +atlas api alertConfigurations listGroupAlertConfigs +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all alert configurations for one project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +These alert configurations apply to any component in the project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupalertconfigs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alertConfigurations listGroupAlertConfigs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupAlertConfigs + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-alertConfigurations-listGroupAlertConfigs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-alertConfigurations-toggleAlertConfiguration.txt b/docs/command/atlas-api-alertConfigurations-toggleAlertConfiguration.txt deleted file mode 100644 index fca89ddbff..0000000000 --- a/docs/command/atlas-api-alertConfigurations-toggleAlertConfiguration.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-alertConfigurations-toggleAlertConfiguration: - -====================================================== -atlas api alertConfigurations toggleAlertConfiguration -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Enables or disables the specified alert configuration in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The resource enables the specified alert configuration if currently enabled. The resource disables the specified alert configuration if currently disabled. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - - -NOTE: This endpoint updates only the enabled/disabled state for the alert configuration. To update more than just this configuration, see Update One Alert Configuration. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglealertconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alertConfigurations toggleAlertConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --alertConfigId - - string - - true - - Unique 24-hexadecimal digit string that identifies the alert configuration that triggered this alert. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for toggleAlertConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-alertConfigurations-toggleGroupAlertConfig.txt b/docs/command/atlas-api-alertConfigurations-toggleGroupAlertConfig.txt new file mode 100644 index 0000000000..4a2e1ccb3f --- /dev/null +++ b/docs/command/atlas-api-alertConfigurations-toggleGroupAlertConfig.txt @@ -0,0 +1,107 @@ +.. _atlas-api-alertConfigurations-toggleGroupAlertConfig: + +==================================================== +atlas api alertConfigurations toggleGroupAlertConfig +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Enables or disables the specified alert configuration in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The resource enables the specified alert configuration if currently enabled. The resource disables the specified alert configuration if currently disabled. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. + + +NOTE: This endpoint updates only the enabled/disabled state for the alert configuration. To update more than just this configuration, see Update One Alert Configuration. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglegroupalertconfig. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alertConfigurations toggleGroupAlertConfig [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --alertConfigId + - string + - true + - Unique 24-hexadecimal digit string that identifies the alert configuration that triggered this alert. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for toggleGroupAlertConfig + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-alertConfigurations-updateAlertConfiguration.txt b/docs/command/atlas-api-alertConfigurations-updateAlertConfiguration.txt deleted file mode 100644 index 68f9f9ed1b..0000000000 --- a/docs/command/atlas-api-alertConfigurations-updateAlertConfiguration.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-alertConfigurations-updateAlertConfiguration: - -====================================================== -atlas api alertConfigurations updateAlertConfiguration -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one alert configuration in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - - -NOTE: To enable or disable the alert configuration, see Toggle One State of One Alert Configuration in One Project. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatealertconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alertConfigurations updateAlertConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --alertConfigId - - string - - true - - Unique 24-hexadecimal digit string that identifies the alert configuration. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateAlertConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-alertConfigurations-updateGroupAlertConfig.txt b/docs/command/atlas-api-alertConfigurations-updateGroupAlertConfig.txt new file mode 100644 index 0000000000..96fee34f7e --- /dev/null +++ b/docs/command/atlas-api-alertConfigurations-updateGroupAlertConfig.txt @@ -0,0 +1,107 @@ +.. _atlas-api-alertConfigurations-updateGroupAlertConfig: + +==================================================== +atlas api alertConfigurations updateGroupAlertConfig +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one alert configuration in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. + + +NOTE: To enable or disable the alert configuration, see Toggle One State of One Alert Configuration in One Project. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupalertconfig. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alertConfigurations updateGroupAlertConfig [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --alertConfigId + - string + - true + - Unique 24-hexadecimal digit string that identifies the alert configuration. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupAlertConfig + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-alertConfigurations.txt b/docs/command/atlas-api-alertConfigurations.txt index 4dc2b34377..852c7d3085 100644 --- a/docs/command/atlas-api-alertConfigurations.txt +++ b/docs/command/atlas-api-alertConfigurations.txt @@ -54,25 +54,25 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-alertConfigurations-createAlertConfiguration` - `Public Preview: please provide feedback `_: Creates one alert configuration for the specified project. -* :ref:`atlas-api-alertConfigurations-deleteAlertConfiguration` - `Public Preview: please provide feedback `_: Removes one alert configuration from the specified project. -* :ref:`atlas-api-alertConfigurations-getAlertConfiguration` - `Public Preview: please provide feedback `_: Returns the specified alert configuration from the specified project. -* :ref:`atlas-api-alertConfigurations-listAlertConfigurationMatchersFieldNames` - `Public Preview: please provide feedback `_: Get all field names that the matchers.fieldName parameter accepts when you create or update an Alert Configuration. -* :ref:`atlas-api-alertConfigurations-listAlertConfigurations` - `Public Preview: please provide feedback `_: Returns all alert configurations for one project. -* :ref:`atlas-api-alertConfigurations-listAlertConfigurationsByAlertId` - `Public Preview: please provide feedback `_: Returns all alert configurations set for the specified alert. -* :ref:`atlas-api-alertConfigurations-toggleAlertConfiguration` - `Public Preview: please provide feedback `_: Enables or disables the specified alert configuration in the specified project. -* :ref:`atlas-api-alertConfigurations-updateAlertConfiguration` - `Public Preview: please provide feedback `_: Updates one alert configuration in the specified project. +* :ref:`atlas-api-alertConfigurations-createGroupAlertConfig` - `Public Preview: please provide feedback `_: Creates one alert configuration for the specified project. +* :ref:`atlas-api-alertConfigurations-deleteGroupAlertConfig` - `Public Preview: please provide feedback `_: Removes one alert configuration from the specified project. +* :ref:`atlas-api-alertConfigurations-getGroupAlertAlertConfigs` - `Public Preview: please provide feedback `_: Returns all alert configurations set for the specified alert. +* :ref:`atlas-api-alertConfigurations-getGroupAlertConfig` - `Public Preview: please provide feedback `_: Returns the specified alert configuration from the specified project. +* :ref:`atlas-api-alertConfigurations-listAlertConfigMatcherFieldNames` - `Public Preview: please provide feedback `_: Get all field names that the matchers.fieldName parameter accepts when you create or update an Alert Configuration. +* :ref:`atlas-api-alertConfigurations-listGroupAlertConfigs` - `Public Preview: please provide feedback `_: Returns all alert configurations for one project. +* :ref:`atlas-api-alertConfigurations-toggleGroupAlertConfig` - `Public Preview: please provide feedback `_: Enables or disables the specified alert configuration in the specified project. +* :ref:`atlas-api-alertConfigurations-updateGroupAlertConfig` - `Public Preview: please provide feedback `_: Updates one alert configuration in the specified project. .. toctree:: :titlesonly: - createAlertConfiguration - deleteAlertConfiguration - getAlertConfiguration - listAlertConfigurationMatchersFieldNames - listAlertConfigurations - listAlertConfigurationsByAlertId - toggleAlertConfiguration - updateAlertConfiguration + createGroupAlertConfig + deleteGroupAlertConfig + getGroupAlertAlertConfigs + getGroupAlertConfig + listAlertConfigMatcherFieldNames + listGroupAlertConfigs + toggleGroupAlertConfig + updateGroupAlertConfig diff --git a/docs/command/atlas-api-alerts-acknowledgeAlert.txt b/docs/command/atlas-api-alerts-acknowledgeAlert.txt deleted file mode 100644 index 9c0d165150..0000000000 --- a/docs/command/atlas-api-alerts-acknowledgeAlert.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-alerts-acknowledgeAlert: - -================================= -atlas api alerts acknowledgeAlert -================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Confirms receipt of one existing alert. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This alert applies to any component in one project. Acknowledging an alert prevents successive notifications. You receive an alert when a monitored component meets or exceeds a value you set until you acknowledge the alert. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acknowledgealert. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alerts acknowledgeAlert [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --alertId - - string - - true - - Unique 24-hexadecimal digit string that identifies the alert. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for acknowledgeAlert - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-alerts-acknowledgeGroupAlert.txt b/docs/command/atlas-api-alerts-acknowledgeGroupAlert.txt new file mode 100644 index 0000000000..2f30fdc2ce --- /dev/null +++ b/docs/command/atlas-api-alerts-acknowledgeGroupAlert.txt @@ -0,0 +1,104 @@ +.. _atlas-api-alerts-acknowledgeGroupAlert: + +====================================== +atlas api alerts acknowledgeGroupAlert +====================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Confirms receipt of one existing alert. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This alert applies to any component in one project. Acknowledging an alert prevents successive notifications. You receive an alert when a monitored component meets or exceeds a value you set until you acknowledge the alert. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acknowledgegroupalert. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alerts acknowledgeGroupAlert [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --alertId + - string + - true + - Unique 24-hexadecimal digit string that identifies the alert. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for acknowledgeGroupAlert + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-alerts-getAlert.txt b/docs/command/atlas-api-alerts-getAlert.txt deleted file mode 100644 index d4220dac65..0000000000 --- a/docs/command/atlas-api-alerts-getAlert.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-alerts-getAlert: - -========================= -atlas api alerts getAlert -========================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one alert. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This alert applies to any component in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getalert. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alerts getAlert [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --alertId - - string - - true - - Unique 24-hexadecimal digit string that identifies the alert. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAlert - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-alerts-getAlert-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-alerts-getGroupAlert.txt b/docs/command/atlas-api-alerts-getGroupAlert.txt new file mode 100644 index 0000000000..61c87199e2 --- /dev/null +++ b/docs/command/atlas-api-alerts-getGroupAlert.txt @@ -0,0 +1,105 @@ +.. _atlas-api-alerts-getGroupAlert: + +============================== +atlas api alerts getGroupAlert +============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one alert. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This alert applies to any component in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupalert. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alerts getGroupAlert [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --alertId + - string + - true + - Unique 24-hexadecimal digit string that identifies the alert. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupAlert + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-alerts-getGroupAlert-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-alerts-getGroupAlertConfigAlerts.txt b/docs/command/atlas-api-alerts-getGroupAlertConfigAlerts.txt new file mode 100644 index 0000000000..6cc22e741d --- /dev/null +++ b/docs/command/atlas-api-alerts-getGroupAlertConfigAlerts.txt @@ -0,0 +1,117 @@ +.. _atlas-api-alerts-getGroupAlertConfigAlerts: + +========================================== +atlas api alerts getGroupAlertConfigAlerts +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all open alerts that the specified alert configuration triggers. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +These alert configurations apply to the specified project only. Alert configurations define the triggers and notification methods for alerts. Open alerts have been triggered but remain unacknowledged. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupalertconfigalerts. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alerts getGroupAlertConfigAlerts [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --alertConfigId + - string + - true + - Unique 24-hexadecimal digit string that identifies the alert configuration. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupAlertConfigAlerts + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-alerts-getGroupAlertConfigAlerts-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-alerts-listAlerts.txt b/docs/command/atlas-api-alerts-listAlerts.txt deleted file mode 100644 index 2033467828..0000000000 --- a/docs/command/atlas-api-alerts-listAlerts.txt +++ /dev/null @@ -1,117 +0,0 @@ -.. _atlas-api-alerts-listAlerts: - -=========================== -atlas api alerts listAlerts -=========================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all alerts. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -These alerts apply to all components in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalerts. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alerts listAlerts [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAlerts - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --status - - string - - false - - Status of the alerts to return. Omit this parameter to return all alerts in all statuses. TRACKING indicates the alert condition exists but has not persisted for the minimum notification delay. OPEN indicates the alert condition currently exists. CLOSED indicates the alert condition has been resolved. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-alerts-listAlerts-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-alerts-listAlertsByAlertConfigurationId.txt b/docs/command/atlas-api-alerts-listAlertsByAlertConfigurationId.txt deleted file mode 100644 index 369a4c0bdd..0000000000 --- a/docs/command/atlas-api-alerts-listAlertsByAlertConfigurationId.txt +++ /dev/null @@ -1,117 +0,0 @@ -.. _atlas-api-alerts-listAlertsByAlertConfigurationId: - -================================================= -atlas api alerts listAlertsByAlertConfigurationId -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all open alerts that the specified alert configuration triggers. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -These alert configurations apply to the specified project only. Alert configurations define the triggers and notification methods for alerts. Open alerts have been triggered but remain unacknowledged. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertsbyalertconfigurationid. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api alerts listAlertsByAlertConfigurationId [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --alertConfigId - - string - - true - - Unique 24-hexadecimal digit string that identifies the alert configuration. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAlertsByAlertConfigurationId - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-alerts-listAlertsByAlertConfigurationId-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-alerts-listGroupAlerts.txt b/docs/command/atlas-api-alerts-listGroupAlerts.txt new file mode 100644 index 0000000000..fbf6052eb2 --- /dev/null +++ b/docs/command/atlas-api-alerts-listGroupAlerts.txt @@ -0,0 +1,117 @@ +.. _atlas-api-alerts-listGroupAlerts: + +================================ +atlas api alerts listGroupAlerts +================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all alerts. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +These alerts apply to all components in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupalerts. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api alerts listGroupAlerts [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupAlerts + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --status + - string + - false + - Status of the alerts to return. Omit this parameter to return all alerts in all statuses. TRACKING indicates the alert condition exists but has not persisted for the minimum notification delay. OPEN indicates the alert condition currently exists. CLOSED indicates the alert condition has been resolved. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-alerts-listGroupAlerts-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-alerts.txt b/docs/command/atlas-api-alerts.txt index ceaa4a22b1..a5127e6e20 100644 --- a/docs/command/atlas-api-alerts.txt +++ b/docs/command/atlas-api-alerts.txt @@ -54,17 +54,17 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-alerts-acknowledgeAlert` - `Public Preview: please provide feedback `_: Confirms receipt of one existing alert. -* :ref:`atlas-api-alerts-getAlert` - `Public Preview: please provide feedback `_: Returns one alert. -* :ref:`atlas-api-alerts-listAlerts` - `Public Preview: please provide feedback `_: Returns all alerts. -* :ref:`atlas-api-alerts-listAlertsByAlertConfigurationId` - `Public Preview: please provide feedback `_: Returns all open alerts that the specified alert configuration triggers. +* :ref:`atlas-api-alerts-acknowledgeGroupAlert` - `Public Preview: please provide feedback `_: Confirms receipt of one existing alert. +* :ref:`atlas-api-alerts-getGroupAlert` - `Public Preview: please provide feedback `_: Returns one alert. +* :ref:`atlas-api-alerts-getGroupAlertConfigAlerts` - `Public Preview: please provide feedback `_: Returns all open alerts that the specified alert configuration triggers. +* :ref:`atlas-api-alerts-listGroupAlerts` - `Public Preview: please provide feedback `_: Returns all alerts. .. toctree:: :titlesonly: - acknowledgeAlert - getAlert - listAlerts - listAlertsByAlertConfigurationId + acknowledgeGroupAlert + getGroupAlert + getGroupAlertConfigAlerts + listGroupAlerts diff --git a/docs/command/atlas-api-atlasSearch-createAtlasSearchDeployment.txt b/docs/command/atlas-api-atlasSearch-createAtlasSearchDeployment.txt deleted file mode 100644 index 8b7f0c4de4..0000000000 --- a/docs/command/atlas-api-atlasSearch-createAtlasSearchDeployment.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-atlasSearch-createAtlasSearchDeployment: - -================================================= -atlas api atlasSearch createAtlasSearchDeployment -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates Search Nodes for the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchdeployment. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch createAtlasSearchDeployment [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Label that identifies the cluster to create Search Nodes for. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createAtlasSearchDeployment - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-atlasSearch-createAtlasSearchIndex.txt b/docs/command/atlas-api-atlasSearch-createAtlasSearchIndex.txt deleted file mode 100644 index 37fe0bcba8..0000000000 --- a/docs/command/atlas-api-atlasSearch-createAtlasSearchIndex.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-atlasSearch-createAtlasSearchIndex: - -============================================ -atlas api atlasSearch createAtlasSearchIndex -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one Atlas Search index on the specified collection. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchindex. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch createAtlasSearchIndex [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection on which to create an Atlas Search index. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createAtlasSearchIndex - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-atlasSearch-createAtlasSearchIndexDeprecated.txt b/docs/command/atlas-api-atlasSearch-createAtlasSearchIndexDeprecated.txt deleted file mode 100644 index e76e3e63eb..0000000000 --- a/docs/command/atlas-api-atlasSearch-createAtlasSearchIndexDeprecated.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-atlasSearch-createAtlasSearchIndexDeprecated: - -====================================================== -atlas api atlasSearch createAtlasSearchIndexDeprecated -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one Atlas Search index on the specified collection. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchindexdeprecated. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch createAtlasSearchIndexDeprecated [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection on which to create an Atlas Search index. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createAtlasSearchIndexDeprecated - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-atlasSearch-createGroupClusterFtsIndex.txt b/docs/command/atlas-api-atlasSearch-createGroupClusterFtsIndex.txt new file mode 100644 index 0000000000..c8a6ee3c71 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-createGroupClusterFtsIndex.txt @@ -0,0 +1,101 @@ +.. _atlas-api-atlasSearch-createGroupClusterFtsIndex: + +================================================ +atlas api atlasSearch createGroupClusterFtsIndex +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one Atlas Search index on the specified collection. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterftsindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch createGroupClusterFtsIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection on which to create an Atlas Search index. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterFtsIndex + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-atlasSearch-createGroupClusterSearchDeployment.txt b/docs/command/atlas-api-atlasSearch-createGroupClusterSearchDeployment.txt new file mode 100644 index 0000000000..5ab9670239 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-createGroupClusterSearchDeployment.txt @@ -0,0 +1,107 @@ +.. _atlas-api-atlasSearch-createGroupClusterSearchDeployment: + +======================================================== +atlas api atlasSearch createGroupClusterSearchDeployment +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates Search Nodes for the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclustersearchdeployment. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch createGroupClusterSearchDeployment [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Label that identifies the cluster to create Search Nodes for. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterSearchDeployment + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-atlasSearch-createGroupClusterSearchIndex.txt b/docs/command/atlas-api-atlasSearch-createGroupClusterSearchIndex.txt new file mode 100644 index 0000000000..f65e327ec8 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-createGroupClusterSearchIndex.txt @@ -0,0 +1,101 @@ +.. _atlas-api-atlasSearch-createGroupClusterSearchIndex: + +=================================================== +atlas api atlasSearch createGroupClusterSearchIndex +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one Atlas Search index on the specified collection. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclustersearchindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch createGroupClusterSearchIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection on which to create an Atlas Search index. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterSearchIndex + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-atlasSearch-deleteAtlasSearchDeployment.txt b/docs/command/atlas-api-atlasSearch-deleteAtlasSearchDeployment.txt deleted file mode 100644 index 7c37646cfe..0000000000 --- a/docs/command/atlas-api-atlasSearch-deleteAtlasSearchDeployment.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-atlasSearch-deleteAtlasSearchDeployment: - -================================================= -atlas api atlasSearch deleteAtlasSearchDeployment -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes the Search Nodes for the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchdeployment. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch deleteAtlasSearchDeployment [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Label that identifies the cluster to delete. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteAtlasSearchDeployment - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-deleteAtlasSearchDeployment-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndex.txt b/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndex.txt deleted file mode 100644 index e18cf884ae..0000000000 --- a/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndex.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-atlasSearch-deleteAtlasSearchIndex: - -============================================ -atlas api atlasSearch deleteAtlasSearchIndex -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its unique ID. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindex. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch deleteAtlasSearchIndex [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the database and collection with one or more Application Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteAtlasSearchIndex - * - --indexId - - string - - true - - Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-deleteAtlasSearchIndex-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndexByName.txt b/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndexByName.txt deleted file mode 100644 index 529fd65db1..0000000000 --- a/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndexByName.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-atlasSearch-deleteAtlasSearchIndexByName: - -================================================== -atlas api atlasSearch deleteAtlasSearchIndexByName -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its database, collection, and name. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindexbyname. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch deleteAtlasSearchIndexByName [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the database and collection with one or more Application Search indexes. - * - --collectionName - - string - - true - - Name of the collection that contains one or more Atlas Search indexes. - * - --databaseName - - string - - true - - Label that identifies the database that contains the collection with one or more Atlas Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteAtlasSearchIndexByName - * - --indexName - - string - - true - - Name of the Atlas Search index to delete. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-deleteAtlasSearchIndexByName-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated.txt b/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated.txt deleted file mode 100644 index 6e7e94436d..0000000000 --- a/docs/command/atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated: - -====================================================== -atlas api atlasSearch deleteAtlasSearchIndexDeprecated -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its unique ID. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindexdeprecated. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch deleteAtlasSearchIndexDeprecated [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the database and collection with one or more Application Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteAtlasSearchIndexDeprecated - * - --indexId - - string - - true - - Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-deleteGroupClusterFtsIndex.txt b/docs/command/atlas-api-atlasSearch-deleteGroupClusterFtsIndex.txt new file mode 100644 index 0000000000..b4697a847d --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-deleteGroupClusterFtsIndex.txt @@ -0,0 +1,106 @@ +.. _atlas-api-atlasSearch-deleteGroupClusterFtsIndex: + +================================================ +atlas api atlasSearch deleteGroupClusterFtsIndex +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its unique ID. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterftsindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch deleteGroupClusterFtsIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the database and collection with one or more Application Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterFtsIndex + * - --indexId + - string + - true + - Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-deleteGroupClusterFtsIndex-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchDeployment.txt b/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchDeployment.txt new file mode 100644 index 0000000000..5a43d5dd79 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchDeployment.txt @@ -0,0 +1,108 @@ +.. _atlas-api-atlasSearch-deleteGroupClusterSearchDeployment: + +======================================================== +atlas api atlasSearch deleteGroupClusterSearchDeployment +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes the Search Nodes for the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclustersearchdeployment. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch deleteGroupClusterSearchDeployment [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Label that identifies the cluster to delete. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterSearchDeployment + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-deleteGroupClusterSearchDeployment-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchIndex.txt b/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchIndex.txt new file mode 100644 index 0000000000..adff0b7a07 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchIndex.txt @@ -0,0 +1,106 @@ +.. _atlas-api-atlasSearch-deleteGroupClusterSearchIndex: + +=================================================== +atlas api atlasSearch deleteGroupClusterSearchIndex +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its unique ID. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclustersearchindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch deleteGroupClusterSearchIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the database and collection with one or more Application Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterSearchIndex + * - --indexId + - string + - true + - Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-deleteGroupClusterSearchIndex-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName.txt b/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName.txt new file mode 100644 index 0000000000..bc375ac467 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName.txt @@ -0,0 +1,114 @@ +.. _atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName: + +========================================================= +atlas api atlasSearch deleteGroupClusterSearchIndexByName +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its database, collection, and name. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclustersearchindexbyname. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch deleteGroupClusterSearchIndexByName [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the database and collection with one or more Application Search indexes. + * - --collectionName + - string + - true + - Name of the collection that contains one or more Atlas Search indexes. + * - --databaseName + - string + - true + - Label that identifies the database that contains the collection with one or more Atlas Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterSearchIndexByName + * - --indexName + - string + - true + - Name of the Atlas Search index to delete. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-getAtlasSearchDeployment.txt b/docs/command/atlas-api-atlasSearch-getAtlasSearchDeployment.txt deleted file mode 100644 index 551d496121..0000000000 --- a/docs/command/atlas-api-atlasSearch-getAtlasSearchDeployment.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-atlasSearch-getAtlasSearchDeployment: - -============================================== -atlas api atlasSearch getAtlasSearchDeployment -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the Search Nodes for the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchdeployment. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch getAtlasSearchDeployment [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Label that identifies the cluster to return the Search Nodes for. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAtlasSearchDeployment - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2024-05-30", "2025-03-12"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-03-12". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-getAtlasSearchDeployment-2025-03-12-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-getAtlasSearchIndex.txt b/docs/command/atlas-api-atlasSearch-getAtlasSearchIndex.txt deleted file mode 100644 index 4e24895c23..0000000000 --- a/docs/command/atlas-api-atlasSearch-getAtlasSearchIndex.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-atlasSearch-getAtlasSearchIndex: - -========================================= -atlas api atlasSearch getAtlasSearchIndex -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one Atlas Search index that you identified with its unique ID. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindex. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch getAtlasSearchIndex [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection with one or more Atlas Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAtlasSearchIndex - * - --indexId - - string - - true - - Unique 24-hexadecimal digit string that identifies the Application Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Application Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Application Search indexes. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-getAtlasSearchIndex-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-getAtlasSearchIndexByName.txt b/docs/command/atlas-api-atlasSearch-getAtlasSearchIndexByName.txt deleted file mode 100644 index 80d70bdd49..0000000000 --- a/docs/command/atlas-api-atlasSearch-getAtlasSearchIndexByName.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-atlasSearch-getAtlasSearchIndexByName: - -=============================================== -atlas api atlasSearch getAtlasSearchIndexByName -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one Atlas Search index that you identified with its database, collection name, and index name. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindexbyname. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch getAtlasSearchIndexByName [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection with one or more Atlas Search indexes. - * - --collectionName - - string - - true - - Name of the collection that contains one or more Atlas Search indexes. - * - --databaseName - - string - - true - - Label that identifies the database that contains the collection with one or more Atlas Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAtlasSearchIndexByName - * - --indexName - - string - - true - - Name of the Atlas Search index to return. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-getAtlasSearchIndexByName-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-getAtlasSearchIndexDeprecated.txt b/docs/command/atlas-api-atlasSearch-getAtlasSearchIndexDeprecated.txt deleted file mode 100644 index 2acba5b882..0000000000 --- a/docs/command/atlas-api-atlasSearch-getAtlasSearchIndexDeprecated.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-atlasSearch-getAtlasSearchIndexDeprecated: - -=================================================== -atlas api atlasSearch getAtlasSearchIndexDeprecated -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one Atlas Search index in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindexdeprecated. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch getAtlasSearchIndexDeprecated [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection with one or more Atlas Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAtlasSearchIndexDeprecated - * - --indexId - - string - - true - - Unique 24-hexadecimal digit string that identifies the Application Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Application Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Application Search indexes. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-getAtlasSearchIndexDeprecated-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-getGroupClusterFtsIndex.txt b/docs/command/atlas-api-atlasSearch-getGroupClusterFtsIndex.txt new file mode 100644 index 0000000000..951a62f5d1 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-getGroupClusterFtsIndex.txt @@ -0,0 +1,106 @@ +.. _atlas-api-atlasSearch-getGroupClusterFtsIndex: + +============================================= +atlas api atlasSearch getGroupClusterFtsIndex +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one Atlas Search index in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterftsindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch getGroupClusterFtsIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection with one or more Atlas Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterFtsIndex + * - --indexId + - string + - true + - Unique 24-hexadecimal digit string that identifies the Application Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Application Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Application Search indexes. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-getGroupClusterFtsIndex-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-getGroupClusterSearchDeployment.txt b/docs/command/atlas-api-atlasSearch-getGroupClusterSearchDeployment.txt new file mode 100644 index 0000000000..aba41e857f --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-getGroupClusterSearchDeployment.txt @@ -0,0 +1,100 @@ +.. _atlas-api-atlasSearch-getGroupClusterSearchDeployment: + +===================================================== +atlas api atlasSearch getGroupClusterSearchDeployment +===================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the Search Nodes for the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersearchdeployment. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch getGroupClusterSearchDeployment [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Label that identifies the cluster to return the Search Nodes for. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterSearchDeployment + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2024-05-30", "2025-03-12"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-03-12". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-getGroupClusterSearchDeployment-2025-03-12-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-getGroupClusterSearchIndex.txt b/docs/command/atlas-api-atlasSearch-getGroupClusterSearchIndex.txt new file mode 100644 index 0000000000..f8731a48dd --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-getGroupClusterSearchIndex.txt @@ -0,0 +1,106 @@ +.. _atlas-api-atlasSearch-getGroupClusterSearchIndex: + +================================================ +atlas api atlasSearch getGroupClusterSearchIndex +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one Atlas Search index that you identified with its unique ID. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersearchindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch getGroupClusterSearchIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection with one or more Atlas Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterSearchIndex + * - --indexId + - string + - true + - Unique 24-hexadecimal digit string that identifies the Application Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Application Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Application Search indexes. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-getGroupClusterSearchIndex-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-getGroupClusterSearchIndexByName.txt b/docs/command/atlas-api-atlasSearch-getGroupClusterSearchIndexByName.txt new file mode 100644 index 0000000000..a54b5a5a2f --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-getGroupClusterSearchIndexByName.txt @@ -0,0 +1,114 @@ +.. _atlas-api-atlasSearch-getGroupClusterSearchIndexByName: + +====================================================== +atlas api atlasSearch getGroupClusterSearchIndexByName +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one Atlas Search index that you identified with its database, collection name, and index name. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersearchindexbyname. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch getGroupClusterSearchIndexByName [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection with one or more Atlas Search indexes. + * - --collectionName + - string + - true + - Name of the collection that contains one or more Atlas Search indexes. + * - --databaseName + - string + - true + - Label that identifies the database that contains the collection with one or more Atlas Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterSearchIndexByName + * - --indexName + - string + - true + - Name of the Atlas Search index to return. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-getGroupClusterSearchIndexByName-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexes.txt b/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexes.txt deleted file mode 100644 index 8cfdca193c..0000000000 --- a/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexes.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-atlasSearch-listAtlasSearchIndexes: - -============================================ -atlas api atlasSearch listAtlasSearchIndexes -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified collection. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexes. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch listAtlasSearchIndexes [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection with one or more Atlas Search indexes. - * - --collectionName - - string - - true - - Name of the collection that contains one or more Atlas Search indexes. - * - --databaseName - - string - - true - - Label that identifies the database that contains the collection with one or more Atlas Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAtlasSearchIndexes - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-listAtlasSearchIndexes-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexesCluster.txt b/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexesCluster.txt deleted file mode 100644 index f8a8899f52..0000000000 --- a/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexesCluster.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-atlasSearch-listAtlasSearchIndexesCluster: - -=================================================== -atlas api atlasSearch listAtlasSearchIndexesCluster -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexescluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch listAtlasSearchIndexesCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection with one or more Atlas Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAtlasSearchIndexesCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-listAtlasSearchIndexesCluster-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated.txt b/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated.txt deleted file mode 100644 index 031e07c694..0000000000 --- a/docs/command/atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated: - -====================================================== -atlas api atlasSearch listAtlasSearchIndexesDeprecated -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified collection. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexesdeprecated. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch listAtlasSearchIndexesDeprecated [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection with one or more Atlas Search indexes. - * - --collectionName - - string - - true - - Name of the collection that contains one or more Atlas Search indexes. - * - --databaseName - - string - - true - - Human-readable label that identifies the database that contains the collection with one or more Atlas Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAtlasSearchIndexesDeprecated - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-atlasSearch-listGroupClusterFtsIndex.txt b/docs/command/atlas-api-atlasSearch-listGroupClusterFtsIndex.txt new file mode 100644 index 0000000000..0d877911c1 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-listGroupClusterFtsIndex.txt @@ -0,0 +1,110 @@ +.. _atlas-api-atlasSearch-listGroupClusterFtsIndex: + +============================================== +atlas api atlasSearch listGroupClusterFtsIndex +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified collection. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterftsindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch listGroupClusterFtsIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection with one or more Atlas Search indexes. + * - --collectionName + - string + - true + - Name of the collection that contains one or more Atlas Search indexes. + * - --databaseName + - string + - true + - Human-readable label that identifies the database that contains the collection with one or more Atlas Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterFtsIndex + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-listGroupClusterFtsIndex-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-listGroupClusterSearchIndex.txt b/docs/command/atlas-api-atlasSearch-listGroupClusterSearchIndex.txt new file mode 100644 index 0000000000..34d69f7b71 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-listGroupClusterSearchIndex.txt @@ -0,0 +1,110 @@ +.. _atlas-api-atlasSearch-listGroupClusterSearchIndex: + +================================================= +atlas api atlasSearch listGroupClusterSearchIndex +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified collection. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustersearchindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch listGroupClusterSearchIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection with one or more Atlas Search indexes. + * - --collectionName + - string + - true + - Name of the collection that contains one or more Atlas Search indexes. + * - --databaseName + - string + - true + - Label that identifies the database that contains the collection with one or more Atlas Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterSearchIndex + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-listGroupClusterSearchIndex-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-listGroupClusterSearchIndexes.txt b/docs/command/atlas-api-atlasSearch-listGroupClusterSearchIndexes.txt new file mode 100644 index 0000000000..5013759f93 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-listGroupClusterSearchIndexes.txt @@ -0,0 +1,102 @@ +.. _atlas-api-atlasSearch-listGroupClusterSearchIndexes: + +=================================================== +atlas api atlasSearch listGroupClusterSearchIndexes +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustersearchindexes. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch listGroupClusterSearchIndexes [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection with one or more Atlas Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterSearchIndexes + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-atlasSearch-listGroupClusterSearchIndexes-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-atlasSearch-updateAtlasSearchDeployment.txt b/docs/command/atlas-api-atlasSearch-updateAtlasSearchDeployment.txt deleted file mode 100644 index 01e7b5a2f9..0000000000 --- a/docs/command/atlas-api-atlasSearch-updateAtlasSearchDeployment.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-atlasSearch-updateAtlasSearchDeployment: - -================================================= -atlas api atlasSearch updateAtlasSearchDeployment -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the Search Nodes for the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchdeployment. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch updateAtlasSearchDeployment [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Label that identifies the cluster to update the Search Nodes for. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateAtlasSearchDeployment - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndex.txt b/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndex.txt deleted file mode 100644 index b096c6dfbf..0000000000 --- a/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndex.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-atlasSearch-updateAtlasSearchIndex: - -============================================ -atlas api atlasSearch updateAtlasSearchIndex -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its unique ID. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindex. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch updateAtlasSearchIndex [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection whose Atlas Search index you want to update. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateAtlasSearchIndex - * - --indexId - - string - - true - - Unique 24-hexadecimal digit string that identifies the Atlas Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndexByName.txt b/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndexByName.txt deleted file mode 100644 index 07dfdad1b6..0000000000 --- a/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndexByName.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-atlasSearch-updateAtlasSearchIndexByName: - -================================================== -atlas api atlasSearch updateAtlasSearchIndexByName -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its database, collection name, and index name. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindexbyname. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch updateAtlasSearchIndexByName [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection whose Atlas Search index you want to update. - * - --collectionName - - string - - true - - Name of the collection that contains one or more Atlas Search indexes. - * - --databaseName - - string - - true - - Label that identifies the database that contains the collection with one or more Atlas Search indexes. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateAtlasSearchIndexByName - * - --indexName - - string - - true - - Name of the Atlas Search index to update. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndexDeprecated.txt b/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndexDeprecated.txt deleted file mode 100644 index fa2ab9bd32..0000000000 --- a/docs/command/atlas-api-atlasSearch-updateAtlasSearchIndexDeprecated.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-atlasSearch-updateAtlasSearchIndexDeprecated: - -====================================================== -atlas api atlasSearch updateAtlasSearchIndexDeprecated -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its unique ID. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindexdeprecated. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api atlasSearch updateAtlasSearchIndexDeprecated [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Name of the cluster that contains the collection whose Atlas Search index to update. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateAtlasSearchIndexDeprecated - * - --indexId - - string - - true - - Unique 24-hexadecimal digit string that identifies the Atlas Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-atlasSearch-updateGroupClusterFtsIndex.txt b/docs/command/atlas-api-atlasSearch-updateGroupClusterFtsIndex.txt new file mode 100644 index 0000000000..6616b88495 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-updateGroupClusterFtsIndex.txt @@ -0,0 +1,105 @@ +.. _atlas-api-atlasSearch-updateGroupClusterFtsIndex: + +================================================ +atlas api atlasSearch updateGroupClusterFtsIndex +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its unique ID. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusterftsindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch updateGroupClusterFtsIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection whose Atlas Search index to update. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterFtsIndex + * - --indexId + - string + - true + - Unique 24-hexadecimal digit string that identifies the Atlas Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchDeployment.txt b/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchDeployment.txt new file mode 100644 index 0000000000..eaba01cbbb --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchDeployment.txt @@ -0,0 +1,107 @@ +.. _atlas-api-atlasSearch-updateGroupClusterSearchDeployment: + +======================================================== +atlas api atlasSearch updateGroupClusterSearchDeployment +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the Search Nodes for the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchdeployment. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch updateGroupClusterSearchDeployment [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Label that identifies the cluster to update the Search Nodes for. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterSearchDeployment + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchIndex.txt b/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchIndex.txt new file mode 100644 index 0000000000..60a820db1d --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchIndex.txt @@ -0,0 +1,105 @@ +.. _atlas-api-atlasSearch-updateGroupClusterSearchIndex: + +=================================================== +atlas api atlasSearch updateGroupClusterSearchIndex +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its unique ID. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch updateGroupClusterSearchIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection whose Atlas Search index you want to update. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterSearchIndex + * - --indexId + - string + - true + - Unique 24-hexadecimal digit string that identifies the Atlas Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchIndexByName.txt b/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchIndexByName.txt new file mode 100644 index 0000000000..2dd3f2d4e7 --- /dev/null +++ b/docs/command/atlas-api-atlasSearch-updateGroupClusterSearchIndexByName.txt @@ -0,0 +1,113 @@ +.. _atlas-api-atlasSearch-updateGroupClusterSearchIndexByName: + +========================================================= +atlas api atlasSearch updateGroupClusterSearchIndexByName +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its database, collection name, and index name. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchindexbyname. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api atlasSearch updateGroupClusterSearchIndexByName [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Name of the cluster that contains the collection whose Atlas Search index you want to update. + * - --collectionName + - string + - true + - Name of the collection that contains one or more Atlas Search indexes. + * - --databaseName + - string + - true + - Label that identifies the database that contains the collection with one or more Atlas Search indexes. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterSearchIndexByName + * - --indexName + - string + - true + - Name of the Atlas Search index to update. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-atlasSearch.txt b/docs/command/atlas-api-atlasSearch.txt index bb650c3628..996f92a29f 100644 --- a/docs/command/atlas-api-atlasSearch.txt +++ b/docs/command/atlas-api-atlasSearch.txt @@ -54,45 +54,45 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-atlasSearch-createAtlasSearchDeployment` - `Public Preview: please provide feedback `_: Creates Search Nodes for the specified cluster. -* :ref:`atlas-api-atlasSearch-createAtlasSearchIndex` - `Public Preview: please provide feedback `_: Creates one Atlas Search index on the specified collection. -* :ref:`atlas-api-atlasSearch-createAtlasSearchIndexDeprecated` - `Public Preview: please provide feedback `_: Creates one Atlas Search index on the specified collection. -* :ref:`atlas-api-atlasSearch-deleteAtlasSearchDeployment` - `Public Preview: please provide feedback `_: Deletes the Search Nodes for the specified cluster. -* :ref:`atlas-api-atlasSearch-deleteAtlasSearchIndex` - `Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its unique ID. -* :ref:`atlas-api-atlasSearch-deleteAtlasSearchIndexByName` - `Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its database, collection, and name. -* :ref:`atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated` - `Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its unique ID. -* :ref:`atlas-api-atlasSearch-getAtlasSearchDeployment` - `Public Preview: please provide feedback `_: Returns the Search Nodes for the specified cluster. -* :ref:`atlas-api-atlasSearch-getAtlasSearchIndex` - `Public Preview: please provide feedback `_: Returns one Atlas Search index that you identified with its unique ID. -* :ref:`atlas-api-atlasSearch-getAtlasSearchIndexByName` - `Public Preview: please provide feedback `_: Returns one Atlas Search index that you identified with its database, collection name, and index name. -* :ref:`atlas-api-atlasSearch-getAtlasSearchIndexDeprecated` - `Public Preview: please provide feedback `_: Returns one Atlas Search index in the specified project. -* :ref:`atlas-api-atlasSearch-listAtlasSearchIndexes` - `Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified collection. -* :ref:`atlas-api-atlasSearch-listAtlasSearchIndexesCluster` - `Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified cluster. -* :ref:`atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated` - `Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified collection. -* :ref:`atlas-api-atlasSearch-updateAtlasSearchDeployment` - `Public Preview: please provide feedback `_: Updates the Search Nodes for the specified cluster. -* :ref:`atlas-api-atlasSearch-updateAtlasSearchIndex` - `Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its unique ID. -* :ref:`atlas-api-atlasSearch-updateAtlasSearchIndexByName` - `Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its database, collection name, and index name. -* :ref:`atlas-api-atlasSearch-updateAtlasSearchIndexDeprecated` - `Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its unique ID. +* :ref:`atlas-api-atlasSearch-createGroupClusterFtsIndex` - `Public Preview: please provide feedback `_: Creates one Atlas Search index on the specified collection. +* :ref:`atlas-api-atlasSearch-createGroupClusterSearchDeployment` - `Public Preview: please provide feedback `_: Creates Search Nodes for the specified cluster. +* :ref:`atlas-api-atlasSearch-createGroupClusterSearchIndex` - `Public Preview: please provide feedback `_: Creates one Atlas Search index on the specified collection. +* :ref:`atlas-api-atlasSearch-deleteGroupClusterFtsIndex` - `Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its unique ID. +* :ref:`atlas-api-atlasSearch-deleteGroupClusterSearchDeployment` - `Public Preview: please provide feedback `_: Deletes the Search Nodes for the specified cluster. +* :ref:`atlas-api-atlasSearch-deleteGroupClusterSearchIndex` - `Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its unique ID. +* :ref:`atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName` - `Public Preview: please provide feedback `_: Removes one Atlas Search index that you identified with its database, collection, and name. +* :ref:`atlas-api-atlasSearch-getGroupClusterFtsIndex` - `Public Preview: please provide feedback `_: Returns one Atlas Search index in the specified project. +* :ref:`atlas-api-atlasSearch-getGroupClusterSearchDeployment` - `Public Preview: please provide feedback `_: Returns the Search Nodes for the specified cluster. +* :ref:`atlas-api-atlasSearch-getGroupClusterSearchIndex` - `Public Preview: please provide feedback `_: Returns one Atlas Search index that you identified with its unique ID. +* :ref:`atlas-api-atlasSearch-getGroupClusterSearchIndexByName` - `Public Preview: please provide feedback `_: Returns one Atlas Search index that you identified with its database, collection name, and index name. +* :ref:`atlas-api-atlasSearch-listGroupClusterFtsIndex` - `Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified collection. +* :ref:`atlas-api-atlasSearch-listGroupClusterSearchIndex` - `Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified collection. +* :ref:`atlas-api-atlasSearch-listGroupClusterSearchIndexes` - `Public Preview: please provide feedback `_: Returns all Atlas Search indexes on the specified cluster. +* :ref:`atlas-api-atlasSearch-updateGroupClusterFtsIndex` - `Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its unique ID. +* :ref:`atlas-api-atlasSearch-updateGroupClusterSearchDeployment` - `Public Preview: please provide feedback `_: Updates the Search Nodes for the specified cluster. +* :ref:`atlas-api-atlasSearch-updateGroupClusterSearchIndex` - `Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its unique ID. +* :ref:`atlas-api-atlasSearch-updateGroupClusterSearchIndexByName` - `Public Preview: please provide feedback `_: Updates one Atlas Search index that you identified with its database, collection name, and index name. .. toctree:: :titlesonly: - createAtlasSearchDeployment - createAtlasSearchIndex - createAtlasSearchIndexDeprecated - deleteAtlasSearchDeployment - deleteAtlasSearchIndex - deleteAtlasSearchIndexByName - deleteAtlasSearchIndexDeprecated - getAtlasSearchDeployment - getAtlasSearchIndex - getAtlasSearchIndexByName - getAtlasSearchIndexDeprecated - listAtlasSearchIndexes - listAtlasSearchIndexesCluster - listAtlasSearchIndexesDeprecated - updateAtlasSearchDeployment - updateAtlasSearchIndex - updateAtlasSearchIndexByName - updateAtlasSearchIndexDeprecated + createGroupClusterFtsIndex + createGroupClusterSearchDeployment + createGroupClusterSearchIndex + deleteGroupClusterFtsIndex + deleteGroupClusterSearchDeployment + deleteGroupClusterSearchIndex + deleteGroupClusterSearchIndexByName + getGroupClusterFtsIndex + getGroupClusterSearchDeployment + getGroupClusterSearchIndex + getGroupClusterSearchIndexByName + listGroupClusterFtsIndex + listGroupClusterSearchIndex + listGroupClusterSearchIndexes + updateGroupClusterFtsIndex + updateGroupClusterSearchDeployment + updateGroupClusterSearchIndex + updateGroupClusterSearchIndexByName diff --git a/docs/command/atlas-api-auditing-getAuditingConfiguration.txt b/docs/command/atlas-api-auditing-getAuditingConfiguration.txt deleted file mode 100644 index e860e9bd78..0000000000 --- a/docs/command/atlas-api-auditing-getAuditingConfiguration.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-auditing-getAuditingConfiguration: - -=========================================== -atlas api auditing getAuditingConfiguration -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the auditing configuration for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for M0, M2, M5, or serverless clusters. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getauditingconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api auditing getAuditingConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAuditingConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-auditing-getAuditingConfiguration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-auditing-getGroupAuditLog.txt b/docs/command/atlas-api-auditing-getGroupAuditLog.txt new file mode 100644 index 0000000000..33d92d37e1 --- /dev/null +++ b/docs/command/atlas-api-auditing-getGroupAuditLog.txt @@ -0,0 +1,98 @@ +.. _atlas-api-auditing-getGroupAuditLog: + +=================================== +atlas api auditing getGroupAuditLog +=================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the auditing configuration for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for M0, M2, M5, or serverless clusters. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupauditlog. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api auditing getGroupAuditLog [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupAuditLog + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-auditing-getGroupAuditLog-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-auditing-updateAuditingConfiguration.txt b/docs/command/atlas-api-auditing-updateAuditingConfiguration.txt deleted file mode 100644 index 65f5cb25da..0000000000 --- a/docs/command/atlas-api-auditing-updateAuditingConfiguration.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-auditing-updateAuditingConfiguration: - -============================================== -atlas api auditing updateAuditingConfiguration -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the auditing configuration for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for M0, M2, M5, or serverless clusters. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateauditingconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api auditing updateAuditingConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateAuditingConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-auditing-updateGroupAuditLog.txt b/docs/command/atlas-api-auditing-updateGroupAuditLog.txt new file mode 100644 index 0000000000..6b9f3403c2 --- /dev/null +++ b/docs/command/atlas-api-auditing-updateGroupAuditLog.txt @@ -0,0 +1,97 @@ +.. _atlas-api-auditing-updateGroupAuditLog: + +====================================== +atlas api auditing updateGroupAuditLog +====================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the auditing configuration for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for M0, M2, M5, or serverless clusters. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupauditlog. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api auditing updateGroupAuditLog [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupAuditLog + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-auditing.txt b/docs/command/atlas-api-auditing.txt index 0cd3df8d11..e0fd6d763d 100644 --- a/docs/command/atlas-api-auditing.txt +++ b/docs/command/atlas-api-auditing.txt @@ -54,13 +54,13 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-auditing-getAuditingConfiguration` - `Public Preview: please provide feedback `_: Returns the auditing configuration for the specified project. -* :ref:`atlas-api-auditing-updateAuditingConfiguration` - `Public Preview: please provide feedback `_: Updates the auditing configuration for the specified project. +* :ref:`atlas-api-auditing-getGroupAuditLog` - `Public Preview: please provide feedback `_: Returns the auditing configuration for the specified project. +* :ref:`atlas-api-auditing-updateGroupAuditLog` - `Public Preview: please provide feedback `_: Updates the auditing configuration for the specified project. .. toctree:: :titlesonly: - getAuditingConfiguration - updateAuditingConfiguration + getGroupAuditLog + updateGroupAuditLog diff --git a/docs/command/atlas-api-awsClustersDns-getAwsCustomDns.txt b/docs/command/atlas-api-awsClustersDns-getAwsCustomDns.txt deleted file mode 100644 index f91ceffec5..0000000000 --- a/docs/command/atlas-api-awsClustersDns-getAwsCustomDns.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-awsClustersDns-getAwsCustomDns: - -======================================== -atlas api awsClustersDns getAwsCustomDns -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the custom DNS configuration for AWS clusters in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getawscustomdns. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api awsClustersDns getAwsCustomDns [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAwsCustomDns - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-awsClustersDns-getAwsCustomDns-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-awsClustersDns-getGroupAwsCustomDns.txt b/docs/command/atlas-api-awsClustersDns-getGroupAwsCustomDns.txt new file mode 100644 index 0000000000..5ad268d3c0 --- /dev/null +++ b/docs/command/atlas-api-awsClustersDns-getGroupAwsCustomDns.txt @@ -0,0 +1,98 @@ +.. _atlas-api-awsClustersDns-getGroupAwsCustomDns: + +============================================= +atlas api awsClustersDns getGroupAwsCustomDns +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the custom DNS configuration for AWS clusters in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupawscustomdns. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api awsClustersDns getGroupAwsCustomDns [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupAwsCustomDns + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-awsClustersDns-getGroupAwsCustomDns-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-awsClustersDns-toggleAwsCustomDns.txt b/docs/command/atlas-api-awsClustersDns-toggleAwsCustomDns.txt deleted file mode 100644 index b873f60300..0000000000 --- a/docs/command/atlas-api-awsClustersDns-toggleAwsCustomDns.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-awsClustersDns-toggleAwsCustomDns: - -=========================================== -atlas api awsClustersDns toggleAwsCustomDns -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Enables or disables the custom DNS configuration for AWS clusters in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Enable custom DNS if you use AWS VPC peering and use your own DNS servers. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-toggleawscustomdns. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api awsClustersDns toggleAwsCustomDns [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for toggleAwsCustomDns - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-awsClustersDns-toggleGroupAwsCustomDns.txt b/docs/command/atlas-api-awsClustersDns-toggleGroupAwsCustomDns.txt new file mode 100644 index 0000000000..f9e47ee79a --- /dev/null +++ b/docs/command/atlas-api-awsClustersDns-toggleGroupAwsCustomDns.txt @@ -0,0 +1,97 @@ +.. _atlas-api-awsClustersDns-toggleGroupAwsCustomDns: + +================================================ +atlas api awsClustersDns toggleGroupAwsCustomDns +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Enables or disables the custom DNS configuration for AWS clusters in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Enable custom DNS if you use AWS VPC peering and use your own DNS servers. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglegroupawscustomdns. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api awsClustersDns toggleGroupAwsCustomDns [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for toggleGroupAwsCustomDns + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-awsClustersDns.txt b/docs/command/atlas-api-awsClustersDns.txt index 025ed45180..aa533bf5a6 100644 --- a/docs/command/atlas-api-awsClustersDns.txt +++ b/docs/command/atlas-api-awsClustersDns.txt @@ -54,13 +54,13 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-awsClustersDns-getAwsCustomDns` - `Public Preview: please provide feedback `_: Returns the custom DNS configuration for AWS clusters in the specified project. -* :ref:`atlas-api-awsClustersDns-toggleAwsCustomDns` - `Public Preview: please provide feedback `_: Enables or disables the custom DNS configuration for AWS clusters in the specified project. +* :ref:`atlas-api-awsClustersDns-getGroupAwsCustomDns` - `Public Preview: please provide feedback `_: Returns the custom DNS configuration for AWS clusters in the specified project. +* :ref:`atlas-api-awsClustersDns-toggleGroupAwsCustomDns` - `Public Preview: please provide feedback `_: Enables or disables the custom DNS configuration for AWS clusters in the specified project. .. toctree:: :titlesonly: - getAwsCustomDns - toggleAwsCustomDns + getGroupAwsCustomDns + toggleGroupAwsCustomDns diff --git a/docs/command/atlas-api-cloudBackups-cancelBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-cancelBackupRestoreJob.txt deleted file mode 100644 index fd68659f5c..0000000000 --- a/docs/command/atlas-api-cloudBackups-cancelBackupRestoreJob.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-cloudBackups-cancelBackupRestoreJob: - -============================================= -atlas api cloudBackups cancelBackupRestoreJob -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Cancels one cloud backup restore job of one cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cancelbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups cancelBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for cancelBackupRestoreJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --restoreJobId - - string - - true - - Unique 24-hexadecimal digit string that identifies the restore job to remove. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-cancelBackupRestoreJob-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob.txt new file mode 100644 index 0000000000..bd854984a4 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob.txt @@ -0,0 +1,106 @@ +.. _atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob: + +========================================================= +atlas api cloudBackups cancelGroupClusterBackupRestoreJob +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Cancels one cloud backup restore job of one cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cancelgroupclusterbackuprestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups cancelGroupClusterBackupRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for cancelGroupClusterBackupRestoreJob + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --restoreJobId + - string + - true + - Unique 24-hexadecimal digit string that identifies the restore job to remove. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-createBackupExportJob.txt b/docs/command/atlas-api-cloudBackups-createBackupExportJob.txt deleted file mode 100644 index 4e5ee99f7f..0000000000 --- a/docs/command/atlas-api-cloudBackups-createBackupExportJob.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-cloudBackups-createBackupExportJob: - -============================================ -atlas api cloudBackups createBackupExportJob -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Exports one backup Snapshot for dedicated Atlas cluster using Cloud Backups to an Export Bucket. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createbackupexportjob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups createBackupExportJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createBackupExportJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudBackups-createBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-createBackupRestoreJob.txt deleted file mode 100644 index 1dac6b3903..0000000000 --- a/docs/command/atlas-api-cloudBackups-createBackupRestoreJob.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-cloudBackups-createBackupRestoreJob: - -============================================= -atlas api cloudBackups createBackupRestoreJob -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Restores one snapshot of one cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -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 Service Account or API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups createBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createBackupRestoreJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudBackups-createExportBucket.txt b/docs/command/atlas-api-cloudBackups-createExportBucket.txt deleted file mode 100644 index afd330ae35..0000000000 --- a/docs/command/atlas-api-cloudBackups-createExportBucket.txt +++ /dev/null @@ -1,154 +0,0 @@ -.. _atlas-api-cloudBackups-createExportBucket: - -========================================= -atlas api cloudBackups createExportBucket -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Once created, an snapshots can be exported to the Export Bucket and its referenced AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createexportbucket. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups createExportBucket [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createExportBucket - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. tabs:: - - .. tab:: Example - :tabid: 2023-01-01_aws - - AWS - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createExportBucket-2023-01-01-aws-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createExportBucket-2023-01-01-aws.sh - :language: shell - .. tab:: Example 1 - :tabid: 2024-05-30_aws - - AWS - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createExportBucket-2024-05-30-aws-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createExportBucket-2024-05-30-aws.sh - :language: shell - .. tab:: Example 2 - :tabid: 2024-05-30_azure - - Azure - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createExportBucket-2024-05-30-azure-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createExportBucket-2024-05-30-azure.sh - :language: shell - .. tab:: Example 3 - :tabid: 2024-05-30_gcp - - GCP - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createExportBucket-2024-05-30-gcp-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createExportBucket-2024-05-30-gcp.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-createGroupBackupExportBucket.txt b/docs/command/atlas-api-cloudBackups-createGroupBackupExportBucket.txt new file mode 100644 index 0000000000..13668848d8 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-createGroupBackupExportBucket.txt @@ -0,0 +1,154 @@ +.. _atlas-api-cloudBackups-createGroupBackupExportBucket: + +==================================================== +atlas api cloudBackups createGroupBackupExportBucket +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Once created, an snapshots can be exported to the Export Bucket and its referenced AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupbackupexportbucket. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups createGroupBackupExportBucket [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupBackupExportBucket + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. tabs:: + + .. tab:: Example + :tabid: 2023-01-01_aws + + AWS + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createGroupBackupExportBucket-2023-01-01-aws-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createGroupBackupExportBucket-2023-01-01-aws.sh + :language: shell + .. tab:: Example 1 + :tabid: 2024-05-30_aws + + AWS + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-aws-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-aws.sh + :language: shell + .. tab:: Example 2 + :tabid: 2024-05-30_azure + + Azure + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-azure-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-azure.sh + :language: shell + .. tab:: Example 3 + :tabid: 2024-05-30_gcp + + GCP + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-gcp-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-gcp.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-createGroupClusterBackupExport.txt b/docs/command/atlas-api-cloudBackups-createGroupClusterBackupExport.txt new file mode 100644 index 0000000000..d51bccbf7b --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-createGroupClusterBackupExport.txt @@ -0,0 +1,105 @@ +.. _atlas-api-cloudBackups-createGroupClusterBackupExport: + +===================================================== +atlas api cloudBackups createGroupClusterBackupExport +===================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Exports one backup Snapshot for dedicated Atlas cluster using Cloud Backups to an Export Bucket. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterbackupexport. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups createGroupClusterBackupExport [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterBackupExport + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudBackups-createGroupClusterBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-createGroupClusterBackupRestoreJob.txt new file mode 100644 index 0000000000..ac0af6fa6d --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-createGroupClusterBackupRestoreJob.txt @@ -0,0 +1,104 @@ +.. _atlas-api-cloudBackups-createGroupClusterBackupRestoreJob: + +========================================================= +atlas api cloudBackups createGroupClusterBackupRestoreJob +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Restores one snapshot of one cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +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 Service Account or API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterbackuprestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups createGroupClusterBackupRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterBackupRestoreJob + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudBackups-createGroupServerlessBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-createGroupServerlessBackupRestoreJob.txt new file mode 100644 index 0000000000..853308590c --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-createGroupServerlessBackupRestoreJob.txt @@ -0,0 +1,104 @@ +.. _atlas-api-cloudBackups-createGroupServerlessBackupRestoreJob: + +============================================================ +atlas api cloudBackups createGroupServerlessBackupRestoreJob +============================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Restores one snapshot of one serverless instance from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the createFlexBackupRestoreJob endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserverlessbackuprestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups createGroupServerlessBackupRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the serverless instance whose snapshot you want to restore. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupServerlessBackupRestoreJob + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudBackups-createServerlessBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-createServerlessBackupRestoreJob.txt deleted file mode 100644 index 3748ff9b06..0000000000 --- a/docs/command/atlas-api-cloudBackups-createServerlessBackupRestoreJob.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-cloudBackups-createServerlessBackupRestoreJob: - -======================================================= -atlas api cloudBackups createServerlessBackupRestoreJob -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Restores one snapshot of one serverless instance from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the createFlexBackupRestoreJob endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserverlessbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups createServerlessBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the serverless instance whose snapshot you want to restore. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createServerlessBackupRestoreJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudBackups-deleteAllBackupSchedules.txt b/docs/command/atlas-api-cloudBackups-deleteAllBackupSchedules.txt deleted file mode 100644 index 937c7c05e2..0000000000 --- a/docs/command/atlas-api-cloudBackups-deleteAllBackupSchedules.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-cloudBackups-deleteAllBackupSchedules: - -=============================================== -atlas api cloudBackups deleteAllBackupSchedules -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes all cloud backup schedules for the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteallbackupschedules. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups deleteAllBackupSchedules [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteAllBackupSchedules - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-deleteAllBackupSchedules-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-deleteExportBucket.txt b/docs/command/atlas-api-cloudBackups-deleteExportBucket.txt deleted file mode 100644 index 3aff0065e1..0000000000 --- a/docs/command/atlas-api-cloudBackups-deleteExportBucket.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-cloudBackups-deleteExportBucket: - -========================================= -atlas api cloudBackups deleteExportBucket -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes an Export Bucket. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Auto export must be disabled on all clusters in this Project exporting to this Export Bucket before revoking access. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteexportbucket. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups deleteExportBucket [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --exportBucketId - - string - - true - - Unique 24-hexadecimal character string that identifies the Export Bucket. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteExportBucket - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-deleteExportBucket-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-deleteGroupBackupExportBucket.txt b/docs/command/atlas-api-cloudBackups-deleteGroupBackupExportBucket.txt new file mode 100644 index 0000000000..a67bc0034e --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-deleteGroupBackupExportBucket.txt @@ -0,0 +1,98 @@ +.. _atlas-api-cloudBackups-deleteGroupBackupExportBucket: + +==================================================== +atlas api cloudBackups deleteGroupBackupExportBucket +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes an Export Bucket. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Auto export must be disabled on all clusters in this Project exporting to this Export Bucket before revoking access. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupbackupexportbucket. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups deleteGroupBackupExportBucket [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --exportBucketId + - string + - true + - Unique 24-hexadecimal character string that identifies the Export Bucket. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupBackupExportBucket + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-deleteGroupBackupExportBucket-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSchedule.txt b/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSchedule.txt new file mode 100644 index 0000000000..9131020856 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSchedule.txt @@ -0,0 +1,98 @@ +.. _atlas-api-cloudBackups-deleteGroupClusterBackupSchedule: + +======================================================= +atlas api cloudBackups deleteGroupClusterBackupSchedule +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes all cloud backup schedules for the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterbackupschedule. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups deleteGroupClusterBackupSchedule [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterBackupSchedule + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-deleteGroupClusterBackupSchedule-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot.txt b/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot.txt new file mode 100644 index 0000000000..5f5fa066f6 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot.txt @@ -0,0 +1,114 @@ +.. _atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot: + +======================================================= +atlas api cloudBackups deleteGroupClusterBackupSnapshot +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the specified snapshot. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterbackupsnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups deleteGroupClusterBackupSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterBackupSnapshot + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster.txt b/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster.txt new file mode 100644 index 0000000000..07bd9b0f84 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster.txt @@ -0,0 +1,106 @@ +.. _atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster: + +===================================================================== +atlas api cloudBackups deleteGroupClusterBackupSnapshotShardedCluster +===================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one snapshot of one sharded cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterbackupsnapshotshardedcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups deleteGroupClusterBackupSnapshotShardedCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterBackupSnapshotShardedCluster + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-deleteReplicaSetBackup.txt b/docs/command/atlas-api-cloudBackups-deleteReplicaSetBackup.txt deleted file mode 100644 index 854537ab91..0000000000 --- a/docs/command/atlas-api-cloudBackups-deleteReplicaSetBackup.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-cloudBackups-deleteReplicaSetBackup: - -============================================= -atlas api cloudBackups deleteReplicaSetBackup -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the specified snapshot. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletereplicasetbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups deleteReplicaSetBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteReplicaSetBackup - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-deleteReplicaSetBackup-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-deleteShardedClusterBackup.txt b/docs/command/atlas-api-cloudBackups-deleteShardedClusterBackup.txt deleted file mode 100644 index 01f2edb5e7..0000000000 --- a/docs/command/atlas-api-cloudBackups-deleteShardedClusterBackup.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-cloudBackups-deleteShardedClusterBackup: - -================================================= -atlas api cloudBackups deleteShardedClusterBackup -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one snapshot of one sharded cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteshardedclusterbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups deleteShardedClusterBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteShardedClusterBackup - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-deleteShardedClusterBackup-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-disableDataProtectionSettings.txt b/docs/command/atlas-api-cloudBackups-disableDataProtectionSettings.txt deleted file mode 100644 index 82c05fd0dd..0000000000 --- a/docs/command/atlas-api-cloudBackups-disableDataProtectionSettings.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-cloudBackups-disableDataProtectionSettings: - -==================================================== -atlas api cloudBackups disableDataProtectionSettings -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Disables the Backup Compliance Policy settings with the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -As a prerequisite, a support ticket needs to be file first, instructions in https://www.mongodb.com/docs/atlas/backup/cloud-backup/backup-compliance-policy/. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disabledataprotectionsettings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups disableDataProtectionSettings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for disableDataProtectionSettings - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - * - -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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-disableDataProtectionSettings-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-disableGroupBackupCompliancePolicy.txt b/docs/command/atlas-api-cloudBackups-disableGroupBackupCompliancePolicy.txt new file mode 100644 index 0000000000..5c24d67326 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-disableGroupBackupCompliancePolicy.txt @@ -0,0 +1,106 @@ +.. _atlas-api-cloudBackups-disableGroupBackupCompliancePolicy: + +========================================================= +atlas api cloudBackups disableGroupBackupCompliancePolicy +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Disables the Backup Compliance Policy settings with the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +As a prerequisite, a support ticket needs to be file first, instructions in https://www.mongodb.com/docs/atlas/backup/cloud-backup/backup-compliance-policy/. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablegroupbackupcompliancepolicy. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups disableGroupBackupCompliancePolicy [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for disableGroupBackupCompliancePolicy + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + * - -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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-disableGroupBackupCompliancePolicy-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getBackupExportJob.txt b/docs/command/atlas-api-cloudBackups-getBackupExportJob.txt deleted file mode 100644 index 3d90c9c923..0000000000 --- a/docs/command/atlas-api-cloudBackups-getBackupExportJob.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-cloudBackups-getBackupExportJob: - -========================================= -atlas api cloudBackups getBackupExportJob -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackupexportjob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getBackupExportJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --exportId - - string - - true - - Unique 24-hexadecimal character string that identifies the Export Job. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getBackupExportJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getBackupExportJob-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-getBackupRestoreJob.txt deleted file mode 100644 index 861d7e6760..0000000000 --- a/docs/command/atlas-api-cloudBackups-getBackupRestoreJob.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-cloudBackups-getBackupRestoreJob: - -========================================== -atlas api cloudBackups getBackupRestoreJob -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one cloud backup restore job for one cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster with the restore jobs you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getBackupRestoreJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --restoreJobId - - string - - true - - Unique 24-hexadecimal digit string that identifies the restore job to return. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getBackupRestoreJob-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getBackupSchedule.txt b/docs/command/atlas-api-cloudBackups-getBackupSchedule.txt deleted file mode 100644 index 7795a2a261..0000000000 --- a/docs/command/atlas-api-cloudBackups-getBackupSchedule.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-cloudBackups-getBackupSchedule: - -======================================== -atlas api cloudBackups getBackupSchedule -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the cloud backup schedule for the specified cluster within the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackupschedule. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getBackupSchedule [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getBackupSchedule - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getBackupSchedule-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getDataProtectionSettings.txt b/docs/command/atlas-api-cloudBackups-getDataProtectionSettings.txt deleted file mode 100644 index 83619024ed..0000000000 --- a/docs/command/atlas-api-cloudBackups-getDataProtectionSettings.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-cloudBackups-getDataProtectionSettings: - -================================================ -atlas api cloudBackups getDataProtectionSettings -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the Backup Compliance Policy settings with the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdataprotectionsettings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getDataProtectionSettings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getDataProtectionSettings - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-10-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-10-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getDataProtectionSettings-2023-10-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getExportBucket.txt b/docs/command/atlas-api-cloudBackups-getExportBucket.txt deleted file mode 100644 index 868a275e3a..0000000000 --- a/docs/command/atlas-api-cloudBackups-getExportBucket.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-cloudBackups-getExportBucket: - -====================================== -atlas api cloudBackups getExportBucket -====================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one Export Bucket associated with the specified Project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getexportbucket. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getExportBucket [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --exportBucketId - - string - - true - - Unique 24-hexadecimal character string that identifies the Export Bucket. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getExportBucket - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getExportBucket-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupBackupCompliancePolicy.txt b/docs/command/atlas-api-cloudBackups-getGroupBackupCompliancePolicy.txt new file mode 100644 index 0000000000..f29a740766 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupBackupCompliancePolicy.txt @@ -0,0 +1,98 @@ +.. _atlas-api-cloudBackups-getGroupBackupCompliancePolicy: + +===================================================== +atlas api cloudBackups getGroupBackupCompliancePolicy +===================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the Backup Compliance Policy settings with the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupbackupcompliancepolicy. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupBackupCompliancePolicy [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupBackupCompliancePolicy + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-10-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-10-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupBackupCompliancePolicy-2023-10-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupBackupExportBucket.txt b/docs/command/atlas-api-cloudBackups-getGroupBackupExportBucket.txt new file mode 100644 index 0000000000..8943c06d39 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupBackupExportBucket.txt @@ -0,0 +1,98 @@ +.. _atlas-api-cloudBackups-getGroupBackupExportBucket: + +================================================= +atlas api cloudBackups getGroupBackupExportBucket +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one Export Bucket associated with the specified Project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupbackupexportbucket. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupBackupExportBucket [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --exportBucketId + - string + - true + - Unique 24-hexadecimal character string that identifies the Export Bucket. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupBackupExportBucket + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupBackupExportBucket-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupClusterBackupExport.txt b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupExport.txt new file mode 100644 index 0000000000..0c0fa29a85 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupExport.txt @@ -0,0 +1,102 @@ +.. _atlas-api-cloudBackups-getGroupClusterBackupExport: + +================================================== +atlas api cloudBackups getGroupClusterBackupExport +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupexport. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupClusterBackupExport [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --exportId + - string + - true + - Unique 24-hexadecimal character string that identifies the Export Job. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterBackupExport + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupClusterBackupExport-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupClusterBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupRestoreJob.txt new file mode 100644 index 0000000000..1c098082fe --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupRestoreJob.txt @@ -0,0 +1,106 @@ +.. _atlas-api-cloudBackups-getGroupClusterBackupRestoreJob: + +====================================================== +atlas api cloudBackups getGroupClusterBackupRestoreJob +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one cloud backup restore job for one cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackuprestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupClusterBackupRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster with the restore jobs you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterBackupRestoreJob + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --restoreJobId + - string + - true + - Unique 24-hexadecimal digit string that identifies the restore job to return. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupClusterBackupRestoreJob-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSchedule.txt b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSchedule.txt new file mode 100644 index 0000000000..ce9e0874a8 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSchedule.txt @@ -0,0 +1,102 @@ +.. _atlas-api-cloudBackups-getGroupClusterBackupSchedule: + +==================================================== +atlas api cloudBackups getGroupClusterBackupSchedule +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the cloud backup schedule for the specified cluster within the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupschedule. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupClusterBackupSchedule [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterBackupSchedule + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupClusterBackupSchedule-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSnapshot.txt b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSnapshot.txt new file mode 100644 index 0000000000..00b109b635 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSnapshot.txt @@ -0,0 +1,106 @@ +.. _atlas-api-cloudBackups-getGroupClusterBackupSnapshot: + +==================================================== +atlas api cloudBackups getGroupClusterBackupSnapshot +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one snapshot from the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupsnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupClusterBackupSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterBackupSnapshot + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupClusterBackupSnapshot-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster.txt b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster.txt new file mode 100644 index 0000000000..a29ca0ff97 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster.txt @@ -0,0 +1,106 @@ +.. _atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster: + +================================================================== +atlas api cloudBackups getGroupClusterBackupSnapshotShardedCluster +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one snapshot of one sharded cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupsnapshotshardedcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupClusterBackupSnapshotShardedCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterBackupSnapshotShardedCluster + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob.txt new file mode 100644 index 0000000000..cc17aa9330 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob.txt @@ -0,0 +1,109 @@ +.. _atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob: + +========================================================= +atlas api cloudBackups getGroupServerlessBackupRestoreJob +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one restore job for one serverless instance from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the getFlexBackupRestoreJob endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserverlessbackuprestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupServerlessBackupRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the serverless instance. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupServerlessBackupRestoreJob + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --restoreJobId + - string + - true + - Unique 24-hexadecimal digit string that identifies the restore job to return. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getGroupServerlessBackupSnapshot.txt b/docs/command/atlas-api-cloudBackups-getGroupServerlessBackupSnapshot.txt new file mode 100644 index 0000000000..988d0d0131 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-getGroupServerlessBackupSnapshot.txt @@ -0,0 +1,105 @@ +.. _atlas-api-cloudBackups-getGroupServerlessBackupSnapshot: + +======================================================= +atlas api cloudBackups getGroupServerlessBackupSnapshot +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one snapshot of one serverless instance from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This endpoint can also be used on Flex clusters that were created with the createServerlessInstance API or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the getFlexBackup endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserverlessbackupsnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups getGroupServerlessBackupSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the serverless instance. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupServerlessBackupSnapshot + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getGroupServerlessBackupSnapshot-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getReplicaSetBackup.txt b/docs/command/atlas-api-cloudBackups-getReplicaSetBackup.txt deleted file mode 100644 index dafbaf3368..0000000000 --- a/docs/command/atlas-api-cloudBackups-getReplicaSetBackup.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-cloudBackups-getReplicaSetBackup: - -========================================== -atlas api cloudBackups getReplicaSetBackup -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one snapshot from the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getreplicasetbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getReplicaSetBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getReplicaSetBackup - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getReplicaSetBackup-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getServerlessBackup.txt b/docs/command/atlas-api-cloudBackups-getServerlessBackup.txt deleted file mode 100644 index 72af10a289..0000000000 --- a/docs/command/atlas-api-cloudBackups-getServerlessBackup.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-cloudBackups-getServerlessBackup: - -========================================== -atlas api cloudBackups getServerlessBackup -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one snapshot of one serverless instance from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This endpoint can also be used on Flex clusters that were created with the createServerlessInstance API or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the getFlexBackup endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getServerlessBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the serverless instance. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getServerlessBackup - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getServerlessBackup-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getServerlessBackupRestoreJob.txt b/docs/command/atlas-api-cloudBackups-getServerlessBackupRestoreJob.txt deleted file mode 100644 index cc3a8eb1bc..0000000000 --- a/docs/command/atlas-api-cloudBackups-getServerlessBackupRestoreJob.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-cloudBackups-getServerlessBackupRestoreJob: - -==================================================== -atlas api cloudBackups getServerlessBackupRestoreJob -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one restore job for one serverless instance from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the getFlexBackupRestoreJob endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getServerlessBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the serverless instance. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getServerlessBackupRestoreJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --restoreJobId - - string - - true - - Unique 24-hexadecimal digit string that identifies the restore job to return. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getServerlessBackupRestoreJob-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-getShardedClusterBackup.txt b/docs/command/atlas-api-cloudBackups-getShardedClusterBackup.txt deleted file mode 100644 index 71f5ee1eea..0000000000 --- a/docs/command/atlas-api-cloudBackups-getShardedClusterBackup.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-cloudBackups-getShardedClusterBackup: - -============================================== -atlas api cloudBackups getShardedClusterBackup -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one snapshot of one sharded cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getshardedclusterbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups getShardedClusterBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getShardedClusterBackup - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-getShardedClusterBackup-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listBackupExportJobs.txt b/docs/command/atlas-api-cloudBackups-listBackupExportJobs.txt deleted file mode 100644 index 52201dd823..0000000000 --- a/docs/command/atlas-api-cloudBackups-listBackupExportJobs.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-cloudBackups-listBackupExportJobs: - -=========================================== -atlas api cloudBackups listBackupExportJobs -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listbackupexportjobs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups listBackupExportJobs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listBackupExportJobs - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listBackupExportJobs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listBackupRestoreJobs.txt b/docs/command/atlas-api-cloudBackups-listBackupRestoreJobs.txt deleted file mode 100644 index a5b2798ba0..0000000000 --- a/docs/command/atlas-api-cloudBackups-listBackupRestoreJobs.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-cloudBackups-listBackupRestoreJobs: - -============================================ -atlas api cloudBackups listBackupRestoreJobs -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all cloud backup restore jobs for one cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listbackuprestorejobs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups listBackupRestoreJobs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster with the restore jobs you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listBackupRestoreJobs - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listBackupRestoreJobs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listExportBuckets.txt b/docs/command/atlas-api-cloudBackups-listExportBuckets.txt deleted file mode 100644 index 121b6b9af0..0000000000 --- a/docs/command/atlas-api-cloudBackups-listExportBuckets.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-cloudBackups-listExportBuckets: - -======================================== -atlas api cloudBackups listExportBuckets -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Export Buckets associated with the specified Project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listexportbuckets. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups listExportBuckets [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listExportBuckets - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listExportBuckets-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listGroupBackupExportBuckets.txt b/docs/command/atlas-api-cloudBackups-listGroupBackupExportBuckets.txt new file mode 100644 index 0000000000..608003f254 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-listGroupBackupExportBuckets.txt @@ -0,0 +1,110 @@ +.. _atlas-api-cloudBackups-listGroupBackupExportBuckets: + +=================================================== +atlas api cloudBackups listGroupBackupExportBuckets +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Export Buckets associated with the specified Project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupbackupexportbuckets. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups listGroupBackupExportBuckets [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupBackupExportBuckets + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listGroupBackupExportBuckets-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listGroupClusterBackupExports.txt b/docs/command/atlas-api-cloudBackups-listGroupClusterBackupExports.txt new file mode 100644 index 0000000000..bbcb190543 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-listGroupClusterBackupExports.txt @@ -0,0 +1,114 @@ +.. _atlas-api-cloudBackups-listGroupClusterBackupExports: + +==================================================== +atlas api cloudBackups listGroupClusterBackupExports +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackupexports. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups listGroupClusterBackupExports [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterBackupExports + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listGroupClusterBackupExports-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs.txt b/docs/command/atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs.txt new file mode 100644 index 0000000000..a0d45d6bf1 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs.txt @@ -0,0 +1,114 @@ +.. _atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs: + +======================================================== +atlas api cloudBackups listGroupClusterBackupRestoreJobs +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all cloud backup restore jobs for one cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackuprestorejobs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups listGroupClusterBackupRestoreJobs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster with the restore jobs you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterBackupRestoreJobs + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters.txt b/docs/command/atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters.txt new file mode 100644 index 0000000000..958205c2c7 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters.txt @@ -0,0 +1,102 @@ +.. _atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters: + +==================================================================== +atlas api cloudBackups listGroupClusterBackupSnapshotShardedClusters +==================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all snapshots of one sharded cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackupsnapshotshardedclusters. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups listGroupClusterBackupSnapshotShardedClusters [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterBackupSnapshotShardedClusters + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listGroupClusterBackupSnapshots.txt b/docs/command/atlas-api-cloudBackups-listGroupClusterBackupSnapshots.txt new file mode 100644 index 0000000000..5101eb1bf5 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-listGroupClusterBackupSnapshots.txt @@ -0,0 +1,114 @@ +.. _atlas-api-cloudBackups-listGroupClusterBackupSnapshots: + +====================================================== +atlas api cloudBackups listGroupClusterBackupSnapshots +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all snapshots of one cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackupsnapshots. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups listGroupClusterBackupSnapshots [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterBackupSnapshots + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listGroupClusterBackupSnapshots-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs.txt b/docs/command/atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs.txt new file mode 100644 index 0000000000..73d97601fe --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs.txt @@ -0,0 +1,117 @@ +.. _atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs: + +=========================================================== +atlas api cloudBackups listGroupServerlessBackupRestoreJobs +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all restore jobs for one serverless instance from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the listFlexBackupRestoreJobs endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserverlessbackuprestorejobs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups listGroupServerlessBackupRestoreJobs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the serverless instance. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupServerlessBackupRestoreJobs + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listGroupServerlessBackupSnapshots.txt b/docs/command/atlas-api-cloudBackups-listGroupServerlessBackupSnapshots.txt new file mode 100644 index 0000000000..e9d2c67be1 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-listGroupServerlessBackupSnapshots.txt @@ -0,0 +1,117 @@ +.. _atlas-api-cloudBackups-listGroupServerlessBackupSnapshots: + +========================================================= +atlas api cloudBackups listGroupServerlessBackupSnapshots +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all snapshots of one serverless instance from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the listFlexBackups endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserverlessbackupsnapshots. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups listGroupServerlessBackupSnapshots [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the serverless instance. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupServerlessBackupSnapshots + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listGroupServerlessBackupSnapshots-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listReplicaSetBackups.txt b/docs/command/atlas-api-cloudBackups-listReplicaSetBackups.txt deleted file mode 100644 index 7a12e2f0e6..0000000000 --- a/docs/command/atlas-api-cloudBackups-listReplicaSetBackups.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-cloudBackups-listReplicaSetBackups: - -============================================ -atlas api cloudBackups listReplicaSetBackups -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all snapshots of one cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listreplicasetbackups. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups listReplicaSetBackups [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listReplicaSetBackups - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listReplicaSetBackups-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listServerlessBackupRestoreJobs.txt b/docs/command/atlas-api-cloudBackups-listServerlessBackupRestoreJobs.txt deleted file mode 100644 index c024b09ca8..0000000000 --- a/docs/command/atlas-api-cloudBackups-listServerlessBackupRestoreJobs.txt +++ /dev/null @@ -1,117 +0,0 @@ -.. _atlas-api-cloudBackups-listServerlessBackupRestoreJobs: - -====================================================== -atlas api cloudBackups listServerlessBackupRestoreJobs -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all restore jobs for one serverless instance from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the listFlexBackupRestoreJobs endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserverlessbackuprestorejobs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups listServerlessBackupRestoreJobs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the serverless instance. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listServerlessBackupRestoreJobs - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listServerlessBackupRestoreJobs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listServerlessBackups.txt b/docs/command/atlas-api-cloudBackups-listServerlessBackups.txt deleted file mode 100644 index 9d53431410..0000000000 --- a/docs/command/atlas-api-cloudBackups-listServerlessBackups.txt +++ /dev/null @@ -1,117 +0,0 @@ -.. _atlas-api-cloudBackups-listServerlessBackups: - -============================================ -atlas api cloudBackups listServerlessBackups -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all snapshots of one serverless instance from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the listFlexBackups endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserverlessbackups. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups listServerlessBackups [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the serverless instance. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listServerlessBackups - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listServerlessBackups-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-listShardedClusterBackups.txt b/docs/command/atlas-api-cloudBackups-listShardedClusterBackups.txt deleted file mode 100644 index 3678723bd4..0000000000 --- a/docs/command/atlas-api-cloudBackups-listShardedClusterBackups.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-cloudBackups-listShardedClusterBackups: - -================================================ -atlas api cloudBackups listShardedClusterBackups -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all snapshots of one sharded cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listshardedclusterbackups. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups listShardedClusterBackups [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listShardedClusterBackups - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudBackups-listShardedClusterBackups-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudBackups-takeGroupClusterBackupSnapshots.txt b/docs/command/atlas-api-cloudBackups-takeGroupClusterBackupSnapshots.txt new file mode 100644 index 0000000000..82f29e1943 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-takeGroupClusterBackupSnapshots.txt @@ -0,0 +1,112 @@ +.. _atlas-api-cloudBackups-takeGroupClusterBackupSnapshots: + +====================================================== +atlas api cloudBackups takeGroupClusterBackupSnapshots +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Takes one on-demand snapshot for the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +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 Service Account or API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-takegroupclusterbackupsnapshots. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups takeGroupClusterBackupSnapshots [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for takeGroupClusterBackupSnapshots + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudBackups-takeSnapshot.txt b/docs/command/atlas-api-cloudBackups-takeSnapshot.txt deleted file mode 100644 index 3eebc51358..0000000000 --- a/docs/command/atlas-api-cloudBackups-takeSnapshot.txt +++ /dev/null @@ -1,112 +0,0 @@ -.. _atlas-api-cloudBackups-takeSnapshot: - -=================================== -atlas api cloudBackups takeSnapshot -=================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Takes one on-demand snapshot for the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -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 Service Account or API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-takesnapshot. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups takeSnapshot [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for takeSnapshot - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudBackups-updateBackupSchedule.txt b/docs/command/atlas-api-cloudBackups-updateBackupSchedule.txt deleted file mode 100644 index 2d49672b13..0000000000 --- a/docs/command/atlas-api-cloudBackups-updateBackupSchedule.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-cloudBackups-updateBackupSchedule: - -=========================================== -atlas api cloudBackups updateBackupSchedule -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the cloud backup schedule for one cluster within the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatebackupschedule. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups updateBackupSchedule [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateBackupSchedule - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudBackups-updateDataProtectionSettings.txt b/docs/command/atlas-api-cloudBackups-updateDataProtectionSettings.txt deleted file mode 100644 index 48046b4020..0000000000 --- a/docs/command/atlas-api-cloudBackups-updateDataProtectionSettings.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-cloudBackups-updateDataProtectionSettings: - -=================================================== -atlas api cloudBackups updateDataProtectionSettings -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the Backup Compliance Policy settings for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatedataprotectionsettings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups updateDataProtectionSettings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateDataProtectionSettings - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --overwriteBackupPolicies - - - - false - - Flag that indicates whether to overwrite non complying backup policies with the new data protection settings or not. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-10-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-10-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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudBackups-updateGroupBackupCompliancePolicy.txt b/docs/command/atlas-api-cloudBackups-updateGroupBackupCompliancePolicy.txt new file mode 100644 index 0000000000..f428ea0334 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-updateGroupBackupCompliancePolicy.txt @@ -0,0 +1,109 @@ +.. _atlas-api-cloudBackups-updateGroupBackupCompliancePolicy: + +======================================================== +atlas api cloudBackups updateGroupBackupCompliancePolicy +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the Backup Compliance Policy settings for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupbackupcompliancepolicy. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups updateGroupBackupCompliancePolicy [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupBackupCompliancePolicy + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --overwriteBackupPolicies + - + - false + - Flag that indicates whether to overwrite non complying backup policies with the new data protection settings or not. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-10-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-10-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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudBackups-updateGroupClusterBackupSchedule.txt b/docs/command/atlas-api-cloudBackups-updateGroupClusterBackupSchedule.txt new file mode 100644 index 0000000000..c8c1d385c1 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-updateGroupClusterBackupSchedule.txt @@ -0,0 +1,101 @@ +.. _atlas-api-cloudBackups-updateGroupClusterBackupSchedule: + +======================================================= +atlas api cloudBackups updateGroupClusterBackupSchedule +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the cloud backup schedule for one cluster within the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusterbackupschedule. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups updateGroupClusterBackupSchedule [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterBackupSchedule + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudBackups-updateGroupClusterBackupSnapshot.txt b/docs/command/atlas-api-cloudBackups-updateGroupClusterBackupSnapshot.txt new file mode 100644 index 0000000000..6b8b625e74 --- /dev/null +++ b/docs/command/atlas-api-cloudBackups-updateGroupClusterBackupSnapshot.txt @@ -0,0 +1,113 @@ +.. _atlas-api-cloudBackups-updateGroupClusterBackupSnapshot: + +======================================================= +atlas api cloudBackups updateGroupClusterBackupSnapshot +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Changes the expiration date for one cloud backup snapshot for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The requesting API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusterbackupsnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudBackups updateGroupClusterBackupSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterBackupSnapshot + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudBackups-updateSnapshotRetention.txt b/docs/command/atlas-api-cloudBackups-updateSnapshotRetention.txt deleted file mode 100644 index 2966a0b12c..0000000000 --- a/docs/command/atlas-api-cloudBackups-updateSnapshotRetention.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-cloudBackups-updateSnapshotRetention: - -============================================== -atlas api cloudBackups updateSnapshotRetention -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Changes the expiration date for one cloud backup snapshot for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The requesting API Key must have the Project Backup Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatesnapshotretention. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudBackups updateSnapshotRetention [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateSnapshotRetention - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudBackups.txt b/docs/command/atlas-api-cloudBackups.txt index 8676164f20..c09fd2292b 100644 --- a/docs/command/atlas-api-cloudBackups.txt +++ b/docs/command/atlas-api-cloudBackups.txt @@ -54,69 +54,69 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-cloudBackups-cancelBackupRestoreJob` - `Public Preview: please provide feedback `_: Cancels one cloud backup restore job of one cluster from the specified project. -* :ref:`atlas-api-cloudBackups-createBackupExportJob` - `Public Preview: please provide feedback `_: Exports one backup Snapshot for dedicated Atlas cluster using Cloud Backups to an Export Bucket. -* :ref:`atlas-api-cloudBackups-createBackupRestoreJob` - `Public Preview: please provide feedback `_: Restores one snapshot of one cluster from the specified project. -* :ref:`atlas-api-cloudBackups-createExportBucket` - `Public Preview: please provide feedback `_: Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. -* :ref:`atlas-api-cloudBackups-createServerlessBackupRestoreJob` - `Public Preview: please provide feedback `_: Restores one snapshot of one serverless instance from the specified project. -* :ref:`atlas-api-cloudBackups-deleteAllBackupSchedules` - `Public Preview: please provide feedback `_: Removes all cloud backup schedules for the specified cluster. -* :ref:`atlas-api-cloudBackups-deleteExportBucket` - `Public Preview: please provide feedback `_: Deletes an Export Bucket. -* :ref:`atlas-api-cloudBackups-deleteReplicaSetBackup` - `Public Preview: please provide feedback `_: Removes the specified snapshot. -* :ref:`atlas-api-cloudBackups-deleteShardedClusterBackup` - `Public Preview: please provide feedback `_: Removes one snapshot of one sharded cluster from the specified project. -* :ref:`atlas-api-cloudBackups-disableDataProtectionSettings` - `Public Preview: please provide feedback `_: Disables the Backup Compliance Policy settings with the specified project. -* :ref:`atlas-api-cloudBackups-getBackupExportJob` - `Public Preview: please provide feedback `_: Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. -* :ref:`atlas-api-cloudBackups-getBackupRestoreJob` - `Public Preview: please provide feedback `_: Returns one cloud backup restore job for one cluster from the specified project. -* :ref:`atlas-api-cloudBackups-getBackupSchedule` - `Public Preview: please provide feedback `_: Returns the cloud backup schedule for the specified cluster within the specified project. -* :ref:`atlas-api-cloudBackups-getDataProtectionSettings` - `Public Preview: please provide feedback `_: Returns the Backup Compliance Policy settings with the specified project. -* :ref:`atlas-api-cloudBackups-getExportBucket` - `Public Preview: please provide feedback `_: Returns one Export Bucket associated with the specified Project. -* :ref:`atlas-api-cloudBackups-getReplicaSetBackup` - `Public Preview: please provide feedback `_: Returns one snapshot from the specified cluster. -* :ref:`atlas-api-cloudBackups-getServerlessBackup` - `Public Preview: please provide feedback `_: Returns one snapshot of one serverless instance from the specified project. -* :ref:`atlas-api-cloudBackups-getServerlessBackupRestoreJob` - `Public Preview: please provide feedback `_: Returns one restore job for one serverless instance from the specified project. -* :ref:`atlas-api-cloudBackups-getShardedClusterBackup` - `Public Preview: please provide feedback `_: Returns one snapshot of one sharded cluster from the specified project. -* :ref:`atlas-api-cloudBackups-listBackupExportJobs` - `Public Preview: please provide feedback `_: Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. -* :ref:`atlas-api-cloudBackups-listBackupRestoreJobs` - `Public Preview: please provide feedback `_: Returns all cloud backup restore jobs for one cluster from the specified project. -* :ref:`atlas-api-cloudBackups-listExportBuckets` - `Public Preview: please provide feedback `_: Returns all Export Buckets associated with the specified Project. -* :ref:`atlas-api-cloudBackups-listReplicaSetBackups` - `Public Preview: please provide feedback `_: Returns all snapshots of one cluster from the specified project. -* :ref:`atlas-api-cloudBackups-listServerlessBackupRestoreJobs` - `Public Preview: please provide feedback `_: Returns all restore jobs for one serverless instance from the specified project. -* :ref:`atlas-api-cloudBackups-listServerlessBackups` - `Public Preview: please provide feedback `_: Returns all snapshots of one serverless instance from the specified project. -* :ref:`atlas-api-cloudBackups-listShardedClusterBackups` - `Public Preview: please provide feedback `_: Returns all snapshots of one sharded cluster from the specified project. -* :ref:`atlas-api-cloudBackups-takeSnapshot` - `Public Preview: please provide feedback `_: Takes one on-demand snapshot for the specified cluster. -* :ref:`atlas-api-cloudBackups-updateBackupSchedule` - `Public Preview: please provide feedback `_: Updates the cloud backup schedule for one cluster within the specified project. -* :ref:`atlas-api-cloudBackups-updateDataProtectionSettings` - `Public Preview: please provide feedback `_: Updates the Backup Compliance Policy settings for the specified project. -* :ref:`atlas-api-cloudBackups-updateSnapshotRetention` - `Public Preview: please provide feedback `_: Changes the expiration date for one cloud backup snapshot for one cluster in the specified project. +* :ref:`atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob` - `Public Preview: please provide feedback `_: Cancels one cloud backup restore job of one cluster from the specified project. +* :ref:`atlas-api-cloudBackups-createGroupBackupExportBucket` - `Public Preview: please provide feedback `_: Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. +* :ref:`atlas-api-cloudBackups-createGroupClusterBackupExport` - `Public Preview: please provide feedback `_: Exports one backup Snapshot for dedicated Atlas cluster using Cloud Backups to an Export Bucket. +* :ref:`atlas-api-cloudBackups-createGroupClusterBackupRestoreJob` - `Public Preview: please provide feedback `_: Restores one snapshot of one cluster from the specified project. +* :ref:`atlas-api-cloudBackups-createGroupServerlessBackupRestoreJob` - `Public Preview: please provide feedback `_: Restores one snapshot of one serverless instance from the specified project. +* :ref:`atlas-api-cloudBackups-deleteGroupBackupExportBucket` - `Public Preview: please provide feedback `_: Deletes an Export Bucket. +* :ref:`atlas-api-cloudBackups-deleteGroupClusterBackupSchedule` - `Public Preview: please provide feedback `_: Removes all cloud backup schedules for the specified cluster. +* :ref:`atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot` - `Public Preview: please provide feedback `_: Removes the specified snapshot. +* :ref:`atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster` - `Public Preview: please provide feedback `_: Removes one snapshot of one sharded cluster from the specified project. +* :ref:`atlas-api-cloudBackups-disableGroupBackupCompliancePolicy` - `Public Preview: please provide feedback `_: Disables the Backup Compliance Policy settings with the specified project. +* :ref:`atlas-api-cloudBackups-getGroupBackupCompliancePolicy` - `Public Preview: please provide feedback `_: Returns the Backup Compliance Policy settings with the specified project. +* :ref:`atlas-api-cloudBackups-getGroupBackupExportBucket` - `Public Preview: please provide feedback `_: Returns one Export Bucket associated with the specified Project. +* :ref:`atlas-api-cloudBackups-getGroupClusterBackupExport` - `Public Preview: please provide feedback `_: Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. +* :ref:`atlas-api-cloudBackups-getGroupClusterBackupRestoreJob` - `Public Preview: please provide feedback `_: Returns one cloud backup restore job for one cluster from the specified project. +* :ref:`atlas-api-cloudBackups-getGroupClusterBackupSchedule` - `Public Preview: please provide feedback `_: Returns the cloud backup schedule for the specified cluster within the specified project. +* :ref:`atlas-api-cloudBackups-getGroupClusterBackupSnapshot` - `Public Preview: please provide feedback `_: Returns one snapshot from the specified cluster. +* :ref:`atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster` - `Public Preview: please provide feedback `_: Returns one snapshot of one sharded cluster from the specified project. +* :ref:`atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob` - `Public Preview: please provide feedback `_: Returns one restore job for one serverless instance from the specified project. +* :ref:`atlas-api-cloudBackups-getGroupServerlessBackupSnapshot` - `Public Preview: please provide feedback `_: Returns one snapshot of one serverless instance from the specified project. +* :ref:`atlas-api-cloudBackups-listGroupBackupExportBuckets` - `Public Preview: please provide feedback `_: Returns all Export Buckets associated with the specified Project. +* :ref:`atlas-api-cloudBackups-listGroupClusterBackupExports` - `Public Preview: please provide feedback `_: Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. +* :ref:`atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs` - `Public Preview: please provide feedback `_: Returns all cloud backup restore jobs for one cluster from the specified project. +* :ref:`atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters` - `Public Preview: please provide feedback `_: Returns all snapshots of one sharded cluster from the specified project. +* :ref:`atlas-api-cloudBackups-listGroupClusterBackupSnapshots` - `Public Preview: please provide feedback `_: Returns all snapshots of one cluster from the specified project. +* :ref:`atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs` - `Public Preview: please provide feedback `_: Returns all restore jobs for one serverless instance from the specified project. +* :ref:`atlas-api-cloudBackups-listGroupServerlessBackupSnapshots` - `Public Preview: please provide feedback `_: Returns all snapshots of one serverless instance from the specified project. +* :ref:`atlas-api-cloudBackups-takeGroupClusterBackupSnapshots` - `Public Preview: please provide feedback `_: Takes one on-demand snapshot for the specified cluster. +* :ref:`atlas-api-cloudBackups-updateGroupBackupCompliancePolicy` - `Public Preview: please provide feedback `_: Updates the Backup Compliance Policy settings for the specified project. +* :ref:`atlas-api-cloudBackups-updateGroupClusterBackupSchedule` - `Public Preview: please provide feedback `_: Updates the cloud backup schedule for one cluster within the specified project. +* :ref:`atlas-api-cloudBackups-updateGroupClusterBackupSnapshot` - `Public Preview: please provide feedback `_: Changes the expiration date for one cloud backup snapshot for one cluster in the specified project. .. toctree:: :titlesonly: - cancelBackupRestoreJob - createBackupExportJob - createBackupRestoreJob - createExportBucket - createServerlessBackupRestoreJob - deleteAllBackupSchedules - deleteExportBucket - deleteReplicaSetBackup - deleteShardedClusterBackup - disableDataProtectionSettings - getBackupExportJob - getBackupRestoreJob - getBackupSchedule - getDataProtectionSettings - getExportBucket - getReplicaSetBackup - getServerlessBackup - getServerlessBackupRestoreJob - getShardedClusterBackup - listBackupExportJobs - listBackupRestoreJobs - listExportBuckets - listReplicaSetBackups - listServerlessBackupRestoreJobs - listServerlessBackups - listShardedClusterBackups - takeSnapshot - updateBackupSchedule - updateDataProtectionSettings - updateSnapshotRetention + cancelGroupClusterBackupRestoreJob + createGroupBackupExportBucket + createGroupClusterBackupExport + createGroupClusterBackupRestoreJob + createGroupServerlessBackupRestoreJob + deleteGroupBackupExportBucket + deleteGroupClusterBackupSchedule + deleteGroupClusterBackupSnapshot + deleteGroupClusterBackupSnapshotShardedCluster + disableGroupBackupCompliancePolicy + getGroupBackupCompliancePolicy + getGroupBackupExportBucket + getGroupClusterBackupExport + getGroupClusterBackupRestoreJob + getGroupClusterBackupSchedule + getGroupClusterBackupSnapshot + getGroupClusterBackupSnapshotShardedCluster + getGroupServerlessBackupRestoreJob + getGroupServerlessBackupSnapshot + listGroupBackupExportBuckets + listGroupClusterBackupExports + listGroupClusterBackupRestoreJobs + listGroupClusterBackupSnapshotShardedClusters + listGroupClusterBackupSnapshots + listGroupServerlessBackupRestoreJobs + listGroupServerlessBackupSnapshots + takeGroupClusterBackupSnapshots + updateGroupBackupCompliancePolicy + updateGroupClusterBackupSchedule + updateGroupClusterBackupSnapshot diff --git a/docs/command/atlas-api-cloudMigrationService-createGroupLiveMigration.txt b/docs/command/atlas-api-cloudMigrationService-createGroupLiveMigration.txt new file mode 100644 index 0000000000..bb6e9472e9 --- /dev/null +++ b/docs/command/atlas-api-cloudMigrationService-createGroupLiveMigration.txt @@ -0,0 +1,103 @@ +.. _atlas-api-cloudMigrationService-createGroupLiveMigration: + +======================================================== +atlas api cloudMigrationService createGroupLiveMigration +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Migrate one cluster that Cloud or Ops Manager manages to MongoDB Atlas. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Please make sure to validate your migration before initiating it. + + +You can use this API endpoint for push live migrations only. Your API Key must have the Organization Owner role to successfully call this resource. + + +NOTE: Migrating time-series collections is not yet supported on MongoDB 6.0 or higher. Migrations on MongoDB 6.0 or higher will skip any time-series collections on the source cluster. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategrouplivemigration. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudMigrationService createGroupLiveMigration [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupLiveMigration + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudMigrationService-createLinkToken.txt b/docs/command/atlas-api-cloudMigrationService-createLinkToken.txt deleted file mode 100644 index c1c362ad3d..0000000000 --- a/docs/command/atlas-api-cloudMigrationService-createLinkToken.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-cloudMigrationService-createLinkToken: - -=============================================== -atlas api cloudMigrationService createLinkToken -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Create one link-token that contains all the information required to complete the link. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Atlas uses the link-token for push live migrations only. Live migration (push) allows you to securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createlinktoken. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudMigrationService createLinkToken [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createLinkToken - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudMigrationService-createOrgLiveMigrationLinkToken.txt b/docs/command/atlas-api-cloudMigrationService-createOrgLiveMigrationLinkToken.txt new file mode 100644 index 0000000000..81ff2369b9 --- /dev/null +++ b/docs/command/atlas-api-cloudMigrationService-createOrgLiveMigrationLinkToken.txt @@ -0,0 +1,95 @@ +.. _atlas-api-cloudMigrationService-createOrgLiveMigrationLinkToken: + +=============================================================== +atlas api cloudMigrationService createOrgLiveMigrationLinkToken +=============================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Create one link-token that contains all the information required to complete the link. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Atlas uses the link-token for push live migrations only. Live migration (push) allows you to securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorglivemigrationlinktoken. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudMigrationService createOrgLiveMigrationLinkToken [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgLiveMigrationLinkToken + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudMigrationService-createPushMigration.txt b/docs/command/atlas-api-cloudMigrationService-createPushMigration.txt deleted file mode 100644 index 35d0382e0a..0000000000 --- a/docs/command/atlas-api-cloudMigrationService-createPushMigration.txt +++ /dev/null @@ -1,103 +0,0 @@ -.. _atlas-api-cloudMigrationService-createPushMigration: - -=================================================== -atlas api cloudMigrationService createPushMigration -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Migrate one cluster that Cloud or Ops Manager manages to MongoDB Atlas. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Please make sure to validate your migration before initiating it. - - -You can use this API endpoint for push live migrations only. Your API Key must have the Organization Owner role to successfully call this resource. - - -NOTE: Migrating time-series collections is not yet supported on MongoDB 6.0 or higher. Migrations on MongoDB 6.0 or higher will skip any time-series collections on the source cluster. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpushmigration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudMigrationService createPushMigration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createPushMigration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudMigrationService-cutoverGroupLiveMigration.txt b/docs/command/atlas-api-cloudMigrationService-cutoverGroupLiveMigration.txt new file mode 100644 index 0000000000..a5a2a7d8b0 --- /dev/null +++ b/docs/command/atlas-api-cloudMigrationService-cutoverGroupLiveMigration.txt @@ -0,0 +1,102 @@ +.. _atlas-api-cloudMigrationService-cutoverGroupLiveMigration: + +========================================================= +atlas api cloudMigrationService cutoverGroupLiveMigration +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Cut over the migrated cluster to MongoDB Atlas. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Confirm when the cut over completes. When the cut over completes, MongoDB Atlas completes the live migration process and stops synchronizing with the source cluster. Your API Key must have the Organization Owner role to successfully call this resource. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cutovergrouplivemigration. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudMigrationService cutoverGroupLiveMigration [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for cutoverGroupLiveMigration + * - --liveMigrationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the migration. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-cutoverGroupLiveMigration-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-cutoverMigration.txt b/docs/command/atlas-api-cloudMigrationService-cutoverMigration.txt deleted file mode 100644 index fc47a63982..0000000000 --- a/docs/command/atlas-api-cloudMigrationService-cutoverMigration.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-cloudMigrationService-cutoverMigration: - -================================================ -atlas api cloudMigrationService cutoverMigration -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Cut over the migrated cluster to MongoDB Atlas. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Confirm when the cut over completes. When the cut over completes, MongoDB Atlas completes the live migration process and stops synchronizing with the source cluster. Your API Key must have the Organization Owner role to successfully call this resource. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cutovermigration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudMigrationService cutoverMigration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for cutoverMigration - * - --liveMigrationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the migration. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-cutoverMigration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-deleteLinkToken.txt b/docs/command/atlas-api-cloudMigrationService-deleteLinkToken.txt deleted file mode 100644 index e56f8ff7c1..0000000000 --- a/docs/command/atlas-api-cloudMigrationService-deleteLinkToken.txt +++ /dev/null @@ -1,92 +0,0 @@ -.. _atlas-api-cloudMigrationService-deleteLinkToken: - -=============================================== -atlas api cloudMigrationService deleteLinkToken -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Remove one organization link and its associated public API key. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Atlas uses the link-token for push live migrations only. Live migrations (push) let you securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletelinktoken. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudMigrationService deleteLinkToken [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteLinkToken - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-deleteLinkToken-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens.txt b/docs/command/atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens.txt new file mode 100644 index 0000000000..eb916f419f --- /dev/null +++ b/docs/command/atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens.txt @@ -0,0 +1,92 @@ +.. _atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens: + +================================================================ +atlas api cloudMigrationService deleteOrgLiveMigrationLinkTokens +================================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Remove one organization link and its associated public API key. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Atlas uses the link-token for push live migrations only. Live migrations (push) let you securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorglivemigrationlinktokens. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudMigrationService deleteOrgLiveMigrationLinkTokens [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrgLiveMigrationLinkTokens + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-getGroupLiveMigration.txt b/docs/command/atlas-api-cloudMigrationService-getGroupLiveMigration.txt new file mode 100644 index 0000000000..2f26c3a24a --- /dev/null +++ b/docs/command/atlas-api-cloudMigrationService-getGroupLiveMigration.txt @@ -0,0 +1,102 @@ +.. _atlas-api-cloudMigrationService-getGroupLiveMigration: + +===================================================== +atlas api cloudMigrationService getGroupLiveMigration +===================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Return details of one cluster migration job. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Each push live migration job uses one migration host. Your API Key must have the Organization Member role to successfully call this resource. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouplivemigration. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudMigrationService getGroupLiveMigration [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupLiveMigration + * - --liveMigrationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the migration. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-getGroupLiveMigration-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus.txt b/docs/command/atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus.txt new file mode 100644 index 0000000000..edece55864 --- /dev/null +++ b/docs/command/atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus.txt @@ -0,0 +1,98 @@ +.. _atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus: + +=================================================================== +atlas api cloudMigrationService getGroupLiveMigrationValidateStatus +=================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Return the status of one migration validation job. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Your API Key must have the Organization Owner role to successfully call this resource. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouplivemigrationvalidatestatus. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudMigrationService getGroupLiveMigrationValidateStatus [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupLiveMigrationValidateStatus + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --validationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the validation job. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-getPushMigration.txt b/docs/command/atlas-api-cloudMigrationService-getPushMigration.txt deleted file mode 100644 index 9f0731e3b4..0000000000 --- a/docs/command/atlas-api-cloudMigrationService-getPushMigration.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-cloudMigrationService-getPushMigration: - -================================================ -atlas api cloudMigrationService getPushMigration -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Return details of one cluster migration job. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Each push live migration job uses one migration host. Your API Key must have the Organization Member role to successfully call this resource. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpushmigration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudMigrationService getPushMigration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getPushMigration - * - --liveMigrationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the migration. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-getPushMigration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-getValidationStatus.txt b/docs/command/atlas-api-cloudMigrationService-getValidationStatus.txt deleted file mode 100644 index 3ec67f200c..0000000000 --- a/docs/command/atlas-api-cloudMigrationService-getValidationStatus.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-cloudMigrationService-getValidationStatus: - -=================================================== -atlas api cloudMigrationService getValidationStatus -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Return the status of one migration validation job. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Your API Key must have the Organization Owner role to successfully call this resource. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getvalidationstatus. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudMigrationService getValidationStatus [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getValidationStatus - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --validationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the validation job. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-getValidationStatus-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects.txt b/docs/command/atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects.txt new file mode 100644 index 0000000000..9ed611c84d --- /dev/null +++ b/docs/command/atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects.txt @@ -0,0 +1,94 @@ +.. _atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects: + +===================================================================== +atlas api cloudMigrationService listOrgLiveMigrationAvailableProjects +===================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Return all projects that you can migrate to the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorglivemigrationavailableprojects. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudMigrationService listOrgLiveMigrationAvailableProjects [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgLiveMigrationAvailableProjects + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-listSourceProjects.txt b/docs/command/atlas-api-cloudMigrationService-listSourceProjects.txt deleted file mode 100644 index 7451741383..0000000000 --- a/docs/command/atlas-api-cloudMigrationService-listSourceProjects.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-cloudMigrationService-listSourceProjects: - -================================================== -atlas api cloudMigrationService listSourceProjects -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Return all projects that you can migrate to the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsourceprojects. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudMigrationService listSourceProjects [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listSourceProjects - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudMigrationService-listSourceProjects-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudMigrationService-validateGroupLiveMigrations.txt b/docs/command/atlas-api-cloudMigrationService-validateGroupLiveMigrations.txt new file mode 100644 index 0000000000..565f2349e4 --- /dev/null +++ b/docs/command/atlas-api-cloudMigrationService-validateGroupLiveMigrations.txt @@ -0,0 +1,97 @@ +.. _atlas-api-cloudMigrationService-validateGroupLiveMigrations: + +=========================================================== +atlas api cloudMigrationService validateGroupLiveMigrations +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Verifies whether the provided credentials, available disk space, MongoDB versions, and so on meet the requirements of the migration request. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If the check passes, the migration can proceed. Your API Key must have the Organization Owner role to successfully call this resource. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validategrouplivemigrations. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudMigrationService validateGroupLiveMigrations [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for validateGroupLiveMigrations + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudMigrationService-validateMigration.txt b/docs/command/atlas-api-cloudMigrationService-validateMigration.txt deleted file mode 100644 index c9e78c36ed..0000000000 --- a/docs/command/atlas-api-cloudMigrationService-validateMigration.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-cloudMigrationService-validateMigration: - -================================================= -atlas api cloudMigrationService validateMigration -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Verifies whether the provided credentials, available disk space, MongoDB versions, and so on meet the requirements of the migration request. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If the check passes, the migration can proceed. Your API Key must have the Organization Owner role to successfully call this resource. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validatemigration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudMigrationService validateMigration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for validateMigration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudMigrationService.txt b/docs/command/atlas-api-cloudMigrationService.txt index 07f47eba6c..7c4ac70ffa 100644 --- a/docs/command/atlas-api-cloudMigrationService.txt +++ b/docs/command/atlas-api-cloudMigrationService.txt @@ -54,25 +54,25 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-cloudMigrationService-createLinkToken` - `Public Preview: please provide feedback `_: Create one link-token that contains all the information required to complete the link. -* :ref:`atlas-api-cloudMigrationService-createPushMigration` - `Public Preview: please provide feedback `_: Migrate one cluster that Cloud or Ops Manager manages to MongoDB Atlas. -* :ref:`atlas-api-cloudMigrationService-cutoverMigration` - `Public Preview: please provide feedback `_: Cut over the migrated cluster to MongoDB Atlas. -* :ref:`atlas-api-cloudMigrationService-deleteLinkToken` - `Public Preview: please provide feedback `_: Remove one organization link and its associated public API key. -* :ref:`atlas-api-cloudMigrationService-getPushMigration` - `Public Preview: please provide feedback `_: Return details of one cluster migration job. -* :ref:`atlas-api-cloudMigrationService-getValidationStatus` - `Public Preview: please provide feedback `_: Return the status of one migration validation job. -* :ref:`atlas-api-cloudMigrationService-listSourceProjects` - `Public Preview: please provide feedback `_: Return all projects that you can migrate to the specified organization. -* :ref:`atlas-api-cloudMigrationService-validateMigration` - `Public Preview: please provide feedback `_: Verifies whether the provided credentials, available disk space, MongoDB versions, and so on meet the requirements of the migration request. +* :ref:`atlas-api-cloudMigrationService-createGroupLiveMigration` - `Public Preview: please provide feedback `_: Migrate one cluster that Cloud or Ops Manager manages to MongoDB Atlas. +* :ref:`atlas-api-cloudMigrationService-createOrgLiveMigrationLinkToken` - `Public Preview: please provide feedback `_: Create one link-token that contains all the information required to complete the link. +* :ref:`atlas-api-cloudMigrationService-cutoverGroupLiveMigration` - `Public Preview: please provide feedback `_: Cut over the migrated cluster to MongoDB Atlas. +* :ref:`atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens` - `Public Preview: please provide feedback `_: Remove one organization link and its associated public API key. +* :ref:`atlas-api-cloudMigrationService-getGroupLiveMigration` - `Public Preview: please provide feedback `_: Return details of one cluster migration job. +* :ref:`atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus` - `Public Preview: please provide feedback `_: Return the status of one migration validation job. +* :ref:`atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects` - `Public Preview: please provide feedback `_: Return all projects that you can migrate to the specified organization. +* :ref:`atlas-api-cloudMigrationService-validateGroupLiveMigrations` - `Public Preview: please provide feedback `_: Verifies whether the provided credentials, available disk space, MongoDB versions, and so on meet the requirements of the migration request. .. toctree:: :titlesonly: - createLinkToken - createPushMigration - cutoverMigration - deleteLinkToken - getPushMigration - getValidationStatus - listSourceProjects - validateMigration + createGroupLiveMigration + createOrgLiveMigrationLinkToken + cutoverGroupLiveMigration + deleteOrgLiveMigrationLinkTokens + getGroupLiveMigration + getGroupLiveMigrationValidateStatus + listOrgLiveMigrationAvailableProjects + validateGroupLiveMigrations diff --git a/docs/command/atlas-api-cloudProviderAccess-authorizeCloudProviderAccessRole.txt b/docs/command/atlas-api-cloudProviderAccess-authorizeCloudProviderAccessRole.txt deleted file mode 100644 index eb3b85417f..0000000000 --- a/docs/command/atlas-api-cloudProviderAccess-authorizeCloudProviderAccessRole.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-cloudProviderAccess-authorizeCloudProviderAccessRole: - -============================================================== -atlas api cloudProviderAccess authorizeCloudProviderAccessRole -============================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Grants access to the specified project for the specified access role. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API endpoint is one step in a procedure to create unified access for MongoDB Cloud services. This is not required for GCP service account access. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-authorizecloudprovideraccessrole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudProviderAccess authorizeCloudProviderAccessRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for authorizeCloudProviderAccessRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --roleId - - string - - true - - Unique 24-hexadecimal digit string that identifies the role. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudProviderAccess-authorizeGroupCloudProviderAccessRole.txt b/docs/command/atlas-api-cloudProviderAccess-authorizeGroupCloudProviderAccessRole.txt new file mode 100644 index 0000000000..bc2efc0c64 --- /dev/null +++ b/docs/command/atlas-api-cloudProviderAccess-authorizeGroupCloudProviderAccessRole.txt @@ -0,0 +1,101 @@ +.. _atlas-api-cloudProviderAccess-authorizeGroupCloudProviderAccessRole: + +=================================================================== +atlas api cloudProviderAccess authorizeGroupCloudProviderAccessRole +=================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Grants access to the specified project for the specified access role. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API endpoint is one step in a procedure to create unified access for MongoDB Cloud services. This is not required for GCP service account access. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-authorizegroupcloudprovideraccessrole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudProviderAccess authorizeGroupCloudProviderAccessRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for authorizeGroupCloudProviderAccessRole + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --roleId + - string + - true + - Unique 24-hexadecimal digit string that identifies the role. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudProviderAccess-createCloudProviderAccessRole.txt b/docs/command/atlas-api-cloudProviderAccess-createCloudProviderAccessRole.txt deleted file mode 100644 index ddf1e93947..0000000000 --- a/docs/command/atlas-api-cloudProviderAccess-createCloudProviderAccessRole.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-cloudProviderAccess-createCloudProviderAccessRole: - -=========================================================== -atlas api cloudProviderAccess createCloudProviderAccessRole -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one access role for the specified cloud provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Some MongoDB Cloud features use these cloud provider access roles for authentication. To use this resource, the requesting Service Account or API Key must have the Project Owner role. For the GCP provider, if the project folder is not yet provisioned, Atlas will now create the role asynchronously. An intermediate role with status IN_PROGRESS will be returned, and the final service account will be provisioned. Once the GCP project is set up, subsequent requests will create the service account synchronously. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcloudprovideraccessrole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudProviderAccess createCloudProviderAccessRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createCloudProviderAccessRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-cloudProviderAccess-createGroupCloudProviderAccess.txt b/docs/command/atlas-api-cloudProviderAccess-createGroupCloudProviderAccess.txt new file mode 100644 index 0000000000..5ec0db5e7d --- /dev/null +++ b/docs/command/atlas-api-cloudProviderAccess-createGroupCloudProviderAccess.txt @@ -0,0 +1,97 @@ +.. _atlas-api-cloudProviderAccess-createGroupCloudProviderAccess: + +============================================================ +atlas api cloudProviderAccess createGroupCloudProviderAccess +============================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one access role for the specified cloud provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Some MongoDB Cloud features use these cloud provider access roles for authentication. To use this resource, the requesting Service Account or API Key must have the Project Owner role. For the GCP provider, if the project folder is not yet provisioned, Atlas will now create the role asynchronously. An intermediate role with status IN_PROGRESS will be returned, and the final service account will be provisioned. Once the GCP project is set up, subsequent requests will create the service account synchronously. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupcloudprovideraccess. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudProviderAccess createGroupCloudProviderAccess [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupCloudProviderAccess + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole.txt b/docs/command/atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole.txt deleted file mode 100644 index 2bf570e133..0000000000 --- a/docs/command/atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole: - -================================================================ -atlas api cloudProviderAccess deauthorizeCloudProviderAccessRole -================================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Revokes access to the specified project for the specified access role. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deauthorizecloudprovideraccessrole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudProviderAccess deauthorizeCloudProviderAccessRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Human-readable label that identifies the cloud provider of the role to deauthorize. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deauthorizeCloudProviderAccessRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --roleId - - string - - true - - Unique 24-hexadecimal digit string that identifies the role. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole.txt b/docs/command/atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole.txt new file mode 100644 index 0000000000..e705b21fa0 --- /dev/null +++ b/docs/command/atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole.txt @@ -0,0 +1,106 @@ +.. _atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole: + +===================================================================== +atlas api cloudProviderAccess deauthorizeGroupCloudProviderAccessRole +===================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Revokes access to the specified project for the specified access role. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deauthorizegroupcloudprovideraccessrole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudProviderAccess deauthorizeGroupCloudProviderAccessRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Human-readable label that identifies the cloud provider of the role to deauthorize. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deauthorizeGroupCloudProviderAccessRole + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --roleId + - string + - true + - Unique 24-hexadecimal digit string that identifies the role. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudProviderAccess-getCloudProviderAccessRole.txt b/docs/command/atlas-api-cloudProviderAccess-getCloudProviderAccessRole.txt deleted file mode 100644 index cfef189067..0000000000 --- a/docs/command/atlas-api-cloudProviderAccess-getCloudProviderAccessRole.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-cloudProviderAccess-getCloudProviderAccessRole: - -======================================================== -atlas api cloudProviderAccess getCloudProviderAccessRole -======================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the access role with the specified id and with access to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcloudprovideraccessrole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudProviderAccess getCloudProviderAccessRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getCloudProviderAccessRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --roleId - - string - - true - - Unique 24-hexadecimal digit string that identifies the role. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudProviderAccess-getCloudProviderAccessRole-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudProviderAccess-getGroupCloudProviderAccess.txt b/docs/command/atlas-api-cloudProviderAccess-getGroupCloudProviderAccess.txt new file mode 100644 index 0000000000..747adf51e2 --- /dev/null +++ b/docs/command/atlas-api-cloudProviderAccess-getGroupCloudProviderAccess.txt @@ -0,0 +1,102 @@ +.. _atlas-api-cloudProviderAccess-getGroupCloudProviderAccess: + +========================================================= +atlas api cloudProviderAccess getGroupCloudProviderAccess +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the access role with the specified id and with access to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupcloudprovideraccess. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudProviderAccess getGroupCloudProviderAccess [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupCloudProviderAccess + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --roleId + - string + - true + - Unique 24-hexadecimal digit string that identifies the role. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudProviderAccess-getGroupCloudProviderAccess-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudProviderAccess-listCloudProviderAccessRoles.txt b/docs/command/atlas-api-cloudProviderAccess-listCloudProviderAccessRoles.txt deleted file mode 100644 index 2f377a18db..0000000000 --- a/docs/command/atlas-api-cloudProviderAccess-listCloudProviderAccessRoles.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-cloudProviderAccess-listCloudProviderAccessRoles: - -========================================================== -atlas api cloudProviderAccess listCloudProviderAccessRoles -========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all cloud provider access roles with access to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcloudprovideraccessroles. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api cloudProviderAccess listCloudProviderAccessRoles [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listCloudProviderAccessRoles - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-cloudProviderAccess-listCloudProviderAccessRoles-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-cloudProviderAccess-listGroupCloudProviderAccess.txt b/docs/command/atlas-api-cloudProviderAccess-listGroupCloudProviderAccess.txt new file mode 100644 index 0000000000..5fb2c6fbee --- /dev/null +++ b/docs/command/atlas-api-cloudProviderAccess-listGroupCloudProviderAccess.txt @@ -0,0 +1,98 @@ +.. _atlas-api-cloudProviderAccess-listGroupCloudProviderAccess: + +========================================================== +atlas api cloudProviderAccess listGroupCloudProviderAccess +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all cloud provider access roles with access to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcloudprovideraccess. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api cloudProviderAccess listGroupCloudProviderAccess [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupCloudProviderAccess + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-cloudProviderAccess-listGroupCloudProviderAccess-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-cloudProviderAccess.txt b/docs/command/atlas-api-cloudProviderAccess.txt index 3076e1ccfb..ae6c97c1d3 100644 --- a/docs/command/atlas-api-cloudProviderAccess.txt +++ b/docs/command/atlas-api-cloudProviderAccess.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-cloudProviderAccess-authorizeCloudProviderAccessRole` - `Public Preview: please provide feedback `_: Grants access to the specified project for the specified access role. -* :ref:`atlas-api-cloudProviderAccess-createCloudProviderAccessRole` - `Public Preview: please provide feedback `_: Creates one access role for the specified cloud provider. -* :ref:`atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole` - `Public Preview: please provide feedback `_: Revokes access to the specified project for the specified access role. -* :ref:`atlas-api-cloudProviderAccess-getCloudProviderAccessRole` - `Public Preview: please provide feedback `_: Returns the access role with the specified id and with access to the specified project. -* :ref:`atlas-api-cloudProviderAccess-listCloudProviderAccessRoles` - `Public Preview: please provide feedback `_: Returns all cloud provider access roles with access to the specified project. +* :ref:`atlas-api-cloudProviderAccess-authorizeGroupCloudProviderAccessRole` - `Public Preview: please provide feedback `_: Grants access to the specified project for the specified access role. +* :ref:`atlas-api-cloudProviderAccess-createGroupCloudProviderAccess` - `Public Preview: please provide feedback `_: Creates one access role for the specified cloud provider. +* :ref:`atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole` - `Public Preview: please provide feedback `_: Revokes access to the specified project for the specified access role. +* :ref:`atlas-api-cloudProviderAccess-getGroupCloudProviderAccess` - `Public Preview: please provide feedback `_: Returns the access role with the specified id and with access to the specified project. +* :ref:`atlas-api-cloudProviderAccess-listGroupCloudProviderAccess` - `Public Preview: please provide feedback `_: Returns all cloud provider access roles with access to the specified project. .. toctree:: :titlesonly: - authorizeCloudProviderAccessRole - createCloudProviderAccessRole - deauthorizeCloudProviderAccessRole - getCloudProviderAccessRole - listCloudProviderAccessRoles + authorizeGroupCloudProviderAccessRole + createGroupCloudProviderAccess + deauthorizeGroupCloudProviderAccessRole + getGroupCloudProviderAccess + listGroupCloudProviderAccess diff --git a/docs/command/atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation.txt b/docs/command/atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation.txt new file mode 100644 index 0000000000..cda1d42a27 --- /dev/null +++ b/docs/command/atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation.txt @@ -0,0 +1,108 @@ +.. _atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation: + +================================================================= +atlas api clusterOutageSimulation endGroupClusterOutageSimulation +================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Ends a cluster outage simulation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-endgroupclusteroutagesimulation. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusterOutageSimulation endGroupClusterOutageSimulation [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that is undergoing outage simulation. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for endGroupClusterOutageSimulation + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusterOutageSimulation-endOutageSimulation.txt b/docs/command/atlas-api-clusterOutageSimulation-endOutageSimulation.txt deleted file mode 100644 index dff06016d5..0000000000 --- a/docs/command/atlas-api-clusterOutageSimulation-endOutageSimulation.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-clusterOutageSimulation-endOutageSimulation: - -===================================================== -atlas api clusterOutageSimulation endOutageSimulation -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Ends a cluster outage simulation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-endoutagesimulation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusterOutageSimulation endOutageSimulation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that is undergoing outage simulation. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for endOutageSimulation - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusterOutageSimulation-endOutageSimulation-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation.txt b/docs/command/atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation.txt new file mode 100644 index 0000000000..722f046145 --- /dev/null +++ b/docs/command/atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation.txt @@ -0,0 +1,100 @@ +.. _atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation: + +================================================================= +atlas api clusterOutageSimulation getGroupClusterOutageSimulation +================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one outage simulation for one cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusteroutagesimulation. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusterOutageSimulation getGroupClusterOutageSimulation [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that is undergoing outage simulation. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterOutageSimulation + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusterOutageSimulation-getOutageSimulation.txt b/docs/command/atlas-api-clusterOutageSimulation-getOutageSimulation.txt deleted file mode 100644 index f91a74a59f..0000000000 --- a/docs/command/atlas-api-clusterOutageSimulation-getOutageSimulation.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-clusterOutageSimulation-getOutageSimulation: - -===================================================== -atlas api clusterOutageSimulation getOutageSimulation -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one outage simulation for one cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getoutagesimulation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusterOutageSimulation getOutageSimulation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that is undergoing outage simulation. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getOutageSimulation - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusterOutageSimulation-getOutageSimulation-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusterOutageSimulation-startGroupClusterOutageSimulation.txt b/docs/command/atlas-api-clusterOutageSimulation-startGroupClusterOutageSimulation.txt new file mode 100644 index 0000000000..705a33459b --- /dev/null +++ b/docs/command/atlas-api-clusterOutageSimulation-startGroupClusterOutageSimulation.txt @@ -0,0 +1,107 @@ +.. _atlas-api-clusterOutageSimulation-startGroupClusterOutageSimulation: + +=================================================================== +atlas api clusterOutageSimulation startGroupClusterOutageSimulation +=================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Starts a cluster outage simulation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startgroupclusteroutagesimulation. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusterOutageSimulation startGroupClusterOutageSimulation [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster to undergo an outage simulation. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for startGroupClusterOutageSimulation + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-clusterOutageSimulation-startOutageSimulation.txt b/docs/command/atlas-api-clusterOutageSimulation-startOutageSimulation.txt deleted file mode 100644 index 608c8efd7e..0000000000 --- a/docs/command/atlas-api-clusterOutageSimulation-startOutageSimulation.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-clusterOutageSimulation-startOutageSimulation: - -======================================================= -atlas api clusterOutageSimulation startOutageSimulation -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Starts a cluster outage simulation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startoutagesimulation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusterOutageSimulation startOutageSimulation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster to undergo an outage simulation. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for startOutageSimulation - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-clusterOutageSimulation.txt b/docs/command/atlas-api-clusterOutageSimulation.txt index 5cd64160be..7a34c7c2ab 100644 --- a/docs/command/atlas-api-clusterOutageSimulation.txt +++ b/docs/command/atlas-api-clusterOutageSimulation.txt @@ -54,15 +54,15 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-clusterOutageSimulation-endOutageSimulation` - `Public Preview: please provide feedback `_: Ends a cluster outage simulation. -* :ref:`atlas-api-clusterOutageSimulation-getOutageSimulation` - `Public Preview: please provide feedback `_: Returns one outage simulation for one cluster. -* :ref:`atlas-api-clusterOutageSimulation-startOutageSimulation` - `Public Preview: please provide feedback `_: Starts a cluster outage simulation. +* :ref:`atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation` - `Public Preview: please provide feedback `_: Ends a cluster outage simulation. +* :ref:`atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation` - `Public Preview: please provide feedback `_: Returns one outage simulation for one cluster. +* :ref:`atlas-api-clusterOutageSimulation-startGroupClusterOutageSimulation` - `Public Preview: please provide feedback `_: Starts a cluster outage simulation. .. toctree:: :titlesonly: - endOutageSimulation - getOutageSimulation - startOutageSimulation + endGroupClusterOutageSimulation + getGroupClusterOutageSimulation + startGroupClusterOutageSimulation diff --git a/docs/command/atlas-api-clusters-autoGroupClusterScalingConfiguration.txt b/docs/command/atlas-api-clusters-autoGroupClusterScalingConfiguration.txt new file mode 100644 index 0000000000..c5467d7ece --- /dev/null +++ b/docs/command/atlas-api-clusters-autoGroupClusterScalingConfiguration.txt @@ -0,0 +1,102 @@ +.. _atlas-api-clusters-autoGroupClusterScalingConfiguration: + +======================================================= +atlas api clusters autoGroupClusterScalingConfiguration +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the internal configuration of AutoScaling for sharded clusters. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This endpoint can be used for diagnostic purposes to ensure that sharded clusters updated from older APIs have gained support for AutoScaling each shard independently. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-autogroupclusterscalingconfiguration. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters autoGroupClusterScalingConfiguration [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for autoGroupClusterScalingConfiguration + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-autoGroupClusterScalingConfiguration-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-autoScalingConfiguration.txt b/docs/command/atlas-api-clusters-autoScalingConfiguration.txt deleted file mode 100644 index d236494c46..0000000000 --- a/docs/command/atlas-api-clusters-autoScalingConfiguration.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-clusters-autoScalingConfiguration: - -=========================================== -atlas api clusters autoScalingConfiguration -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the internal configuration of AutoScaling for sharded clusters. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This endpoint can be used for diagnostic purposes to ensure that sharded clusters updated from older APIs have gained support for AutoScaling each shard independently. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-autoscalingconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters autoScalingConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for autoScalingConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-autoScalingConfiguration-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-createCluster.txt b/docs/command/atlas-api-clusters-createCluster.txt deleted file mode 100644 index 3f158b43eb..0000000000 --- a/docs/command/atlas-api-clusters-createCluster.txt +++ /dev/null @@ -1,152 +0,0 @@ -.. _atlas-api-clusters-createCluster: - -================================ -atlas api clusters createCluster -================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. - - -Please note that using an instanceSize of M2 or M5 will create a Flex cluster instead. Support for the instanceSize of M2 or M5 will be discontinued in January 2026. We recommend using the createFlexCluster API for such configurations moving forward. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters createCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05", "2024-10-23"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-10-23". - * - -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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. tabs:: - - .. tab:: Example - :tabid: 2024-08-05_cluster - - Cluster - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-clusters-createCluster-2024-08-05-cluster-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-clusters-createCluster-2024-08-05-cluster.sh - :language: shell - .. tab:: Example 1 - :tabid: 2024-10-23_cluster - - Cluster - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-clusters-createCluster-2024-10-23-cluster-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-clusters-createCluster-2024-10-23-cluster.sh - :language: shell - .. tab:: Create a basic MongoDB Atlas cluster - :tabid: 2024-10-23_create_cluster - - Creates a new M10 replica set cluster in AWS US East region running MongoDB 6.0 - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-clusters-createCluster-2024-10-23-create_cluster-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-clusters-createCluster-2024-10-23-create_cluster.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-createGroupCluster.txt b/docs/command/atlas-api-clusters-createGroupCluster.txt new file mode 100644 index 0000000000..e6985f8e73 --- /dev/null +++ b/docs/command/atlas-api-clusters-createGroupCluster.txt @@ -0,0 +1,152 @@ +.. _atlas-api-clusters-createGroupCluster: + +===================================== +atlas api clusters createGroupCluster +===================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. + + +Please note that using an instanceSize of M2 or M5 will create a Flex cluster instead. Support for the instanceSize of M2 or M5 will be discontinued in January 2026. We recommend using the createFlexCluster API for such configurations moving forward. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters createGroupCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupCluster + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05", "2024-10-23"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-10-23". + * - -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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. tabs:: + + .. tab:: Example + :tabid: 2024-08-05_cluster + + Cluster + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-clusters-createGroupCluster-2024-08-05-cluster-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-clusters-createGroupCluster-2024-08-05-cluster.sh + :language: shell + .. tab:: Example 1 + :tabid: 2024-10-23_cluster + + Cluster + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-clusters-createGroupCluster-2024-10-23-cluster-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-clusters-createGroupCluster-2024-10-23-cluster.sh + :language: shell + .. tab:: Create a basic MongoDB Atlas cluster + :tabid: 2024-10-23_create_cluster + + Creates a new M10 replica set cluster in AWS US East region running MongoDB 6.0 + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-clusters-createGroupCluster-2024-10-23-create_cluster-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-clusters-createGroupCluster-2024-10-23-create_cluster.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-deleteCluster.txt b/docs/command/atlas-api-clusters-deleteCluster.txt deleted file mode 100644 index 6d0e4338a8..0000000000 --- a/docs/command/atlas-api-clusters-deleteCluster.txt +++ /dev/null @@ -1,117 +0,0 @@ -.. _atlas-api-clusters-deleteCluster: - -================================ -atlas api clusters deleteCluster -================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. - - -This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the deleteFlexCluster endpoint for Flex clusters instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletecluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters deleteCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --retainBackups - - - - false - - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-deleteCluster-2023-02-01-delete_cluster.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-deleteGroupCluster.txt b/docs/command/atlas-api-clusters-deleteGroupCluster.txt new file mode 100644 index 0000000000..1b7af34854 --- /dev/null +++ b/docs/command/atlas-api-clusters-deleteGroupCluster.txt @@ -0,0 +1,117 @@ +.. _atlas-api-clusters-deleteGroupCluster: + +===================================== +atlas api clusters deleteGroupCluster +===================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. + + +This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the deleteFlexCluster endpoint for Flex clusters instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters deleteGroupCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupCluster + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --retainBackups + - + - false + - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-deleteGroupCluster-2023-02-01-delete_cluster.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-getCluster.txt b/docs/command/atlas-api-clusters-getCluster.txt deleted file mode 100644 index 970b1d81d9..0000000000 --- a/docs/command/atlas-api-clusters-getCluster.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-clusters-getCluster: - -============================= -atlas api clusters getCluster -============================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. - - -This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the getFlexCluster endpoint for Flex clusters instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters getCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-getCluster-2024-08-05-get_cluster.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-getClusterAdvancedConfiguration.txt b/docs/command/atlas-api-clusters-getClusterAdvancedConfiguration.txt deleted file mode 100644 index 315a1342e3..0000000000 --- a/docs/command/atlas-api-clusters-getClusterAdvancedConfiguration.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-clusters-getClusterAdvancedConfiguration: - -================================================== -atlas api clusters getClusterAdvancedConfiguration -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the advanced configuration details for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. This feature isn't available for M0 free clusters, M2 and M5 shared-tier clusters, flex clusters, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getclusteradvancedconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters getClusterAdvancedConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getClusterAdvancedConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-getClusterAdvancedConfiguration-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-getClusterStatus.txt b/docs/command/atlas-api-clusters-getClusterStatus.txt deleted file mode 100644 index e12efec779..0000000000 --- a/docs/command/atlas-api-clusters-getClusterStatus.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-clusters-getClusterStatus: - -=================================== -atlas api clusters getClusterStatus -=================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the status of all changes that you made to the specified cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Use this resource to check the progress MongoDB Cloud has made in processing your changes. The response does not include the deployment of new dedicated clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getclusterstatus. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters getClusterStatus [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getClusterStatus - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-getClusterStatus-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-getGroupCluster.txt b/docs/command/atlas-api-clusters-getGroupCluster.txt new file mode 100644 index 0000000000..dfef404069 --- /dev/null +++ b/docs/command/atlas-api-clusters-getGroupCluster.txt @@ -0,0 +1,105 @@ +.. _atlas-api-clusters-getGroupCluster: + +================================== +atlas api clusters getGroupCluster +================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. + + +This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the getFlexCluster endpoint for Flex clusters instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters getGroupCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupCluster + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-getGroupCluster-2024-08-05-get_cluster.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-getGroupClusterProcessArgs.txt b/docs/command/atlas-api-clusters-getGroupClusterProcessArgs.txt new file mode 100644 index 0000000000..25ae342442 --- /dev/null +++ b/docs/command/atlas-api-clusters-getGroupClusterProcessArgs.txt @@ -0,0 +1,102 @@ +.. _atlas-api-clusters-getGroupClusterProcessArgs: + +============================================= +atlas api clusters getGroupClusterProcessArgs +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the advanced configuration details for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. This feature isn't available for M0 free clusters, M2 and M5 shared-tier clusters, flex clusters, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterprocessargs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters getGroupClusterProcessArgs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterProcessArgs + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-getGroupClusterProcessArgs-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-getGroupClusterStatus.txt b/docs/command/atlas-api-clusters-getGroupClusterStatus.txt new file mode 100644 index 0000000000..44d7a94a7b --- /dev/null +++ b/docs/command/atlas-api-clusters-getGroupClusterStatus.txt @@ -0,0 +1,102 @@ +.. _atlas-api-clusters-getGroupClusterStatus: + +======================================== +atlas api clusters getGroupClusterStatus +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the status of all changes that you made to the specified cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Use this resource to check the progress MongoDB Cloud has made in processing your changes. The response does not include the deployment of new dedicated clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterstatus. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters getGroupClusterStatus [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterStatus + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-getGroupClusterStatus-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-getGroupSampleDatasetLoad.txt b/docs/command/atlas-api-clusters-getGroupSampleDatasetLoad.txt new file mode 100644 index 0000000000..983c07832b --- /dev/null +++ b/docs/command/atlas-api-clusters-getGroupSampleDatasetLoad.txt @@ -0,0 +1,98 @@ +.. _atlas-api-clusters-getGroupSampleDatasetLoad: + +============================================ +atlas api clusters getGroupSampleDatasetLoad +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Checks the progress of loading the sample dataset into one cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupsampledatasetload. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters getGroupSampleDatasetLoad [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupSampleDatasetLoad + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --sampleDatasetId + - string + - true + - Unique 24-hexadecimal digit string that identifies the loaded sample dataset. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-getGroupSampleDatasetLoad-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-getSampleDatasetLoadStatus.txt b/docs/command/atlas-api-clusters-getSampleDatasetLoadStatus.txt deleted file mode 100644 index ffaa8948b4..0000000000 --- a/docs/command/atlas-api-clusters-getSampleDatasetLoadStatus.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-clusters-getSampleDatasetLoadStatus: - -============================================= -atlas api clusters getSampleDatasetLoadStatus -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Checks the progress of loading the sample dataset into one cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getsampledatasetloadstatus. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters getSampleDatasetLoadStatus [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getSampleDatasetLoadStatus - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --sampleDatasetId - - string - - true - - Unique 24-hexadecimal digit string that identifies the loaded sample dataset. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-getSampleDatasetLoadStatus-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-grantGroupClusterMongoDbEmployeeAccess.txt b/docs/command/atlas-api-clusters-grantGroupClusterMongoDbEmployeeAccess.txt new file mode 100644 index 0000000000..eb16bd97d7 --- /dev/null +++ b/docs/command/atlas-api-clusters-grantGroupClusterMongoDbEmployeeAccess.txt @@ -0,0 +1,99 @@ +.. _atlas-api-clusters-grantGroupClusterMongoDbEmployeeAccess: + +========================================================= +atlas api clusters grantGroupClusterMongoDbEmployeeAccess +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Grants MongoDB employee cluster access for the given duration and at the specified level for one cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-grantgroupclustermongodbemployeeaccess. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters grantGroupClusterMongoDbEmployeeAccess [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for grantGroupClusterMongoDbEmployeeAccess + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-clusters-grantMongoDbEmployeeAccess.txt b/docs/command/atlas-api-clusters-grantMongoDbEmployeeAccess.txt deleted file mode 100644 index 3b37fc1bb1..0000000000 --- a/docs/command/atlas-api-clusters-grantMongoDbEmployeeAccess.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-clusters-grantMongoDbEmployeeAccess: - -============================================= -atlas api clusters grantMongoDbEmployeeAccess -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Grants MongoDB employee cluster access for the given duration and at the specified level for one cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-grantmongodbemployeeaccess. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters grantMongoDbEmployeeAccess [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for grantMongoDbEmployeeAccess - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-clusters-listCloudProviderRegions.txt b/docs/command/atlas-api-clusters-listCloudProviderRegions.txt deleted file mode 100644 index 8b700284df..0000000000 --- a/docs/command/atlas-api-clusters-listCloudProviderRegions.txt +++ /dev/null @@ -1,118 +0,0 @@ -.. _atlas-api-clusters-listCloudProviderRegions: - -=========================================== -atlas api clusters listCloudProviderRegions -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the list of regions available for the specified cloud provider at the specified tier. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcloudproviderregions. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters listCloudProviderRegions [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listCloudProviderRegions - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --providers - - stringArray - - false - - Cloud providers whose regions to retrieve. When you specify multiple providers, the response can return only tiers and regions that support multi-cloud clusters. - * - --tier - - string - - false - - Cluster tier for which to retrieve the regions. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-listCloudProviderRegions-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-listClusterDetails.txt b/docs/command/atlas-api-clusters-listClusterDetails.txt new file mode 100644 index 0000000000..2b51238aad --- /dev/null +++ b/docs/command/atlas-api-clusters-listClusterDetails.txt @@ -0,0 +1,99 @@ +.. _atlas-api-clusters-listClusterDetails: + +===================================== +atlas api clusters listClusterDetails +===================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details for all clusters in all projects to which you have access. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Clusters contain a group of hosts that maintain the same data set. The response does not include multi-cloud clusters. To use this resource, the requesting Service Account or API Key can have any cluster-level role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusterdetails. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters listClusterDetails [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listClusterDetails + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-clusters-listClusters.txt b/docs/command/atlas-api-clusters-listClusters.txt deleted file mode 100644 index 08481808b3..0000000000 --- a/docs/command/atlas-api-clusters-listClusters.txt +++ /dev/null @@ -1,117 +0,0 @@ -.. _atlas-api-clusters-listClusters: - -=============================== -atlas api clusters listClusters -=============================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details for all clusters in the specific project to which you have access. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. - - -This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the listFlexClusters endpoint for Flex clusters instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters listClusters [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listClusters - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --includeDeletedWithRetainedBackups - - - - false - - Flag that indicates whether to return Clusters with retain backups. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-listClusters-2024-08-05-list_clusters.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-listClustersForAllProjects.txt b/docs/command/atlas-api-clusters-listClustersForAllProjects.txt deleted file mode 100644 index 6364418c6b..0000000000 --- a/docs/command/atlas-api-clusters-listClustersForAllProjects.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-clusters-listClustersForAllProjects: - -============================================= -atlas api clusters listClustersForAllProjects -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details for all clusters in all projects to which you have access. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Clusters contain a group of hosts that maintain the same data set. The response does not include multi-cloud clusters. To use this resource, the requesting Service Account or API Key can have any cluster-level role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclustersforallprojects. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters listClustersForAllProjects [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listClustersForAllProjects - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-clusters-listGroupClusterProviderRegions.txt b/docs/command/atlas-api-clusters-listGroupClusterProviderRegions.txt new file mode 100644 index 0000000000..995790e0da --- /dev/null +++ b/docs/command/atlas-api-clusters-listGroupClusterProviderRegions.txt @@ -0,0 +1,118 @@ +.. _atlas-api-clusters-listGroupClusterProviderRegions: + +================================================== +atlas api clusters listGroupClusterProviderRegions +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the list of regions available for the specified cloud provider at the specified tier. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterproviderregions. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters listGroupClusterProviderRegions [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterProviderRegions + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --providers + - stringArray + - false + - Cloud providers whose regions to retrieve. When you specify multiple providers, the response can return only tiers and regions that support multi-cloud clusters. + * - --tier + - string + - false + - Cluster tier for which to retrieve the regions. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-listGroupClusterProviderRegions-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-listGroupClusters.txt b/docs/command/atlas-api-clusters-listGroupClusters.txt new file mode 100644 index 0000000000..134b308dba --- /dev/null +++ b/docs/command/atlas-api-clusters-listGroupClusters.txt @@ -0,0 +1,117 @@ +.. _atlas-api-clusters-listGroupClusters: + +==================================== +atlas api clusters listGroupClusters +==================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details for all clusters in the specific project to which you have access. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. + + +This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the listFlexClusters endpoint for Flex clusters instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusters. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters listGroupClusters [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusters + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --includeDeletedWithRetainedBackups + - + - false + - Flag that indicates whether to return Clusters with retain backups. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-listGroupClusters-2024-08-05-list_clusters.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-loadSampleDataset.txt b/docs/command/atlas-api-clusters-loadSampleDataset.txt deleted file mode 100644 index 039ca709e2..0000000000 --- a/docs/command/atlas-api-clusters-loadSampleDataset.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-clusters-loadSampleDataset: - -==================================== -atlas api clusters loadSampleDataset -==================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Requests loading the MongoDB sample dataset into the specified cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-loadsampledataset. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters loadSampleDataset [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for loadSampleDataset - * - --name - - string - - true - - Human-readable label that identifies the cluster into which you load the sample dataset. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-loadSampleDataset-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-pinFeatureCompatibilityVersion.txt b/docs/command/atlas-api-clusters-pinFeatureCompatibilityVersion.txt deleted file mode 100644 index 6bc18e0042..0000000000 --- a/docs/command/atlas-api-clusters-pinFeatureCompatibilityVersion.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-clusters-pinFeatureCompatibilityVersion: - -================================================= -atlas api clusters pinFeatureCompatibilityVersion -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If an FCV pin already exists for the cluster, calling this method will only update the expiration date of the existing pin and will not repin the FCV. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinfeaturecompatibilityversion. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters pinFeatureCompatibilityVersion [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for pinFeatureCompatibilityVersion - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-clusters-pinGroupClusterFeatureCompatibilityVersion.txt b/docs/command/atlas-api-clusters-pinGroupClusterFeatureCompatibilityVersion.txt new file mode 100644 index 0000000000..54071baca8 --- /dev/null +++ b/docs/command/atlas-api-clusters-pinGroupClusterFeatureCompatibilityVersion.txt @@ -0,0 +1,101 @@ +.. _atlas-api-clusters-pinGroupClusterFeatureCompatibilityVersion: + +============================================================= +atlas api clusters pinGroupClusterFeatureCompatibilityVersion +============================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If an FCV pin already exists for the cluster, calling this method will only update the expiration date of the existing pin and will not repin the FCV. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pingroupclusterfeaturecompatibilityversion. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters pinGroupClusterFeatureCompatibilityVersion [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for pinGroupClusterFeatureCompatibilityVersion + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-clusters-requestGroupSampleDatasetLoad.txt b/docs/command/atlas-api-clusters-requestGroupSampleDatasetLoad.txt new file mode 100644 index 0000000000..e98449a15c --- /dev/null +++ b/docs/command/atlas-api-clusters-requestGroupSampleDatasetLoad.txt @@ -0,0 +1,106 @@ +.. _atlas-api-clusters-requestGroupSampleDatasetLoad: + +================================================ +atlas api clusters requestGroupSampleDatasetLoad +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Requests loading the MongoDB sample dataset into the specified cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-requestgroupsampledatasetload. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters requestGroupSampleDatasetLoad [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for requestGroupSampleDatasetLoad + * - --name + - string + - true + - Human-readable label that identifies the cluster into which you load the sample dataset. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-requestGroupSampleDatasetLoad-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-restartGroupClusterPrimaries.txt b/docs/command/atlas-api-clusters-restartGroupClusterPrimaries.txt new file mode 100644 index 0000000000..ea47af27e3 --- /dev/null +++ b/docs/command/atlas-api-clusters-restartGroupClusterPrimaries.txt @@ -0,0 +1,102 @@ +.. _atlas-api-clusters-restartGroupClusterPrimaries: + +=============================================== +atlas api clusters restartGroupClusterPrimaries +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Starts a failover test for the specified cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Clusters contain a group of hosts that maintain the same data set. A failover test checks how MongoDB Cloud handles the failure of the cluster's primary node. During the test, MongoDB Cloud shuts down the primary node and elects a new primary. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-restartgroupclusterprimaries. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters restartGroupClusterPrimaries [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for restartGroupClusterPrimaries + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-restartGroupClusterPrimaries-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess.txt b/docs/command/atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess.txt new file mode 100644 index 0000000000..20e8084829 --- /dev/null +++ b/docs/command/atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess.txt @@ -0,0 +1,100 @@ +.. _atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess: + +========================================================== +atlas api clusters revokeGroupClusterMongoDbEmployeeAccess +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Revokes a previously granted MongoDB employee cluster access. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokegroupclustermongodbemployeeaccess. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters revokeGroupClusterMongoDbEmployeeAccess [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for revokeGroupClusterMongoDbEmployeeAccess + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-revokeMongoDbEmployeeAccess.txt b/docs/command/atlas-api-clusters-revokeMongoDbEmployeeAccess.txt deleted file mode 100644 index a0b8b03da4..0000000000 --- a/docs/command/atlas-api-clusters-revokeMongoDbEmployeeAccess.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-clusters-revokeMongoDbEmployeeAccess: - -============================================== -atlas api clusters revokeMongoDbEmployeeAccess -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Revokes a previously granted MongoDB employee cluster access. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokemongodbemployeeaccess. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters revokeMongoDbEmployeeAccess [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for revokeMongoDbEmployeeAccess - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-revokeMongoDbEmployeeAccess-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-testFailover.txt b/docs/command/atlas-api-clusters-testFailover.txt deleted file mode 100644 index f406c9df38..0000000000 --- a/docs/command/atlas-api-clusters-testFailover.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-clusters-testFailover: - -=============================== -atlas api clusters testFailover -=============================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Starts a failover test for the specified cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Clusters contain a group of hosts that maintain the same data set. A failover test checks how MongoDB Cloud handles the failure of the cluster's primary node. During the test, MongoDB Cloud shuts down the primary node and elects a new primary. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-testfailover. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters testFailover [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for testFailover - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-testFailover-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-unpinFeatureCompatibilityVersion.txt b/docs/command/atlas-api-clusters-unpinFeatureCompatibilityVersion.txt deleted file mode 100644 index e4c3b0ef6c..0000000000 --- a/docs/command/atlas-api-clusters-unpinFeatureCompatibilityVersion.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-clusters-unpinFeatureCompatibilityVersion: - -=================================================== -atlas api clusters unpinFeatureCompatibilityVersion -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Unpins the current fixed Feature Compatibility Version (FCV). - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This feature is not available for clusters on rapid release. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpinfeaturecompatibilityversion. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters unpinFeatureCompatibilityVersion [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for unpinFeatureCompatibilityVersion - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-clusters-unpinFeatureCompatibilityVersion-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion.txt b/docs/command/atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion.txt new file mode 100644 index 0000000000..11dd4f06d2 --- /dev/null +++ b/docs/command/atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion.txt @@ -0,0 +1,102 @@ +.. _atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion: + +=============================================================== +atlas api clusters unpinGroupClusterFeatureCompatibilityVersion +=============================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Unpins the current fixed Feature Compatibility Version (FCV). + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This feature is not available for clusters on rapid release. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpingroupclusterfeaturecompatibilityversion. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters unpinGroupClusterFeatureCompatibilityVersion [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for unpinGroupClusterFeatureCompatibilityVersion + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-updateCluster.txt b/docs/command/atlas-api-clusters-updateCluster.txt deleted file mode 100644 index 880827fe4d..0000000000 --- a/docs/command/atlas-api-clusters-updateCluster.txt +++ /dev/null @@ -1,122 +0,0 @@ -.. _atlas-api-clusters-updateCluster: - -================================ -atlas api clusters updateCluster -================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the details for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Clusters contain a group of hosts that maintain the same data set. This resource can update clusters with asymmetrically-sized shards. To update a cluster's termination protection, the requesting Service Account or API Key must have the Project Owner role. For all other updates, the requesting Service Account or API Key must have the Project Cluster Manager role. You can't modify a paused cluster (paused : true). You must call this endpoint to set paused : false. After this endpoint responds with paused : false, you can call it again with the changes you want to make to the cluster. This feature is not available for serverless clusters. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatecluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters updateCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05", "2024-10-23"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-10-23". - * - -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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -Updates the cluster to increase disk size to 20GB and increase node count to 5 - -Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-clusters-updateCluster-2024-10-23-update_cluster-payload.json - :language: shell -After creating ``payload.json``, run the command below in the same directory. - -.. literalinclude:: /includes/examples/atlas-api-clusters-updateCluster-2024-10-23-update_cluster.sh - :language: shell diff --git a/docs/command/atlas-api-clusters-updateClusterAdvancedConfiguration.txt b/docs/command/atlas-api-clusters-updateClusterAdvancedConfiguration.txt deleted file mode 100644 index 310257d94f..0000000000 --- a/docs/command/atlas-api-clusters-updateClusterAdvancedConfiguration.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-clusters-updateClusterAdvancedConfiguration: - -===================================================== -atlas api clusters updateClusterAdvancedConfiguration -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the advanced configuration details for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. This feature isn't available for M0 free clusters, M2 and M5 shared-tier clusters, flex clusters, or serverless clusters. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateclusteradvancedconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters updateClusterAdvancedConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateClusterAdvancedConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-clusters-updateGroupCluster.txt b/docs/command/atlas-api-clusters-updateGroupCluster.txt new file mode 100644 index 0000000000..d60e485989 --- /dev/null +++ b/docs/command/atlas-api-clusters-updateGroupCluster.txt @@ -0,0 +1,122 @@ +.. _atlas-api-clusters-updateGroupCluster: + +===================================== +atlas api clusters updateGroupCluster +===================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the details for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Clusters contain a group of hosts that maintain the same data set. This resource can update clusters with asymmetrically-sized shards. To update a cluster's termination protection, the requesting Service Account or API Key must have the Project Owner role. For all other updates, the requesting Service Account or API Key must have the Project Cluster Manager role. You can't modify a paused cluster (paused : true). You must call this endpoint to set paused : false. After this endpoint responds with paused : false, you can call it again with the changes you want to make to the cluster. This feature is not available for serverless clusters. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters updateGroupCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupCluster + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05", "2024-10-23"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-10-23". + * - -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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +Updates the cluster to increase disk size to 20GB and increase node count to 5 + +Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-clusters-updateGroupCluster-2024-10-23-update_cluster-payload.json + :language: shell +After creating ``payload.json``, run the command below in the same directory. + +.. literalinclude:: /includes/examples/atlas-api-clusters-updateGroupCluster-2024-10-23-update_cluster.sh + :language: shell diff --git a/docs/command/atlas-api-clusters-updateGroupClusterProcessArgs.txt b/docs/command/atlas-api-clusters-updateGroupClusterProcessArgs.txt new file mode 100644 index 0000000000..b57a8385a0 --- /dev/null +++ b/docs/command/atlas-api-clusters-updateGroupClusterProcessArgs.txt @@ -0,0 +1,101 @@ +.. _atlas-api-clusters-updateGroupClusterProcessArgs: + +================================================ +atlas api clusters updateGroupClusterProcessArgs +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the advanced configuration details for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. This feature isn't available for M0 free clusters, M2 and M5 shared-tier clusters, flex clusters, or serverless clusters. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusterprocessargs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters updateGroupClusterProcessArgs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterProcessArgs + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-clusters-upgradeGroupClusterTenantUpgrade.txt b/docs/command/atlas-api-clusters-upgradeGroupClusterTenantUpgrade.txt new file mode 100644 index 0000000000..884991ed05 --- /dev/null +++ b/docs/command/atlas-api-clusters-upgradeGroupClusterTenantUpgrade.txt @@ -0,0 +1,100 @@ +.. _atlas-api-clusters-upgradeGroupClusterTenantUpgrade: + +=================================================== +atlas api clusters upgradeGroupClusterTenantUpgrade +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Upgrades a shared-tier cluster to a Flex or Dedicated (M10+) cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. Each project supports up to 25 clusters. + + +This endpoint can also be used to upgrade Flex clusters that were created using the createCluster API or former M2/M5 clusters that have been migrated to Flex clusters, using instanceSizeName to “M2” or “M5” until January 2026. This functionality will be available until January 2026, after which it will only be available for M0 clusters. Please use the upgradeFlexCluster endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-upgradegroupclustertenantupgrade. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api clusters upgradeGroupClusterTenantUpgrade [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for upgradeGroupClusterTenantUpgrade + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-clusters-upgradeSharedCluster.txt b/docs/command/atlas-api-clusters-upgradeSharedCluster.txt deleted file mode 100644 index 6fe8d74664..0000000000 --- a/docs/command/atlas-api-clusters-upgradeSharedCluster.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-clusters-upgradeSharedCluster: - -======================================= -atlas api clusters upgradeSharedCluster -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Upgrades a shared-tier cluster to a Flex or Dedicated (M10+) cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. Each project supports up to 25 clusters. - - -This endpoint can also be used to upgrade Flex clusters that were created using the createCluster API or former M2/M5 clusters that have been migrated to Flex clusters, using instanceSizeName to “M2” or “M5” until January 2026. This functionality will be available until January 2026, after which it will only be available for M0 clusters. Please use the upgradeFlexCluster endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-upgradesharedcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api clusters upgradeSharedCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for upgradeSharedCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-clusters.txt b/docs/command/atlas-api-clusters.txt index ed4e705dfe..93ce8266da 100644 --- a/docs/command/atlas-api-clusters.txt +++ b/docs/command/atlas-api-clusters.txt @@ -54,47 +54,47 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-clusters-autoScalingConfiguration` - `Public Preview: please provide feedback `_: Returns the internal configuration of AutoScaling for sharded clusters. -* :ref:`atlas-api-clusters-createCluster` - `Public Preview: please provide feedback `_: Creates one cluster in the specified project. -* :ref:`atlas-api-clusters-deleteCluster` - `Public Preview: please provide feedback `_: Removes one cluster from the specified project. -* :ref:`atlas-api-clusters-getCluster` - `Public Preview: please provide feedback `_: Returns the details for one cluster in the specified project. -* :ref:`atlas-api-clusters-getClusterAdvancedConfiguration` - `Public Preview: please provide feedback `_: Returns the advanced configuration details for one cluster in the specified project. -* :ref:`atlas-api-clusters-getClusterStatus` - `Public Preview: please provide feedback `_: Returns the status of all changes that you made to the specified cluster in the specified project. -* :ref:`atlas-api-clusters-getSampleDatasetLoadStatus` - `Public Preview: please provide feedback `_: Checks the progress of loading the sample dataset into one cluster. -* :ref:`atlas-api-clusters-grantMongoDbEmployeeAccess` - `Public Preview: please provide feedback `_: Grants MongoDB employee cluster access for the given duration and at the specified level for one cluster. -* :ref:`atlas-api-clusters-listCloudProviderRegions` - `Public Preview: please provide feedback `_: Returns the list of regions available for the specified cloud provider at the specified tier. -* :ref:`atlas-api-clusters-listClusters` - `Public Preview: please provide feedback `_: Returns the details for all clusters in the specific project to which you have access. -* :ref:`atlas-api-clusters-listClustersForAllProjects` - `Public Preview: please provide feedback `_: Returns the details for all clusters in all projects to which you have access. -* :ref:`atlas-api-clusters-loadSampleDataset` - `Public Preview: please provide feedback `_: Requests loading the MongoDB sample dataset into the specified cluster. -* :ref:`atlas-api-clusters-pinFeatureCompatibilityVersion` - `Public Preview: please provide feedback `_: Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. -* :ref:`atlas-api-clusters-revokeMongoDbEmployeeAccess` - `Public Preview: please provide feedback `_: Revokes a previously granted MongoDB employee cluster access. -* :ref:`atlas-api-clusters-testFailover` - `Public Preview: please provide feedback `_: Starts a failover test for the specified cluster in the specified project. -* :ref:`atlas-api-clusters-unpinFeatureCompatibilityVersion` - `Public Preview: please provide feedback `_: Unpins the current fixed Feature Compatibility Version (FCV). -* :ref:`atlas-api-clusters-updateCluster` - `Public Preview: please provide feedback `_: Updates the details for one cluster in the specified project. -* :ref:`atlas-api-clusters-updateClusterAdvancedConfiguration` - `Public Preview: please provide feedback `_: Updates the advanced configuration details for one cluster in the specified project. -* :ref:`atlas-api-clusters-upgradeSharedCluster` - `Public Preview: please provide feedback `_: Upgrades a shared-tier cluster to a Flex or Dedicated (M10+) cluster in the specified project. +* :ref:`atlas-api-clusters-autoGroupClusterScalingConfiguration` - `Public Preview: please provide feedback `_: Returns the internal configuration of AutoScaling for sharded clusters. +* :ref:`atlas-api-clusters-createGroupCluster` - `Public Preview: please provide feedback `_: Creates one cluster in the specified project. +* :ref:`atlas-api-clusters-deleteGroupCluster` - `Public Preview: please provide feedback `_: Removes one cluster from the specified project. +* :ref:`atlas-api-clusters-getGroupCluster` - `Public Preview: please provide feedback `_: Returns the details for one cluster in the specified project. +* :ref:`atlas-api-clusters-getGroupClusterProcessArgs` - `Public Preview: please provide feedback `_: Returns the advanced configuration details for one cluster in the specified project. +* :ref:`atlas-api-clusters-getGroupClusterStatus` - `Public Preview: please provide feedback `_: Returns the status of all changes that you made to the specified cluster in the specified project. +* :ref:`atlas-api-clusters-getGroupSampleDatasetLoad` - `Public Preview: please provide feedback `_: Checks the progress of loading the sample dataset into one cluster. +* :ref:`atlas-api-clusters-grantGroupClusterMongoDbEmployeeAccess` - `Public Preview: please provide feedback `_: Grants MongoDB employee cluster access for the given duration and at the specified level for one cluster. +* :ref:`atlas-api-clusters-listClusterDetails` - `Public Preview: please provide feedback `_: Returns the details for all clusters in all projects to which you have access. +* :ref:`atlas-api-clusters-listGroupClusterProviderRegions` - `Public Preview: please provide feedback `_: Returns the list of regions available for the specified cloud provider at the specified tier. +* :ref:`atlas-api-clusters-listGroupClusters` - `Public Preview: please provide feedback `_: Returns the details for all clusters in the specific project to which you have access. +* :ref:`atlas-api-clusters-pinGroupClusterFeatureCompatibilityVersion` - `Public Preview: please provide feedback `_: Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. +* :ref:`atlas-api-clusters-requestGroupSampleDatasetLoad` - `Public Preview: please provide feedback `_: Requests loading the MongoDB sample dataset into the specified cluster. +* :ref:`atlas-api-clusters-restartGroupClusterPrimaries` - `Public Preview: please provide feedback `_: Starts a failover test for the specified cluster in the specified project. +* :ref:`atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess` - `Public Preview: please provide feedback `_: Revokes a previously granted MongoDB employee cluster access. +* :ref:`atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion` - `Public Preview: please provide feedback `_: Unpins the current fixed Feature Compatibility Version (FCV). +* :ref:`atlas-api-clusters-updateGroupCluster` - `Public Preview: please provide feedback `_: Updates the details for one cluster in the specified project. +* :ref:`atlas-api-clusters-updateGroupClusterProcessArgs` - `Public Preview: please provide feedback `_: Updates the advanced configuration details for one cluster in the specified project. +* :ref:`atlas-api-clusters-upgradeGroupClusterTenantUpgrade` - `Public Preview: please provide feedback `_: Upgrades a shared-tier cluster to a Flex or Dedicated (M10+) cluster in the specified project. .. toctree:: :titlesonly: - autoScalingConfiguration - createCluster - deleteCluster - getCluster - getClusterAdvancedConfiguration - getClusterStatus - getSampleDatasetLoadStatus - grantMongoDbEmployeeAccess - listCloudProviderRegions - listClusters - listClustersForAllProjects - loadSampleDataset - pinFeatureCompatibilityVersion - revokeMongoDbEmployeeAccess - testFailover - unpinFeatureCompatibilityVersion - updateCluster - updateClusterAdvancedConfiguration - upgradeSharedCluster + autoGroupClusterScalingConfiguration + createGroupCluster + deleteGroupCluster + getGroupCluster + getGroupClusterProcessArgs + getGroupClusterStatus + getGroupSampleDatasetLoad + grantGroupClusterMongoDbEmployeeAccess + listClusterDetails + listGroupClusterProviderRegions + listGroupClusters + pinGroupClusterFeatureCompatibilityVersion + requestGroupSampleDatasetLoad + restartGroupClusterPrimaries + revokeGroupClusterMongoDbEmployeeAccess + unpinGroupClusterFeatureCompatibilityVersion + updateGroupCluster + updateGroupClusterProcessArgs + upgradeGroupClusterTenantUpgrade diff --git a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements.txt b/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements.txt deleted file mode 100644 index ea3491f1cb..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements.txt +++ /dev/null @@ -1,124 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements: - -================================================================================ -atlas api collectionLevelMetrics getCollStatsLatencyNamespaceClusterMeasurements -================================================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespaceclustermeasurements. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics getCollStatsLatencyNamespaceClusterMeasurements [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster to retrieve metrics for. - * - --clusterView - - string - - true - - Human-readable label that identifies the cluster topology to retrieve metrics for. - * - --collectionName - - string - - true - - Human-readable label that identifies the collection. - * - --databaseName - - string - - true - - Human-readable label that identifies the database. - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getCollStatsLatencyNamespaceClusterMeasurements - * - --metrics - - stringArray - - false - - List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements.txt b/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements.txt deleted file mode 100644 index 9cba091588..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements.txt +++ /dev/null @@ -1,120 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements: - -============================================================================= -atlas api collectionLevelMetrics getCollStatsLatencyNamespaceHostMeasurements -============================================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Get a list of the Coll Stats Latency process-level measurements for the given namespace. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacehostmeasurements. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics getCollStatsLatencyNamespaceHostMeasurements [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --collectionName - - string - - true - - Human-readable label that identifies the collection. - * - --databaseName - - string - - true - - Human-readable label that identifies the database. - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getCollStatsLatencyNamespaceHostMeasurements - * - --metrics - - stringArray - - false - - List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --processId - - string - - true - - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics.txt b/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics.txt deleted file mode 100644 index f6fa24af73..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics.txt +++ /dev/null @@ -1,92 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics: - -==================================================================== -atlas api collectionLevelMetrics getCollStatsLatencyNamespaceMetrics -==================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all available Coll Stats Latency metric names and their respective units for the specified project at the time of request. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacemetrics. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics getCollStatsLatencyNamespaceMetrics [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getCollStatsLatencyNamespaceMetrics - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster.txt b/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster.txt deleted file mode 100644 index 5ad7973c33..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster.txt +++ /dev/null @@ -1,112 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster: - -======================================================================== -atlas api collectionLevelMetrics getCollStatsLatencyNamespacesForCluster -======================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacesforcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics getCollStatsLatencyNamespacesForCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster to pin namespaces to. - * - --clusterView - - string - - true - - Human-readable label that identifies the cluster topology to retrieve metrics for. - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getCollStatsLatencyNamespacesForCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost.txt b/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost.txt deleted file mode 100644 index 834d236f10..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost: - -===================================================================== -atlas api collectionLevelMetrics getCollStatsLatencyNamespacesForHost -===================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacesforhost. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics getCollStatsLatencyNamespacesForHost [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getCollStatsLatencyNamespacesForHost - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --processId - - string - - true - - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces.txt b/docs/command/atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces.txt new file mode 100644 index 0000000000..ddd06220cc --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces.txt @@ -0,0 +1,112 @@ +.. _atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces: + +================================================================== +atlas api collectionLevelMetrics getGroupClusterCollStatNamespaces +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustercollstatnamespaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics getGroupClusterCollStatNamespaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster to pin namespaces to. + * - --clusterView + - string + - true + - Human-readable label that identifies the cluster topology to retrieve metrics for. + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterCollStatNamespaces + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces.txt b/docs/command/atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces.txt new file mode 100644 index 0000000000..9feb466cd0 --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces.txt @@ -0,0 +1,108 @@ +.. _atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces: + +================================================================== +atlas api collectionLevelMetrics getGroupProcessCollStatNamespaces +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocesscollstatnamespaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics getGroupProcessCollStatNamespaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupProcessCollStatNamespaces + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --processId + - string + - true + - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-getPinnedNamespaces.txt b/docs/command/atlas-api-collectionLevelMetrics-getPinnedNamespaces.txt deleted file mode 100644 index 525b00442c..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-getPinnedNamespaces.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-getPinnedNamespaces: - -==================================================== -atlas api collectionLevelMetrics getPinnedNamespaces -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpinnednamespaces. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics getPinnedNamespaces [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster to retrieve pinned namespaces for. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getPinnedNamespaces - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-getPinnedNamespaces-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements.txt b/docs/command/atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements.txt new file mode 100644 index 0000000000..81f9b33595 --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements.txt @@ -0,0 +1,124 @@ +.. _atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements: + +===================================================================== +atlas api collectionLevelMetrics listGroupClusterCollStatMeasurements +===================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustercollstatmeasurements. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics listGroupClusterCollStatMeasurements [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster to retrieve metrics for. + * - --clusterView + - string + - true + - Human-readable label that identifies the cluster topology to retrieve metrics for. + * - --collectionName + - string + - true + - Human-readable label that identifies the collection. + * - --databaseName + - string + - true + - Human-readable label that identifies the database. + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterCollStatMeasurements + * - --metrics + - stringArray + - false + - List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces.txt b/docs/command/atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces.txt new file mode 100644 index 0000000000..ff89213e56 --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces.txt @@ -0,0 +1,96 @@ +.. _atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces: + +========================================================================= +atlas api collectionLevelMetrics listGroupClusterCollStatPinnedNamespaces +========================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustercollstatpinnednamespaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics listGroupClusterCollStatPinnedNamespaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster to retrieve pinned namespaces for. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterCollStatPinnedNamespaces + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-listGroupCollStatMetrics.txt b/docs/command/atlas-api-collectionLevelMetrics-listGroupCollStatMetrics.txt new file mode 100644 index 0000000000..8fff221d6a --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-listGroupCollStatMetrics.txt @@ -0,0 +1,92 @@ +.. _atlas-api-collectionLevelMetrics-listGroupCollStatMetrics: + +========================================================= +atlas api collectionLevelMetrics listGroupCollStatMetrics +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all available Coll Stats Latency metric names and their respective units for the specified project at the time of request. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcollstatmetrics. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics listGroupCollStatMetrics [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupCollStatMetrics + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-listGroupCollStatMetrics-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements.txt b/docs/command/atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements.txt new file mode 100644 index 0000000000..73d22f6197 --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements.txt @@ -0,0 +1,120 @@ +.. _atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements: + +===================================================================== +atlas api collectionLevelMetrics listGroupProcessCollStatMeasurements +===================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Get a list of the Coll Stats Latency process-level measurements for the given namespace. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocesscollstatmeasurements. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics listGroupProcessCollStatMeasurements [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --collectionName + - string + - true + - Human-readable label that identifies the collection. + * - --databaseName + - string + - true + - Human-readable label that identifies the database. + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupProcessCollStatMeasurements + * - --metrics + - stringArray + - false + - List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --processId + - string + - true + - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-collectionLevelMetrics-pinGroupClusterCollStatPinnedNamespaces.txt b/docs/command/atlas-api-collectionLevelMetrics-pinGroupClusterCollStatPinnedNamespaces.txt new file mode 100644 index 0000000000..bd277fbd01 --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-pinGroupClusterCollStatPinnedNamespaces.txt @@ -0,0 +1,97 @@ +.. _atlas-api-collectionLevelMetrics-pinGroupClusterCollStatPinnedNamespaces: + +======================================================================== +atlas api collectionLevelMetrics pinGroupClusterCollStatPinnedNamespaces +======================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This initializes a pinned namespaces list or replaces any existing pinned namespaces list for the Group and Cluster. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pingroupclustercollstatpinnednamespaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics pinGroupClusterCollStatPinnedNamespaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster to pin namespaces to. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for pinGroupClusterCollStatPinnedNamespaces + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-collectionLevelMetrics-pinNamespacesPatch.txt b/docs/command/atlas-api-collectionLevelMetrics-pinNamespacesPatch.txt deleted file mode 100644 index b5f33bf709..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-pinNamespacesPatch.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-pinNamespacesPatch: - -=================================================== -atlas api collectionLevelMetrics pinNamespacesPatch -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinnamespacespatch. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics pinNamespacesPatch [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster to pin namespaces to. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for pinNamespacesPatch - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-collectionLevelMetrics-pinNamespacesPut.txt b/docs/command/atlas-api-collectionLevelMetrics-pinNamespacesPut.txt deleted file mode 100644 index ae8e47f2bf..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-pinNamespacesPut.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-pinNamespacesPut: - -================================================= -atlas api collectionLevelMetrics pinNamespacesPut -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This initializes a pinned namespaces list or replaces any existing pinned namespaces list for the Group and Cluster. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinnamespacesput. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics pinNamespacesPut [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster to pin namespaces to. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for pinNamespacesPut - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-collectionLevelMetrics-unpinGroupClusterCollStatUnpinNamespaces.txt b/docs/command/atlas-api-collectionLevelMetrics-unpinGroupClusterCollStatUnpinNamespaces.txt new file mode 100644 index 0000000000..4d9fce0f23 --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-unpinGroupClusterCollStatUnpinNamespaces.txt @@ -0,0 +1,95 @@ +.. _atlas-api-collectionLevelMetrics-unpinGroupClusterCollStatUnpinNamespaces: + +========================================================================= +atlas api collectionLevelMetrics unpinGroupClusterCollStatUnpinNamespaces +========================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpingroupclustercollstatunpinnamespaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics unpinGroupClusterCollStatUnpinNamespaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster to unpin namespaces from. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for unpinGroupClusterCollStatUnpinNamespaces + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-collectionLevelMetrics-unpinNamespaces.txt b/docs/command/atlas-api-collectionLevelMetrics-unpinNamespaces.txt deleted file mode 100644 index 96fdaa2f94..0000000000 --- a/docs/command/atlas-api-collectionLevelMetrics-unpinNamespaces.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-collectionLevelMetrics-unpinNamespaces: - -================================================ -atlas api collectionLevelMetrics unpinNamespaces -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpinnamespaces. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api collectionLevelMetrics unpinNamespaces [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster to unpin namespaces from. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for unpinNamespaces - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-collectionLevelMetrics-updateGroupClusterCollStatPinnedNamespaces.txt b/docs/command/atlas-api-collectionLevelMetrics-updateGroupClusterCollStatPinnedNamespaces.txt new file mode 100644 index 0000000000..411bbe37d7 --- /dev/null +++ b/docs/command/atlas-api-collectionLevelMetrics-updateGroupClusterCollStatPinnedNamespaces.txt @@ -0,0 +1,95 @@ +.. _atlas-api-collectionLevelMetrics-updateGroupClusterCollStatPinnedNamespaces: + +=========================================================================== +atlas api collectionLevelMetrics updateGroupClusterCollStatPinnedNamespaces +=========================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustercollstatpinnednamespaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api collectionLevelMetrics updateGroupClusterCollStatPinnedNamespaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster to pin namespaces to. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterCollStatPinnedNamespaces + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-collectionLevelMetrics.txt b/docs/command/atlas-api-collectionLevelMetrics.txt index e69686c020..5996deab4b 100644 --- a/docs/command/atlas-api-collectionLevelMetrics.txt +++ b/docs/command/atlas-api-collectionLevelMetrics.txt @@ -54,27 +54,27 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements` - `Public Preview: please provide feedback `_: Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. -* :ref:`atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements` - `Public Preview: please provide feedback `_: Get a list of the Coll Stats Latency process-level measurements for the given namespace. -* :ref:`atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics` - `Public Preview: please provide feedback `_: Returns all available Coll Stats Latency metric names and their respective units for the specified project at the time of request. -* :ref:`atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster` - `Public Preview: please provide feedback `_: Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. -* :ref:`atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost` - `Public Preview: please provide feedback `_: Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. -* :ref:`atlas-api-collectionLevelMetrics-getPinnedNamespaces` - `Public Preview: please provide feedback `_: Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. -* :ref:`atlas-api-collectionLevelMetrics-pinNamespacesPatch` - `Public Preview: please provide feedback `_: Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. -* :ref:`atlas-api-collectionLevelMetrics-pinNamespacesPut` - `Public Preview: please provide feedback `_: Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. -* :ref:`atlas-api-collectionLevelMetrics-unpinNamespaces` - `Public Preview: please provide feedback `_: Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. +* :ref:`atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces` - `Public Preview: please provide feedback `_: Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. +* :ref:`atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces` - `Public Preview: please provide feedback `_: Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. +* :ref:`atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements` - `Public Preview: please provide feedback `_: Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. +* :ref:`atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces` - `Public Preview: please provide feedback `_: Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. +* :ref:`atlas-api-collectionLevelMetrics-listGroupCollStatMetrics` - `Public Preview: please provide feedback `_: Returns all available Coll Stats Latency metric names and their respective units for the specified project at the time of request. +* :ref:`atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements` - `Public Preview: please provide feedback `_: Get a list of the Coll Stats Latency process-level measurements for the given namespace. +* :ref:`atlas-api-collectionLevelMetrics-pinGroupClusterCollStatPinnedNamespaces` - `Public Preview: please provide feedback `_: Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. +* :ref:`atlas-api-collectionLevelMetrics-unpinGroupClusterCollStatUnpinNamespaces` - `Public Preview: please provide feedback `_: Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. +* :ref:`atlas-api-collectionLevelMetrics-updateGroupClusterCollStatPinnedNamespaces` - `Public Preview: please provide feedback `_: Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. .. toctree:: :titlesonly: - getCollStatsLatencyNamespaceClusterMeasurements - getCollStatsLatencyNamespaceHostMeasurements - getCollStatsLatencyNamespaceMetrics - getCollStatsLatencyNamespacesForCluster - getCollStatsLatencyNamespacesForHost - getPinnedNamespaces - pinNamespacesPatch - pinNamespacesPut - unpinNamespaces + getGroupClusterCollStatNamespaces + getGroupProcessCollStatNamespaces + listGroupClusterCollStatMeasurements + listGroupClusterCollStatPinnedNamespaces + listGroupCollStatMetrics + listGroupProcessCollStatMeasurements + pinGroupClusterCollStatPinnedNamespaces + unpinGroupClusterCollStatUnpinNamespaces + updateGroupClusterCollStatPinnedNamespaces diff --git a/docs/command/atlas-api-customDatabaseRoles-createCustomDatabaseRole.txt b/docs/command/atlas-api-customDatabaseRoles-createCustomDatabaseRole.txt deleted file mode 100644 index cddd1c8724..0000000000 --- a/docs/command/atlas-api-customDatabaseRoles-createCustomDatabaseRole.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-customDatabaseRoles-createCustomDatabaseRole: - -====================================================== -atlas api customDatabaseRoles createCustomDatabaseRole -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one custom role in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcustomdatabaserole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api customDatabaseRoles createCustomDatabaseRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createCustomDatabaseRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-customDatabaseRoles-createGroupCustomDbRoleRole.txt b/docs/command/atlas-api-customDatabaseRoles-createGroupCustomDbRoleRole.txt new file mode 100644 index 0000000000..b5a87f34d2 --- /dev/null +++ b/docs/command/atlas-api-customDatabaseRoles-createGroupCustomDbRoleRole.txt @@ -0,0 +1,97 @@ +.. _atlas-api-customDatabaseRoles-createGroupCustomDbRoleRole: + +========================================================= +atlas api customDatabaseRoles createGroupCustomDbRoleRole +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one custom role in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupcustomdbrolerole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api customDatabaseRoles createGroupCustomDbRoleRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupCustomDbRoleRole + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-customDatabaseRoles-deleteCustomDatabaseRole.txt b/docs/command/atlas-api-customDatabaseRoles-deleteCustomDatabaseRole.txt deleted file mode 100644 index 0e61e06502..0000000000 --- a/docs/command/atlas-api-customDatabaseRoles-deleteCustomDatabaseRole.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-customDatabaseRoles-deleteCustomDatabaseRole: - -====================================================== -atlas api customDatabaseRoles deleteCustomDatabaseRole -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one custom role from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can't remove a custom role that would leave one or more child roles with no parent roles or actions. You also can't remove a custom role that would leave one or more database users without roles. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletecustomdatabaserole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api customDatabaseRoles deleteCustomDatabaseRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteCustomDatabaseRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --roleName - - string - - true - - Human-readable label that identifies the role for the request. This name must be unique for this custom role in this project. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-customDatabaseRoles-deleteCustomDatabaseRole-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole.txt b/docs/command/atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole.txt new file mode 100644 index 0000000000..22152c33b5 --- /dev/null +++ b/docs/command/atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole.txt @@ -0,0 +1,102 @@ +.. _atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole: + +========================================================= +atlas api customDatabaseRoles deleteGroupCustomDbRoleRole +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one custom role from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can't remove a custom role that would leave one or more child roles with no parent roles or actions. You also can't remove a custom role that would leave one or more database users without roles. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupcustomdbrolerole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api customDatabaseRoles deleteGroupCustomDbRoleRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupCustomDbRoleRole + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --roleName + - string + - true + - Human-readable label that identifies the role for the request. This name must be unique for this custom role in this project. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-customDatabaseRoles-getCustomDatabaseRole.txt b/docs/command/atlas-api-customDatabaseRoles-getCustomDatabaseRole.txt deleted file mode 100644 index 6239d4dfe4..0000000000 --- a/docs/command/atlas-api-customDatabaseRoles-getCustomDatabaseRole.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-customDatabaseRoles-getCustomDatabaseRole: - -=================================================== -atlas api customDatabaseRoles getCustomDatabaseRole -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one custom role for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcustomdatabaserole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api customDatabaseRoles getCustomDatabaseRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getCustomDatabaseRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --roleName - - string - - true - - Human-readable label that identifies the role for the request. This name must be unique for this custom role in this project. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-customDatabaseRoles-getCustomDatabaseRole-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole.txt b/docs/command/atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole.txt new file mode 100644 index 0000000000..b549813a7b --- /dev/null +++ b/docs/command/atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole.txt @@ -0,0 +1,102 @@ +.. _atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole: + +====================================================== +atlas api customDatabaseRoles getGroupCustomDbRoleRole +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one custom role for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupcustomdbrolerole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api customDatabaseRoles getGroupCustomDbRoleRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupCustomDbRoleRole + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --roleName + - string + - true + - Human-readable label that identifies the role for the request. This name must be unique for this custom role in this project. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-customDatabaseRoles-listCustomDatabaseRoles.txt b/docs/command/atlas-api-customDatabaseRoles-listCustomDatabaseRoles.txt deleted file mode 100644 index eaf6020d91..0000000000 --- a/docs/command/atlas-api-customDatabaseRoles-listCustomDatabaseRoles.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-customDatabaseRoles-listCustomDatabaseRoles: - -===================================================== -atlas api customDatabaseRoles listCustomDatabaseRoles -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all custom roles for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcustomdatabaseroles. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api customDatabaseRoles listCustomDatabaseRoles [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listCustomDatabaseRoles - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-customDatabaseRoles-listCustomDatabaseRoles-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles.txt b/docs/command/atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles.txt new file mode 100644 index 0000000000..5255b48a8d --- /dev/null +++ b/docs/command/atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles.txt @@ -0,0 +1,98 @@ +.. _atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles: + +======================================================== +atlas api customDatabaseRoles listGroupCustomDbRoleRoles +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all custom roles for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcustomdbroleroles. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api customDatabaseRoles listGroupCustomDbRoleRoles [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupCustomDbRoleRoles + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-customDatabaseRoles-updateCustomDatabaseRole.txt b/docs/command/atlas-api-customDatabaseRoles-updateCustomDatabaseRole.txt deleted file mode 100644 index fc82f6c07b..0000000000 --- a/docs/command/atlas-api-customDatabaseRoles-updateCustomDatabaseRole.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-customDatabaseRoles-updateCustomDatabaseRole: - -====================================================== -atlas api customDatabaseRoles updateCustomDatabaseRole -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one custom role in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatecustomdatabaserole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api customDatabaseRoles updateCustomDatabaseRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateCustomDatabaseRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --roleName - - string - - true - - Human-readable label that identifies the role for the request. This name must beunique for this custom role in this project. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-customDatabaseRoles-updateGroupCustomDbRoleRole.txt b/docs/command/atlas-api-customDatabaseRoles-updateGroupCustomDbRoleRole.txt new file mode 100644 index 0000000000..4690666ba0 --- /dev/null +++ b/docs/command/atlas-api-customDatabaseRoles-updateGroupCustomDbRoleRole.txt @@ -0,0 +1,101 @@ +.. _atlas-api-customDatabaseRoles-updateGroupCustomDbRoleRole: + +========================================================= +atlas api customDatabaseRoles updateGroupCustomDbRoleRole +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one custom role in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupcustomdbrolerole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api customDatabaseRoles updateGroupCustomDbRoleRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupCustomDbRoleRole + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --roleName + - string + - true + - Human-readable label that identifies the role for the request. This name must beunique for this custom role in this project. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-customDatabaseRoles.txt b/docs/command/atlas-api-customDatabaseRoles.txt index 7c4bf67455..7f2fad5f13 100644 --- a/docs/command/atlas-api-customDatabaseRoles.txt +++ b/docs/command/atlas-api-customDatabaseRoles.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-customDatabaseRoles-createCustomDatabaseRole` - `Public Preview: please provide feedback `_: Creates one custom role in the specified project. -* :ref:`atlas-api-customDatabaseRoles-deleteCustomDatabaseRole` - `Public Preview: please provide feedback `_: Removes one custom role from the specified project. -* :ref:`atlas-api-customDatabaseRoles-getCustomDatabaseRole` - `Public Preview: please provide feedback `_: Returns one custom role for the specified project. -* :ref:`atlas-api-customDatabaseRoles-listCustomDatabaseRoles` - `Public Preview: please provide feedback `_: Returns all custom roles for the specified project. -* :ref:`atlas-api-customDatabaseRoles-updateCustomDatabaseRole` - `Public Preview: please provide feedback `_: Updates one custom role in the specified project. +* :ref:`atlas-api-customDatabaseRoles-createGroupCustomDbRoleRole` - `Public Preview: please provide feedback `_: Creates one custom role in the specified project. +* :ref:`atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole` - `Public Preview: please provide feedback `_: Removes one custom role from the specified project. +* :ref:`atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole` - `Public Preview: please provide feedback `_: Returns one custom role for the specified project. +* :ref:`atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles` - `Public Preview: please provide feedback `_: Returns all custom roles for the specified project. +* :ref:`atlas-api-customDatabaseRoles-updateGroupCustomDbRoleRole` - `Public Preview: please provide feedback `_: Updates one custom role in the specified project. .. toctree:: :titlesonly: - createCustomDatabaseRole - deleteCustomDatabaseRole - getCustomDatabaseRole - listCustomDatabaseRoles - updateCustomDatabaseRole + createGroupCustomDbRoleRole + deleteGroupCustomDbRoleRole + getGroupCustomDbRoleRole + listGroupCustomDbRoleRoles + updateGroupCustomDbRoleRole diff --git a/docs/command/atlas-api-dataFederation-createDataFederationPrivateEndpoint.txt b/docs/command/atlas-api-dataFederation-createDataFederationPrivateEndpoint.txt deleted file mode 100644 index 54510afedc..0000000000 --- a/docs/command/atlas-api-dataFederation-createDataFederationPrivateEndpoint.txt +++ /dev/null @@ -1,124 +0,0 @@ -.. _atlas-api-dataFederation-createDataFederationPrivateEndpoint: - -============================================================ -atlas api dataFederation createDataFederationPrivateEndpoint -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one private endpoint for Federated Database Instances and Online Archives to the specified projects. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If the endpoint ID already exists and the associated comment is unchanged, Atlas Data Federation makes no change to the endpoint ID list. If the endpoint ID already exists and the associated comment is changed, Atlas Data Federation updates the comment value only in the endpoint ID list. If the endpoint ID doesn't exist, Atlas Data Federation appends the new endpoint to the list of endpoints in the endpoint ID list. Each region has an associated service name for the various endpoints in each region. - - -us-east-1 is com.amazonaws.vpce.us-east-1.vpce-svc-00e311695874992b4. - - -us-west-1 is com.amazonaws.vpce.us-west-2.vpce-svc-09d86b19e59d1b4bb. - - -eu-west-1 is com.amazonaws.vpce.eu-west-1.vpce-svc-0824460b72e1a420e. - - -eu-west-2 is com.amazonaws.vpce.eu-west-2.vpce-svc-052f1840aa0c4f1f9. - - -eu-central-1 is com.amazonaws.vpce.eu-central-1.vpce-svc-0ac8ce91871138c0d. - - -sa-east-1 is com.amazonaws.vpce.sa-east-1.vpce-svc-0b56e75e8cdf50044. - - -ap-southeast-2 is com.amazonaws.vpce.ap-southeast-2.vpce-svc-036f1de74d761706e. - - -ap-south-1 is com.amazonaws.vpce.ap-south-1.vpce-svc-03eb8a541f96d356d. - - -To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createdatafederationprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation createDataFederationPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createDataFederationPrivateEndpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-dataFederation-createFederatedDatabase.txt b/docs/command/atlas-api-dataFederation-createFederatedDatabase.txt deleted file mode 100644 index 4759615bff..0000000000 --- a/docs/command/atlas-api-dataFederation-createFederatedDatabase.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-dataFederation-createFederatedDatabase: - -================================================ -atlas api dataFederation createFederatedDatabase -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one federated database instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createfederateddatabase. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation createFederatedDatabase [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createFederatedDatabase - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --skipRoleValidation - - - - false - - Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-dataFederation-createGroupDataFederation.txt b/docs/command/atlas-api-dataFederation-createGroupDataFederation.txt new file mode 100644 index 0000000000..460a478900 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-createGroupDataFederation.txt @@ -0,0 +1,101 @@ +.. _atlas-api-dataFederation-createGroupDataFederation: + +================================================== +atlas api dataFederation createGroupDataFederation +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one federated database instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupdatafederation. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation createGroupDataFederation [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupDataFederation + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --skipRoleValidation + - + - false + - Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-dataFederation-createGroupPrivateNetworkSettingEndpointId.txt b/docs/command/atlas-api-dataFederation-createGroupPrivateNetworkSettingEndpointId.txt new file mode 100644 index 0000000000..bf7a0de5bb --- /dev/null +++ b/docs/command/atlas-api-dataFederation-createGroupPrivateNetworkSettingEndpointId.txt @@ -0,0 +1,124 @@ +.. _atlas-api-dataFederation-createGroupPrivateNetworkSettingEndpointId: + +=================================================================== +atlas api dataFederation createGroupPrivateNetworkSettingEndpointId +=================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one private endpoint for Federated Database Instances and Online Archives to the specified projects. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If the endpoint ID already exists and the associated comment is unchanged, Atlas Data Federation makes no change to the endpoint ID list. If the endpoint ID already exists and the associated comment is changed, Atlas Data Federation updates the comment value only in the endpoint ID list. If the endpoint ID doesn't exist, Atlas Data Federation appends the new endpoint to the list of endpoints in the endpoint ID list. Each region has an associated service name for the various endpoints in each region. + + +us-east-1 is com.amazonaws.vpce.us-east-1.vpce-svc-00e311695874992b4. + + +us-west-1 is com.amazonaws.vpce.us-west-2.vpce-svc-09d86b19e59d1b4bb. + + +eu-west-1 is com.amazonaws.vpce.eu-west-1.vpce-svc-0824460b72e1a420e. + + +eu-west-2 is com.amazonaws.vpce.eu-west-2.vpce-svc-052f1840aa0c4f1f9. + + +eu-central-1 is com.amazonaws.vpce.eu-central-1.vpce-svc-0ac8ce91871138c0d. + + +sa-east-1 is com.amazonaws.vpce.sa-east-1.vpce-svc-0b56e75e8cdf50044. + + +ap-southeast-2 is com.amazonaws.vpce.ap-southeast-2.vpce-svc-036f1de74d761706e. + + +ap-south-1 is com.amazonaws.vpce.ap-south-1.vpce-svc-03eb8a541f96d356d. + + +To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupprivatenetworksettingendpointid. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation createGroupPrivateNetworkSettingEndpointId [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupPrivateNetworkSettingEndpointId + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-dataFederation-createOneDataFederationQueryLimit.txt b/docs/command/atlas-api-dataFederation-createOneDataFederationQueryLimit.txt deleted file mode 100644 index e90a642764..0000000000 --- a/docs/command/atlas-api-dataFederation-createOneDataFederationQueryLimit.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-dataFederation-createOneDataFederationQueryLimit: - -========================================================== -atlas api dataFederation createOneDataFederationQueryLimit -========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates or updates one query limit for one federated database instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createonedatafederationquerylimit. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation createOneDataFederationQueryLimit [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createOneDataFederationQueryLimit - * - --limitName - - string - - true - - Human-readable label that identifies this data federation instance limit. - - | Limit Name | Description | Default | - | --- | --- | --- | - | bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | - | bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | - | bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | - | bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | - - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --tenantName - - string - - true - - Human-readable label that identifies the federated database instance to which the query limit applies. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-dataFederation-deleteDataFederationPrivateEndpoint.txt b/docs/command/atlas-api-dataFederation-deleteDataFederationPrivateEndpoint.txt deleted file mode 100644 index 0bd95c9773..0000000000 --- a/docs/command/atlas-api-dataFederation-deleteDataFederationPrivateEndpoint.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-dataFederation-deleteDataFederationPrivateEndpoint: - -============================================================ -atlas api dataFederation deleteDataFederationPrivateEndpoint -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one private endpoint for Federated Database Instances and Online Archives in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletedatafederationprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation deleteDataFederationPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --endpointId - - string - - true - - Unique 22-character alphanumeric string that identifies the private endpoint to remove. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteDataFederationPrivateEndpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-deleteDataFederationPrivateEndpoint-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-deleteFederatedDatabase.txt b/docs/command/atlas-api-dataFederation-deleteFederatedDatabase.txt deleted file mode 100644 index 493745465c..0000000000 --- a/docs/command/atlas-api-dataFederation-deleteFederatedDatabase.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-dataFederation-deleteFederatedDatabase: - -================================================ -atlas api dataFederation deleteFederatedDatabase -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one federated database instance from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederateddatabase. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation deleteFederatedDatabase [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteFederatedDatabase - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the federated database instance to remove. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-deleteFederatedDatabase-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-deleteGroupDataFederation.txt b/docs/command/atlas-api-dataFederation-deleteGroupDataFederation.txt new file mode 100644 index 0000000000..a2c7da14d0 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-deleteGroupDataFederation.txt @@ -0,0 +1,102 @@ +.. _atlas-api-dataFederation-deleteGroupDataFederation: + +================================================== +atlas api dataFederation deleteGroupDataFederation +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one federated database instance from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupdatafederation. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation deleteGroupDataFederation [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupDataFederation + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the federated database instance to remove. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-deleteGroupDataFederation-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-deleteGroupDataFederationLimit.txt b/docs/command/atlas-api-dataFederation-deleteGroupDataFederationLimit.txt new file mode 100644 index 0000000000..4347d45617 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-deleteGroupDataFederationLimit.txt @@ -0,0 +1,110 @@ +.. _atlas-api-dataFederation-deleteGroupDataFederationLimit: + +======================================================= +atlas api dataFederation deleteGroupDataFederationLimit +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes one query limit for one federated database instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupdatafederationlimit. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation deleteGroupDataFederationLimit [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupDataFederationLimit + * - --limitName + - string + - true + - Human-readable label that identifies this data federation instance limit. + + | Limit Name | Description | Default | + | --- | --- | --- | + | bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | + | bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | + | bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | + | bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | + + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --tenantName + - string + - true + - Human-readable label that identifies the federated database instance to which the query limit applies. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-deleteGroupDataFederationLimit-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId.txt b/docs/command/atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId.txt new file mode 100644 index 0000000000..29474e6720 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId.txt @@ -0,0 +1,102 @@ +.. _atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId: + +=================================================================== +atlas api dataFederation deleteGroupPrivateNetworkSettingEndpointId +=================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one private endpoint for Federated Database Instances and Online Archives in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupprivatenetworksettingendpointid. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation deleteGroupPrivateNetworkSettingEndpointId [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --endpointId + - string + - true + - Unique 22-character alphanumeric string that identifies the private endpoint to remove. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupPrivateNetworkSettingEndpointId + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit.txt b/docs/command/atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit.txt deleted file mode 100644 index f97cab75db..0000000000 --- a/docs/command/atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit: - -================================================================== -atlas api dataFederation deleteOneDataFederationInstanceQueryLimit -================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes one query limit for one federated database instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteonedatafederationinstancequerylimit. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation deleteOneDataFederationInstanceQueryLimit [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteOneDataFederationInstanceQueryLimit - * - --limitName - - string - - true - - Human-readable label that identifies this data federation instance limit. - - | Limit Name | Description | Default | - | --- | --- | --- | - | bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | - | bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | - | bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | - | bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | - - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --tenantName - - string - - true - - Human-readable label that identifies the federated database instance to which the query limit applies. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs.txt b/docs/command/atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs.txt deleted file mode 100644 index d45c5490e8..0000000000 --- a/docs/command/atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs: - -=========================================================== -atlas api dataFederation downloadFederatedDatabaseQueryLogs -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Downloads the query logs for the specified federated database instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Data Access Read Write roles. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadfederateddatabasequerylogs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation downloadFederatedDatabaseQueryLogs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --endDate - - int - - false - - Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for downloadFederatedDatabaseQueryLogs - * - -o, --output - - string - - false - - preferred api format, can be ["gzip"] This value defaults to "gzip". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --startDate - - int - - false - - Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. - * - --tenantName - - string - - true - - Human-readable label that identifies the federated database instance for which you want to download query logs. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-downloadGroupDataFederationQueryLogs.txt b/docs/command/atlas-api-dataFederation-downloadGroupDataFederationQueryLogs.txt new file mode 100644 index 0000000000..419ef27c67 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-downloadGroupDataFederationQueryLogs.txt @@ -0,0 +1,102 @@ +.. _atlas-api-dataFederation-downloadGroupDataFederationQueryLogs: + +============================================================= +atlas api dataFederation downloadGroupDataFederationQueryLogs +============================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Downloads the query logs for the specified federated database instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Data Access Read Write roles. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupdatafederationquerylogs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation downloadGroupDataFederationQueryLogs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --endDate + - int + - false + - Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for downloadGroupDataFederationQueryLogs + * - -o, --output + - string + - false + - preferred api format, can be ["gzip"] This value defaults to "gzip". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --startDate + - int + - false + - Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. + * - --tenantName + - string + - true + - Human-readable label that identifies the federated database instance for which you want to download query logs. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-downloadGroupDataFederationQueryLogs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-getDataFederationPrivateEndpoint.txt b/docs/command/atlas-api-dataFederation-getDataFederationPrivateEndpoint.txt deleted file mode 100644 index e6ab64cea4..0000000000 --- a/docs/command/atlas-api-dataFederation-getDataFederationPrivateEndpoint.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-dataFederation-getDataFederationPrivateEndpoint: - -========================================================= -atlas api dataFederation getDataFederationPrivateEndpoint -========================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatafederationprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation getDataFederationPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --endpointId - - string - - true - - Unique 22-character alphanumeric string that identifies the private endpoint to return. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getDataFederationPrivateEndpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-getDataFederationPrivateEndpoint-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-getFederatedDatabase.txt b/docs/command/atlas-api-dataFederation-getFederatedDatabase.txt deleted file mode 100644 index e5d2b182a7..0000000000 --- a/docs/command/atlas-api-dataFederation-getFederatedDatabase.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-dataFederation-getFederatedDatabase: - -============================================= -atlas api dataFederation getFederatedDatabase -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details of one federated database instance within the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederateddatabase. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation getFederatedDatabase [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getFederatedDatabase - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --tenantName - - string - - true - - Human-readable label that identifies the Federated Database to return. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-getFederatedDatabase-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-getGroupDataFederation.txt b/docs/command/atlas-api-dataFederation-getGroupDataFederation.txt new file mode 100644 index 0000000000..a16155d1b1 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-getGroupDataFederation.txt @@ -0,0 +1,98 @@ +.. _atlas-api-dataFederation-getGroupDataFederation: + +=============================================== +atlas api dataFederation getGroupDataFederation +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details of one federated database instance within the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdatafederation. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation getGroupDataFederation [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupDataFederation + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --tenantName + - string + - true + - Human-readable label that identifies the Federated Database to return. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-getGroupDataFederation-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-getGroupDataFederationLimit.txt b/docs/command/atlas-api-dataFederation-getGroupDataFederationLimit.txt new file mode 100644 index 0000000000..3cd741ea5a --- /dev/null +++ b/docs/command/atlas-api-dataFederation-getGroupDataFederationLimit.txt @@ -0,0 +1,114 @@ +.. _atlas-api-dataFederation-getGroupDataFederationLimit: + +==================================================== +atlas api dataFederation getGroupDataFederationLimit +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details of one query limit for the specified federated database instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdatafederationlimit. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation getGroupDataFederationLimit [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupDataFederationLimit + * - --limitName + - string + - true + - Human-readable label that identifies this data federation instance limit. + + | Limit Name | Description | Default | + | --- | --- | --- | + | bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | + | bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | + | bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | + | bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | + + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the federated database instance to which the query limit applies. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-getGroupDataFederationLimit-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId.txt b/docs/command/atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId.txt new file mode 100644 index 0000000000..49942b7c74 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId.txt @@ -0,0 +1,102 @@ +.. _atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId: + +================================================================ +atlas api dataFederation getGroupPrivateNetworkSettingEndpointId +================================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivatenetworksettingendpointid. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation getGroupPrivateNetworkSettingEndpointId [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --endpointId + - string + - true + - Unique 22-character alphanumeric string that identifies the private endpoint to return. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupPrivateNetworkSettingEndpointId + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-listDataFederationPrivateEndpoints.txt b/docs/command/atlas-api-dataFederation-listDataFederationPrivateEndpoints.txt deleted file mode 100644 index 4e4ec88db0..0000000000 --- a/docs/command/atlas-api-dataFederation-listDataFederationPrivateEndpoints.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-dataFederation-listDataFederationPrivateEndpoints: - -=========================================================== -atlas api dataFederation listDataFederationPrivateEndpoints -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all private endpoints for Federated Database Instances and Online Archives in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatafederationprivateendpoints. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation listDataFederationPrivateEndpoints [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listDataFederationPrivateEndpoints - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-listDataFederationPrivateEndpoints-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-listFederatedDatabases.txt b/docs/command/atlas-api-dataFederation-listFederatedDatabases.txt deleted file mode 100644 index 1afeeb6250..0000000000 --- a/docs/command/atlas-api-dataFederation-listFederatedDatabases.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-dataFederation-listFederatedDatabases: - -=============================================== -atlas api dataFederation listFederatedDatabases -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details of all federated database instances in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only or higher role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederateddatabases. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation listFederatedDatabases [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listFederatedDatabases - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --type - - string - - false - - Type of Federated Database Instances to return. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-listFederatedDatabases-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-listGroupDataFederation.txt b/docs/command/atlas-api-dataFederation-listGroupDataFederation.txt new file mode 100644 index 0000000000..d19bb1ae99 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-listGroupDataFederation.txt @@ -0,0 +1,102 @@ +.. _atlas-api-dataFederation-listGroupDataFederation: + +================================================ +atlas api dataFederation listGroupDataFederation +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details of all federated database instances in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only or higher role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupdatafederation. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation listGroupDataFederation [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupDataFederation + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --type + - string + - false + - Type of Federated Database Instances to return. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-listGroupDataFederation-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-listGroupDataFederationLimits.txt b/docs/command/atlas-api-dataFederation-listGroupDataFederationLimits.txt new file mode 100644 index 0000000000..51a5e07223 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-listGroupDataFederationLimits.txt @@ -0,0 +1,102 @@ +.. _atlas-api-dataFederation-listGroupDataFederationLimits: + +====================================================== +atlas api dataFederation listGroupDataFederationLimits +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns query limits for a federated databases instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupdatafederationlimits. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation listGroupDataFederationLimits [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupDataFederationLimits + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the federated database instance for which you want to retrieve query limits. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-listGroupDataFederationLimits-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds.txt b/docs/command/atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds.txt new file mode 100644 index 0000000000..df8e80c223 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds.txt @@ -0,0 +1,110 @@ +.. _atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds: + +================================================================== +atlas api dataFederation listGroupPrivateNetworkSettingEndpointIds +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all private endpoints for Federated Database Instances and Online Archives in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprivatenetworksettingendpointids. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation listGroupPrivateNetworkSettingEndpointIds [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupPrivateNetworkSettingEndpointIds + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-dataFederation-returnFederatedDatabaseQueryLimit.txt b/docs/command/atlas-api-dataFederation-returnFederatedDatabaseQueryLimit.txt deleted file mode 100644 index df56bb033d..0000000000 --- a/docs/command/atlas-api-dataFederation-returnFederatedDatabaseQueryLimit.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-dataFederation-returnFederatedDatabaseQueryLimit: - -========================================================== -atlas api dataFederation returnFederatedDatabaseQueryLimit -========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details of one query limit for the specified federated database instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnfederateddatabasequerylimit. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation returnFederatedDatabaseQueryLimit [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for returnFederatedDatabaseQueryLimit - * - --limitName - - string - - true - - Human-readable label that identifies this data federation instance limit. - - | Limit Name | Description | Default | - | --- | --- | --- | - | bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | - | bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | - | bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | - | bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | - - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the federated database instance to which the query limit applies. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-returnFederatedDatabaseQueryLimit-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-returnFederatedDatabaseQueryLimits.txt b/docs/command/atlas-api-dataFederation-returnFederatedDatabaseQueryLimits.txt deleted file mode 100644 index ef07babdc1..0000000000 --- a/docs/command/atlas-api-dataFederation-returnFederatedDatabaseQueryLimits.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-dataFederation-returnFederatedDatabaseQueryLimits: - -=========================================================== -atlas api dataFederation returnFederatedDatabaseQueryLimits -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns query limits for a federated databases instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnfederateddatabasequerylimits. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation returnFederatedDatabaseQueryLimits [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for returnFederatedDatabaseQueryLimits - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the federated database instance for which you want to retrieve query limits. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-dataFederation-returnFederatedDatabaseQueryLimits-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-dataFederation-setGroupDataFederationLimit.txt b/docs/command/atlas-api-dataFederation-setGroupDataFederationLimit.txt new file mode 100644 index 0000000000..759beb3059 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-setGroupDataFederationLimit.txt @@ -0,0 +1,109 @@ +.. _atlas-api-dataFederation-setGroupDataFederationLimit: + +==================================================== +atlas api dataFederation setGroupDataFederationLimit +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates or updates one query limit for one federated database instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setgroupdatafederationlimit. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation setGroupDataFederationLimit [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for setGroupDataFederationLimit + * - --limitName + - string + - true + - Human-readable label that identifies this data federation instance limit. + + | Limit Name | Description | Default | + | --- | --- | --- | + | bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | + | bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | + | bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | + | bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | + + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --tenantName + - string + - true + - Human-readable label that identifies the federated database instance to which the query limit applies. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-dataFederation-updateFederatedDatabase.txt b/docs/command/atlas-api-dataFederation-updateFederatedDatabase.txt deleted file mode 100644 index e209bbcefd..0000000000 --- a/docs/command/atlas-api-dataFederation-updateFederatedDatabase.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-dataFederation-updateFederatedDatabase: - -================================================ -atlas api dataFederation updateFederatedDatabase -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the details of one federated database instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner or higher role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederateddatabase. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api dataFederation updateFederatedDatabase [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateFederatedDatabase - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --skipRoleValidation - - - - true - - Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check. - * - --tenantName - - string - - true - - Human-readable label that identifies the federated database instance to update. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-dataFederation-updateGroupDataFederation.txt b/docs/command/atlas-api-dataFederation-updateGroupDataFederation.txt new file mode 100644 index 0000000000..0a6f42b514 --- /dev/null +++ b/docs/command/atlas-api-dataFederation-updateGroupDataFederation.txt @@ -0,0 +1,105 @@ +.. _atlas-api-dataFederation-updateGroupDataFederation: + +================================================== +atlas api dataFederation updateGroupDataFederation +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the details of one federated database instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner or higher role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupdatafederation. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api dataFederation updateGroupDataFederation [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupDataFederation + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --skipRoleValidation + - + - true + - Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check. + * - --tenantName + - string + - true + - Human-readable label that identifies the federated database instance to update. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-dataFederation.txt b/docs/command/atlas-api-dataFederation.txt index 4e39e60b74..05319475ea 100644 --- a/docs/command/atlas-api-dataFederation.txt +++ b/docs/command/atlas-api-dataFederation.txt @@ -54,37 +54,37 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-dataFederation-createDataFederationPrivateEndpoint` - `Public Preview: please provide feedback `_: Adds one private endpoint for Federated Database Instances and Online Archives to the specified projects. -* :ref:`atlas-api-dataFederation-createFederatedDatabase` - `Public Preview: please provide feedback `_: Creates one federated database instance in the specified project. -* :ref:`atlas-api-dataFederation-createOneDataFederationQueryLimit` - `Public Preview: please provide feedback `_: Creates or updates one query limit for one federated database instance. -* :ref:`atlas-api-dataFederation-deleteDataFederationPrivateEndpoint` - `Public Preview: please provide feedback `_: Removes one private endpoint for Federated Database Instances and Online Archives in the specified project. -* :ref:`atlas-api-dataFederation-deleteFederatedDatabase` - `Public Preview: please provide feedback `_: Removes one federated database instance from the specified project. -* :ref:`atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit` - `Public Preview: please provide feedback `_: Deletes one query limit for one federated database instance. -* :ref:`atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs` - `Public Preview: please provide feedback `_: Downloads the query logs for the specified federated database instance. -* :ref:`atlas-api-dataFederation-getDataFederationPrivateEndpoint` - `Public Preview: please provide feedback `_: Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. -* :ref:`atlas-api-dataFederation-getFederatedDatabase` - `Public Preview: please provide feedback `_: Returns the details of one federated database instance within the specified project. -* :ref:`atlas-api-dataFederation-listDataFederationPrivateEndpoints` - `Public Preview: please provide feedback `_: Returns all private endpoints for Federated Database Instances and Online Archives in the specified project. -* :ref:`atlas-api-dataFederation-listFederatedDatabases` - `Public Preview: please provide feedback `_: Returns the details of all federated database instances in the specified project. -* :ref:`atlas-api-dataFederation-returnFederatedDatabaseQueryLimit` - `Public Preview: please provide feedback `_: Returns the details of one query limit for the specified federated database instance in the specified project. -* :ref:`atlas-api-dataFederation-returnFederatedDatabaseQueryLimits` - `Public Preview: please provide feedback `_: Returns query limits for a federated databases instance in the specified project. -* :ref:`atlas-api-dataFederation-updateFederatedDatabase` - `Public Preview: please provide feedback `_: Updates the details of one federated database instance in the specified project. +* :ref:`atlas-api-dataFederation-createGroupDataFederation` - `Public Preview: please provide feedback `_: Creates one federated database instance in the specified project. +* :ref:`atlas-api-dataFederation-createGroupPrivateNetworkSettingEndpointId` - `Public Preview: please provide feedback `_: Adds one private endpoint for Federated Database Instances and Online Archives to the specified projects. +* :ref:`atlas-api-dataFederation-deleteGroupDataFederation` - `Public Preview: please provide feedback `_: Removes one federated database instance from the specified project. +* :ref:`atlas-api-dataFederation-deleteGroupDataFederationLimit` - `Public Preview: please provide feedback `_: Deletes one query limit for one federated database instance. +* :ref:`atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId` - `Public Preview: please provide feedback `_: Removes one private endpoint for Federated Database Instances and Online Archives in the specified project. +* :ref:`atlas-api-dataFederation-downloadGroupDataFederationQueryLogs` - `Public Preview: please provide feedback `_: Downloads the query logs for the specified federated database instance. +* :ref:`atlas-api-dataFederation-getGroupDataFederation` - `Public Preview: please provide feedback `_: Returns the details of one federated database instance within the specified project. +* :ref:`atlas-api-dataFederation-getGroupDataFederationLimit` - `Public Preview: please provide feedback `_: Returns the details of one query limit for the specified federated database instance in the specified project. +* :ref:`atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId` - `Public Preview: please provide feedback `_: Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. +* :ref:`atlas-api-dataFederation-listGroupDataFederation` - `Public Preview: please provide feedback `_: Returns the details of all federated database instances in the specified project. +* :ref:`atlas-api-dataFederation-listGroupDataFederationLimits` - `Public Preview: please provide feedback `_: Returns query limits for a federated databases instance in the specified project. +* :ref:`atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds` - `Public Preview: please provide feedback `_: Returns all private endpoints for Federated Database Instances and Online Archives in the specified project. +* :ref:`atlas-api-dataFederation-setGroupDataFederationLimit` - `Public Preview: please provide feedback `_: Creates or updates one query limit for one federated database instance. +* :ref:`atlas-api-dataFederation-updateGroupDataFederation` - `Public Preview: please provide feedback `_: Updates the details of one federated database instance in the specified project. .. toctree:: :titlesonly: - createDataFederationPrivateEndpoint - createFederatedDatabase - createOneDataFederationQueryLimit - deleteDataFederationPrivateEndpoint - deleteFederatedDatabase - deleteOneDataFederationInstanceQueryLimit - downloadFederatedDatabaseQueryLogs - getDataFederationPrivateEndpoint - getFederatedDatabase - listDataFederationPrivateEndpoints - listFederatedDatabases - returnFederatedDatabaseQueryLimit - returnFederatedDatabaseQueryLimits - updateFederatedDatabase + createGroupDataFederation + createGroupPrivateNetworkSettingEndpointId + deleteGroupDataFederation + deleteGroupDataFederationLimit + deleteGroupPrivateNetworkSettingEndpointId + downloadGroupDataFederationQueryLogs + getGroupDataFederation + getGroupDataFederationLimit + getGroupPrivateNetworkSettingEndpointId + listGroupDataFederation + listGroupDataFederationLimits + listGroupPrivateNetworkSettingEndpointIds + setGroupDataFederationLimit + updateGroupDataFederation diff --git a/docs/command/atlas-api-databaseUsers-createDatabaseUser.txt b/docs/command/atlas-api-databaseUsers-createDatabaseUser.txt deleted file mode 100644 index c6a881abda..0000000000 --- a/docs/command/atlas-api-databaseUsers-createDatabaseUser.txt +++ /dev/null @@ -1,180 +0,0 @@ -.. _atlas-api-databaseUsers-createDatabaseUser: - -========================================== -atlas api databaseUsers createDatabaseUser -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one database user in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This MongoDB Cloud supports a maximum of 100 database users per project. If you require more than 100 database users on a project, contact Support. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createdatabaseuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api databaseUsers createDatabaseUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createDatabaseUser - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. tabs:: - - .. tab:: Example - :tabid: 2023-01-01_aws_iam_authentication - - AWS IAM Authentication - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-aws_iam_authentication-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-aws_iam_authentication.sh - :language: shell - .. tab:: Example 1 - :tabid: 2023-01-01_ldap_authentication - - LDAP Authentication - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-ldap_authentication-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-ldap_authentication.sh - :language: shell - .. tab:: Example 2 - :tabid: 2023-01-01_oidc_workforce_federated_authentication - - OIDC Workforce Federated Authentication - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workforce_federated_authentication-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workforce_federated_authentication.sh - :language: shell - .. tab:: Example 3 - :tabid: 2023-01-01_oidc_workload_federated_authentication - - OIDC Workload Federated Authentication - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workload_federated_authentication-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workload_federated_authentication.sh - :language: shell - .. tab:: Example 4 - :tabid: 2023-01-01_scram-sha_authentication - - SCRAM-SHA Authentication - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-scram-sha_authentication-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-scram-sha_authentication.sh - :language: shell - .. tab:: Example 5 - :tabid: 2023-01-01_x509_authentication - - X509 Authentication - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-x509_authentication-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-x509_authentication.sh - :language: shell diff --git a/docs/command/atlas-api-databaseUsers-createGroupDatabaseUser.txt b/docs/command/atlas-api-databaseUsers-createGroupDatabaseUser.txt new file mode 100644 index 0000000000..5e8b01122d --- /dev/null +++ b/docs/command/atlas-api-databaseUsers-createGroupDatabaseUser.txt @@ -0,0 +1,180 @@ +.. _atlas-api-databaseUsers-createGroupDatabaseUser: + +=============================================== +atlas api databaseUsers createGroupDatabaseUser +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one database user in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This MongoDB Cloud supports a maximum of 100 database users per project. If you require more than 100 database users on a project, contact Support. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupdatabaseuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api databaseUsers createGroupDatabaseUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupDatabaseUser + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. tabs:: + + .. tab:: Example + :tabid: 2023-01-01_aws_iam_authentication + + AWS IAM Authentication + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-aws_iam_authentication-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-aws_iam_authentication.sh + :language: shell + .. tab:: Example 1 + :tabid: 2023-01-01_ldap_authentication + + LDAP Authentication + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-ldap_authentication-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-ldap_authentication.sh + :language: shell + .. tab:: Example 2 + :tabid: 2023-01-01_oidc_workforce_federated_authentication + + OIDC Workforce Federated Authentication + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workforce_federated_authentication-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workforce_federated_authentication.sh + :language: shell + .. tab:: Example 3 + :tabid: 2023-01-01_oidc_workload_federated_authentication + + OIDC Workload Federated Authentication + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workload_federated_authentication-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workload_federated_authentication.sh + :language: shell + .. tab:: Example 4 + :tabid: 2023-01-01_scram-sha_authentication + + SCRAM-SHA Authentication + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-scram-sha_authentication-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-scram-sha_authentication.sh + :language: shell + .. tab:: Example 5 + :tabid: 2023-01-01_x509_authentication + + X509 Authentication + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-x509_authentication-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-x509_authentication.sh + :language: shell diff --git a/docs/command/atlas-api-databaseUsers-deleteDatabaseUser.txt b/docs/command/atlas-api-databaseUsers-deleteDatabaseUser.txt deleted file mode 100644 index a0dab0c03e..0000000000 --- a/docs/command/atlas-api-databaseUsers-deleteDatabaseUser.txt +++ /dev/null @@ -1,119 +0,0 @@ -.. _atlas-api-databaseUsers-deleteDatabaseUser: - -========================================== -atlas api databaseUsers deleteDatabaseUser -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one database user from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletedatabaseuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api databaseUsers deleteDatabaseUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --databaseName - - $external - - true - - The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be $external. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be `admin`. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteDatabaseUser - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - true - - Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: - - | Authentication Method | Parameter Needed | Parameter Value | username Format | - - | AWS IAM | awsIAMType | ROLE | ARN | - | AWS IAM | awsIAMType | USER | ARN | - | x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | - | OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | - | SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | - - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-databaseUsers-deleteDatabaseUser-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-databaseUsers-deleteGroupDatabaseUser.txt b/docs/command/atlas-api-databaseUsers-deleteGroupDatabaseUser.txt new file mode 100644 index 0000000000..80e3f5ed37 --- /dev/null +++ b/docs/command/atlas-api-databaseUsers-deleteGroupDatabaseUser.txt @@ -0,0 +1,119 @@ +.. _atlas-api-databaseUsers-deleteGroupDatabaseUser: + +=============================================== +atlas api databaseUsers deleteGroupDatabaseUser +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one database user from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupdatabaseuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api databaseUsers deleteGroupDatabaseUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --databaseName + - $external + - true + - The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be $external. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be `admin`. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupDatabaseUser + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - true + - Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: + + | Authentication Method | Parameter Needed | Parameter Value | username Format | + + | AWS IAM | awsIAMType | ROLE | ARN | + | AWS IAM | awsIAMType | USER | ARN | + | x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | + | OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | + | SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | + + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-databaseUsers-deleteGroupDatabaseUser-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-databaseUsers-getDatabaseUser.txt b/docs/command/atlas-api-databaseUsers-getDatabaseUser.txt deleted file mode 100644 index f982191688..0000000000 --- a/docs/command/atlas-api-databaseUsers-getDatabaseUser.txt +++ /dev/null @@ -1,119 +0,0 @@ -.. _atlas-api-databaseUsers-getDatabaseUser: - -======================================= -atlas api databaseUsers getDatabaseUser -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one database user that belong to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabaseuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api databaseUsers getDatabaseUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --databaseName - - $external - - true - - The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be $external. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be `admin`. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getDatabaseUser - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - true - - Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: - - | Authentication Method | Parameter Needed | Parameter Value | username Format | - - | AWS IAM | awsIAMType | ROLE | ARN | - | AWS IAM | awsIAMType | USER | ARN | - | x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | - | OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | - | SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | - - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-databaseUsers-getDatabaseUser-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-databaseUsers-getGroupDatabaseUser.txt b/docs/command/atlas-api-databaseUsers-getGroupDatabaseUser.txt new file mode 100644 index 0000000000..228279a509 --- /dev/null +++ b/docs/command/atlas-api-databaseUsers-getGroupDatabaseUser.txt @@ -0,0 +1,119 @@ +.. _atlas-api-databaseUsers-getGroupDatabaseUser: + +============================================ +atlas api databaseUsers getGroupDatabaseUser +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one database user that belong to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdatabaseuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api databaseUsers getGroupDatabaseUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --databaseName + - $external + - true + - The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be $external. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be `admin`. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupDatabaseUser + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - true + - Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: + + | Authentication Method | Parameter Needed | Parameter Value | username Format | + + | AWS IAM | awsIAMType | ROLE | ARN | + | AWS IAM | awsIAMType | USER | ARN | + | x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | + | OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | + | SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | + + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-databaseUsers-getGroupDatabaseUser-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-databaseUsers-listDatabaseUsers.txt b/docs/command/atlas-api-databaseUsers-listDatabaseUsers.txt deleted file mode 100644 index 6afcd62d89..0000000000 --- a/docs/command/atlas-api-databaseUsers-listDatabaseUsers.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-databaseUsers-listDatabaseUsers: - -========================================= -atlas api databaseUsers listDatabaseUsers -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all database users that belong to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabaseusers. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api databaseUsers listDatabaseUsers [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listDatabaseUsers - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-databaseUsers-listDatabaseUsers-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-databaseUsers-listGroupDatabaseUsers.txt b/docs/command/atlas-api-databaseUsers-listGroupDatabaseUsers.txt new file mode 100644 index 0000000000..515e539e6d --- /dev/null +++ b/docs/command/atlas-api-databaseUsers-listGroupDatabaseUsers.txt @@ -0,0 +1,110 @@ +.. _atlas-api-databaseUsers-listGroupDatabaseUsers: + +============================================== +atlas api databaseUsers listGroupDatabaseUsers +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all database users that belong to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupdatabaseusers. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api databaseUsers listGroupDatabaseUsers [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupDatabaseUsers + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-databaseUsers-listGroupDatabaseUsers-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-databaseUsers-updateDatabaseUser.txt b/docs/command/atlas-api-databaseUsers-updateDatabaseUser.txt deleted file mode 100644 index e3605a7893..0000000000 --- a/docs/command/atlas-api-databaseUsers-updateDatabaseUser.txt +++ /dev/null @@ -1,118 +0,0 @@ -.. _atlas-api-databaseUsers-updateDatabaseUser: - -========================================== -atlas api databaseUsers updateDatabaseUser -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one database user that belongs to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatedatabaseuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api databaseUsers updateDatabaseUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --databaseName - - $external - - true - - The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be $external. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be `admin`. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateDatabaseUser - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - true - - Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: - - | Authentication Method | Parameter Needed | Parameter Value | username Format | - - | AWS IAM | awsIAMType | ROLE | ARN | - | AWS IAM | awsIAMType | USER | ARN | - | x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | - | OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | - | OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | - | SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | - - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-databaseUsers-updateGroupDatabaseUser.txt b/docs/command/atlas-api-databaseUsers-updateGroupDatabaseUser.txt new file mode 100644 index 0000000000..8ae6508da0 --- /dev/null +++ b/docs/command/atlas-api-databaseUsers-updateGroupDatabaseUser.txt @@ -0,0 +1,118 @@ +.. _atlas-api-databaseUsers-updateGroupDatabaseUser: + +=============================================== +atlas api databaseUsers updateGroupDatabaseUser +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one database user that belongs to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupdatabaseuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api databaseUsers updateGroupDatabaseUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --databaseName + - $external + - true + - The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be $external. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be `admin`. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupDatabaseUser + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - true + - Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: + + | Authentication Method | Parameter Needed | Parameter Value | username Format | + + | AWS IAM | awsIAMType | ROLE | ARN | + | AWS IAM | awsIAMType | USER | ARN | + | x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | + | OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | + | OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | + | SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | + + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-databaseUsers.txt b/docs/command/atlas-api-databaseUsers.txt index a4b211cfb4..047eec9532 100644 --- a/docs/command/atlas-api-databaseUsers.txt +++ b/docs/command/atlas-api-databaseUsers.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-databaseUsers-createDatabaseUser` - `Public Preview: please provide feedback `_: Creates one database user in the specified project. -* :ref:`atlas-api-databaseUsers-deleteDatabaseUser` - `Public Preview: please provide feedback `_: Removes one database user from the specified project. -* :ref:`atlas-api-databaseUsers-getDatabaseUser` - `Public Preview: please provide feedback `_: Returns one database user that belong to the specified project. -* :ref:`atlas-api-databaseUsers-listDatabaseUsers` - `Public Preview: please provide feedback `_: Returns all database users that belong to the specified project. -* :ref:`atlas-api-databaseUsers-updateDatabaseUser` - `Public Preview: please provide feedback `_: Updates one database user that belongs to the specified project. +* :ref:`atlas-api-databaseUsers-createGroupDatabaseUser` - `Public Preview: please provide feedback `_: Creates one database user in the specified project. +* :ref:`atlas-api-databaseUsers-deleteGroupDatabaseUser` - `Public Preview: please provide feedback `_: Removes one database user from the specified project. +* :ref:`atlas-api-databaseUsers-getGroupDatabaseUser` - `Public Preview: please provide feedback `_: Returns one database user that belong to the specified project. +* :ref:`atlas-api-databaseUsers-listGroupDatabaseUsers` - `Public Preview: please provide feedback `_: Returns all database users that belong to the specified project. +* :ref:`atlas-api-databaseUsers-updateGroupDatabaseUser` - `Public Preview: please provide feedback `_: Updates one database user that belongs to the specified project. .. toctree:: :titlesonly: - createDatabaseUser - deleteDatabaseUser - getDatabaseUser - listDatabaseUsers - updateDatabaseUser + createGroupDatabaseUser + deleteGroupDatabaseUser + getGroupDatabaseUser + listGroupDatabaseUsers + updateGroupDatabaseUser diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-createEncryptionAtRestPrivateEndpoint.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-createEncryptionAtRestPrivateEndpoint.txt deleted file mode 100644 index 50d7f5e979..0000000000 --- a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-createEncryptionAtRestPrivateEndpoint.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-createEncryptionAtRestPrivateEndpoint: - -========================================================================================== -atlas api encryptionAtRestUsingCustomerKeyManagement createEncryptionAtRestPrivateEndpoint -========================================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates a private endpoint in the specified region for encryption at rest using customer key management. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createencryptionatrestprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api encryptionAtRestUsingCustomerKeyManagement createEncryptionAtRestPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Human-readable label that identifies the cloud provider for the private endpoint to create. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createEncryptionAtRestPrivateEndpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-createGroupEncryptionAtRestPrivateEndpoint.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-createGroupEncryptionAtRestPrivateEndpoint.txt new file mode 100644 index 0000000000..06d76da05d --- /dev/null +++ b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-createGroupEncryptionAtRestPrivateEndpoint.txt @@ -0,0 +1,99 @@ +.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-createGroupEncryptionAtRestPrivateEndpoint: + +=============================================================================================== +atlas api encryptionAtRestUsingCustomerKeyManagement createGroupEncryptionAtRestPrivateEndpoint +=============================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates a private endpoint in the specified region for encryption at rest using customer key management. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupencryptionatrestprivateendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api encryptionAtRestUsingCustomerKeyManagement createGroupEncryptionAtRestPrivateEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Human-readable label that identifies the cloud provider for the private endpoint to create. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupEncryptionAtRestPrivateEndpoint + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest.txt deleted file mode 100644 index 27e582e378..0000000000 --- a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest: - -======================================================================== -atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRest -======================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the configuration for encryption at rest using the keys you manage through your cloud provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. - - -LIMITED TO M10 OR GREATER: MongoDB Cloud limits this feature to dedicated cluster tiers of M10 and greater. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getencryptionatrest. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRest [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getEncryptionAtRest - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint.txt deleted file mode 100644 index a5ce596a19..0000000000 --- a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint: - -======================================================================================= -atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRestPrivateEndpoint -======================================================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getencryptionatrestprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRestPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Human-readable label that identifies the cloud provider of the private endpoint. - * - --endpointId - - string - - true - - Unique 24-hexadecimal digit string that identifies the private endpoint. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getEncryptionAtRestPrivateEndpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider.txt deleted file mode 100644 index cbb9fb3dcf..0000000000 --- a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider.txt +++ /dev/null @@ -1,112 +0,0 @@ -.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider: - -======================================================================================================== -atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRestPrivateEndpointsForCloudProvider -======================================================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the private endpoints of the specified cloud provider for encryption at rest using customer key management. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getencryptionatrestprivateendpointsforcloudprovider. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRestPrivateEndpointsForCloudProvider [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Human-readable label that identifies the cloud provider for the private endpoints to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getEncryptionAtRestPrivateEndpointsForCloudProvider - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest.txt new file mode 100644 index 0000000000..efd216206f --- /dev/null +++ b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest.txt @@ -0,0 +1,101 @@ +.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest: + +============================================================================= +atlas api encryptionAtRestUsingCustomerKeyManagement getGroupEncryptionAtRest +============================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the configuration for encryption at rest using the keys you manage through your cloud provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. + + +LIMITED TO M10 OR GREATER: MongoDB Cloud limits this feature to dedicated cluster tiers of M10 and greater. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupencryptionatrest. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api encryptionAtRestUsingCustomerKeyManagement getGroupEncryptionAtRest [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupEncryptionAtRest + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint.txt new file mode 100644 index 0000000000..cdca4a804a --- /dev/null +++ b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint.txt @@ -0,0 +1,104 @@ +.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint: + +============================================================================================ +atlas api encryptionAtRestUsingCustomerKeyManagement getGroupEncryptionAtRestPrivateEndpoint +============================================================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupencryptionatrestprivateendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api encryptionAtRestUsingCustomerKeyManagement getGroupEncryptionAtRestPrivateEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Human-readable label that identifies the cloud provider of the private endpoint. + * - --endpointId + - string + - true + - Unique 24-hexadecimal digit string that identifies the private endpoint. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupEncryptionAtRestPrivateEndpoint + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints.txt new file mode 100644 index 0000000000..e51f590820 --- /dev/null +++ b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints.txt @@ -0,0 +1,112 @@ +.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints: + +============================================================================================== +atlas api encryptionAtRestUsingCustomerKeyManagement listGroupEncryptionAtRestPrivateEndpoints +============================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the private endpoints of the specified cloud provider for encryption at rest using customer key management. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupencryptionatrestprivateendpoints. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api encryptionAtRestUsingCustomerKeyManagement listGroupEncryptionAtRestPrivateEndpoints [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Human-readable label that identifies the cloud provider for the private endpoints to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupEncryptionAtRestPrivateEndpoints + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion.txt deleted file mode 100644 index 0adc5345dd..0000000000 --- a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion: - -=================================================================================================== -atlas api encryptionAtRestUsingCustomerKeyManagement requestEncryptionAtRestPrivateEndpointDeletion -=================================================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-requestencryptionatrestprivateendpointdeletion. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api encryptionAtRestUsingCustomerKeyManagement requestEncryptionAtRestPrivateEndpointDeletion [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Human-readable label that identifies the cloud provider of the private endpoint to delete. - * - --endpointId - - string - - true - - Unique 24-hexadecimal digit string that identifies the private endpoint to delete. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for requestEncryptionAtRestPrivateEndpointDeletion - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion.txt new file mode 100644 index 0000000000..91bae1ff81 --- /dev/null +++ b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion.txt @@ -0,0 +1,104 @@ +.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion: + +======================================================================================================== +atlas api encryptionAtRestUsingCustomerKeyManagement requestGroupEncryptionAtRestPrivateEndpointDeletion +======================================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-requestgroupencryptionatrestprivateendpointdeletion. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api encryptionAtRestUsingCustomerKeyManagement requestGroupEncryptionAtRestPrivateEndpointDeletion [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Human-readable label that identifies the cloud provider of the private endpoint to delete. + * - --endpointId + - string + - true + - Unique 24-hexadecimal digit string that identifies the private endpoint to delete. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for requestGroupEncryptionAtRestPrivateEndpointDeletion + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateEncryptionAtRest.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateEncryptionAtRest.txt deleted file mode 100644 index 7936d87b39..0000000000 --- a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateEncryptionAtRest.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateEncryptionAtRest: - -=========================================================================== -atlas api encryptionAtRestUsingCustomerKeyManagement updateEncryptionAtRest -=========================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the configuration for encryption at rest using the keys you manage through your cloud provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. This feature isn't available for M0 free clusters, M2, M5, or serverless clusters. - - -After you configure at least one Encryption at Rest using a Customer Key Management provider for the MongoDB Cloud project, Project Owners can enable Encryption at Rest using Customer Key Management for each MongoDB Cloud cluster for which they require encryption. The Encryption at Rest using Customer Key Management provider doesn't have to match the cluster cloud service provider. MongoDB Cloud doesn't automatically rotate user-managed encryption keys. Defer to your preferred Encryption at Rest using Customer Key Management provider's documentation and guidance for best practices on key rotation. MongoDB Cloud automatically creates a 90-day key rotation alert when you configure Encryption at Rest using Customer Key Management using your Key Management in an MongoDB Cloud project. MongoDB Cloud encrypts all storage whether or not you use your own key management. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateencryptionatrest. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api encryptionAtRestUsingCustomerKeyManagement updateEncryptionAtRest [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateEncryptionAtRest - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateGroupEncryptionAtRest.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateGroupEncryptionAtRest.txt new file mode 100644 index 0000000000..4029a3d9b9 --- /dev/null +++ b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateGroupEncryptionAtRest.txt @@ -0,0 +1,100 @@ +.. _atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateGroupEncryptionAtRest: + +================================================================================ +atlas api encryptionAtRestUsingCustomerKeyManagement updateGroupEncryptionAtRest +================================================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the configuration for encryption at rest using the keys you manage through your cloud provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. This feature isn't available for M0 free clusters, M2, M5, or serverless clusters. + + +After you configure at least one Encryption at Rest using a Customer Key Management provider for the MongoDB Cloud project, Project Owners can enable Encryption at Rest using Customer Key Management for each MongoDB Cloud cluster for which they require encryption. The Encryption at Rest using Customer Key Management provider doesn't have to match the cluster cloud service provider. MongoDB Cloud doesn't automatically rotate user-managed encryption keys. Defer to your preferred Encryption at Rest using Customer Key Management provider's documentation and guidance for best practices on key rotation. MongoDB Cloud automatically creates a 90-day key rotation alert when you configure Encryption at Rest using Customer Key Management using your Key Management in an MongoDB Cloud project. MongoDB Cloud encrypts all storage whether or not you use your own key management. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupencryptionatrest. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api encryptionAtRestUsingCustomerKeyManagement updateGroupEncryptionAtRest [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupEncryptionAtRest + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement.txt b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement.txt index 46dc2bea9f..b31898d64c 100644 --- a/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement.txt +++ b/docs/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement.txt @@ -54,21 +54,21 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-createEncryptionAtRestPrivateEndpoint` - `Public Preview: please provide feedback `_: Creates a private endpoint in the specified region for encryption at rest using customer key management. -* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest` - `Public Preview: please provide feedback `_: Returns the configuration for encryption at rest using the keys you manage through your cloud provider. -* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint` - `Public Preview: please provide feedback `_: Returns one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. -* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider` - `Public Preview: please provide feedback `_: Returns the private endpoints of the specified cloud provider for encryption at rest using customer key management. -* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion` - `Public Preview: please provide feedback `_: Deletes one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. -* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateEncryptionAtRest` - `Public Preview: please provide feedback `_: Updates the configuration for encryption at rest using the keys you manage through your cloud provider. +* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-createGroupEncryptionAtRestPrivateEndpoint` - `Public Preview: please provide feedback `_: Creates a private endpoint in the specified region for encryption at rest using customer key management. +* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest` - `Public Preview: please provide feedback `_: Returns the configuration for encryption at rest using the keys you manage through your cloud provider. +* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint` - `Public Preview: please provide feedback `_: Returns one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. +* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints` - `Public Preview: please provide feedback `_: Returns the private endpoints of the specified cloud provider for encryption at rest using customer key management. +* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion` - `Public Preview: please provide feedback `_: Deletes one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. +* :ref:`atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateGroupEncryptionAtRest` - `Public Preview: please provide feedback `_: Updates the configuration for encryption at rest using the keys you manage through your cloud provider. .. toctree:: :titlesonly: - createEncryptionAtRestPrivateEndpoint - getEncryptionAtRest - getEncryptionAtRestPrivateEndpoint - getEncryptionAtRestPrivateEndpointsForCloudProvider - requestEncryptionAtRestPrivateEndpointDeletion - updateEncryptionAtRest + createGroupEncryptionAtRestPrivateEndpoint + getGroupEncryptionAtRest + getGroupEncryptionAtRestPrivateEndpoint + listGroupEncryptionAtRestPrivateEndpoints + requestGroupEncryptionAtRestPrivateEndpointDeletion + updateGroupEncryptionAtRest diff --git a/docs/command/atlas-api-events-getGroupEvent.txt b/docs/command/atlas-api-events-getGroupEvent.txt new file mode 100644 index 0000000000..0f864f949c --- /dev/null +++ b/docs/command/atlas-api-events-getGroupEvent.txt @@ -0,0 +1,109 @@ +.. _atlas-api-events-getGroupEvent: + +============================== +atlas api events getGroupEvent +============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one event for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return Events from One Project endpoint to retrieve all events to which the authenticated user has access. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupevent. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api events getGroupEvent [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --eventId + - string + - true + - Unique 24-hexadecimal digit string that identifies the event that you want to return. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupEvent + * - --includeRaw + - + - false + - Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-events-getGroupEvent-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-events-getOrgEvent.txt b/docs/command/atlas-api-events-getOrgEvent.txt new file mode 100644 index 0000000000..db2df50c80 --- /dev/null +++ b/docs/command/atlas-api-events-getOrgEvent.txt @@ -0,0 +1,107 @@ +.. _atlas-api-events-getOrgEvent: + +============================ +atlas api events getOrgEvent +============================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one event for the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. Use the Return Events from One Organization endpoint to retrieve all events to which the authenticated user has access. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgevent. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api events getOrgEvent [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --eventId + - string + - true + - Unique 24-hexadecimal digit string that identifies the event that you want to return. + * - -h, --help + - + - false + - help for getOrgEvent + * - --includeRaw + - + - false + - Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-events-getOrgEvent-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-events-getOrganizationEvent.txt b/docs/command/atlas-api-events-getOrganizationEvent.txt deleted file mode 100644 index 5aae2493b7..0000000000 --- a/docs/command/atlas-api-events-getOrganizationEvent.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-events-getOrganizationEvent: - -===================================== -atlas api events getOrganizationEvent -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one event for the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. Use the Return Events from One Organization endpoint to retrieve all events to which the authenticated user has access. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationevent. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api events getOrganizationEvent [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --eventId - - string - - true - - Unique 24-hexadecimal digit string that identifies the event that you want to return. - * - -h, --help - - - - false - - help for getOrganizationEvent - * - --includeRaw - - - - false - - Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-events-getOrganizationEvent-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-events-getProjectEvent.txt b/docs/command/atlas-api-events-getProjectEvent.txt deleted file mode 100644 index 6d3f469ae6..0000000000 --- a/docs/command/atlas-api-events-getProjectEvent.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-events-getProjectEvent: - -================================ -atlas api events getProjectEvent -================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one event for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return Events from One Project endpoint to retrieve all events to which the authenticated user has access. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectevent. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api events getProjectEvent [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --eventId - - string - - true - - Unique 24-hexadecimal digit string that identifies the event that you want to return. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectEvent - * - --includeRaw - - - - false - - Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-events-getProjectEvent-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-events-listGroupEvents.txt b/docs/command/atlas-api-events-listGroupEvents.txt new file mode 100644 index 0000000000..6e3e2a3f73 --- /dev/null +++ b/docs/command/atlas-api-events-listGroupEvents.txt @@ -0,0 +1,141 @@ +.. _atlas-api-events-listGroupEvents: + +================================ +atlas api events listGroupEvents +================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns events for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupevents. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api events listGroupEvents [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterNames + - stringArray + - false + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --eventType + - stringArray + - false + - Category of incident recorded at this moment in time. + + **IMPORTANT**: The complete list of event type values changes frequently. + * - --excludedEventType + - stringArray + - false + - Category of event that you would like to exclude from query results, such as CLUSTER_CREATED + + **IMPORTANT**: Event type names change frequently. Verify that you specify the event type correctly by checking the complete list of event types. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupEvents + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --includeRaw + - + - false + - Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --maxDate + - string + - false + - Date and time from when MongoDB Cloud stops returning events. This parameter uses the ISO 8601 timestamp format in UTC. + * - --minDate + - string + - false + - Date and time from when MongoDB Cloud starts returning events. This parameter uses the ISO 8601 timestamp format in UTC. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-events-listGroupEvents-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-events-listOrgEvents.txt b/docs/command/atlas-api-events-listOrgEvents.txt new file mode 100644 index 0000000000..f11714afa4 --- /dev/null +++ b/docs/command/atlas-api-events-listOrgEvents.txt @@ -0,0 +1,129 @@ +.. _atlas-api-events-listOrgEvents: + +============================== +atlas api events listOrgEvents +============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns events for the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + + +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgevents. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api events listOrgEvents [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --eventType + - stringArray + - false + - Category of incident recorded at this moment in time. + + **IMPORTANT**: The complete list of event type values changes frequently. + * - -h, --help + - + - false + - help for listOrgEvents + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --includeRaw + - + - false + - Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --maxDate + - string + - false + - Date and time from when MongoDB Cloud stops returning events. This parameter uses the ISO 8601 timestamp format in UTC. + * - --minDate + - string + - false + - Date and time from when MongoDB Cloud starts returning events. This parameter uses the ISO 8601 timestamp format in UTC. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-events-listOrgEvents-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-events-listOrganizationEvents.txt b/docs/command/atlas-api-events-listOrganizationEvents.txt deleted file mode 100644 index 41500d5a07..0000000000 --- a/docs/command/atlas-api-events-listOrganizationEvents.txt +++ /dev/null @@ -1,129 +0,0 @@ -.. _atlas-api-events-listOrganizationEvents: - -======================================= -atlas api events listOrganizationEvents -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns events for the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationevents. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api events listOrganizationEvents [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --eventType - - stringArray - - false - - Category of incident recorded at this moment in time. - - **IMPORTANT**: The complete list of event type values changes frequently. - * - -h, --help - - - - false - - help for listOrganizationEvents - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --includeRaw - - - - false - - Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --maxDate - - string - - false - - Date and time from when MongoDB Cloud stops returning events. This parameter uses the ISO 8601 timestamp format in UTC. - * - --minDate - - string - - false - - Date and time from when MongoDB Cloud starts returning events. This parameter uses the ISO 8601 timestamp format in UTC. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-events-listOrganizationEvents-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-events-listProjectEvents.txt b/docs/command/atlas-api-events-listProjectEvents.txt deleted file mode 100644 index bb46fca30b..0000000000 --- a/docs/command/atlas-api-events-listProjectEvents.txt +++ /dev/null @@ -1,141 +0,0 @@ -.. _atlas-api-events-listProjectEvents: - -================================== -atlas api events listProjectEvents -================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns events for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectevents. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api events listProjectEvents [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterNames - - stringArray - - false - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --eventType - - stringArray - - false - - Category of incident recorded at this moment in time. - - **IMPORTANT**: The complete list of event type values changes frequently. - * - --excludedEventType - - stringArray - - false - - Category of event that you would like to exclude from query results, such as CLUSTER_CREATED - - **IMPORTANT**: Event type names change frequently. Verify that you specify the event type correctly by checking the complete list of event types. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectEvents - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --includeRaw - - - - false - - Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --maxDate - - string - - false - - Date and time from when MongoDB Cloud stops returning events. This parameter uses the ISO 8601 timestamp format in UTC. - * - --minDate - - string - - false - - Date and time from when MongoDB Cloud starts returning events. This parameter uses the ISO 8601 timestamp format in UTC. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-events-listProjectEvents-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-events.txt b/docs/command/atlas-api-events.txt index b2a943d274..7beae29119 100644 --- a/docs/command/atlas-api-events.txt +++ b/docs/command/atlas-api-events.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-events-getOrganizationEvent` - `Public Preview: please provide feedback `_: Returns one event for the specified organization. -* :ref:`atlas-api-events-getProjectEvent` - `Public Preview: please provide feedback `_: Returns one event for the specified project. +* :ref:`atlas-api-events-getGroupEvent` - `Public Preview: please provide feedback `_: Returns one event for the specified project. +* :ref:`atlas-api-events-getOrgEvent` - `Public Preview: please provide feedback `_: Returns one event for the specified organization. * :ref:`atlas-api-events-listEventTypes` - `Public Preview: please provide feedback `_: Returns a list of all event types, along with a description and additional metadata about each event. -* :ref:`atlas-api-events-listOrganizationEvents` - `Public Preview: please provide feedback `_: Returns events for the specified organization. -* :ref:`atlas-api-events-listProjectEvents` - `Public Preview: please provide feedback `_: Returns events for the specified project. +* :ref:`atlas-api-events-listGroupEvents` - `Public Preview: please provide feedback `_: Returns events for the specified project. +* :ref:`atlas-api-events-listOrgEvents` - `Public Preview: please provide feedback `_: Returns events for the specified organization. .. toctree:: :titlesonly: - getOrganizationEvent - getProjectEvent + getGroupEvent + getOrgEvent listEventTypes - listOrganizationEvents - listProjectEvents + listGroupEvents + listOrgEvents diff --git a/docs/command/atlas-api-federatedAuthentication-createFederationSettingConnectedOrgConfigRoleMapping.txt b/docs/command/atlas-api-federatedAuthentication-createFederationSettingConnectedOrgConfigRoleMapping.txt new file mode 100644 index 0000000000..a88e3888d7 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-createFederationSettingConnectedOrgConfigRoleMapping.txt @@ -0,0 +1,95 @@ +.. _atlas-api-federatedAuthentication-createFederationSettingConnectedOrgConfigRoleMapping: + +====================================================================================== +atlas api federatedAuthentication createFederationSettingConnectedOrgConfigRoleMapping +====================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one role mapping to the specified organization in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createfederationsettingconnectedorgconfigrolemapping. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication createFederationSettingConnectedOrgConfigRoleMapping [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createFederationSettingConnectedOrgConfigRoleMapping + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-federatedAuthentication-createFederationSettingIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-createFederationSettingIdentityProvider.txt new file mode 100644 index 0000000000..2995cdcdc5 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-createFederationSettingIdentityProvider.txt @@ -0,0 +1,94 @@ +.. _atlas-api-federatedAuthentication-createFederationSettingIdentityProvider: + +========================================================================= +atlas api federatedAuthentication createFederationSettingIdentityProvider +========================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one identity provider within the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + + +Note: This resource only supports the creation of OIDC identity providers. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createfederationsettingidentityprovider. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication createFederationSettingIdentityProvider [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createFederationSettingIdentityProvider + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-federatedAuthentication-createIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-createIdentityProvider.txt deleted file mode 100644 index d9d3fedef7..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-createIdentityProvider.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-federatedAuthentication-createIdentityProvider: - -======================================================== -atlas api federatedAuthentication createIdentityProvider -======================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one identity provider within the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - - -Note: This resource only supports the creation of OIDC identity providers. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createidentityprovider. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication createIdentityProvider [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createIdentityProvider - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-federatedAuthentication-createRoleMapping.txt b/docs/command/atlas-api-federatedAuthentication-createRoleMapping.txt deleted file mode 100644 index 14a97847a5..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-createRoleMapping.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-federatedAuthentication-createRoleMapping: - -=================================================== -atlas api federatedAuthentication createRoleMapping -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one role mapping to the specified organization in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createrolemapping. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication createRoleMapping [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createRoleMapping - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-federatedAuthentication-deleteFederationApp.txt b/docs/command/atlas-api-federatedAuthentication-deleteFederationApp.txt deleted file mode 100644 index e6a3ceee82..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-deleteFederationApp.txt +++ /dev/null @@ -1,88 +0,0 @@ -.. _atlas-api-federatedAuthentication-deleteFederationApp: - -===================================================== -atlas api federatedAuthentication deleteFederationApp -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes the federation settings instance and all associated data, including identity providers and domains. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the last remaining connected organization. Note: requests to this resource will fail if there is more than one connected organization in the federation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationapp. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication deleteFederationApp [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for deleteFederationApp - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-deleteFederationApp-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-deleteFederationSetting.txt b/docs/command/atlas-api-federatedAuthentication-deleteFederationSetting.txt new file mode 100644 index 0000000000..5afe4d5f55 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-deleteFederationSetting.txt @@ -0,0 +1,88 @@ +.. _atlas-api-federatedAuthentication-deleteFederationSetting: + +========================================================= +atlas api federatedAuthentication deleteFederationSetting +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes the federation settings instance and all associated data, including identity providers and domains. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the last remaining connected organization. Note: requests to this resource will fail if there is more than one connected organization in the federation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationsetting. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication deleteFederationSetting [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for deleteFederationSetting + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-deleteFederationSetting-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping.txt b/docs/command/atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping.txt new file mode 100644 index 0000000000..6c4ac3e532 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping.txt @@ -0,0 +1,100 @@ +.. _atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping: + +====================================================================================== +atlas api federatedAuthentication deleteFederationSettingConnectedOrgConfigRoleMapping +====================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one role mapping in the specified organization from the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationsettingconnectedorgconfigrolemapping. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication deleteFederationSettingConnectedOrgConfigRoleMapping [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for deleteFederationSettingConnectedOrgConfigRoleMapping + * - --id + - string + - true + - Unique 24-hexadecimal digit string that identifies the role mapping that you want to remove. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider.txt new file mode 100644 index 0000000000..6f868ceab7 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider.txt @@ -0,0 +1,99 @@ +.. _atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider: + +========================================================================= +atlas api federatedAuthentication deleteFederationSettingIdentityProvider +========================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes one identity provider in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + + +Note: Requests to this resource will fail if the identity provider has any connected organizations. Before deleting an identity provider, disconnect all organizations and confirm that no organization in your account uses this identity provider. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationsettingidentityprovider. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication deleteFederationSettingIdentityProvider [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for deleteFederationSettingIdentityProvider + * - --identityProviderId + - string + - true + - Unique 24-hexadecimal digit string that identifies the identity provider to connect. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-deleteIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-deleteIdentityProvider.txt deleted file mode 100644 index 672abe6d2f..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-deleteIdentityProvider.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-federatedAuthentication-deleteIdentityProvider: - -======================================================== -atlas api federatedAuthentication deleteIdentityProvider -======================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes one identity provider in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - - -Note: Requests to this resource will fail if the identity provider has any connected organizations. Before deleting an identity provider, disconnect all organizations and confirm that no organization in your account uses this identity provider. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteidentityprovider. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication deleteIdentityProvider [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for deleteIdentityProvider - * - --identityProviderId - - string - - true - - Unique 24-hexadecimal digit string that identifies the identity provider to connect. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-deleteIdentityProvider-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-deleteRoleMapping.txt b/docs/command/atlas-api-federatedAuthentication-deleteRoleMapping.txt deleted file mode 100644 index b310b65f50..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-deleteRoleMapping.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-federatedAuthentication-deleteRoleMapping: - -=================================================== -atlas api federatedAuthentication deleteRoleMapping -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one role mapping in the specified organization from the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleterolemapping. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication deleteRoleMapping [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for deleteRoleMapping - * - --id - - string - - true - - Unique 24-hexadecimal digit string that identifies the role mapping that you want to remove. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-deleteRoleMapping-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getConnectedOrgConfig.txt b/docs/command/atlas-api-federatedAuthentication-getConnectedOrgConfig.txt deleted file mode 100644 index 2aee3a4c3b..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-getConnectedOrgConfig.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-federatedAuthentication-getConnectedOrgConfig: - -======================================================= -atlas api federatedAuthentication getConnectedOrgConfig -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the specified connected org config from the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getconnectedorgconfig. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication getConnectedOrgConfig [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for getConnectedOrgConfig - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the connected organization configuration to return. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getConnectedOrgConfig-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig.txt b/docs/command/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig.txt new file mode 100644 index 0000000000..5904d3b6b3 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig.txt @@ -0,0 +1,96 @@ +.. _atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig: + +======================================================================== +atlas api federatedAuthentication getFederationSettingConnectedOrgConfig +======================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the specified connected org config from the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettingconnectedorgconfig. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication getFederationSettingConnectedOrgConfig [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for getFederationSettingConnectedOrgConfig + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the connected organization configuration to return. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping.txt b/docs/command/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping.txt new file mode 100644 index 0000000000..1ceab13e37 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping.txt @@ -0,0 +1,100 @@ +.. _atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping: + +=================================================================================== +atlas api federatedAuthentication getFederationSettingConnectedOrgConfigRoleMapping +=================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one role mapping from the specified organization in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettingconnectedorgconfigrolemapping. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication getFederationSettingConnectedOrgConfigRoleMapping [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for getFederationSettingConnectedOrgConfigRoleMapping + * - --id + - string + - true + - Unique 24-hexadecimal digit string that identifies the role mapping that you want to return. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getFederationSettingIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-getFederationSettingIdentityProvider.txt new file mode 100644 index 0000000000..1313468cb1 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-getFederationSettingIdentityProvider.txt @@ -0,0 +1,96 @@ +.. _atlas-api-federatedAuthentication-getFederationSettingIdentityProvider: + +====================================================================== +atlas api federatedAuthentication getFederationSettingIdentityProvider +====================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one identity provider in the specified federation by the identity provider's id. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettingidentityprovider. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication getFederationSettingIdentityProvider [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for getFederationSettingIdentityProvider + * - --identityProviderId + - string + - true + - Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getFederationSettingIdentityProvider-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata.txt b/docs/command/atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata.txt new file mode 100644 index 0000000000..bf075133cc --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata.txt @@ -0,0 +1,92 @@ +.. _atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata: + +============================================================================== +atlas api federatedAuthentication getFederationSettingIdentityProviderMetadata +============================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the metadata of one identity provider in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettingidentityprovidermetadata. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication getFederationSettingIdentityProviderMetadata [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for getFederationSettingIdentityProviderMetadata + * - --identityProviderId + - string + - true + - Legacy 20-hexadecimal digit string that identifies the identity provider. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getFederationSettings.txt b/docs/command/atlas-api-federatedAuthentication-getFederationSettings.txt deleted file mode 100644 index c052eef5d9..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-getFederationSettings.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-federatedAuthentication-getFederationSettings: - -======================================================= -atlas api federatedAuthentication getFederationSettings -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns information about the federation settings for the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication getFederationSettings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getFederationSettings - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getFederationSettings-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-getIdentityProvider.txt deleted file mode 100644 index bb6ae01a6c..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-getIdentityProvider.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-federatedAuthentication-getIdentityProvider: - -===================================================== -atlas api federatedAuthentication getIdentityProvider -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one identity provider in the specified federation by the identity provider's id. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getidentityprovider. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication getIdentityProvider [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for getIdentityProvider - * - --identityProviderId - - string - - true - - Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getIdentityProvider-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getIdentityProviderMetadata.txt b/docs/command/atlas-api-federatedAuthentication-getIdentityProviderMetadata.txt deleted file mode 100644 index 327dff2a99..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-getIdentityProviderMetadata.txt +++ /dev/null @@ -1,92 +0,0 @@ -.. _atlas-api-federatedAuthentication-getIdentityProviderMetadata: - -============================================================= -atlas api federatedAuthentication getIdentityProviderMetadata -============================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the metadata of one identity provider in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getidentityprovidermetadata. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication getIdentityProviderMetadata [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for getIdentityProviderMetadata - * - --identityProviderId - - string - - true - - Legacy 20-hexadecimal digit string that identifies the identity provider. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getIdentityProviderMetadata-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getOrgFederationSettings.txt b/docs/command/atlas-api-federatedAuthentication-getOrgFederationSettings.txt new file mode 100644 index 0000000000..f8a6ed0539 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-getOrgFederationSettings.txt @@ -0,0 +1,96 @@ +.. _atlas-api-federatedAuthentication-getOrgFederationSettings: + +========================================================== +atlas api federatedAuthentication getOrgFederationSettings +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns information about the federation settings for the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgfederationsettings. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication getOrgFederationSettings [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgFederationSettings + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getOrgFederationSettings-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-getRoleMapping.txt b/docs/command/atlas-api-federatedAuthentication-getRoleMapping.txt deleted file mode 100644 index 85736bc33f..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-getRoleMapping.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-federatedAuthentication-getRoleMapping: - -================================================ -atlas api federatedAuthentication getRoleMapping -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one role mapping from the specified organization in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getrolemapping. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication getRoleMapping [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for getRoleMapping - * - --id - - string - - true - - Unique 24-hexadecimal digit string that identifies the role mapping that you want to return. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-getRoleMapping-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-listConnectedOrgConfigs.txt b/docs/command/atlas-api-federatedAuthentication-listConnectedOrgConfigs.txt deleted file mode 100644 index 1d67d4e252..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-listConnectedOrgConfigs.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-federatedAuthentication-listConnectedOrgConfigs: - -========================================================= -atlas api federatedAuthentication listConnectedOrgConfigs -========================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all connected org configs in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected orgs. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listconnectedorgconfigs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication listConnectedOrgConfigs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for listConnectedOrgConfigs - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-listConnectedOrgConfigs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings.txt b/docs/command/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings.txt new file mode 100644 index 0000000000..107cd15599 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings.txt @@ -0,0 +1,96 @@ +.. _atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings: + +===================================================================================== +atlas api federatedAuthentication listFederationSettingConnectedOrgConfigRoleMappings +===================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all role mappings from the specified organization in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederationsettingconnectedorgconfigrolemappings. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication listFederationSettingConnectedOrgConfigRoleMappings [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for listFederationSettingConnectedOrgConfigRoleMappings + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs.txt b/docs/command/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs.txt new file mode 100644 index 0000000000..111e2227f2 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs.txt @@ -0,0 +1,100 @@ +.. _atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs: + +========================================================================== +atlas api federatedAuthentication listFederationSettingConnectedOrgConfigs +========================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all connected org configs in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected orgs. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederationsettingconnectedorgconfigs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication listFederationSettingConnectedOrgConfigs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for listFederationSettingConnectedOrgConfigs + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-listFederationSettingIdentityProviders.txt b/docs/command/atlas-api-federatedAuthentication-listFederationSettingIdentityProviders.txt new file mode 100644 index 0000000000..5805d7f699 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-listFederationSettingIdentityProviders.txt @@ -0,0 +1,108 @@ +.. _atlas-api-federatedAuthentication-listFederationSettingIdentityProviders: + +======================================================================== +atlas api federatedAuthentication listFederationSettingIdentityProviders +======================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all identity providers with the provided protocol and type in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If no protocol is specified, only SAML identity providers will be returned. If no idpType is specified, only WORKFORCE identity providers will be returned. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederationsettingidentityproviders. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication listFederationSettingIdentityProviders [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for listFederationSettingIdentityProviders + * - --idpType + - stringArray + - false + - The types of the target identity providers. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --protocol + - stringArray + - false + - The protocols of the target identity providers. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-listFederationSettingIdentityProviders-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-listIdentityProviders.txt b/docs/command/atlas-api-federatedAuthentication-listIdentityProviders.txt deleted file mode 100644 index 345a92a0d7..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-listIdentityProviders.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-federatedAuthentication-listIdentityProviders: - -======================================================= -atlas api federatedAuthentication listIdentityProviders -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all identity providers with the provided protocol and type in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If no protocol is specified, only SAML identity providers will be returned. If no idpType is specified, only WORKFORCE identity providers will be returned. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listidentityproviders. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication listIdentityProviders [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for listIdentityProviders - * - --idpType - - stringArray - - false - - The types of the target identity providers. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --protocol - - stringArray - - false - - The protocols of the target identity providers. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-listIdentityProviders-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-listRoleMappings.txt b/docs/command/atlas-api-federatedAuthentication-listRoleMappings.txt deleted file mode 100644 index 847183dc6a..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-listRoleMappings.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-federatedAuthentication-listRoleMappings: - -================================================== -atlas api federatedAuthentication listRoleMappings -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all role mappings from the specified organization in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listrolemappings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication listRoleMappings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for listRoleMappings - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-listRoleMappings-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-removeConnectedOrgConfig.txt b/docs/command/atlas-api-federatedAuthentication-removeConnectedOrgConfig.txt deleted file mode 100644 index 02e75700bb..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-removeConnectedOrgConfig.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-federatedAuthentication-removeConnectedOrgConfig: - -========================================================== -atlas api federatedAuthentication removeConnectedOrgConfig -========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one connected organization configuration from the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This request fails if only one connected organization exists in the federation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeconnectedorgconfig. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication removeConnectedOrgConfig [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for removeConnectedOrgConfig - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the connected organization configuration to remove. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-removeConnectedOrgConfig-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig.txt b/docs/command/atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig.txt new file mode 100644 index 0000000000..504bc2ed11 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig.txt @@ -0,0 +1,96 @@ +.. _atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig: + +=========================================================================== +atlas api federatedAuthentication removeFederationSettingConnectedOrgConfig +=========================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one connected organization configuration from the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This request fails if only one connected organization exists in the federation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removefederationsettingconnectedorgconfig. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication removeFederationSettingConnectedOrgConfig [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for removeFederationSettingConnectedOrgConfig + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the connected organization configuration to remove. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks.txt b/docs/command/atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks.txt new file mode 100644 index 0000000000..1d4ce3c485 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks.txt @@ -0,0 +1,99 @@ +.. _atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks: + +============================================================================= +atlas api federatedAuthentication revokeFederationSettingIdentityProviderJwks +============================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Revokes the JWKS tokens from the requested OIDC identity provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + + +Note: Revoking your JWKS tokens immediately refreshes your IdP public keys from all your Atlas clusters, invalidating previously signed access tokens and logging out all users. You may need to restart your MongoDB clients. All organizations connected to the identity provider will be affected. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokefederationsettingidentityproviderjwks. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication revokeFederationSettingIdentityProviderJwks [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - -h, --help + - + - false + - help for revokeFederationSettingIdentityProviderJwks + * - --identityProviderId + - string + - true + - Unique 24-hexadecimal digit string that identifies the identity provider to connect. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks-2023-11-15-default.sh + :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider.txt deleted file mode 100644 index 4c92f428a4..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider: - -================================================================ -atlas api federatedAuthentication revokeJwksFromIdentityProvider -================================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Revokes the JWKS tokens from the requested OIDC identity provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - - -Note: Revoking your JWKS tokens immediately refreshes your IdP public keys from all your Atlas clusters, invalidating previously signed access tokens and logging out all users. You may need to restart your MongoDB clients. All organizations connected to the identity provider will be affected. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokejwksfromidentityprovider. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication revokeJwksFromIdentityProvider [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - -h, --help - - - - false - - help for revokeJwksFromIdentityProvider - * - --identityProviderId - - string - - true - - Unique 24-hexadecimal digit string that identifies the identity provider to connect. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider-2023-11-15-default.sh - :language: shell diff --git a/docs/command/atlas-api-federatedAuthentication-updateConnectedOrgConfig.txt b/docs/command/atlas-api-federatedAuthentication-updateConnectedOrgConfig.txt deleted file mode 100644 index 8c8bd42f72..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-updateConnectedOrgConfig.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-federatedAuthentication-updateConnectedOrgConfig: - -========================================================== -atlas api federatedAuthentication updateConnectedOrgConfig -========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one connected organization configuration from the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note If the organization configuration has no associated identity provider, you can't use this resource to update role mappings or post authorization role grants. - - -Note: The domainRestrictionEnabled field defaults to false if not provided in the request. - - -Note: If the identityProviderId field is not provided, you will disconnect the organization and the identity provider. - - -Note: Currently connected data access identity providers missing from the dataAccessIdentityProviderIds field will be disconnected. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateconnectedorgconfig. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication updateConnectedOrgConfig [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateConnectedOrgConfig - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the connected organization configuration to update. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfig.txt b/docs/command/atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfig.txt new file mode 100644 index 0000000000..6994804fd2 --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfig.txt @@ -0,0 +1,107 @@ +.. _atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfig: + +=========================================================================== +atlas api federatedAuthentication updateFederationSettingConnectedOrgConfig +=========================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one connected organization configuration from the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note If the organization configuration has no associated identity provider, you can't use this resource to update role mappings or post authorization role grants. + + +Note: The domainRestrictionEnabled field defaults to false if not provided in the request. + + +Note: If the identityProviderId field is not provided, you will disconnect the organization and the identity provider. + + +Note: Currently connected data access identity providers missing from the dataAccessIdentityProviderIds field will be disconnected. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederationsettingconnectedorgconfig. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication updateFederationSettingConnectedOrgConfig [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateFederationSettingConnectedOrgConfig + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the connected organization configuration to update. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfigRoleMapping.txt b/docs/command/atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfigRoleMapping.txt new file mode 100644 index 0000000000..38989923ce --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfigRoleMapping.txt @@ -0,0 +1,99 @@ +.. _atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfigRoleMapping: + +====================================================================================== +atlas api federatedAuthentication updateFederationSettingConnectedOrgConfigRoleMapping +====================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one role mapping in the specified organization in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederationsettingconnectedorgconfigrolemapping. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication updateFederationSettingConnectedOrgConfigRoleMapping [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateFederationSettingConnectedOrgConfigRoleMapping + * - --id + - string + - true + - Unique 24-hexadecimal digit string that identifies the role mapping that you want to update. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-federatedAuthentication-updateFederationSettingIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-updateFederationSettingIdentityProvider.txt new file mode 100644 index 0000000000..ffbdf62c2d --- /dev/null +++ b/docs/command/atlas-api-federatedAuthentication-updateFederationSettingIdentityProvider.txt @@ -0,0 +1,98 @@ +.. _atlas-api-federatedAuthentication-updateFederationSettingIdentityProvider: + +========================================================================= +atlas api federatedAuthentication updateFederationSettingIdentityProvider +========================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one identity provider in the specified federation. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + + +Note: Changing authorization types and/or updating authorization claims can prevent current users and/or groups from accessing the database. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederationsettingidentityprovider. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api federatedAuthentication updateFederationSettingIdentityProvider [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --federationSettingsId + - string + - true + - Unique 24-hexadecimal digit string that identifies your federation. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateFederationSettingIdentityProvider + * - --identityProviderId + - string + - true + - Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-federatedAuthentication-updateIdentityProvider.txt b/docs/command/atlas-api-federatedAuthentication-updateIdentityProvider.txt deleted file mode 100644 index 0c37d319be..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-updateIdentityProvider.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-federatedAuthentication-updateIdentityProvider: - -======================================================== -atlas api federatedAuthentication updateIdentityProvider -======================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one identity provider in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - - -Note: Changing authorization types and/or updating authorization claims can prevent current users and/or groups from accessing the database. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateidentityprovider. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication updateIdentityProvider [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateIdentityProvider - * - --identityProviderId - - string - - true - - Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-federatedAuthentication-updateRoleMapping.txt b/docs/command/atlas-api-federatedAuthentication-updateRoleMapping.txt deleted file mode 100644 index f6cbdf0492..0000000000 --- a/docs/command/atlas-api-federatedAuthentication-updateRoleMapping.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-federatedAuthentication-updateRoleMapping: - -=================================================== -atlas api federatedAuthentication updateRoleMapping -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one role mapping in the specified organization in the specified federation. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updaterolemapping. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api federatedAuthentication updateRoleMapping [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --federationSettingsId - - string - - true - - Unique 24-hexadecimal digit string that identifies your federation. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateRoleMapping - * - --id - - string - - true - - Unique 24-hexadecimal digit string that identifies the role mapping that you want to update. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-federatedAuthentication.txt b/docs/command/atlas-api-federatedAuthentication.txt index 641db9b072..22cf733c62 100644 --- a/docs/command/atlas-api-federatedAuthentication.txt +++ b/docs/command/atlas-api-federatedAuthentication.txt @@ -54,45 +54,45 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-federatedAuthentication-createIdentityProvider` - `Public Preview: please provide feedback `_: Creates one identity provider within the specified federation. -* :ref:`atlas-api-federatedAuthentication-createRoleMapping` - `Public Preview: please provide feedback `_: Adds one role mapping to the specified organization in the specified federation. -* :ref:`atlas-api-federatedAuthentication-deleteFederationApp` - `Public Preview: please provide feedback `_: Deletes the federation settings instance and all associated data, including identity providers and domains. -* :ref:`atlas-api-federatedAuthentication-deleteIdentityProvider` - `Public Preview: please provide feedback `_: Deletes one identity provider in the specified federation. -* :ref:`atlas-api-federatedAuthentication-deleteRoleMapping` - `Public Preview: please provide feedback `_: Removes one role mapping in the specified organization from the specified federation. -* :ref:`atlas-api-federatedAuthentication-getConnectedOrgConfig` - `Public Preview: please provide feedback `_: Returns the specified connected org config from the specified federation. -* :ref:`atlas-api-federatedAuthentication-getFederationSettings` - `Public Preview: please provide feedback `_: Returns information about the federation settings for the specified organization. -* :ref:`atlas-api-federatedAuthentication-getIdentityProvider` - `Public Preview: please provide feedback `_: Returns one identity provider in the specified federation by the identity provider's id. -* :ref:`atlas-api-federatedAuthentication-getIdentityProviderMetadata` - `Public Preview: please provide feedback `_: Returns the metadata of one identity provider in the specified federation. -* :ref:`atlas-api-federatedAuthentication-getRoleMapping` - `Public Preview: please provide feedback `_: Returns one role mapping from the specified organization in the specified federation. -* :ref:`atlas-api-federatedAuthentication-listConnectedOrgConfigs` - `Public Preview: please provide feedback `_: Returns all connected org configs in the specified federation. -* :ref:`atlas-api-federatedAuthentication-listIdentityProviders` - `Public Preview: please provide feedback `_: Returns all identity providers with the provided protocol and type in the specified federation. -* :ref:`atlas-api-federatedAuthentication-listRoleMappings` - `Public Preview: please provide feedback `_: Returns all role mappings from the specified organization in the specified federation. -* :ref:`atlas-api-federatedAuthentication-removeConnectedOrgConfig` - `Public Preview: please provide feedback `_: Removes one connected organization configuration from the specified federation. -* :ref:`atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider` - `Public Preview: please provide feedback `_: Revokes the JWKS tokens from the requested OIDC identity provider. -* :ref:`atlas-api-federatedAuthentication-updateConnectedOrgConfig` - `Public Preview: please provide feedback `_: Updates one connected organization configuration from the specified federation. -* :ref:`atlas-api-federatedAuthentication-updateIdentityProvider` - `Public Preview: please provide feedback `_: Updates one identity provider in the specified federation. -* :ref:`atlas-api-federatedAuthentication-updateRoleMapping` - `Public Preview: please provide feedback `_: Updates one role mapping in the specified organization in the specified federation. +* :ref:`atlas-api-federatedAuthentication-createFederationSettingConnectedOrgConfigRoleMapping` - `Public Preview: please provide feedback `_: Adds one role mapping to the specified organization in the specified federation. +* :ref:`atlas-api-federatedAuthentication-createFederationSettingIdentityProvider` - `Public Preview: please provide feedback `_: Creates one identity provider within the specified federation. +* :ref:`atlas-api-federatedAuthentication-deleteFederationSetting` - `Public Preview: please provide feedback `_: Deletes the federation settings instance and all associated data, including identity providers and domains. +* :ref:`atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping` - `Public Preview: please provide feedback `_: Removes one role mapping in the specified organization from the specified federation. +* :ref:`atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider` - `Public Preview: please provide feedback `_: Deletes one identity provider in the specified federation. +* :ref:`atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig` - `Public Preview: please provide feedback `_: Returns the specified connected org config from the specified federation. +* :ref:`atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping` - `Public Preview: please provide feedback `_: Returns one role mapping from the specified organization in the specified federation. +* :ref:`atlas-api-federatedAuthentication-getFederationSettingIdentityProvider` - `Public Preview: please provide feedback `_: Returns one identity provider in the specified federation by the identity provider's id. +* :ref:`atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata` - `Public Preview: please provide feedback `_: Returns the metadata of one identity provider in the specified federation. +* :ref:`atlas-api-federatedAuthentication-getOrgFederationSettings` - `Public Preview: please provide feedback `_: Returns information about the federation settings for the specified organization. +* :ref:`atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings` - `Public Preview: please provide feedback `_: Returns all role mappings from the specified organization in the specified federation. +* :ref:`atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs` - `Public Preview: please provide feedback `_: Returns all connected org configs in the specified federation. +* :ref:`atlas-api-federatedAuthentication-listFederationSettingIdentityProviders` - `Public Preview: please provide feedback `_: Returns all identity providers with the provided protocol and type in the specified federation. +* :ref:`atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig` - `Public Preview: please provide feedback `_: Removes one connected organization configuration from the specified federation. +* :ref:`atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks` - `Public Preview: please provide feedback `_: Revokes the JWKS tokens from the requested OIDC identity provider. +* :ref:`atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfig` - `Public Preview: please provide feedback `_: Updates one connected organization configuration from the specified federation. +* :ref:`atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfigRoleMapping` - `Public Preview: please provide feedback `_: Updates one role mapping in the specified organization in the specified federation. +* :ref:`atlas-api-federatedAuthentication-updateFederationSettingIdentityProvider` - `Public Preview: please provide feedback `_: Updates one identity provider in the specified federation. .. toctree:: :titlesonly: - createIdentityProvider - createRoleMapping - deleteFederationApp - deleteIdentityProvider - deleteRoleMapping - getConnectedOrgConfig - getFederationSettings - getIdentityProvider - getIdentityProviderMetadata - getRoleMapping - listConnectedOrgConfigs - listIdentityProviders - listRoleMappings - removeConnectedOrgConfig - revokeJwksFromIdentityProvider - updateConnectedOrgConfig - updateIdentityProvider - updateRoleMapping + createFederationSettingConnectedOrgConfigRoleMapping + createFederationSettingIdentityProvider + deleteFederationSetting + deleteFederationSettingConnectedOrgConfigRoleMapping + deleteFederationSettingIdentityProvider + getFederationSettingConnectedOrgConfig + getFederationSettingConnectedOrgConfigRoleMapping + getFederationSettingIdentityProvider + getFederationSettingIdentityProviderMetadata + getOrgFederationSettings + listFederationSettingConnectedOrgConfigRoleMappings + listFederationSettingConnectedOrgConfigs + listFederationSettingIdentityProviders + removeFederationSettingConnectedOrgConfig + revokeFederationSettingIdentityProviderJwks + updateFederationSettingConnectedOrgConfig + updateFederationSettingConnectedOrgConfigRoleMapping + updateFederationSettingIdentityProvider diff --git a/docs/command/atlas-api-flexClusters-createFlexCluster.txt b/docs/command/atlas-api-flexClusters-createFlexCluster.txt deleted file mode 100644 index 6230433631..0000000000 --- a/docs/command/atlas-api-flexClusters-createFlexCluster.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-flexClusters-createFlexCluster: - -======================================== -atlas api flexClusters createFlexCluster -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one flex cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createflexcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexClusters createFlexCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createFlexCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - * - -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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-flexClusters-createGroupFlexCluster.txt b/docs/command/atlas-api-flexClusters-createGroupFlexCluster.txt new file mode 100644 index 0000000000..f55c86fa5d --- /dev/null +++ b/docs/command/atlas-api-flexClusters-createGroupFlexCluster.txt @@ -0,0 +1,105 @@ +.. _atlas-api-flexClusters-createGroupFlexCluster: + +============================================= +atlas api flexClusters createGroupFlexCluster +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one flex cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupflexcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexClusters createGroupFlexCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupFlexCluster + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + * - -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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-flexClusters-deleteFlexCluster.txt b/docs/command/atlas-api-flexClusters-deleteFlexCluster.txt deleted file mode 100644 index bf8d6fedd4..0000000000 --- a/docs/command/atlas-api-flexClusters-deleteFlexCluster.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-flexClusters-deleteFlexCluster: - -======================================== -atlas api flexClusters deleteFlexCluster -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one flex cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The flex cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteflexcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexClusters deleteFlexCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteFlexCluster - * - --name - - string - - true - - Human-readable label that identifies the flex cluster. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - * - -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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-flexClusters-deleteFlexCluster-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-flexClusters-deleteGroupFlexCluster.txt b/docs/command/atlas-api-flexClusters-deleteGroupFlexCluster.txt new file mode 100644 index 0000000000..c18726aaab --- /dev/null +++ b/docs/command/atlas-api-flexClusters-deleteGroupFlexCluster.txt @@ -0,0 +1,110 @@ +.. _atlas-api-flexClusters-deleteGroupFlexCluster: + +============================================= +atlas api flexClusters deleteGroupFlexCluster +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one flex cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The flex cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupflexcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexClusters deleteGroupFlexCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupFlexCluster + * - --name + - string + - true + - Human-readable label that identifies the flex cluster. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + * - -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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-flexClusters-deleteGroupFlexCluster-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-flexClusters-getFlexCluster.txt b/docs/command/atlas-api-flexClusters-getFlexCluster.txt deleted file mode 100644 index f0001be21e..0000000000 --- a/docs/command/atlas-api-flexClusters-getFlexCluster.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-flexClusters-getFlexCluster: - -===================================== -atlas api flexClusters getFlexCluster -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details for one flex cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexClusters getFlexCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getFlexCluster - * - --name - - string - - true - - Human-readable label that identifies the flex cluster. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-flexClusters-getFlexCluster-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-flexClusters-getGroupFlexCluster.txt b/docs/command/atlas-api-flexClusters-getGroupFlexCluster.txt new file mode 100644 index 0000000000..afc01a91ad --- /dev/null +++ b/docs/command/atlas-api-flexClusters-getGroupFlexCluster.txt @@ -0,0 +1,102 @@ +.. _atlas-api-flexClusters-getGroupFlexCluster: + +========================================== +atlas api flexClusters getGroupFlexCluster +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details for one flex cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupflexcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexClusters getGroupFlexCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupFlexCluster + * - --name + - string + - true + - Human-readable label that identifies the flex cluster. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-flexClusters-getGroupFlexCluster-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-flexClusters-listFlexClusters.txt b/docs/command/atlas-api-flexClusters-listFlexClusters.txt deleted file mode 100644 index 4b96e02398..0000000000 --- a/docs/command/atlas-api-flexClusters-listFlexClusters.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-flexClusters-listFlexClusters: - -======================================= -atlas api flexClusters listFlexClusters -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details for all flex clusters in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexclusters. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexClusters listFlexClusters [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listFlexClusters - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-flexClusters-listFlexClusters-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-flexClusters-listGroupFlexClusters.txt b/docs/command/atlas-api-flexClusters-listGroupFlexClusters.txt new file mode 100644 index 0000000000..6fd33954dc --- /dev/null +++ b/docs/command/atlas-api-flexClusters-listGroupFlexClusters.txt @@ -0,0 +1,110 @@ +.. _atlas-api-flexClusters-listGroupFlexClusters: + +============================================ +atlas api flexClusters listGroupFlexClusters +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details for all flex clusters in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupflexclusters. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexClusters listGroupFlexClusters [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupFlexClusters + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-flexClusters-listGroupFlexClusters-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-flexClusters-tenantGroupFlexClusterUpgrade.txt b/docs/command/atlas-api-flexClusters-tenantGroupFlexClusterUpgrade.txt new file mode 100644 index 0000000000..a9c08dc0a6 --- /dev/null +++ b/docs/command/atlas-api-flexClusters-tenantGroupFlexClusterUpgrade.txt @@ -0,0 +1,97 @@ +.. _atlas-api-flexClusters-tenantGroupFlexClusterUpgrade: + +==================================================== +atlas api flexClusters tenantGroupFlexClusterUpgrade +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-tenantgroupflexclusterupgrade. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexClusters tenantGroupFlexClusterUpgrade [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for tenantGroupFlexClusterUpgrade + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-flexClusters-updateFlexCluster.txt b/docs/command/atlas-api-flexClusters-updateFlexCluster.txt deleted file mode 100644 index 0389fa29a3..0000000000 --- a/docs/command/atlas-api-flexClusters-updateFlexCluster.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-flexClusters-updateFlexCluster: - -======================================== -atlas api flexClusters updateFlexCluster -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one flex cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateflexcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexClusters updateFlexCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateFlexCluster - * - --name - - string - - true - - Human-readable label that identifies the flex cluster. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - * - -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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-flexClusters-updateGroupFlexCluster.txt b/docs/command/atlas-api-flexClusters-updateGroupFlexCluster.txt new file mode 100644 index 0000000000..dde9753b92 --- /dev/null +++ b/docs/command/atlas-api-flexClusters-updateGroupFlexCluster.txt @@ -0,0 +1,109 @@ +.. _atlas-api-flexClusters-updateGroupFlexCluster: + +============================================= +atlas api flexClusters updateGroupFlexCluster +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one flex cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupflexcluster. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexClusters updateGroupFlexCluster [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupFlexCluster + * - --name + - string + - true + - Human-readable label that identifies the flex cluster. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + * - -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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-flexClusters-upgradeFlexCluster.txt b/docs/command/atlas-api-flexClusters-upgradeFlexCluster.txt deleted file mode 100644 index fc0d58a06d..0000000000 --- a/docs/command/atlas-api-flexClusters-upgradeFlexCluster.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-flexClusters-upgradeFlexCluster: - -========================================= -atlas api flexClusters upgradeFlexCluster -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-upgradeflexcluster. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexClusters upgradeFlexCluster [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for upgradeFlexCluster - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-flexClusters.txt b/docs/command/atlas-api-flexClusters.txt index 3df453a573..fba9c7d4d4 100644 --- a/docs/command/atlas-api-flexClusters.txt +++ b/docs/command/atlas-api-flexClusters.txt @@ -54,21 +54,21 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-flexClusters-createFlexCluster` - `Public Preview: please provide feedback `_: Creates one flex cluster in the specified project. -* :ref:`atlas-api-flexClusters-deleteFlexCluster` - `Public Preview: please provide feedback `_: Removes one flex cluster from the specified project. -* :ref:`atlas-api-flexClusters-getFlexCluster` - `Public Preview: please provide feedback `_: Returns details for one flex cluster in the specified project. -* :ref:`atlas-api-flexClusters-listFlexClusters` - `Public Preview: please provide feedback `_: Returns details for all flex clusters in the specified project. -* :ref:`atlas-api-flexClusters-updateFlexCluster` - `Public Preview: please provide feedback `_: Updates one flex cluster in the specified project. -* :ref:`atlas-api-flexClusters-upgradeFlexCluster` - `Public Preview: please provide feedback `_: Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. +* :ref:`atlas-api-flexClusters-createGroupFlexCluster` - `Public Preview: please provide feedback `_: Creates one flex cluster in the specified project. +* :ref:`atlas-api-flexClusters-deleteGroupFlexCluster` - `Public Preview: please provide feedback `_: Removes one flex cluster from the specified project. +* :ref:`atlas-api-flexClusters-getGroupFlexCluster` - `Public Preview: please provide feedback `_: Returns details for one flex cluster in the specified project. +* :ref:`atlas-api-flexClusters-listGroupFlexClusters` - `Public Preview: please provide feedback `_: Returns details for all flex clusters in the specified project. +* :ref:`atlas-api-flexClusters-tenantGroupFlexClusterUpgrade` - `Public Preview: please provide feedback `_: Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. +* :ref:`atlas-api-flexClusters-updateGroupFlexCluster` - `Public Preview: please provide feedback `_: Updates one flex cluster in the specified project. .. toctree:: :titlesonly: - createFlexCluster - deleteFlexCluster - getFlexCluster - listFlexClusters - updateFlexCluster - upgradeFlexCluster + createGroupFlexCluster + deleteGroupFlexCluster + getGroupFlexCluster + listGroupFlexClusters + tenantGroupFlexClusterUpgrade + updateGroupFlexCluster diff --git a/docs/command/atlas-api-flexRestoreJobs-createFlexBackupRestoreJob.txt b/docs/command/atlas-api-flexRestoreJobs-createFlexBackupRestoreJob.txt deleted file mode 100644 index 740f1ad825..0000000000 --- a/docs/command/atlas-api-flexRestoreJobs-createFlexBackupRestoreJob.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-flexRestoreJobs-createFlexBackupRestoreJob: - -==================================================== -atlas api flexRestoreJobs createFlexBackupRestoreJob -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Restores one snapshot of one flex cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createflexbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexRestoreJobs createFlexBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createFlexBackupRestoreJob - * - --name - - string - - true - - Human-readable label that identifies the flex cluster whose snapshot you want to restore. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - * - -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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-flexRestoreJobs-createGroupFlexClusterBackupRestoreJob.txt b/docs/command/atlas-api-flexRestoreJobs-createGroupFlexClusterBackupRestoreJob.txt new file mode 100644 index 0000000000..3e9e3e79f2 --- /dev/null +++ b/docs/command/atlas-api-flexRestoreJobs-createGroupFlexClusterBackupRestoreJob.txt @@ -0,0 +1,109 @@ +.. _atlas-api-flexRestoreJobs-createGroupFlexClusterBackupRestoreJob: + +================================================================ +atlas api flexRestoreJobs createGroupFlexClusterBackupRestoreJob +================================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Restores one snapshot of one flex cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupflexclusterbackuprestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexRestoreJobs createGroupFlexClusterBackupRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupFlexClusterBackupRestoreJob + * - --name + - string + - true + - Human-readable label that identifies the flex cluster whose snapshot you want to restore. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + * - -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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-flexRestoreJobs-getFlexBackupRestoreJob.txt b/docs/command/atlas-api-flexRestoreJobs-getFlexBackupRestoreJob.txt deleted file mode 100644 index 6784778286..0000000000 --- a/docs/command/atlas-api-flexRestoreJobs-getFlexBackupRestoreJob.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-flexRestoreJobs-getFlexBackupRestoreJob: - -================================================= -atlas api flexRestoreJobs getFlexBackupRestoreJob -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one restore job for one flex cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexRestoreJobs getFlexBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getFlexBackupRestoreJob - * - --name - - string - - true - - Human-readable label that identifies the flex cluster. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --restoreJobId - - string - - true - - Unique 24-hexadecimal digit string that identifies the restore job to return. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-flexRestoreJobs-getFlexBackupRestoreJob-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob.txt b/docs/command/atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob.txt new file mode 100644 index 0000000000..192a874cdf --- /dev/null +++ b/docs/command/atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob.txt @@ -0,0 +1,106 @@ +.. _atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob: + +============================================================= +atlas api flexRestoreJobs getGroupFlexClusterBackupRestoreJob +============================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one restore job for one flex cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupflexclusterbackuprestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexRestoreJobs getGroupFlexClusterBackupRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupFlexClusterBackupRestoreJob + * - --name + - string + - true + - Human-readable label that identifies the flex cluster. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --restoreJobId + - string + - true + - Unique 24-hexadecimal digit string that identifies the restore job to return. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs.txt b/docs/command/atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs.txt deleted file mode 100644 index 7f9ef2bc42..0000000000 --- a/docs/command/atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs: - -=================================================== -atlas api flexRestoreJobs listFlexBackupRestoreJobs -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all restore jobs for one flex cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexbackuprestorejobs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexRestoreJobs listFlexBackupRestoreJobs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listFlexBackupRestoreJobs - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --name - - string - - true - - Human-readable label that identifies the flex cluster. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs.txt b/docs/command/atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs.txt new file mode 100644 index 0000000000..fdaf4d1fc7 --- /dev/null +++ b/docs/command/atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs.txt @@ -0,0 +1,114 @@ +.. _atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs: + +=============================================================== +atlas api flexRestoreJobs listGroupFlexClusterBackupRestoreJobs +=============================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all restore jobs for one flex cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupflexclusterbackuprestorejobs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexRestoreJobs listGroupFlexClusterBackupRestoreJobs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupFlexClusterBackupRestoreJobs + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --name + - string + - true + - Human-readable label that identifies the flex cluster. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-flexRestoreJobs.txt b/docs/command/atlas-api-flexRestoreJobs.txt index af1e93c687..3d08e796b4 100644 --- a/docs/command/atlas-api-flexRestoreJobs.txt +++ b/docs/command/atlas-api-flexRestoreJobs.txt @@ -54,15 +54,15 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-flexRestoreJobs-createFlexBackupRestoreJob` - `Public Preview: please provide feedback `_: Restores one snapshot of one flex cluster from the specified project. -* :ref:`atlas-api-flexRestoreJobs-getFlexBackupRestoreJob` - `Public Preview: please provide feedback `_: Returns one restore job for one flex cluster from the specified project. -* :ref:`atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs` - `Public Preview: please provide feedback `_: Returns all restore jobs for one flex cluster from the specified project. +* :ref:`atlas-api-flexRestoreJobs-createGroupFlexClusterBackupRestoreJob` - `Public Preview: please provide feedback `_: Restores one snapshot of one flex cluster from the specified project. +* :ref:`atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob` - `Public Preview: please provide feedback `_: Returns one restore job for one flex cluster from the specified project. +* :ref:`atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs` - `Public Preview: please provide feedback `_: Returns all restore jobs for one flex cluster from the specified project. .. toctree:: :titlesonly: - createFlexBackupRestoreJob - getFlexBackupRestoreJob - listFlexBackupRestoreJobs + createGroupFlexClusterBackupRestoreJob + getGroupFlexClusterBackupRestoreJob + listGroupFlexClusterBackupRestoreJobs diff --git a/docs/command/atlas-api-flexSnapshots-downloadFlexBackup.txt b/docs/command/atlas-api-flexSnapshots-downloadFlexBackup.txt deleted file mode 100644 index 357e8c63e0..0000000000 --- a/docs/command/atlas-api-flexSnapshots-downloadFlexBackup.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-flexSnapshots-downloadFlexBackup: - -========================================== -atlas api flexSnapshots downloadFlexBackup -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Requests one snapshot for the specified flex cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This resource returns a snapshotURL that you can use to download the snapshot. This snapshotURL remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadflexbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexSnapshots downloadFlexBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for downloadFlexBackup - * - --name - - string - - true - - Human-readable label that identifies the flex cluster. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-flexSnapshots-downloadGroupFlexClusterBackup.txt b/docs/command/atlas-api-flexSnapshots-downloadGroupFlexClusterBackup.txt new file mode 100644 index 0000000000..67f084f226 --- /dev/null +++ b/docs/command/atlas-api-flexSnapshots-downloadGroupFlexClusterBackup.txt @@ -0,0 +1,101 @@ +.. _atlas-api-flexSnapshots-downloadGroupFlexClusterBackup: + +====================================================== +atlas api flexSnapshots downloadGroupFlexClusterBackup +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Requests one snapshot for the specified flex cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This resource returns a snapshotURL that you can use to download the snapshot. This snapshotURL remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupflexclusterbackup. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexSnapshots downloadGroupFlexClusterBackup [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for downloadGroupFlexClusterBackup + * - --name + - string + - true + - Human-readable label that identifies the flex cluster. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-flexSnapshots-getFlexBackup.txt b/docs/command/atlas-api-flexSnapshots-getFlexBackup.txt deleted file mode 100644 index a4db3d69b0..0000000000 --- a/docs/command/atlas-api-flexSnapshots-getFlexBackup.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-flexSnapshots-getFlexBackup: - -===================================== -atlas api flexSnapshots getFlexBackup -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one snapshot of one flex cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexSnapshots getFlexBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getFlexBackup - * - --name - - string - - true - - Human-readable label that identifies the flex cluster. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-flexSnapshots-getFlexBackup-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot.txt b/docs/command/atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot.txt new file mode 100644 index 0000000000..49eb1a6073 --- /dev/null +++ b/docs/command/atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot.txt @@ -0,0 +1,102 @@ +.. _atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot: + +========================================================= +atlas api flexSnapshots getGroupFlexClusterBackupSnapshot +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one snapshot of one flex cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupflexclusterbackupsnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexSnapshots getGroupFlexClusterBackupSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupFlexClusterBackupSnapshot + * - --name + - string + - true + - Human-readable label that identifies the flex cluster. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-flexSnapshots-listFlexBackups.txt b/docs/command/atlas-api-flexSnapshots-listFlexBackups.txt deleted file mode 100644 index e66a06c592..0000000000 --- a/docs/command/atlas-api-flexSnapshots-listFlexBackups.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-flexSnapshots-listFlexBackups: - -======================================= -atlas api flexSnapshots listFlexBackups -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all snapshots of one flex cluster from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexbackups. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api flexSnapshots listFlexBackups [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listFlexBackups - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --name - - string - - true - - Human-readable label that identifies the flex cluster. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-flexSnapshots-listFlexBackups-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots.txt b/docs/command/atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots.txt new file mode 100644 index 0000000000..aea4ebfa30 --- /dev/null +++ b/docs/command/atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots.txt @@ -0,0 +1,114 @@ +.. _atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots: + +=========================================================== +atlas api flexSnapshots listGroupFlexClusterBackupSnapshots +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all snapshots of one flex cluster from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupflexclusterbackupsnapshots. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api flexSnapshots listGroupFlexClusterBackupSnapshots [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupFlexClusterBackupSnapshots + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --name + - string + - true + - Human-readable label that identifies the flex cluster. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-flexSnapshots.txt b/docs/command/atlas-api-flexSnapshots.txt index a284c15a44..f4c8c8aabc 100644 --- a/docs/command/atlas-api-flexSnapshots.txt +++ b/docs/command/atlas-api-flexSnapshots.txt @@ -54,15 +54,15 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-flexSnapshots-downloadFlexBackup` - `Public Preview: please provide feedback `_: Requests one snapshot for the specified flex cluster. -* :ref:`atlas-api-flexSnapshots-getFlexBackup` - `Public Preview: please provide feedback `_: Returns one snapshot of one flex cluster from the specified project. -* :ref:`atlas-api-flexSnapshots-listFlexBackups` - `Public Preview: please provide feedback `_: Returns all snapshots of one flex cluster from the specified project. +* :ref:`atlas-api-flexSnapshots-downloadGroupFlexClusterBackup` - `Public Preview: please provide feedback `_: Requests one snapshot for the specified flex cluster. +* :ref:`atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot` - `Public Preview: please provide feedback `_: Returns one snapshot of one flex cluster from the specified project. +* :ref:`atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots` - `Public Preview: please provide feedback `_: Returns all snapshots of one flex cluster from the specified project. .. toctree:: :titlesonly: - downloadFlexBackup - getFlexBackup - listFlexBackups + downloadGroupFlexClusterBackup + getGroupFlexClusterBackupSnapshot + listGroupFlexClusterBackupSnapshots diff --git a/docs/command/atlas-api-globalClusters-createCustomZoneMapping.txt b/docs/command/atlas-api-globalClusters-createCustomZoneMapping.txt deleted file mode 100644 index 678ce58271..0000000000 --- a/docs/command/atlas-api-globalClusters-createCustomZoneMapping.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-globalClusters-createCustomZoneMapping: - -================================================ -atlas api globalClusters createCustomZoneMapping -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one custom zone mapping for the specified global cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcustomzonemapping. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api globalClusters createCustomZoneMapping [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createCustomZoneMapping - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-globalClusters-createGroupClusterGlobalWriteCustomZoneMapping.txt b/docs/command/atlas-api-globalClusters-createGroupClusterGlobalWriteCustomZoneMapping.txt new file mode 100644 index 0000000000..492310f278 --- /dev/null +++ b/docs/command/atlas-api-globalClusters-createGroupClusterGlobalWriteCustomZoneMapping.txt @@ -0,0 +1,101 @@ +.. _atlas-api-globalClusters-createGroupClusterGlobalWriteCustomZoneMapping: + +======================================================================= +atlas api globalClusters createGroupClusterGlobalWriteCustomZoneMapping +======================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one custom zone mapping for the specified global cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterglobalwritecustomzonemapping. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api globalClusters createGroupClusterGlobalWriteCustomZoneMapping [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterGlobalWriteCustomZoneMapping + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-globalClusters-createGroupClusterGlobalWriteManagedNamespace.txt b/docs/command/atlas-api-globalClusters-createGroupClusterGlobalWriteManagedNamespace.txt new file mode 100644 index 0000000000..81fc629058 --- /dev/null +++ b/docs/command/atlas-api-globalClusters-createGroupClusterGlobalWriteManagedNamespace.txt @@ -0,0 +1,101 @@ +.. _atlas-api-globalClusters-createGroupClusterGlobalWriteManagedNamespace: + +====================================================================== +atlas api globalClusters createGroupClusterGlobalWriteManagedNamespace +====================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one managed namespace within the specified global cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterglobalwritemanagednamespace. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api globalClusters createGroupClusterGlobalWriteManagedNamespace [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterGlobalWriteManagedNamespace + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-globalClusters-createManagedNamespace.txt b/docs/command/atlas-api-globalClusters-createManagedNamespace.txt deleted file mode 100644 index 021d545786..0000000000 --- a/docs/command/atlas-api-globalClusters-createManagedNamespace.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-globalClusters-createManagedNamespace: - -=============================================== -atlas api globalClusters createManagedNamespace -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one managed namespace within the specified global cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createmanagednamespace. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api globalClusters createManagedNamespace [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createManagedNamespace - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-globalClusters-deleteAllCustomZoneMappings.txt b/docs/command/atlas-api-globalClusters-deleteAllCustomZoneMappings.txt deleted file mode 100644 index 147ab2a78c..0000000000 --- a/docs/command/atlas-api-globalClusters-deleteAllCustomZoneMappings.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-globalClusters-deleteAllCustomZoneMappings: - -==================================================== -atlas api globalClusters deleteAllCustomZoneMappings -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes all custom zone mappings for the specified global cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. Removing the custom zone mappings restores the default mapping. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteallcustomzonemappings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api globalClusters deleteAllCustomZoneMappings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteAllCustomZoneMappings - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-globalClusters-deleteAllCustomZoneMappings-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping.txt b/docs/command/atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping.txt new file mode 100644 index 0000000000..874f358ad8 --- /dev/null +++ b/docs/command/atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping.txt @@ -0,0 +1,102 @@ +.. _atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping: + +======================================================================= +atlas api globalClusters deleteGroupClusterGlobalWriteCustomZoneMapping +======================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes all custom zone mappings for the specified global cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. Removing the custom zone mappings restores the default mapping. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterglobalwritecustomzonemapping. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api globalClusters deleteGroupClusterGlobalWriteCustomZoneMapping [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterGlobalWriteCustomZoneMapping + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces.txt b/docs/command/atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces.txt new file mode 100644 index 0000000000..623274a48b --- /dev/null +++ b/docs/command/atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces.txt @@ -0,0 +1,110 @@ +.. _atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces: + +======================================================================= +atlas api globalClusters deleteGroupClusterGlobalWriteManagedNamespaces +======================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one managed namespace within the specified global cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A managed namespace identifies a collection using the database name, the dot separator, and the collection name. Deleting a managed namespace does not remove the associated collection or data. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterglobalwritemanagednamespaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api globalClusters deleteGroupClusterGlobalWriteManagedNamespaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --collection + - string + - false + - Human-readable label that identifies the collection associated with the managed namespace. + * - --db + - string + - false + - Human-readable label that identifies the database that contains the collection. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterGlobalWriteManagedNamespaces + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-globalClusters-deleteManagedNamespace.txt b/docs/command/atlas-api-globalClusters-deleteManagedNamespace.txt deleted file mode 100644 index ee636b332d..0000000000 --- a/docs/command/atlas-api-globalClusters-deleteManagedNamespace.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-globalClusters-deleteManagedNamespace: - -=============================================== -atlas api globalClusters deleteManagedNamespace -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one managed namespace within the specified global cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A managed namespace identifies a collection using the database name, the dot separator, and the collection name. Deleting a managed namespace does not remove the associated collection or data. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletemanagednamespace. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api globalClusters deleteManagedNamespace [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --collection - - string - - false - - Human-readable label that identifies the collection associated with the managed namespace. - * - --db - - string - - false - - Human-readable label that identifies the database that contains the collection. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteManagedNamespace - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-globalClusters-deleteManagedNamespace-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-globalClusters-getGroupClusterGlobalWrites.txt b/docs/command/atlas-api-globalClusters-getGroupClusterGlobalWrites.txt new file mode 100644 index 0000000000..389028d50a --- /dev/null +++ b/docs/command/atlas-api-globalClusters-getGroupClusterGlobalWrites.txt @@ -0,0 +1,102 @@ +.. _atlas-api-globalClusters-getGroupClusterGlobalWrites: + +==================================================== +atlas api globalClusters getGroupClusterGlobalWrites +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one managed namespace within the specified global cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterglobalwrites. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api globalClusters getGroupClusterGlobalWrites [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies this cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterGlobalWrites + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-globalClusters-getGroupClusterGlobalWrites-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-globalClusters-getManagedNamespace.txt b/docs/command/atlas-api-globalClusters-getManagedNamespace.txt deleted file mode 100644 index d07ba6c19d..0000000000 --- a/docs/command/atlas-api-globalClusters-getManagedNamespace.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-globalClusters-getManagedNamespace: - -============================================ -atlas api globalClusters getManagedNamespace -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one managed namespace within the specified global cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmanagednamespace. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api globalClusters getManagedNamespace [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies this cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getManagedNamespace - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01", "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-globalClusters-getManagedNamespace-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-globalClusters.txt b/docs/command/atlas-api-globalClusters.txt index 1c7dc58029..918ccd5dae 100644 --- a/docs/command/atlas-api-globalClusters.txt +++ b/docs/command/atlas-api-globalClusters.txt @@ -55,19 +55,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-globalClusters-createCustomZoneMapping` - `Public Preview: please provide feedback `_: Creates one custom zone mapping for the specified global cluster. -* :ref:`atlas-api-globalClusters-createManagedNamespace` - `Public Preview: please provide feedback `_: Creates one managed namespace within the specified global cluster. -* :ref:`atlas-api-globalClusters-deleteAllCustomZoneMappings` - `Public Preview: please provide feedback `_: Removes all custom zone mappings for the specified global cluster. -* :ref:`atlas-api-globalClusters-deleteManagedNamespace` - `Public Preview: please provide feedback `_: Removes one managed namespace within the specified global cluster. -* :ref:`atlas-api-globalClusters-getManagedNamespace` - `Public Preview: please provide feedback `_: Returns one managed namespace within the specified global cluster. +* :ref:`atlas-api-globalClusters-createGroupClusterGlobalWriteCustomZoneMapping` - `Public Preview: please provide feedback `_: Creates one custom zone mapping for the specified global cluster. +* :ref:`atlas-api-globalClusters-createGroupClusterGlobalWriteManagedNamespace` - `Public Preview: please provide feedback `_: Creates one managed namespace within the specified global cluster. +* :ref:`atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping` - `Public Preview: please provide feedback `_: Removes all custom zone mappings for the specified global cluster. +* :ref:`atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces` - `Public Preview: please provide feedback `_: Removes one managed namespace within the specified global cluster. +* :ref:`atlas-api-globalClusters-getGroupClusterGlobalWrites` - `Public Preview: please provide feedback `_: Returns one managed namespace within the specified global cluster. .. toctree:: :titlesonly: - createCustomZoneMapping - createManagedNamespace - deleteAllCustomZoneMappings - deleteManagedNamespace - getManagedNamespace + createGroupClusterGlobalWriteCustomZoneMapping + createGroupClusterGlobalWriteManagedNamespace + deleteGroupClusterGlobalWriteCustomZoneMapping + deleteGroupClusterGlobalWriteManagedNamespaces + getGroupClusterGlobalWrites diff --git a/docs/command/atlas-api-invoices-createCostExplorerQueryProcess.txt b/docs/command/atlas-api-invoices-createCostExplorerQueryProcess.txt deleted file mode 100644 index 2a64115c66..0000000000 --- a/docs/command/atlas-api-invoices-createCostExplorerQueryProcess.txt +++ /dev/null @@ -1,91 +0,0 @@ -.. _atlas-api-invoices-createCostExplorerQueryProcess: - -================================================= -atlas api invoices createCostExplorerQueryProcess -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates a query process within the Cost Explorer for the given parameters. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A token is returned that can be used to poll the status of the query and eventually retrieve the results. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcostexplorerqueryprocess. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api invoices createCostExplorerQueryProcess [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createCostExplorerQueryProcess - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-invoices-createOrgBillingCostExplorerUsageProcess.txt b/docs/command/atlas-api-invoices-createOrgBillingCostExplorerUsageProcess.txt new file mode 100644 index 0000000000..589d127efe --- /dev/null +++ b/docs/command/atlas-api-invoices-createOrgBillingCostExplorerUsageProcess.txt @@ -0,0 +1,91 @@ +.. _atlas-api-invoices-createOrgBillingCostExplorerUsageProcess: + +=========================================================== +atlas api invoices createOrgBillingCostExplorerUsageProcess +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates a query process within the Cost Explorer for the given parameters. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A token is returned that can be used to poll the status of the query and eventually retrieve the results. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgbillingcostexplorerusageprocess. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api invoices createOrgBillingCostExplorerUsageProcess [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgBillingCostExplorerUsageProcess + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-invoices-downloadInvoiceCsv.txt b/docs/command/atlas-api-invoices-downloadInvoiceCsv.txt deleted file mode 100644 index 91757d9e8d..0000000000 --- a/docs/command/atlas-api-invoices-downloadInvoiceCsv.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-invoices-downloadInvoiceCsv: - -===================================== -atlas api invoices downloadInvoiceCsv -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one invoice that MongoDB issued to the specified organization in CSV format. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A unique 24-hexadecimal digit string identifies the invoice. To use this resource, the requesting Service Account or API Key have at least the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner Role. -To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadinvoicecsv. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api invoices downloadInvoiceCsv [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for downloadInvoiceCsv - * - --invoiceId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["csv"] This value defaults to "csv". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-invoices-downloadInvoiceCsv-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-invoices-getCostExplorerQueryProcess.txt b/docs/command/atlas-api-invoices-getCostExplorerQueryProcess.txt deleted file mode 100644 index c2ec03fe4c..0000000000 --- a/docs/command/atlas-api-invoices-getCostExplorerQueryProcess.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-invoices-getCostExplorerQueryProcess: - -============================================== -atlas api invoices getCostExplorerQueryProcess -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If the data is not ready, a 'processing' response willindicate that another request should be sent later to view the data. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcostexplorerqueryprocess. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api invoices getCostExplorerQueryProcess [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getCostExplorerQueryProcess - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - true - - preferred api format, can be ["csv", "json", go-template] - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --token - - string - - true - - Unique 64 digit string that identifies the Cost Explorer query. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-invoices-getCostExplorerQueryProcess-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-invoices-getInvoice.txt b/docs/command/atlas-api-invoices-getInvoice.txt deleted file mode 100644 index cceb2efcd7..0000000000 --- a/docs/command/atlas-api-invoices-getInvoice.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-invoices-getInvoice: - -============================= -atlas api invoices getInvoice -============================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one invoice that MongoDB issued to the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A unique 24-hexadecimal digit string identifies the invoice. You can choose to receive this invoice in JSON or CSV format. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner role. -To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getinvoice. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api invoices getInvoice [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getInvoice - * - --invoiceId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - true - - preferred api format, can be ["csv", "json", go-template] - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-invoices-getInvoice-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-invoices-getOrgBillingCostExplorerUsage.txt b/docs/command/atlas-api-invoices-getOrgBillingCostExplorerUsage.txt new file mode 100644 index 0000000000..33007de0ed --- /dev/null +++ b/docs/command/atlas-api-invoices-getOrgBillingCostExplorerUsage.txt @@ -0,0 +1,96 @@ +.. _atlas-api-invoices-getOrgBillingCostExplorerUsage: + +================================================= +atlas api invoices getOrgBillingCostExplorerUsage +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If the data is not ready, a 'processing' response willindicate that another request should be sent later to view the data. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgbillingcostexplorerusage. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api invoices getOrgBillingCostExplorerUsage [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgBillingCostExplorerUsage + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - true + - preferred api format, can be ["csv", "json", go-template] + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --token + - string + - true + - Unique 64 digit string that identifies the Cost Explorer query. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-invoices-getOrgBillingCostExplorerUsage-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-invoices-getOrgInvoice.txt b/docs/command/atlas-api-invoices-getOrgInvoice.txt new file mode 100644 index 0000000000..2ec2b364c9 --- /dev/null +++ b/docs/command/atlas-api-invoices-getOrgInvoice.txt @@ -0,0 +1,101 @@ +.. _atlas-api-invoices-getOrgInvoice: + +================================ +atlas api invoices getOrgInvoice +================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one invoice that MongoDB issued to the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A unique 24-hexadecimal digit string identifies the invoice. You can choose to receive this invoice in JSON or CSV format. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner role. +To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorginvoice. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api invoices getOrgInvoice [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgInvoice + * - --invoiceId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - true + - preferred api format, can be ["csv", "json", go-template] + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-invoices-getOrgInvoice-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-invoices-getOrgInvoiceCsv.txt b/docs/command/atlas-api-invoices-getOrgInvoiceCsv.txt new file mode 100644 index 0000000000..016f7302b7 --- /dev/null +++ b/docs/command/atlas-api-invoices-getOrgInvoiceCsv.txt @@ -0,0 +1,101 @@ +.. _atlas-api-invoices-getOrgInvoiceCsv: + +=================================== +atlas api invoices getOrgInvoiceCsv +=================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one invoice that MongoDB issued to the specified organization in CSV format. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A unique 24-hexadecimal digit string identifies the invoice. To use this resource, the requesting Service Account or API Key have at least the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner Role. +To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorginvoicecsv. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api invoices getOrgInvoiceCsv [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgInvoiceCsv + * - --invoiceId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["csv"] This value defaults to "csv". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-invoices-getOrgInvoiceCsv-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-invoices-listInvoices.txt b/docs/command/atlas-api-invoices-listInvoices.txt deleted file mode 100644 index 375ace7246..0000000000 --- a/docs/command/atlas-api-invoices-listInvoices.txt +++ /dev/null @@ -1,133 +0,0 @@ -.. _atlas-api-invoices-listInvoices: - -=============================== -atlas api invoices listInvoices -=============================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all invoices that MongoDB issued to the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This list includes all invoices regardless of invoice status. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner role. -To compute the total owed amount of the invoices - sum up total owed of each invoice. It could be computed as a sum of owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listinvoices. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api invoices listInvoices [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --fromDate - - string - - false - - Retrieve the invoices the startDates of which are greater than or equal to the fromDate. If omit, the invoices return will go back to earliest startDate. - * - -h, --help - - - - false - - help for listInvoices - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orderBy - - string - - false - - Field used to order the returned invoices by. Use in combination of sortBy parameter to control the order of the result. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --sortBy - - string - - false - - Field used to sort the returned invoices by. Use in combination with orderBy parameter to control the order of the result. - * - --statusNames - - stringArray - - false - - Statuses of the invoice to be retrieved. Omit to return invoices of all statuses. - * - --toDate - - string - - false - - Retrieve the invoices the endDates of which are smaller than or equal to the toDate. If omit, the invoices return will go further to latest endDate. - * - --version - - 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". - * - --viewLinkedInvoices - - - - false - - Flag that indicates whether to return linked invoices in the linkedInvoices field. - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-invoices-listInvoices-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-invoices-listOrgInvoicePending.txt b/docs/command/atlas-api-invoices-listOrgInvoicePending.txt new file mode 100644 index 0000000000..bf650d4fdd --- /dev/null +++ b/docs/command/atlas-api-invoices-listOrgInvoicePending.txt @@ -0,0 +1,96 @@ +.. _atlas-api-invoices-listOrgInvoicePending: + +======================================== +atlas api invoices listOrgInvoicePending +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all invoices accruing charges for the current billing cycle for the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner Role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorginvoicepending. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api invoices listOrgInvoicePending [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgInvoicePending + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-invoices-listOrgInvoicePending-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-invoices-listOrgInvoices.txt b/docs/command/atlas-api-invoices-listOrgInvoices.txt new file mode 100644 index 0000000000..41a2f04ae5 --- /dev/null +++ b/docs/command/atlas-api-invoices-listOrgInvoices.txt @@ -0,0 +1,133 @@ +.. _atlas-api-invoices-listOrgInvoices: + +================================== +atlas api invoices listOrgInvoices +================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all invoices that MongoDB issued to the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This list includes all invoices regardless of invoice status. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner role. +To compute the total owed amount of the invoices - sum up total owed of each invoice. It could be computed as a sum of owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorginvoices. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api invoices listOrgInvoices [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --fromDate + - string + - false + - Retrieve the invoices the startDates of which are greater than or equal to the fromDate. If omit, the invoices return will go back to earliest startDate. + * - -h, --help + - + - false + - help for listOrgInvoices + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orderBy + - string + - false + - Field used to order the returned invoices by. Use in combination of sortBy parameter to control the order of the result. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --sortBy + - string + - false + - Field used to sort the returned invoices by. Use in combination with orderBy parameter to control the order of the result. + * - --statusNames + - stringArray + - false + - Statuses of the invoice to be retrieved. Omit to return invoices of all statuses. + * - --toDate + - string + - false + - Retrieve the invoices the endDates of which are smaller than or equal to the toDate. If omit, the invoices return will go further to latest endDate. + * - --version + - 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". + * - --viewLinkedInvoices + - + - false + - Flag that indicates whether to return linked invoices in the linkedInvoices field. + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-invoices-listOrgInvoices-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-invoices-listPendingInvoices.txt b/docs/command/atlas-api-invoices-listPendingInvoices.txt deleted file mode 100644 index f893f2b719..0000000000 --- a/docs/command/atlas-api-invoices-listPendingInvoices.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-invoices-listPendingInvoices: - -====================================== -atlas api invoices listPendingInvoices -====================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all invoices accruing charges for the current billing cycle for the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner Role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpendinginvoices. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api invoices listPendingInvoices [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listPendingInvoices - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-invoices-listPendingInvoices-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-invoices-queryLineItemsFromSingleInvoice.txt b/docs/command/atlas-api-invoices-queryLineItemsFromSingleInvoice.txt deleted file mode 100644 index 68783354ff..0000000000 --- a/docs/command/atlas-api-invoices-queryLineItemsFromSingleInvoice.txt +++ /dev/null @@ -1,103 +0,0 @@ -.. _atlas-api-invoices-queryLineItemsFromSingleInvoice: - -================================================== -atlas api invoices queryLineItemsFromSingleInvoice -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Query the lineItems of the specified invoice and return the result JSON. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A unique 24-hexadecimal digit string identifies the invoice. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-querylineitemsfromsingleinvoice. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api invoices queryLineItemsFromSingleInvoice [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for queryLineItemsFromSingleInvoice - * - --invoiceId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-invoices-searchOrgInvoiceLineItems.txt b/docs/command/atlas-api-invoices-searchOrgInvoiceLineItems.txt new file mode 100644 index 0000000000..3be0bda1b3 --- /dev/null +++ b/docs/command/atlas-api-invoices-searchOrgInvoiceLineItems.txt @@ -0,0 +1,103 @@ +.. _atlas-api-invoices-searchOrgInvoiceLineItems: + +============================================ +atlas api invoices searchOrgInvoiceLineItems +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Query the lineItems of the specified invoice and return the result JSON. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A unique 24-hexadecimal digit string identifies the invoice. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-searchorginvoicelineitems. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api invoices searchOrgInvoiceLineItems [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for searchOrgInvoiceLineItems + * - --invoiceId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-invoices.txt b/docs/command/atlas-api-invoices.txt index d94df194e7..321d29d58b 100644 --- a/docs/command/atlas-api-invoices.txt +++ b/docs/command/atlas-api-invoices.txt @@ -54,23 +54,23 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-invoices-createCostExplorerQueryProcess` - `Public Preview: please provide feedback `_: Creates a query process within the Cost Explorer for the given parameters. -* :ref:`atlas-api-invoices-downloadInvoiceCsv` - `Public Preview: please provide feedback `_: Returns one invoice that MongoDB issued to the specified organization in CSV format. -* :ref:`atlas-api-invoices-getCostExplorerQueryProcess` - `Public Preview: please provide feedback `_: Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. -* :ref:`atlas-api-invoices-getInvoice` - `Public Preview: please provide feedback `_: Returns one invoice that MongoDB issued to the specified organization. -* :ref:`atlas-api-invoices-listInvoices` - `Public Preview: please provide feedback `_: Returns all invoices that MongoDB issued to the specified organization. -* :ref:`atlas-api-invoices-listPendingInvoices` - `Public Preview: please provide feedback `_: Returns all invoices accruing charges for the current billing cycle for the specified organization. -* :ref:`atlas-api-invoices-queryLineItemsFromSingleInvoice` - `Public Preview: please provide feedback `_: Query the lineItems of the specified invoice and return the result JSON. +* :ref:`atlas-api-invoices-createOrgBillingCostExplorerUsageProcess` - `Public Preview: please provide feedback `_: Creates a query process within the Cost Explorer for the given parameters. +* :ref:`atlas-api-invoices-getOrgBillingCostExplorerUsage` - `Public Preview: please provide feedback `_: Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. +* :ref:`atlas-api-invoices-getOrgInvoice` - `Public Preview: please provide feedback `_: Returns one invoice that MongoDB issued to the specified organization. +* :ref:`atlas-api-invoices-getOrgInvoiceCsv` - `Public Preview: please provide feedback `_: Returns one invoice that MongoDB issued to the specified organization in CSV format. +* :ref:`atlas-api-invoices-listOrgInvoicePending` - `Public Preview: please provide feedback `_: Returns all invoices accruing charges for the current billing cycle for the specified organization. +* :ref:`atlas-api-invoices-listOrgInvoices` - `Public Preview: please provide feedback `_: Returns all invoices that MongoDB issued to the specified organization. +* :ref:`atlas-api-invoices-searchOrgInvoiceLineItems` - `Public Preview: please provide feedback `_: Query the lineItems of the specified invoice and return the result JSON. .. toctree:: :titlesonly: - createCostExplorerQueryProcess - downloadInvoiceCsv - getCostExplorerQueryProcess - getInvoice - listInvoices - listPendingInvoices - queryLineItemsFromSingleInvoice + createOrgBillingCostExplorerUsageProcess + getOrgBillingCostExplorerUsage + getOrgInvoice + getOrgInvoiceCsv + listOrgInvoicePending + listOrgInvoices + searchOrgInvoiceLineItems diff --git a/docs/command/atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping.txt b/docs/command/atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping.txt new file mode 100644 index 0000000000..ef16ce22ab --- /dev/null +++ b/docs/command/atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping.txt @@ -0,0 +1,98 @@ +.. _atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping: + +====================================================================== +atlas api ldapConfiguration deleteGroupUserSecurityLdapUserToDnMapping +====================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the current LDAP Distinguished Name mapping captured in the userToDNMapping document from the LDAP configuration for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupusersecurityldapusertodnmapping. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api ldapConfiguration deleteGroupUserSecurityLdapUserToDnMapping [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupUserSecurityLdapUserToDnMapping + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-ldapConfiguration-deleteLdapConfiguration.txt b/docs/command/atlas-api-ldapConfiguration-deleteLdapConfiguration.txt deleted file mode 100644 index b029940d7f..0000000000 --- a/docs/command/atlas-api-ldapConfiguration-deleteLdapConfiguration.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-ldapConfiguration-deleteLdapConfiguration: - -=================================================== -atlas api ldapConfiguration deleteLdapConfiguration -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the current LDAP Distinguished Name mapping captured in the userToDNMapping document from the LDAP configuration for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteldapconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api ldapConfiguration deleteLdapConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteLdapConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-ldapConfiguration-deleteLdapConfiguration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-ldapConfiguration-getGroupUserSecurity.txt b/docs/command/atlas-api-ldapConfiguration-getGroupUserSecurity.txt new file mode 100644 index 0000000000..82326adeac --- /dev/null +++ b/docs/command/atlas-api-ldapConfiguration-getGroupUserSecurity.txt @@ -0,0 +1,98 @@ +.. _atlas-api-ldapConfiguration-getGroupUserSecurity: + +================================================ +atlas api ldapConfiguration getGroupUserSecurity +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the current LDAP configuration for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupusersecurity. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api ldapConfiguration getGroupUserSecurity [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupUserSecurity + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-ldapConfiguration-getGroupUserSecurity-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify.txt b/docs/command/atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify.txt new file mode 100644 index 0000000000..05729190eb --- /dev/null +++ b/docs/command/atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify.txt @@ -0,0 +1,102 @@ +.. _atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify: + +========================================================== +atlas api ldapConfiguration getGroupUserSecurityLdapVerify +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the status of one request to verify one LDAP configuration for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupusersecurityldapverify. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api ldapConfiguration getGroupUserSecurityLdapVerify [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupUserSecurityLdapVerify + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --requestId + - string + - true + - Unique string that identifies the request to verify an Lightweight Directory Access Protocol (LDAP) configuration. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-ldapConfiguration-getLdapConfiguration.txt b/docs/command/atlas-api-ldapConfiguration-getLdapConfiguration.txt deleted file mode 100644 index 102b5169c5..0000000000 --- a/docs/command/atlas-api-ldapConfiguration-getLdapConfiguration.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-ldapConfiguration-getLdapConfiguration: - -================================================ -atlas api ldapConfiguration getLdapConfiguration -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the current LDAP configuration for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getldapconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api ldapConfiguration getLdapConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getLdapConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-ldapConfiguration-getLdapConfiguration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-ldapConfiguration-getLdapConfigurationStatus.txt b/docs/command/atlas-api-ldapConfiguration-getLdapConfigurationStatus.txt deleted file mode 100644 index b24fd93e13..0000000000 --- a/docs/command/atlas-api-ldapConfiguration-getLdapConfigurationStatus.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-ldapConfiguration-getLdapConfigurationStatus: - -====================================================== -atlas api ldapConfiguration getLdapConfigurationStatus -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the status of one request to verify one LDAP configuration for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getldapconfigurationstatus. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api ldapConfiguration getLdapConfigurationStatus [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getLdapConfigurationStatus - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --requestId - - string - - true - - Unique string that identifies the request to verify an Lightweight Directory Access Protocol (LDAP) configuration. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-ldapConfiguration-getLdapConfigurationStatus-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-ldapConfiguration-saveLdapConfiguration.txt b/docs/command/atlas-api-ldapConfiguration-saveLdapConfiguration.txt deleted file mode 100644 index e11f80f92e..0000000000 --- a/docs/command/atlas-api-ldapConfiguration-saveLdapConfiguration.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-ldapConfiguration-saveLdapConfiguration: - -================================================= -atlas api ldapConfiguration saveLdapConfiguration -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Edits the LDAP configuration for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -Updating this configuration triggers a rolling restart of the database. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-saveldapconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api ldapConfiguration saveLdapConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for saveLdapConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-ldapConfiguration-updateGroupUserSecurity.txt b/docs/command/atlas-api-ldapConfiguration-updateGroupUserSecurity.txt new file mode 100644 index 0000000000..e2c878f68e --- /dev/null +++ b/docs/command/atlas-api-ldapConfiguration-updateGroupUserSecurity.txt @@ -0,0 +1,100 @@ +.. _atlas-api-ldapConfiguration-updateGroupUserSecurity: + +=================================================== +atlas api ldapConfiguration updateGroupUserSecurity +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Edits the LDAP configuration for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +Updating this configuration triggers a rolling restart of the database. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupusersecurity. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api ldapConfiguration updateGroupUserSecurity [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupUserSecurity + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-ldapConfiguration-verifyGroupUserSecurityLdap.txt b/docs/command/atlas-api-ldapConfiguration-verifyGroupUserSecurityLdap.txt new file mode 100644 index 0000000000..efc39aa977 --- /dev/null +++ b/docs/command/atlas-api-ldapConfiguration-verifyGroupUserSecurityLdap.txt @@ -0,0 +1,105 @@ +.. _atlas-api-ldapConfiguration-verifyGroupUserSecurityLdap: + +======================================================= +atlas api ldapConfiguration verifyGroupUserSecurityLdap +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Verifies the LDAP configuration for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifygroupusersecurityldap. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api ldapConfiguration verifyGroupUserSecurityLdap [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for verifyGroupUserSecurityLdap + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-ldapConfiguration-verifyLdapConfiguration.txt b/docs/command/atlas-api-ldapConfiguration-verifyLdapConfiguration.txt deleted file mode 100644 index 711f109a4e..0000000000 --- a/docs/command/atlas-api-ldapConfiguration-verifyLdapConfiguration.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-ldapConfiguration-verifyLdapConfiguration: - -=================================================== -atlas api ldapConfiguration verifyLdapConfiguration -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Verifies the LDAP configuration for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifyldapconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api ldapConfiguration verifyLdapConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for verifyLdapConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-ldapConfiguration.txt b/docs/command/atlas-api-ldapConfiguration.txt index 0bd261b391..96a4942dd9 100644 --- a/docs/command/atlas-api-ldapConfiguration.txt +++ b/docs/command/atlas-api-ldapConfiguration.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-ldapConfiguration-deleteLdapConfiguration` - `Public Preview: please provide feedback `_: Removes the current LDAP Distinguished Name mapping captured in the userToDNMapping document from the LDAP configuration for the specified project. -* :ref:`atlas-api-ldapConfiguration-getLdapConfiguration` - `Public Preview: please provide feedback `_: Returns the current LDAP configuration for the specified project. -* :ref:`atlas-api-ldapConfiguration-getLdapConfigurationStatus` - `Public Preview: please provide feedback `_: Returns the status of one request to verify one LDAP configuration for the specified project. -* :ref:`atlas-api-ldapConfiguration-saveLdapConfiguration` - `Public Preview: please provide feedback `_: Edits the LDAP configuration for the specified project. -* :ref:`atlas-api-ldapConfiguration-verifyLdapConfiguration` - `Public Preview: please provide feedback `_: Verifies the LDAP configuration for the specified project. +* :ref:`atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping` - `Public Preview: please provide feedback `_: Removes the current LDAP Distinguished Name mapping captured in the userToDNMapping document from the LDAP configuration for the specified project. +* :ref:`atlas-api-ldapConfiguration-getGroupUserSecurity` - `Public Preview: please provide feedback `_: Returns the current LDAP configuration for the specified project. +* :ref:`atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify` - `Public Preview: please provide feedback `_: Returns the status of one request to verify one LDAP configuration for the specified project. +* :ref:`atlas-api-ldapConfiguration-updateGroupUserSecurity` - `Public Preview: please provide feedback `_: Edits the LDAP configuration for the specified project. +* :ref:`atlas-api-ldapConfiguration-verifyGroupUserSecurityLdap` - `Public Preview: please provide feedback `_: Verifies the LDAP configuration for the specified project. .. toctree:: :titlesonly: - deleteLdapConfiguration - getLdapConfiguration - getLdapConfigurationStatus - saveLdapConfiguration - verifyLdapConfiguration + deleteGroupUserSecurityLdapUserToDnMapping + getGroupUserSecurity + getGroupUserSecurityLdapVerify + updateGroupUserSecurity + verifyGroupUserSecurityLdap diff --git a/docs/command/atlas-api-legacyBackup-createGroupClusterRestoreJob.txt b/docs/command/atlas-api-legacyBackup-createGroupClusterRestoreJob.txt new file mode 100644 index 0000000000..eb1258c56b --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-createGroupClusterRestoreJob.txt @@ -0,0 +1,101 @@ +.. _atlas-api-legacyBackup-createGroupClusterRestoreJob: + +=================================================== +atlas api legacyBackup createGroupClusterRestoreJob +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Restores one legacy backup for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This endpoint doesn't support creating checkpoint restore jobs for sharded clusters, or creating restore jobs for queryable backup snapshots. If you create an automated restore job by specifying delivery.methodName of AUTOMATED_RESTORE in your request body, MongoDB Cloud removes all existing data on the target cluster prior to the restore. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterrestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup createGroupClusterRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster with the snapshot you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterRestoreJob + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-legacyBackup-createLegacyBackupRestoreJob.txt b/docs/command/atlas-api-legacyBackup-createLegacyBackupRestoreJob.txt deleted file mode 100644 index 8908543bac..0000000000 --- a/docs/command/atlas-api-legacyBackup-createLegacyBackupRestoreJob.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-legacyBackup-createLegacyBackupRestoreJob: - -=================================================== -atlas api legacyBackup createLegacyBackupRestoreJob -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Restores one legacy backup for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This endpoint doesn't support creating checkpoint restore jobs for sharded clusters, or creating restore jobs for queryable backup snapshots. If you create an automated restore job by specifying delivery.methodName of AUTOMATED_RESTORE in your request body, MongoDB Cloud removes all existing data on the target cluster prior to the restore. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createlegacybackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup createLegacyBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster with the snapshot you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createLegacyBackupRestoreJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-legacyBackup-deleteGroupClusterSnapshot.txt b/docs/command/atlas-api-legacyBackup-deleteGroupClusterSnapshot.txt new file mode 100644 index 0000000000..de059dff70 --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-deleteGroupClusterSnapshot.txt @@ -0,0 +1,106 @@ +.. _atlas-api-legacyBackup-deleteGroupClusterSnapshot: + +================================================= +atlas api legacyBackup deleteGroupClusterSnapshot +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one legacy backup snapshot for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclustersnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup deleteGroupClusterSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterSnapshot + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-legacyBackup-deleteGroupClusterSnapshot-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-legacyBackup-deleteLegacySnapshot.txt b/docs/command/atlas-api-legacyBackup-deleteLegacySnapshot.txt deleted file mode 100644 index 8937f4e5b6..0000000000 --- a/docs/command/atlas-api-legacyBackup-deleteLegacySnapshot.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-legacyBackup-deleteLegacySnapshot: - -=========================================== -atlas api legacyBackup deleteLegacySnapshot -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one legacy backup snapshot for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletelegacysnapshot. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup deleteLegacySnapshot [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteLegacySnapshot - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-legacyBackup-deleteLegacySnapshot-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-legacyBackup-getGroupClusterBackupCheckpoint.txt b/docs/command/atlas-api-legacyBackup-getGroupClusterBackupCheckpoint.txt new file mode 100644 index 0000000000..487f9a0565 --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-getGroupClusterBackupCheckpoint.txt @@ -0,0 +1,106 @@ +.. _atlas-api-legacyBackup-getGroupClusterBackupCheckpoint: + +====================================================== +atlas api legacyBackup getGroupClusterBackupCheckpoint +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one legacy backup checkpoint for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupcheckpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup getGroupClusterBackupCheckpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --checkpointId + - string + - true + - Unique 24-hexadecimal digit string that identifies the checkpoint. + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that contains the checkpoints that you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterBackupCheckpoint + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-legacyBackup-getGroupClusterBackupCheckpoint-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-legacyBackup-getGroupClusterRestoreJob.txt b/docs/command/atlas-api-legacyBackup-getGroupClusterRestoreJob.txt new file mode 100644 index 0000000000..0b30b10eb9 --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-getGroupClusterRestoreJob.txt @@ -0,0 +1,109 @@ +.. _atlas-api-legacyBackup-getGroupClusterRestoreJob: + +================================================ +atlas api legacyBackup getGroupClusterRestoreJob +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one legacy backup restore job for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterrestorejob. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup getGroupClusterRestoreJob [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster with the snapshot you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterRestoreJob + * - --jobId + - string + - true + - Unique 24-hexadecimal digit string that identifies the restore job. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-legacyBackup-getGroupClusterRestoreJob-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-legacyBackup-getGroupClusterSnapshot.txt b/docs/command/atlas-api-legacyBackup-getGroupClusterSnapshot.txt new file mode 100644 index 0000000000..25cd3803e4 --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-getGroupClusterSnapshot.txt @@ -0,0 +1,106 @@ +.. _atlas-api-legacyBackup-getGroupClusterSnapshot: + +============================================== +atlas api legacyBackup getGroupClusterSnapshot +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one legacy backup snapshot for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup getGroupClusterSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterSnapshot + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-legacyBackup-getGroupClusterSnapshot-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-legacyBackup-getGroupClusterSnapshotSchedule.txt b/docs/command/atlas-api-legacyBackup-getGroupClusterSnapshotSchedule.txt new file mode 100644 index 0000000000..9525569129 --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-getGroupClusterSnapshotSchedule.txt @@ -0,0 +1,105 @@ +.. _atlas-api-legacyBackup-getGroupClusterSnapshotSchedule: + +====================================================== +atlas api legacyBackup getGroupClusterSnapshotSchedule +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the snapshot schedule for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersnapshotschedule. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup getGroupClusterSnapshotSchedule [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster with the snapshot you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterSnapshotSchedule + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-legacyBackup-getGroupClusterSnapshotSchedule-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-legacyBackup-getLegacyBackupCheckpoint.txt b/docs/command/atlas-api-legacyBackup-getLegacyBackupCheckpoint.txt deleted file mode 100644 index a68d8d0240..0000000000 --- a/docs/command/atlas-api-legacyBackup-getLegacyBackupCheckpoint.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-legacyBackup-getLegacyBackupCheckpoint: - -================================================ -atlas api legacyBackup getLegacyBackupCheckpoint -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one legacy backup checkpoint for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacybackupcheckpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup getLegacyBackupCheckpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --checkpointId - - string - - true - - Unique 24-hexadecimal digit string that identifies the checkpoint. - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that contains the checkpoints that you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getLegacyBackupCheckpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-legacyBackup-getLegacyBackupCheckpoint-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-legacyBackup-getLegacyBackupRestoreJob.txt b/docs/command/atlas-api-legacyBackup-getLegacyBackupRestoreJob.txt deleted file mode 100644 index d66027d40d..0000000000 --- a/docs/command/atlas-api-legacyBackup-getLegacyBackupRestoreJob.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-legacyBackup-getLegacyBackupRestoreJob: - -================================================ -atlas api legacyBackup getLegacyBackupRestoreJob -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one legacy backup restore job for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacybackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup getLegacyBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster with the snapshot you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getLegacyBackupRestoreJob - * - --jobId - - string - - true - - Unique 24-hexadecimal digit string that identifies the restore job. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-legacyBackup-getLegacyBackupRestoreJob-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-legacyBackup-getLegacySnapshot.txt b/docs/command/atlas-api-legacyBackup-getLegacySnapshot.txt deleted file mode 100644 index 108f4bf66d..0000000000 --- a/docs/command/atlas-api-legacyBackup-getLegacySnapshot.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-legacyBackup-getLegacySnapshot: - -======================================== -atlas api legacyBackup getLegacySnapshot -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one legacy backup snapshot for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacysnapshot. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup getLegacySnapshot [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getLegacySnapshot - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-legacyBackup-getLegacySnapshot-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-legacyBackup-getLegacySnapshotSchedule.txt b/docs/command/atlas-api-legacyBackup-getLegacySnapshotSchedule.txt deleted file mode 100644 index f02333810a..0000000000 --- a/docs/command/atlas-api-legacyBackup-getLegacySnapshotSchedule.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-legacyBackup-getLegacySnapshotSchedule: - -================================================ -atlas api legacyBackup getLegacySnapshotSchedule -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the snapshot schedule for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacysnapshotschedule. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup getLegacySnapshotSchedule [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster with the snapshot you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getLegacySnapshotSchedule - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-legacyBackup-getLegacySnapshotSchedule-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-legacyBackup-listGroupClusterBackupCheckpoints.txt b/docs/command/atlas-api-legacyBackup-listGroupClusterBackupCheckpoints.txt new file mode 100644 index 0000000000..17e676113d --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-listGroupClusterBackupCheckpoints.txt @@ -0,0 +1,114 @@ +.. _atlas-api-legacyBackup-listGroupClusterBackupCheckpoints: + +======================================================== +atlas api legacyBackup listGroupClusterBackupCheckpoints +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all legacy backup checkpoints for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackupcheckpoints. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup listGroupClusterBackupCheckpoints [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that contains the checkpoints that you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterBackupCheckpoints + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-legacyBackup-listGroupClusterBackupCheckpoints-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-legacyBackup-listGroupClusterRestoreJobs.txt b/docs/command/atlas-api-legacyBackup-listGroupClusterRestoreJobs.txt new file mode 100644 index 0000000000..e2733a286b --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-listGroupClusterRestoreJobs.txt @@ -0,0 +1,121 @@ +.. _atlas-api-legacyBackup-listGroupClusterRestoreJobs: + +================================================== +atlas api legacyBackup listGroupClusterRestoreJobs +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all legacy backup restore jobs for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. If you use the BATCH-ID query parameter, you can retrieve all restore jobs in the specified batch. When creating a restore job for a sharded cluster, MongoDB Cloud creates a separate job for each shard, plus another for the config server. Each of those jobs are part of a batch. However, a batch can't include a restore job for a replica set. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterrestorejobs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup listGroupClusterRestoreJobs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --batchId + - string + - false + - Unique 24-hexadecimal digit string that identifies the batch of restore jobs to return. Timestamp in ISO 8601 date and time format in UTC when creating a restore job for a sharded cluster, Application creates a separate job for each shard, plus another for the config host. Each of these jobs comprise one batch. A restore job for a replica set can't be part of a batch. + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster with the snapshot you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterRestoreJobs + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-legacyBackup-listGroupClusterRestoreJobs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-legacyBackup-listGroupClusterSnapshots.txt b/docs/command/atlas-api-legacyBackup-listGroupClusterSnapshots.txt new file mode 100644 index 0000000000..06148bcc11 --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-listGroupClusterSnapshots.txt @@ -0,0 +1,118 @@ +.. _atlas-api-legacyBackup-listGroupClusterSnapshots: + +================================================ +atlas api legacyBackup listGroupClusterSnapshots +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all legacy backup snapshots for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustersnapshots. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup listGroupClusterSnapshots [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --completed + - string + - false + - Human-readable label that specifies whether to return only completed, incomplete, or all snapshots. By default, MongoDB Cloud only returns completed snapshots. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterSnapshots + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-legacyBackup-listGroupClusterSnapshots-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-legacyBackup-listLegacyBackupCheckpoints.txt b/docs/command/atlas-api-legacyBackup-listLegacyBackupCheckpoints.txt deleted file mode 100644 index 02d692d370..0000000000 --- a/docs/command/atlas-api-legacyBackup-listLegacyBackupCheckpoints.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-legacyBackup-listLegacyBackupCheckpoints: - -================================================== -atlas api legacyBackup listLegacyBackupCheckpoints -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all legacy backup checkpoints for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listlegacybackupcheckpoints. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup listLegacyBackupCheckpoints [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that contains the checkpoints that you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listLegacyBackupCheckpoints - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-legacyBackup-listLegacyBackupCheckpoints-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-legacyBackup-listLegacyBackupRestoreJobs.txt b/docs/command/atlas-api-legacyBackup-listLegacyBackupRestoreJobs.txt deleted file mode 100644 index c86e97d0d0..0000000000 --- a/docs/command/atlas-api-legacyBackup-listLegacyBackupRestoreJobs.txt +++ /dev/null @@ -1,121 +0,0 @@ -.. _atlas-api-legacyBackup-listLegacyBackupRestoreJobs: - -================================================== -atlas api legacyBackup listLegacyBackupRestoreJobs -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all legacy backup restore jobs for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. If you use the BATCH-ID query parameter, you can retrieve all restore jobs in the specified batch. When creating a restore job for a sharded cluster, MongoDB Cloud creates a separate job for each shard, plus another for the config server. Each of those jobs are part of a batch. However, a batch can't include a restore job for a replica set. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listlegacybackuprestorejobs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup listLegacyBackupRestoreJobs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --batchId - - string - - false - - Unique 24-hexadecimal digit string that identifies the batch of restore jobs to return. Timestamp in ISO 8601 date and time format in UTC when creating a restore job for a sharded cluster, Application creates a separate job for each shard, plus another for the config host. Each of these jobs comprise one batch. A restore job for a replica set can't be part of a batch. - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster with the snapshot you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listLegacyBackupRestoreJobs - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-legacyBackup-listLegacyBackupRestoreJobs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-legacyBackup-listLegacySnapshots.txt b/docs/command/atlas-api-legacyBackup-listLegacySnapshots.txt deleted file mode 100644 index 87e2e03f93..0000000000 --- a/docs/command/atlas-api-legacyBackup-listLegacySnapshots.txt +++ /dev/null @@ -1,118 +0,0 @@ -.. _atlas-api-legacyBackup-listLegacySnapshots: - -========================================== -atlas api legacyBackup listLegacySnapshots -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all legacy backup snapshots for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listlegacysnapshots. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup listLegacySnapshots [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --completed - - string - - false - - Human-readable label that specifies whether to return only completed, incomplete, or all snapshots. By default, MongoDB Cloud only returns completed snapshots. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listLegacySnapshots - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-legacyBackup-listLegacySnapshots-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-legacyBackup-updateGroupClusterSnapshot.txt b/docs/command/atlas-api-legacyBackup-updateGroupClusterSnapshot.txt new file mode 100644 index 0000000000..bb0792ae5e --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-updateGroupClusterSnapshot.txt @@ -0,0 +1,105 @@ +.. _atlas-api-legacyBackup-updateGroupClusterSnapshot: + +================================================= +atlas api legacyBackup updateGroupClusterSnapshot +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Changes the expiration date for one legacy backup snapshot for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup updateGroupClusterSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterSnapshot + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-legacyBackup-updateGroupClusterSnapshotSchedule.txt b/docs/command/atlas-api-legacyBackup-updateGroupClusterSnapshotSchedule.txt new file mode 100644 index 0000000000..54e0c0f85a --- /dev/null +++ b/docs/command/atlas-api-legacyBackup-updateGroupClusterSnapshotSchedule.txt @@ -0,0 +1,104 @@ +.. _atlas-api-legacyBackup-updateGroupClusterSnapshotSchedule: + +========================================================= +atlas api legacyBackup updateGroupClusterSnapshotSchedule +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the snapshot schedule for one cluster in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersnapshotschedule. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api legacyBackup updateGroupClusterSnapshotSchedule [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster with the snapshot you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterSnapshotSchedule + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-legacyBackup-updateLegacySnapshotRetention.txt b/docs/command/atlas-api-legacyBackup-updateLegacySnapshotRetention.txt deleted file mode 100644 index 11945268fd..0000000000 --- a/docs/command/atlas-api-legacyBackup-updateLegacySnapshotRetention.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-legacyBackup-updateLegacySnapshotRetention: - -==================================================== -atlas api legacyBackup updateLegacySnapshotRetention -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Changes the expiration date for one legacy backup snapshot for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatelegacysnapshotretention. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup updateLegacySnapshotRetention [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateLegacySnapshotRetention - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-legacyBackup-updateLegacySnapshotSchedule.txt b/docs/command/atlas-api-legacyBackup-updateLegacySnapshotSchedule.txt deleted file mode 100644 index a994a3b1b3..0000000000 --- a/docs/command/atlas-api-legacyBackup-updateLegacySnapshotSchedule.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-legacyBackup-updateLegacySnapshotSchedule: - -=================================================== -atlas api legacyBackup updateLegacySnapshotSchedule -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the snapshot schedule for one cluster in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatelegacysnapshotschedule. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api legacyBackup updateLegacySnapshotSchedule [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster with the snapshot you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateLegacySnapshotSchedule - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-legacyBackup.txt b/docs/command/atlas-api-legacyBackup.txt index 440d2bd94f..b07d2df0e7 100644 --- a/docs/command/atlas-api-legacyBackup.txt +++ b/docs/command/atlas-api-legacyBackup.txt @@ -54,31 +54,31 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-legacyBackup-createLegacyBackupRestoreJob` - `Public Preview: please provide feedback `_: Restores one legacy backup for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-deleteLegacySnapshot` - `Public Preview: please provide feedback `_: Removes one legacy backup snapshot for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-getLegacyBackupCheckpoint` - `Public Preview: please provide feedback `_: Returns one legacy backup checkpoint for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-getLegacyBackupRestoreJob` - `Public Preview: please provide feedback `_: Returns one legacy backup restore job for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-getLegacySnapshot` - `Public Preview: please provide feedback `_: Returns one legacy backup snapshot for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-getLegacySnapshotSchedule` - `Public Preview: please provide feedback `_: Returns the snapshot schedule for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-listLegacyBackupCheckpoints` - `Public Preview: please provide feedback `_: Returns all legacy backup checkpoints for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-listLegacyBackupRestoreJobs` - `Public Preview: please provide feedback `_: Returns all legacy backup restore jobs for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-listLegacySnapshots` - `Public Preview: please provide feedback `_: Returns all legacy backup snapshots for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-updateLegacySnapshotRetention` - `Public Preview: please provide feedback `_: Changes the expiration date for one legacy backup snapshot for one cluster in the specified project. -* :ref:`atlas-api-legacyBackup-updateLegacySnapshotSchedule` - `Public Preview: please provide feedback `_: Updates the snapshot schedule for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-createGroupClusterRestoreJob` - `Public Preview: please provide feedback `_: Restores one legacy backup for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-deleteGroupClusterSnapshot` - `Public Preview: please provide feedback `_: Removes one legacy backup snapshot for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-getGroupClusterBackupCheckpoint` - `Public Preview: please provide feedback `_: Returns one legacy backup checkpoint for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-getGroupClusterRestoreJob` - `Public Preview: please provide feedback `_: Returns one legacy backup restore job for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-getGroupClusterSnapshot` - `Public Preview: please provide feedback `_: Returns one legacy backup snapshot for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-getGroupClusterSnapshotSchedule` - `Public Preview: please provide feedback `_: Returns the snapshot schedule for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-listGroupClusterBackupCheckpoints` - `Public Preview: please provide feedback `_: Returns all legacy backup checkpoints for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-listGroupClusterRestoreJobs` - `Public Preview: please provide feedback `_: Returns all legacy backup restore jobs for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-listGroupClusterSnapshots` - `Public Preview: please provide feedback `_: Returns all legacy backup snapshots for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-updateGroupClusterSnapshot` - `Public Preview: please provide feedback `_: Changes the expiration date for one legacy backup snapshot for one cluster in the specified project. +* :ref:`atlas-api-legacyBackup-updateGroupClusterSnapshotSchedule` - `Public Preview: please provide feedback `_: Updates the snapshot schedule for one cluster in the specified project. .. toctree:: :titlesonly: - createLegacyBackupRestoreJob - deleteLegacySnapshot - getLegacyBackupCheckpoint - getLegacyBackupRestoreJob - getLegacySnapshot - getLegacySnapshotSchedule - listLegacyBackupCheckpoints - listLegacyBackupRestoreJobs - listLegacySnapshots - updateLegacySnapshotRetention - updateLegacySnapshotSchedule + createGroupClusterRestoreJob + deleteGroupClusterSnapshot + getGroupClusterBackupCheckpoint + getGroupClusterRestoreJob + getGroupClusterSnapshot + getGroupClusterSnapshotSchedule + listGroupClusterBackupCheckpoints + listGroupClusterRestoreJobs + listGroupClusterSnapshots + updateGroupClusterSnapshot + updateGroupClusterSnapshotSchedule diff --git a/docs/command/atlas-api-maintenanceWindows-deferGroupMaintenanceWindow.txt b/docs/command/atlas-api-maintenanceWindows-deferGroupMaintenanceWindow.txt new file mode 100644 index 0000000000..b785c4ee82 --- /dev/null +++ b/docs/command/atlas-api-maintenanceWindows-deferGroupMaintenanceWindow.txt @@ -0,0 +1,94 @@ +.. _atlas-api-maintenanceWindows-deferGroupMaintenanceWindow: + +======================================================== +atlas api maintenanceWindows deferGroupMaintenanceWindow +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Defers the maintenance window for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-defergroupmaintenancewindow. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api maintenanceWindows deferGroupMaintenanceWindow [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deferGroupMaintenanceWindow + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-maintenanceWindows-deferGroupMaintenanceWindow-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-maintenanceWindows-deferMaintenanceWindow.txt b/docs/command/atlas-api-maintenanceWindows-deferMaintenanceWindow.txt deleted file mode 100644 index f76a6509a7..0000000000 --- a/docs/command/atlas-api-maintenanceWindows-deferMaintenanceWindow.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-maintenanceWindows-deferMaintenanceWindow: - -=================================================== -atlas api maintenanceWindows deferMaintenanceWindow -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Defers the maintenance window for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-defermaintenancewindow. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api maintenanceWindows deferMaintenanceWindow [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deferMaintenanceWindow - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-maintenanceWindows-deferMaintenanceWindow-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-maintenanceWindows-getGroupMaintenanceWindow.txt b/docs/command/atlas-api-maintenanceWindows-getGroupMaintenanceWindow.txt new file mode 100644 index 0000000000..d8b4060cd5 --- /dev/null +++ b/docs/command/atlas-api-maintenanceWindows-getGroupMaintenanceWindow.txt @@ -0,0 +1,98 @@ +.. _atlas-api-maintenanceWindows-getGroupMaintenanceWindow: + +====================================================== +atlas api maintenanceWindows getGroupMaintenanceWindow +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the maintenance window for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Cloud starts those maintenance activities when needed. You can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupmaintenancewindow. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api maintenanceWindows getGroupMaintenanceWindow [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupMaintenanceWindow + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-maintenanceWindows-getGroupMaintenanceWindow-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-maintenanceWindows-getMaintenanceWindow.txt b/docs/command/atlas-api-maintenanceWindows-getMaintenanceWindow.txt deleted file mode 100644 index a4c4b730be..0000000000 --- a/docs/command/atlas-api-maintenanceWindows-getMaintenanceWindow.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-maintenanceWindows-getMaintenanceWindow: - -================================================= -atlas api maintenanceWindows getMaintenanceWindow -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the maintenance window for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Cloud starts those maintenance activities when needed. You can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmaintenancewindow. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api maintenanceWindows getMaintenanceWindow [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getMaintenanceWindow - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-maintenanceWindows-getMaintenanceWindow-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-maintenanceWindows-resetGroupMaintenanceWindow.txt b/docs/command/atlas-api-maintenanceWindows-resetGroupMaintenanceWindow.txt new file mode 100644 index 0000000000..7d91d39eec --- /dev/null +++ b/docs/command/atlas-api-maintenanceWindows-resetGroupMaintenanceWindow.txt @@ -0,0 +1,94 @@ +.. _atlas-api-maintenanceWindows-resetGroupMaintenanceWindow: + +======================================================== +atlas api maintenanceWindows resetGroupMaintenanceWindow +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Resets the maintenance window for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-resetgroupmaintenancewindow. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api maintenanceWindows resetGroupMaintenanceWindow [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for resetGroupMaintenanceWindow + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-maintenanceWindows-resetGroupMaintenanceWindow-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-maintenanceWindows-resetMaintenanceWindow.txt b/docs/command/atlas-api-maintenanceWindows-resetMaintenanceWindow.txt deleted file mode 100644 index d23fe8eb34..0000000000 --- a/docs/command/atlas-api-maintenanceWindows-resetMaintenanceWindow.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-maintenanceWindows-resetMaintenanceWindow: - -=================================================== -atlas api maintenanceWindows resetMaintenanceWindow -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Resets the maintenance window for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-resetmaintenancewindow. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api maintenanceWindows resetMaintenanceWindow [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for resetMaintenanceWindow - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-maintenanceWindows-resetMaintenanceWindow-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer.txt b/docs/command/atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer.txt new file mode 100644 index 0000000000..ae6d9f6c11 --- /dev/null +++ b/docs/command/atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer.txt @@ -0,0 +1,94 @@ +.. _atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer: + +================================================================== +atlas api maintenanceWindows toggleGroupMaintenanceWindowAutoDefer +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Toggles automatic deferral of the maintenance window for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglegroupmaintenancewindowautodefer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api maintenanceWindows toggleGroupMaintenanceWindowAutoDefer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for toggleGroupMaintenanceWindowAutoDefer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer.txt b/docs/command/atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer.txt deleted file mode 100644 index 0ea96dd8a3..0000000000 --- a/docs/command/atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer: - -======================================================= -atlas api maintenanceWindows toggleMaintenanceAutoDefer -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Toggles automatic deferral of the maintenance window for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglemaintenanceautodefer. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api maintenanceWindows toggleMaintenanceAutoDefer [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for toggleMaintenanceAutoDefer - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-maintenanceWindows-updateGroupMaintenanceWindow.txt b/docs/command/atlas-api-maintenanceWindows-updateGroupMaintenanceWindow.txt new file mode 100644 index 0000000000..0da8b7a985 --- /dev/null +++ b/docs/command/atlas-api-maintenanceWindows-updateGroupMaintenanceWindow.txt @@ -0,0 +1,93 @@ +.. _atlas-api-maintenanceWindows-updateGroupMaintenanceWindow: + +========================================================= +atlas api maintenanceWindows updateGroupMaintenanceWindow +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the maintenance window for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. Updating the maintenance window will reset any maintenance deferrals for this project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupmaintenancewindow. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api maintenanceWindows updateGroupMaintenanceWindow [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupMaintenanceWindow + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-maintenanceWindows-updateMaintenanceWindow.txt b/docs/command/atlas-api-maintenanceWindows-updateMaintenanceWindow.txt deleted file mode 100644 index f12b9c7621..0000000000 --- a/docs/command/atlas-api-maintenanceWindows-updateMaintenanceWindow.txt +++ /dev/null @@ -1,93 +0,0 @@ -.. _atlas-api-maintenanceWindows-updateMaintenanceWindow: - -==================================================== -atlas api maintenanceWindows updateMaintenanceWindow -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the maintenance window for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. Updating the maintenance window will reset any maintenance deferrals for this project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatemaintenancewindow. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api maintenanceWindows updateMaintenanceWindow [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateMaintenanceWindow - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-maintenanceWindows.txt b/docs/command/atlas-api-maintenanceWindows.txt index 2ff75c5f27..bd954c6210 100644 --- a/docs/command/atlas-api-maintenanceWindows.txt +++ b/docs/command/atlas-api-maintenanceWindows.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-maintenanceWindows-deferMaintenanceWindow` - `Public Preview: please provide feedback `_: Defers the maintenance window for the specified project. -* :ref:`atlas-api-maintenanceWindows-getMaintenanceWindow` - `Public Preview: please provide feedback `_: Returns the maintenance window for the specified project. -* :ref:`atlas-api-maintenanceWindows-resetMaintenanceWindow` - `Public Preview: please provide feedback `_: Resets the maintenance window for the specified project. -* :ref:`atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer` - `Public Preview: please provide feedback `_: Toggles automatic deferral of the maintenance window for the specified project. -* :ref:`atlas-api-maintenanceWindows-updateMaintenanceWindow` - `Public Preview: please provide feedback `_: Updates the maintenance window for the specified project. +* :ref:`atlas-api-maintenanceWindows-deferGroupMaintenanceWindow` - `Public Preview: please provide feedback `_: Defers the maintenance window for the specified project. +* :ref:`atlas-api-maintenanceWindows-getGroupMaintenanceWindow` - `Public Preview: please provide feedback `_: Returns the maintenance window for the specified project. +* :ref:`atlas-api-maintenanceWindows-resetGroupMaintenanceWindow` - `Public Preview: please provide feedback `_: Resets the maintenance window for the specified project. +* :ref:`atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer` - `Public Preview: please provide feedback `_: Toggles automatic deferral of the maintenance window for the specified project. +* :ref:`atlas-api-maintenanceWindows-updateGroupMaintenanceWindow` - `Public Preview: please provide feedback `_: Updates the maintenance window for the specified project. .. toctree:: :titlesonly: - deferMaintenanceWindow - getMaintenanceWindow - resetMaintenanceWindow - toggleMaintenanceAutoDefer - updateMaintenanceWindow + deferGroupMaintenanceWindow + getGroupMaintenanceWindow + resetGroupMaintenanceWindow + toggleGroupMaintenanceWindowAutoDefer + updateGroupMaintenanceWindow diff --git a/docs/command/atlas-api-mongoDbCloudUsers-addGroupUserRole.txt b/docs/command/atlas-api-mongoDbCloudUsers-addGroupUserRole.txt new file mode 100644 index 0000000000..8dddbef4fc --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-addGroupUserRole.txt @@ -0,0 +1,104 @@ +.. _atlas-api-mongoDbCloudUsers-addGroupUserRole: + +============================================ +atlas api mongoDbCloudUsers addGroupUserRole +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one project-level role to the MongoDB Cloud user. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can add a role to an active user or a user that has been invited to join the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +Note: This resource cannot be used to add a role to users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupuserrole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers addGroupUserRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for addGroupUserRole + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-addGroupUsers.txt b/docs/command/atlas-api-mongoDbCloudUsers-addGroupUsers.txt new file mode 100644 index 0000000000..456efba27d --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-addGroupUsers.txt @@ -0,0 +1,107 @@ +.. _atlas-api-mongoDbCloudUsers-addGroupUsers: + +========================================= +atlas api mongoDbCloudUsers addGroupUsers +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to one project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + + +If the user has a pending invitation to join the project's organization, MongoDB Cloud modifies it and grants project access. + + +If the user doesn't have an invitation to join the organization, MongoDB Cloud sends a new invitation that grants the user organization and project access. + + +If the user is already active in the project's organization, MongoDB Cloud grants access to the project. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupusers. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers addGroupUsers [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for addGroupUsers + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-addOrgTeamUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-addOrgTeamUser.txt new file mode 100644 index 0000000000..60d6836273 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-addOrgTeamUser.txt @@ -0,0 +1,102 @@ +.. _atlas-api-mongoDbCloudUsers-addOrgTeamUser: + +========================================== +atlas api mongoDbCloudUsers addOrgTeamUser +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to one team. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can add an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: This resource cannot be used to add a user invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addorgteamuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers addOrgTeamUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for addOrgTeamUser + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team to add the MongoDB Cloud user to. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-addOrgUserRole.txt b/docs/command/atlas-api-mongoDbCloudUsers-addOrgUserRole.txt new file mode 100644 index 0000000000..c66c1a7170 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-addOrgUserRole.txt @@ -0,0 +1,105 @@ +.. _atlas-api-mongoDbCloudUsers-addOrgUserRole: + +========================================== +atlas api mongoDbCloudUsers addOrgUserRole +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one organization-level role to the MongoDB Cloud user. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can add a role to an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: This operation is atomic. + + +Note: This resource cannot be used to add a role to users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addorguserrole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers addOrgUserRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for addOrgUserRole + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-addOrganizationRole.txt b/docs/command/atlas-api-mongoDbCloudUsers-addOrganizationRole.txt deleted file mode 100644 index ec643c1edc..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-addOrganizationRole.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-addOrganizationRole: - -=============================================== -atlas api mongoDbCloudUsers addOrganizationRole -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one organization-level role to the MongoDB Cloud user. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can add a role to an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This operation is atomic. - - -Note: This resource cannot be used to add a role to users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addorganizationrole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers addOrganizationRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for addOrganizationRole - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-addProjectRole.txt b/docs/command/atlas-api-mongoDbCloudUsers-addProjectRole.txt deleted file mode 100644 index 936a809163..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-addProjectRole.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-addProjectRole: - -========================================== -atlas api mongoDbCloudUsers addProjectRole -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one project-level role to the MongoDB Cloud user. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can add a role to an active user or a user that has been invited to join the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -Note: This resource cannot be used to add a role to users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectrole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers addProjectRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for addProjectRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-addProjectUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-addProjectUser.txt deleted file mode 100644 index 0246d7ca47..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-addProjectUser.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-addProjectUser: - -========================================== -atlas api mongoDbCloudUsers addProjectUser -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to one project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - - -If the user has a pending invitation to join the project's organization, MongoDB Cloud modifies it and grants project access. - - -If the user doesn't have an invitation to join the organization, MongoDB Cloud sends a new invitation that grants the user organization and project access. - - -If the user is already active in the project's organization, MongoDB Cloud grants access to the project. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers addProjectUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for addProjectUser - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-addUserToTeam.txt b/docs/command/atlas-api-mongoDbCloudUsers-addUserToTeam.txt deleted file mode 100644 index 81db1cd717..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-addUserToTeam.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-addUserToTeam: - -========================================= -atlas api mongoDbCloudUsers addUserToTeam -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to one team. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can add an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This resource cannot be used to add a user invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addusertoteam. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers addUserToTeam [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for addUserToTeam - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team to add the MongoDB Cloud user to. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-createOrgUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-createOrgUser.txt new file mode 100644 index 0000000000..0bfa29f642 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-createOrgUser.txt @@ -0,0 +1,98 @@ +.. _atlas-api-mongoDbCloudUsers-createOrgUser: + +========================================= +atlas api mongoDbCloudUsers createOrgUser +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Invites one new or existing MongoDB Cloud user to join the organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The invitation to join the organization will be sent to the username provided and must be accepted within 30 days. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: If the user does not have an existing MongoDB Cloud account, they will be prompted to finish setting up an account upon accepting the invitation. If the user already has an account, they will still receive an invitation to access the organization. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorguser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers createOrgUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgUser + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-createOrganizationUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-createOrganizationUser.txt deleted file mode 100644 index 64b29f3b14..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-createOrganizationUser.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-createOrganizationUser: - -================================================== -atlas api mongoDbCloudUsers createOrganizationUser -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Invites one new or existing MongoDB Cloud user to join the organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The invitation to join the organization will be sent to the username provided and must be accepted within 30 days. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: If the user does not have an existing MongoDB Cloud account, they will be prompted to finish setting up an account upon accepting the invitation. If the user already has an account, they will still receive an invitation to access the organization. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorganizationuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers createOrganizationUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createOrganizationUser - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-getGroupUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-getGroupUser.txt new file mode 100644 index 0000000000..283f23f4f7 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-getGroupUser.txt @@ -0,0 +1,108 @@ +.. _atlas-api-mongoDbCloudUsers-getGroupUser: + +======================================== +atlas api mongoDbCloudUsers getGroupUser +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns information about the specified MongoDB Cloud user within the context of the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +Note: You can only use this resource to fetch information about MongoDB Cloud human users. To return information about an API Key, use the Return One Organization API Key endpoint. + + +Note: This resource does not return information about pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers getGroupUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupUser + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-getGroupUser-2025-02-19-default.sh + :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-getOrgUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-getOrgUser.txt new file mode 100644 index 0000000000..efa96accac --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-getOrgUser.txt @@ -0,0 +1,106 @@ +.. _atlas-api-mongoDbCloudUsers-getOrgUser: + +====================================== +atlas api mongoDbCloudUsers getOrgUser +====================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns information about the specified MongoDB Cloud user within the context of the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Member role. + + +Note: This resource can only be used to fetch information about MongoDB Cloud human users. To return information about an API Key, use the Return One Organization API Key endpoint. + + +Note: This resource does not return information about pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorguser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers getOrgUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgUser + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-getOrgUser-2025-02-19-default.sh + :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-getOrganizationUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-getOrganizationUser.txt deleted file mode 100644 index d8032adc76..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-getOrganizationUser.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-getOrganizationUser: - -=============================================== -atlas api mongoDbCloudUsers getOrganizationUser -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns information about the specified MongoDB Cloud user within the context of the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Member role. - - -Note: This resource can only be used to fetch information about MongoDB Cloud human users. To return information about an API Key, use the Return One Organization API Key endpoint. - - -Note: This resource does not return information about pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers getOrganizationUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getOrganizationUser - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-getOrganizationUser-2025-02-19-default.sh - :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-getProjectUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-getProjectUser.txt deleted file mode 100644 index 422cc877d9..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-getProjectUser.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-getProjectUser: - -========================================== -atlas api mongoDbCloudUsers getProjectUser -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns information about the specified MongoDB Cloud user within the context of the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -Note: You can only use this resource to fetch information about MongoDB Cloud human users. To return information about an API Key, use the Return One Organization API Key endpoint. - - -Note: This resource does not return information about pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers getProjectUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectUser - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-getProjectUser-2025-02-19-default.sh - :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-getUserByName.txt b/docs/command/atlas-api-mongoDbCloudUsers-getUserByName.txt new file mode 100644 index 0000000000..044914de12 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-getUserByName.txt @@ -0,0 +1,91 @@ +.. _atlas-api-mongoDbCloudUsers-getUserByName: + +========================================= +atlas api mongoDbCloudUsers getUserByName +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details for one MongoDB Cloud user account with the specified username. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can't use this endpoint to return information about an API Key. To return information about an API Key, use the Return One Organization API Key endpoint. To use this resource, the requesting Service Account or API Key can have any role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getuserbyname. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers getUserByName [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getUserByName + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userName + - string + - true + - Email address that belongs to the MongoDB Cloud user account. You cannot modify this address after creating the user. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-getUserByUsername.txt b/docs/command/atlas-api-mongoDbCloudUsers-getUserByUsername.txt deleted file mode 100644 index 716a5e25f5..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-getUserByUsername.txt +++ /dev/null @@ -1,91 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-getUserByUsername: - -============================================= -atlas api mongoDbCloudUsers getUserByUsername -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details for one MongoDB Cloud user account with the specified username. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can't use this endpoint to return information about an API Key. To return information about an API Key, use the Return One Organization API Key endpoint. To use this resource, the requesting Service Account or API Key can have any role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getuserbyusername. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers getUserByUsername [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getUserByUsername - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userName - - string - - true - - Email address that belongs to the MongoDB Cloud user account. You cannot modify this address after creating the user. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-listGroupUsers.txt b/docs/command/atlas-api-mongoDbCloudUsers-listGroupUsers.txt new file mode 100644 index 0000000000..38d91b9f3c --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-listGroupUsers.txt @@ -0,0 +1,132 @@ +.. _atlas-api-mongoDbCloudUsers-listGroupUsers: + +========================================== +atlas api mongoDbCloudUsers listGroupUsers +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + + +Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupusers. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers listGroupUsers [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --flattenTeams + - "flattenTeams" : false + - false + - Flag that indicates whether the returned list should include users who belong to a team with a role in this project. You might not have assigned the individual users a role in this project. If "flattenTeams" : false, this resource returns only users with a role in the project. If `"flattenTeams" : true`, this resource returns both users with roles in the project and users who belong to teams with roles in the project. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupUsers + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --includeOrgUsers + - "includeOrgUsers": false + - false + - Flag that indicates whether the returned list should include users with implicit access to the project, the Organization Owner or Organization Read Only role. You might not have assigned the individual users a role in this project. If "includeOrgUsers": false, this resource returns only users with a role in the project. If `"includeOrgUsers": true`, this resource returns both users with roles in the project and users who have implicit access to the project through their organization role. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgMembershipStatus + - string + - false + - Flag that indicates whether to filter the returned list by users organization membership status. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - false + - Email address to filter users by. Not supported in deprecated versions. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-listGroupUsers-2025-02-19-default.sh + :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-listOrgTeamUsers.txt b/docs/command/atlas-api-mongoDbCloudUsers-listOrgTeamUsers.txt new file mode 100644 index 0000000000..2a9f46e8d1 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-listOrgTeamUsers.txt @@ -0,0 +1,126 @@ +.. _atlas-api-mongoDbCloudUsers-listOrgTeamUsers: + +============================================ +atlas api mongoDbCloudUsers listOrgTeamUsers +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified team in the organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + + +Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + + +Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgteamusers. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers listOrgTeamUsers [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgTeamUsers + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - --orgMembershipStatus + - string + - false + - Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team whose application users you want to return. + * - --userId + - string + - false + - Unique 24-hexadecimal digit string to filter users by. Not supported in deprecated versions. + * - --username + - string + - false + - Email address to filter users by. Not supported in deprecated versions. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-listOrgTeamUsers-2025-02-19-default.sh + :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-listOrgUsers.txt b/docs/command/atlas-api-mongoDbCloudUsers-listOrgUsers.txt new file mode 100644 index 0000000000..17437c1d46 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-listOrgUsers.txt @@ -0,0 +1,122 @@ +.. _atlas-api-mongoDbCloudUsers-listOrgUsers: + +======================================== +atlas api mongoDbCloudUsers listOrgUsers +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Member role. + + +Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + + +Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgusers. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers listOrgUsers [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgUsers + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - --orgMembershipStatus + - string + - false + - Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - false + - Email address to filter users by. Not supported in deprecated versions. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-listOrgUsers-2025-02-19-default.sh + :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-listOrganizationUsers.txt b/docs/command/atlas-api-mongoDbCloudUsers-listOrganizationUsers.txt deleted file mode 100644 index 5cace75d1f..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-listOrganizationUsers.txt +++ /dev/null @@ -1,122 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-listOrganizationUsers: - -================================================= -atlas api mongoDbCloudUsers listOrganizationUsers -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Member role. - - -Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - - -Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationusers. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers listOrganizationUsers [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listOrganizationUsers - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - --orgMembershipStatus - - string - - false - - Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - false - - Email address to filter users by. Not supported in deprecated versions. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-listOrganizationUsers-2025-02-19-default.sh - :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-listProjectUsers.txt b/docs/command/atlas-api-mongoDbCloudUsers-listProjectUsers.txt deleted file mode 100644 index 034220e5ad..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-listProjectUsers.txt +++ /dev/null @@ -1,132 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-listProjectUsers: - -============================================ -atlas api mongoDbCloudUsers listProjectUsers -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - - -Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectusers. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers listProjectUsers [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --flattenTeams - - "flattenTeams" : false - - false - - Flag that indicates whether the returned list should include users who belong to a team with a role in this project. You might not have assigned the individual users a role in this project. If "flattenTeams" : false, this resource returns only users with a role in the project. If `"flattenTeams" : true`, this resource returns both users with roles in the project and users who belong to teams with roles in the project. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectUsers - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --includeOrgUsers - - "includeOrgUsers": false - - false - - Flag that indicates whether the returned list should include users with implicit access to the project, the Organization Owner or Organization Read Only role. You might not have assigned the individual users a role in this project. If "includeOrgUsers": false, this resource returns only users with a role in the project. If `"includeOrgUsers": true`, this resource returns both users with roles in the project and users who have implicit access to the project through their organization role. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgMembershipStatus - - string - - false - - Flag that indicates whether to filter the returned list by users organization membership status. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - false - - Email address to filter users by. Not supported in deprecated versions. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-listProjectUsers-2025-02-19-default.sh - :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-listTeamUsers.txt b/docs/command/atlas-api-mongoDbCloudUsers-listTeamUsers.txt deleted file mode 100644 index 8c47c0f3d4..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-listTeamUsers.txt +++ /dev/null @@ -1,126 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-listTeamUsers: - -========================================= -atlas api mongoDbCloudUsers listTeamUsers -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified team in the organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - - -Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - - -Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listteamusers. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers listTeamUsers [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listTeamUsers - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - --orgMembershipStatus - - string - - false - - Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team whose application users you want to return. - * - --userId - - string - - false - - Unique 24-hexadecimal digit string to filter users by. Not supported in deprecated versions. - * - --username - - string - - false - - Email address to filter users by. Not supported in deprecated versions. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-listTeamUsers-2025-02-19-default.sh - :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeGroupUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeGroupUser.txt new file mode 100644 index 0000000000..470b25bd84 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-removeGroupUser.txt @@ -0,0 +1,108 @@ +.. _atlas-api-mongoDbCloudUsers-removeGroupUser: + +=========================================== +atlas api mongoDbCloudUsers removeGroupUser +=========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +Note: This resource cannot be used to remove pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + + +Note: To remove pending or active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users can be removed. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removegroupuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers removeGroupUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for removeGroupUser + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the [Return All MongoDB Cloud Users in One Project](#tag/MongoDB-Cloud-Users/operation/listProjectUsers) resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-removeGroupUser-2025-02-19-default.sh + :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeGroupUserRole.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeGroupUserRole.txt new file mode 100644 index 0000000000..08dbb22f64 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-removeGroupUserRole.txt @@ -0,0 +1,104 @@ +.. _atlas-api-mongoDbCloudUsers-removeGroupUserRole: + +=============================================== +atlas api mongoDbCloudUsers removeGroupUserRole +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one project-level role from the MongoDB Cloud user. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can remove a role from an active user or a user that has been invited to join the project. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +Note: This resource cannot be used to remove a role from users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removegroupuserrole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers removeGroupUserRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for removeGroupUserRole + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeOrgTeamUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeOrgTeamUser.txt new file mode 100644 index 0000000000..b0163b9dd6 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-removeOrgTeamUser.txt @@ -0,0 +1,102 @@ +.. _atlas-api-mongoDbCloudUsers-removeOrgTeamUser: + +============================================= +atlas api mongoDbCloudUsers removeOrgTeamUser +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from one team. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: This resource cannot be used to remove a user invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorgteamuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers removeOrgTeamUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for removeOrgTeamUser + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team to remove the MongoDB user from. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeOrgUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeOrgUser.txt new file mode 100644 index 0000000000..b3a48888b0 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-removeOrgUser.txt @@ -0,0 +1,106 @@ +.. _atlas-api-mongoDbCloudUsers-removeOrgUser: + +========================================= +atlas api mongoDbCloudUsers removeOrgUser +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one MongoDB Cloud user in the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: This resource cannot be used to remove pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + + +Note: To remove pending or active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users can be removed. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorguser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers removeOrgUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for removeOrgUser + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the [Return All MongoDB Cloud Users in One Organization](#tag/MongoDB-Cloud-Users/operation/listOrganizationUsers) resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-removeOrgUser-2025-02-19-default.sh + :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeOrgUserRole.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeOrgUserRole.txt new file mode 100644 index 0000000000..12764157c4 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-removeOrgUserRole.txt @@ -0,0 +1,105 @@ +.. _atlas-api-mongoDbCloudUsers-removeOrgUserRole: + +============================================= +atlas api mongoDbCloudUsers removeOrgUserRole +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one organization-level role from the MongoDB Cloud user. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can remove a role from an active user or a user that has not yet accepted the invitation to join the organization. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: This operation is atomic. + + +Note: This resource cannot be used to remove a role from users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorguserrole. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers removeOrgUserRole [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for removeOrgUserRole + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeOrganizationRole.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeOrganizationRole.txt deleted file mode 100644 index 34fd05e1e6..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-removeOrganizationRole.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-removeOrganizationRole: - -================================================== -atlas api mongoDbCloudUsers removeOrganizationRole -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one organization-level role from the MongoDB Cloud user. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can remove a role from an active user or a user that has not yet accepted the invitation to join the organization. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This operation is atomic. - - -Note: This resource cannot be used to remove a role from users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorganizationrole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers removeOrganizationRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for removeOrganizationRole - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeOrganizationUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeOrganizationUser.txt deleted file mode 100644 index 5f80d485e3..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-removeOrganizationUser.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-removeOrganizationUser: - -================================================== -atlas api mongoDbCloudUsers removeOrganizationUser -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one MongoDB Cloud user in the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This resource cannot be used to remove pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - - -Note: To remove pending or active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users can be removed. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorganizationuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers removeOrganizationUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for removeOrganizationUser - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the [Return All MongoDB Cloud Users in One Organization](#tag/MongoDB-Cloud-Users/operation/listOrganizationUsers) resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-removeOrganizationUser-2025-02-19-default.sh - :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeProjectRole.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeProjectRole.txt deleted file mode 100644 index d07a313196..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-removeProjectRole.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-removeProjectRole: - -============================================= -atlas api mongoDbCloudUsers removeProjectRole -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one project-level role from the MongoDB Cloud user. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can remove a role from an active user or a user that has been invited to join the project. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -Note: This resource cannot be used to remove a role from users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectrole. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers removeProjectRole [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for removeProjectRole - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeProjectUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeProjectUser.txt deleted file mode 100644 index 3a88b2d9af..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-removeProjectUser.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-removeProjectUser: - -============================================= -atlas api mongoDbCloudUsers removeProjectUser -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -Note: This resource cannot be used to remove pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - - -Note: To remove pending or active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users can be removed. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers removeProjectUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for removeProjectUser - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the [Return All MongoDB Cloud Users in One Project](#tag/MongoDB-Cloud-Users/operation/listProjectUsers) resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-mongoDbCloudUsers-removeProjectUser-2025-02-19-default.sh - :language: shell diff --git a/docs/command/atlas-api-mongoDbCloudUsers-removeUserFromTeam.txt b/docs/command/atlas-api-mongoDbCloudUsers-removeUserFromTeam.txt deleted file mode 100644 index 4547a9a4f6..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-removeUserFromTeam.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-removeUserFromTeam: - -============================================== -atlas api mongoDbCloudUsers removeUserFromTeam -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from one team. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This resource cannot be used to remove a user invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeuserfromteam. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers removeUserFromTeam [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for removeUserFromTeam - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team to remove the MongoDB user from. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers-updateOrgUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-updateOrgUser.txt new file mode 100644 index 0000000000..5834bb18f0 --- /dev/null +++ b/docs/command/atlas-api-mongoDbCloudUsers-updateOrgUser.txt @@ -0,0 +1,105 @@ +.. _atlas-api-mongoDbCloudUsers-updateOrgUser: + +========================================= +atlas api mongoDbCloudUsers updateOrgUser +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one MongoDB Cloud user in the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can update an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: Only include the fields you wish to update in the request body. Supplying a field with an empty value will reset that field on the user. + + +Note: This resource cannot be used to update pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorguser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api mongoDbCloudUsers updateOrgUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateOrgUser + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-mongoDbCloudUsers-updateOrganizationUser.txt b/docs/command/atlas-api-mongoDbCloudUsers-updateOrganizationUser.txt deleted file mode 100644 index c564b8a697..0000000000 --- a/docs/command/atlas-api-mongoDbCloudUsers-updateOrganizationUser.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-mongoDbCloudUsers-updateOrganizationUser: - -================================================== -atlas api mongoDbCloudUsers updateOrganizationUser -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one MongoDB Cloud user in the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can update an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: Only include the fields you wish to update in the request body. Supplying a field with an empty value will reset that field on the user. - - -Note: This resource cannot be used to update pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api mongoDbCloudUsers updateOrganizationUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateOrganizationUser - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-02-19"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-02-19". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-mongoDbCloudUsers.txt b/docs/command/atlas-api-mongoDbCloudUsers.txt index 3f5e8e90dd..d1a417c85b 100644 --- a/docs/command/atlas-api-mongoDbCloudUsers.txt +++ b/docs/command/atlas-api-mongoDbCloudUsers.txt @@ -54,47 +54,47 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-mongoDbCloudUsers-addOrganizationRole` - `Public Preview: please provide feedback `_: Adds one organization-level role to the MongoDB Cloud user. -* :ref:`atlas-api-mongoDbCloudUsers-addProjectRole` - `Public Preview: please provide feedback `_: Adds one project-level role to the MongoDB Cloud user. -* :ref:`atlas-api-mongoDbCloudUsers-addProjectUser` - `Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to one project. -* :ref:`atlas-api-mongoDbCloudUsers-addUserToTeam` - `Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to one team. -* :ref:`atlas-api-mongoDbCloudUsers-createOrganizationUser` - `Public Preview: please provide feedback `_: Invites one new or existing MongoDB Cloud user to join the organization. +* :ref:`atlas-api-mongoDbCloudUsers-addGroupUserRole` - `Public Preview: please provide feedback `_: Adds one project-level role to the MongoDB Cloud user. +* :ref:`atlas-api-mongoDbCloudUsers-addGroupUsers` - `Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to one project. +* :ref:`atlas-api-mongoDbCloudUsers-addOrgTeamUser` - `Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to one team. +* :ref:`atlas-api-mongoDbCloudUsers-addOrgUserRole` - `Public Preview: please provide feedback `_: Adds one organization-level role to the MongoDB Cloud user. +* :ref:`atlas-api-mongoDbCloudUsers-createOrgUser` - `Public Preview: please provide feedback `_: Invites one new or existing MongoDB Cloud user to join the organization. * :ref:`atlas-api-mongoDbCloudUsers-createUser` - `Public Preview: please provide feedback `_: Creates one MongoDB Cloud user account. -* :ref:`atlas-api-mongoDbCloudUsers-getOrganizationUser` - `Public Preview: please provide feedback `_: Returns information about the specified MongoDB Cloud user within the context of the specified organization. -* :ref:`atlas-api-mongoDbCloudUsers-getProjectUser` - `Public Preview: please provide feedback `_: Returns information about the specified MongoDB Cloud user within the context of the specified project. +* :ref:`atlas-api-mongoDbCloudUsers-getGroupUser` - `Public Preview: please provide feedback `_: Returns information about the specified MongoDB Cloud user within the context of the specified project. +* :ref:`atlas-api-mongoDbCloudUsers-getOrgUser` - `Public Preview: please provide feedback `_: Returns information about the specified MongoDB Cloud user within the context of the specified organization. * :ref:`atlas-api-mongoDbCloudUsers-getUser` - `Public Preview: please provide feedback `_: Returns the details for one MongoDB Cloud user account with the specified unique identifier for the user. -* :ref:`atlas-api-mongoDbCloudUsers-getUserByUsername` - `Public Preview: please provide feedback `_: Returns the details for one MongoDB Cloud user account with the specified username. -* :ref:`atlas-api-mongoDbCloudUsers-listOrganizationUsers` - `Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified organization. -* :ref:`atlas-api-mongoDbCloudUsers-listProjectUsers` - `Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified project. -* :ref:`atlas-api-mongoDbCloudUsers-listTeamUsers` - `Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified team in the organization. -* :ref:`atlas-api-mongoDbCloudUsers-removeOrganizationRole` - `Public Preview: please provide feedback `_: Removes one organization-level role from the MongoDB Cloud user. -* :ref:`atlas-api-mongoDbCloudUsers-removeOrganizationUser` - `Public Preview: please provide feedback `_: Removes one MongoDB Cloud user in the specified organization. -* :ref:`atlas-api-mongoDbCloudUsers-removeProjectRole` - `Public Preview: please provide feedback `_: Removes one project-level role from the MongoDB Cloud user. -* :ref:`atlas-api-mongoDbCloudUsers-removeProjectUser` - `Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from the specified project. -* :ref:`atlas-api-mongoDbCloudUsers-removeUserFromTeam` - `Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from one team. -* :ref:`atlas-api-mongoDbCloudUsers-updateOrganizationUser` - `Public Preview: please provide feedback `_: Updates one MongoDB Cloud user in the specified organization. +* :ref:`atlas-api-mongoDbCloudUsers-getUserByName` - `Public Preview: please provide feedback `_: Returns the details for one MongoDB Cloud user account with the specified username. +* :ref:`atlas-api-mongoDbCloudUsers-listGroupUsers` - `Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified project. +* :ref:`atlas-api-mongoDbCloudUsers-listOrgTeamUsers` - `Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified team in the organization. +* :ref:`atlas-api-mongoDbCloudUsers-listOrgUsers` - `Public Preview: please provide feedback `_: Returns details about the pending and active MongoDB Cloud users associated with the specified organization. +* :ref:`atlas-api-mongoDbCloudUsers-removeGroupUser` - `Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from the specified project. +* :ref:`atlas-api-mongoDbCloudUsers-removeGroupUserRole` - `Public Preview: please provide feedback `_: Removes one project-level role from the MongoDB Cloud user. +* :ref:`atlas-api-mongoDbCloudUsers-removeOrgTeamUser` - `Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from one team. +* :ref:`atlas-api-mongoDbCloudUsers-removeOrgUser` - `Public Preview: please provide feedback `_: Removes one MongoDB Cloud user in the specified organization. +* :ref:`atlas-api-mongoDbCloudUsers-removeOrgUserRole` - `Public Preview: please provide feedback `_: Removes one organization-level role from the MongoDB Cloud user. +* :ref:`atlas-api-mongoDbCloudUsers-updateOrgUser` - `Public Preview: please provide feedback `_: Updates one MongoDB Cloud user in the specified organization. .. toctree:: :titlesonly: - addOrganizationRole - addProjectRole - addProjectUser - addUserToTeam - createOrganizationUser + addGroupUserRole + addGroupUsers + addOrgTeamUser + addOrgUserRole + createOrgUser createUser - getOrganizationUser - getProjectUser + getGroupUser + getOrgUser getUser - getUserByUsername - listOrganizationUsers - listProjectUsers - listTeamUsers - removeOrganizationRole - removeOrganizationUser - removeProjectRole - removeProjectUser - removeUserFromTeam - updateOrganizationUser + getUserByName + listGroupUsers + listOrgTeamUsers + listOrgUsers + removeGroupUser + removeGroupUserRole + removeOrgTeamUser + removeOrgUser + removeOrgUserRole + updateOrgUser diff --git a/docs/command/atlas-api-monitoringAndLogs-downloadGroupClusterLog.txt b/docs/command/atlas-api-monitoringAndLogs-downloadGroupClusterLog.txt new file mode 100644 index 0000000000..33afcc1ea0 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-downloadGroupClusterLog.txt @@ -0,0 +1,110 @@ +.. _atlas-api-monitoringAndLogs-downloadGroupClusterLog: + +=================================================== +atlas api monitoringAndLogs downloadGroupClusterLog +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB updates process and audit logs from the cluster backend infrastructure every five minutes. Logs are stored in chunks approximately five minutes in length, but this duration may vary. If you poll the API for log files, we recommend polling every five minutes even though consecutive polls could contain some overlapping logs. This feature isn't available for M0 free clusters, M2, M5, flex, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupclusterlog. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs downloadGroupClusterLog [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --endDate + - int + - false + - Specifies the date and time for the ending point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours after the start date. If the start date is also unspecified, the value will default to the time of the request. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for downloadGroupClusterLog + * - --hostName + - string + - true + - Human-readable label that identifies the host that stores the log files that you want to download. + * - --logName + - string + - true + - Human-readable label that identifies the log file that you want to return. To return audit logs, enable *Database Auditing* for the specified project. + * - -o, --output + - string + - false + - preferred api format, can be ["gzip"] This value defaults to "gzip". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --startDate + - int + - false + - Specifies the date and time for the starting point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours prior to the end date. If the end date is also unspecified, the value will default to 24 hours prior to the time of the request. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-01-01", "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-downloadGroupClusterLog-2023-02-01-get_host_logs.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getAtlasProcess.txt b/docs/command/atlas-api-monitoringAndLogs-getAtlasProcess.txt deleted file mode 100644 index 21bdc6900c..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-getAtlasProcess.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-monitoringAndLogs-getAtlasProcess: - -=========================================== -atlas api monitoringAndLogs getAtlasProcess -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the processes for the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlasprocess. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs getAtlasProcess [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAtlasProcess - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getAtlasProcess-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getDatabase.txt b/docs/command/atlas-api-monitoringAndLogs-getDatabase.txt deleted file mode 100644 index 8ca4e1a2ee..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-getDatabase.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-monitoringAndLogs-getDatabase: - -======================================= -atlas api monitoringAndLogs getDatabase -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one database running on the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabase. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs getDatabase [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --databaseName - - string - - true - - Human-readable label that identifies the database that the specified MongoDB process serves. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getDatabase - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getDatabase-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getDatabaseMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-getDatabaseMeasurements.txt deleted file mode 100644 index 6cd09a57e7..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-getDatabaseMeasurements.txt +++ /dev/null @@ -1,126 +0,0 @@ -.. _atlas-api-monitoringAndLogs-getDatabaseMeasurements: - -=================================================== -atlas api monitoringAndLogs getDatabaseMeasurements -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the measurements of one database for the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Returns the database's on-disk storage space based on the MongoDB dbStats command output. To calculate some metric series, Atlas takes the rate between every two adjacent points. For these metric series, the first data point has a null value because Atlas can't calculate a rate for the first data point given the query time range. Atlas retrieves database metrics every 20 minutes but reduces frequency when necessary to optimize database performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabasemeasurements. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs getDatabaseMeasurements [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --databaseName - - string - - true - - Human-readable label that identifies the database that the specified MongoDB process serves. - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --granularity - - string - - true - - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getDatabaseMeasurements - * - --m - - m - - false - - One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the `m` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getDatabaseMeasurements-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getDiskMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-getDiskMeasurements.txt deleted file mode 100644 index bc0028b8de..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-getDiskMeasurements.txt +++ /dev/null @@ -1,143 +0,0 @@ -.. _atlas-api-monitoringAndLogs-getDiskMeasurements: - -=============================================== -atlas api monitoringAndLogs getDiskMeasurements -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the measurements of one disk or partition for the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Returned value can be one of the following: - - - -Throughput of I/O operations for the disk partition used for the MongoDB process - - -Percentage of time during which requests the partition issued and serviced - - -Latency per operation type of the disk partition used for the MongoDB process - - -Amount of free and used disk space on the disk partition used for the MongoDB process - - - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdiskmeasurements. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs getDiskMeasurements [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --granularity - - string - - true - - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getDiskMeasurements - * - --m - - m - - false - - One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the `m` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --partitionName - - string - - true - - Human-readable label of the disk or partition to which the measurements apply. - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getDiskMeasurements-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements.txt new file mode 100644 index 0000000000..4a089fd972 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements.txt @@ -0,0 +1,130 @@ +.. _atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements: + +================================================================== +atlas api monitoringAndLogs getGroupHostFtsMetricIndexMeasurements +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You must have the Project Read Only or higher role to view the Atlas Search metric types. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouphostftsmetricindexmeasurements. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs getGroupHostFtsMetricIndexMeasurements [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --collectionName + - string + - true + - Human-readable label that identifies the collection. + * - --databaseName + - string + - true + - Human-readable label that identifies the database. + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --granularity + - string + - true + - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupHostFtsMetricIndexMeasurements + * - --indexName + - string + - true + - Human-readable label that identifies the index. + * - --metrics + - stringArray + - true + - List that contains the measurements that MongoDB Atlas reports for the associated data series. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --processId + - string + - true + - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getGroupProcess.txt b/docs/command/atlas-api-monitoringAndLogs-getGroupProcess.txt new file mode 100644 index 0000000000..5563cb59d8 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-getGroupProcess.txt @@ -0,0 +1,102 @@ +.. _atlas-api-monitoringAndLogs-getGroupProcess: + +=========================================== +atlas api monitoringAndLogs getGroupProcess +=========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the processes for the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocess. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs getGroupProcess [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupProcess + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getGroupProcess-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDatabase.txt b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDatabase.txt new file mode 100644 index 0000000000..a5e00f0a1a --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDatabase.txt @@ -0,0 +1,106 @@ +.. _atlas-api-monitoringAndLogs-getGroupProcessDatabase: + +=================================================== +atlas api monitoringAndLogs getGroupProcessDatabase +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one database running on the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessdatabase. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs getGroupProcessDatabase [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --databaseName + - string + - true + - Human-readable label that identifies the database that the specified MongoDB process serves. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupProcessDatabase + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getGroupProcessDatabase-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements.txt new file mode 100644 index 0000000000..60564fa581 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements.txt @@ -0,0 +1,126 @@ +.. _atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements: + +=============================================================== +atlas api monitoringAndLogs getGroupProcessDatabaseMeasurements +=============================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the measurements of one database for the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Returns the database's on-disk storage space based on the MongoDB dbStats command output. To calculate some metric series, Atlas takes the rate between every two adjacent points. For these metric series, the first data point has a null value because Atlas can't calculate a rate for the first data point given the query time range. Atlas retrieves database metrics every 20 minutes but reduces frequency when necessary to optimize database performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessdatabasemeasurements. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs getGroupProcessDatabaseMeasurements [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --databaseName + - string + - true + - Human-readable label that identifies the database that the specified MongoDB process serves. + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --granularity + - string + - true + - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupProcessDatabaseMeasurements + * - --m + - m + - false + - One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the `m` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDisk.txt b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDisk.txt new file mode 100644 index 0000000000..3f04a53de8 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDisk.txt @@ -0,0 +1,102 @@ +.. _atlas-api-monitoringAndLogs-getGroupProcessDisk: + +=============================================== +atlas api monitoringAndLogs getGroupProcessDisk +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns measurement details for one disk or partition for the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessdisk. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs getGroupProcessDisk [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupProcessDisk + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --partitionName + - string + - true + - Human-readable label of the disk or partition to which the measurements apply. + * - --processId + - mongod + - true + - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getGroupProcessDisk-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements.txt new file mode 100644 index 0000000000..a1a206e225 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements.txt @@ -0,0 +1,143 @@ +.. _atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements: + +=========================================================== +atlas api monitoringAndLogs getGroupProcessDiskMeasurements +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the measurements of one disk or partition for the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Returned value can be one of the following: + + + +Throughput of I/O operations for the disk partition used for the MongoDB process + + +Percentage of time during which requests the partition issued and serviced + + +Latency per operation type of the disk partition used for the MongoDB process + + +Amount of free and used disk space on the disk partition used for the MongoDB process + + + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessdiskmeasurements. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs getGroupProcessDiskMeasurements [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --granularity + - string + - true + - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupProcessDiskMeasurements + * - --m + - m + - false + - One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the `m` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --partitionName + - string + - true + - Human-readable label of the disk or partition to which the measurements apply. + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getGroupProcessMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessMeasurements.txt new file mode 100644 index 0000000000..d637454722 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-getGroupProcessMeasurements.txt @@ -0,0 +1,142 @@ +.. _atlas-api-monitoringAndLogs-getGroupProcessMeasurements: + +======================================================= +atlas api monitoringAndLogs getGroupProcessMeasurements +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns disk, partition, or host measurements per process for the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Returned value can be one of the following: + + + +Throughput of I/O operations for the disk partition used for the MongoDB process + + +Percentage of time during which requests the partition issued and serviced + + +Latency per operation type of the disk partition used for the MongoDB process + + +Amount of free and used disk space on the disk partition used for the MongoDB process + + +Measurements for the host, such as CPU usage or number of I/O operations + + + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessmeasurements. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs getGroupProcessMeasurements [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --granularity + - string + - true + - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupProcessMeasurements + * - --m + - m + - false + - One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the `m` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getGroupProcessMeasurements-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getHostLogs.txt b/docs/command/atlas-api-monitoringAndLogs-getHostLogs.txt deleted file mode 100644 index ab35961c9b..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-getHostLogs.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-monitoringAndLogs-getHostLogs: - -======================================= -atlas api monitoringAndLogs getHostLogs -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB updates process and audit logs from the cluster backend infrastructure every five minutes. Logs are stored in chunks approximately five minutes in length, but this duration may vary. If you poll the API for log files, we recommend polling every five minutes even though consecutive polls could contain some overlapping logs. This feature isn't available for M0 free clusters, M2, M5, flex, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-gethostlogs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs getHostLogs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --endDate - - int - - false - - Specifies the date and time for the ending point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours after the start date. If the start date is also unspecified, the value will default to the time of the request. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getHostLogs - * - --hostName - - string - - true - - Human-readable label that identifies the host that stores the log files that you want to download. - * - --logName - - string - - true - - Human-readable label that identifies the log file that you want to return. To return audit logs, enable *Database Auditing* for the specified project. - * - -o, --output - - string - - false - - preferred api format, can be ["gzip"] This value defaults to "gzip". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --startDate - - int - - false - - Specifies the date and time for the starting point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours prior to the end date. If the end date is also unspecified, the value will default to 24 hours prior to the time of the request. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-01-01", "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getHostLogs-2023-02-01-get_host_logs.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getHostMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-getHostMeasurements.txt deleted file mode 100644 index 530bb45903..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-getHostMeasurements.txt +++ /dev/null @@ -1,142 +0,0 @@ -.. _atlas-api-monitoringAndLogs-getHostMeasurements: - -=============================================== -atlas api monitoringAndLogs getHostMeasurements -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns disk, partition, or host measurements per process for the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Returned value can be one of the following: - - - -Throughput of I/O operations for the disk partition used for the MongoDB process - - -Percentage of time during which requests the partition issued and serviced - - -Latency per operation type of the disk partition used for the MongoDB process - - -Amount of free and used disk space on the disk partition used for the MongoDB process - - -Measurements for the host, such as CPU usage or number of I/O operations - - - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-gethostmeasurements. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs getHostMeasurements [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --granularity - - string - - true - - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getHostMeasurements - * - --m - - m - - false - - One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the `m` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getHostMeasurements-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getIndexMetrics.txt b/docs/command/atlas-api-monitoringAndLogs-getIndexMetrics.txt deleted file mode 100644 index c5027a5e18..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-getIndexMetrics.txt +++ /dev/null @@ -1,130 +0,0 @@ -.. _atlas-api-monitoringAndLogs-getIndexMetrics: - -=========================================== -atlas api monitoringAndLogs getIndexMetrics -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You must have the Project Read Only or higher role to view the Atlas Search metric types. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getindexmetrics. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs getIndexMetrics [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --collectionName - - string - - true - - Human-readable label that identifies the collection. - * - --databaseName - - string - - true - - Human-readable label that identifies the database. - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --granularity - - string - - true - - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getIndexMetrics - * - --indexName - - string - - true - - Human-readable label that identifies the index. - * - --metrics - - stringArray - - true - - List that contains the measurements that MongoDB Atlas reports for the associated data series. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --processId - - string - - true - - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getIndexMetrics-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-getMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-getMeasurements.txt deleted file mode 100644 index b2dff7d212..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-getMeasurements.txt +++ /dev/null @@ -1,118 +0,0 @@ -.. _atlas-api-monitoringAndLogs-getMeasurements: - -=========================================== -atlas api monitoringAndLogs getMeasurements -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You must have the Project Read Only or higher role to view the Atlas Search metric types. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmeasurements. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs getMeasurements [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --granularity - - string - - true - - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getMeasurements - * - --metrics - - stringArray - - true - - List that contains the metrics that you want MongoDB Atlas to report for the associated data series. If you don't set this parameter, this resource returns all hardware and status metrics for the associated data series. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --processId - - string - - true - - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-getMeasurements-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listAtlasProcesses.txt b/docs/command/atlas-api-monitoringAndLogs-listAtlasProcesses.txt deleted file mode 100644 index d3c8604664..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-listAtlasProcesses.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-monitoringAndLogs-listAtlasProcesses: - -============================================== -atlas api monitoringAndLogs listAtlasProcesses -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details of all processes for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -A MongoDB process can be either a mongod or mongos. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlasprocesses. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs listAtlasProcesses [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listAtlasProcesses - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listAtlasProcesses-2023-01-01-list_atlas_processes.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listDatabases.txt b/docs/command/atlas-api-monitoringAndLogs-listDatabases.txt deleted file mode 100644 index c89638552e..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-listDatabases.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-monitoringAndLogs-listDatabases: - -========================================= -atlas api monitoringAndLogs listDatabases -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the list of databases running on the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -M0 free clusters, M2, M5, serverless, and Flex clusters have some operational limits. The MongoDB Cloud process must be a mongod. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabases. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs listDatabases [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listDatabases - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod). The port must be the IANA port on which the MongoDB process listens for requests. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listDatabases-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listDiskMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-listDiskMeasurements.txt deleted file mode 100644 index 69cba675be..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-listDiskMeasurements.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-monitoringAndLogs-listDiskMeasurements: - -================================================ -atlas api monitoringAndLogs listDiskMeasurements -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns measurement details for one disk or partition for the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdiskmeasurements. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs listDiskMeasurements [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listDiskMeasurements - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --partitionName - - string - - true - - Human-readable label of the disk or partition to which the measurements apply. - * - --processId - - mongod - - true - - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listDiskMeasurements-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listDiskPartitions.txt b/docs/command/atlas-api-monitoringAndLogs-listDiskPartitions.txt deleted file mode 100644 index 28a3e16b58..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-listDiskPartitions.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-monitoringAndLogs-listDiskPartitions: - -============================================== -atlas api monitoringAndLogs listDiskPartitions -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the list of disks or partitions for the specified host for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdiskpartitions. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs listDiskPartitions [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listDiskPartitions - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listDiskPartitions-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements.txt new file mode 100644 index 0000000000..e1763bdc8d --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements.txt @@ -0,0 +1,124 @@ +.. _atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements: + +=================================================================== +atlas api monitoringAndLogs listGroupHostFtsMetricIndexMeasurements +=================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouphostftsmetricindexmeasurements. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs listGroupHostFtsMetricIndexMeasurements [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --collectionName + - string + - true + - Human-readable label that identifies the collection. + * - --databaseName + - string + - true + - Human-readable label that identifies the database. + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --granularity + - string + - true + - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupHostFtsMetricIndexMeasurements + * - --metrics + - stringArray + - true + - List that contains the measurements that MongoDB Atlas reports for the associated data series. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --processId + - string + - true + - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements.txt b/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements.txt new file mode 100644 index 0000000000..c3371db40b --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements.txt @@ -0,0 +1,118 @@ +.. _atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements: + +============================================================== +atlas api monitoringAndLogs listGroupHostFtsMetricMeasurements +============================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You must have the Project Read Only or higher role to view the Atlas Search metric types. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouphostftsmetricmeasurements. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs listGroupHostFtsMetricMeasurements [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --end + - string + - false + - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --granularity + - string + - true + - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupHostFtsMetricMeasurements + * - --metrics + - stringArray + - true + - List that contains the metrics that you want MongoDB Atlas to report for the associated data series. If you don't set this parameter, this resource returns all hardware and status metrics for the associated data series. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --period + - string + - false + - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. + * - --processId + - string + - true + - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. + * - --start + - string + - false + - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetrics.txt b/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetrics.txt new file mode 100644 index 0000000000..3469581bb3 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetrics.txt @@ -0,0 +1,98 @@ +.. _atlas-api-monitoringAndLogs-listGroupHostFtsMetrics: + +=================================================== +atlas api monitoringAndLogs listGroupHostFtsMetrics +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Atlas Search metric types available for one process in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You must have the Project Read Only or higher role to view the Atlas Search metric types. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouphostftsmetrics. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs listGroupHostFtsMetrics [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupHostFtsMetrics + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --processId + - string + - true + - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listGroupHostFtsMetrics-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listGroupProcessDatabases.txt b/docs/command/atlas-api-monitoringAndLogs-listGroupProcessDatabases.txt new file mode 100644 index 0000000000..0f70b7dd31 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-listGroupProcessDatabases.txt @@ -0,0 +1,114 @@ +.. _atlas-api-monitoringAndLogs-listGroupProcessDatabases: + +===================================================== +atlas api monitoringAndLogs listGroupProcessDatabases +===================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the list of databases running on the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +M0 free clusters, M2, M5, serverless, and Flex clusters have some operational limits. The MongoDB Cloud process must be a mongod. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessdatabases. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs listGroupProcessDatabases [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupProcessDatabases + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod). The port must be the IANA port on which the MongoDB process listens for requests. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listGroupProcessDatabases-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listGroupProcessDisks.txt b/docs/command/atlas-api-monitoringAndLogs-listGroupProcessDisks.txt new file mode 100644 index 0000000000..7f8bb52521 --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-listGroupProcessDisks.txt @@ -0,0 +1,114 @@ +.. _atlas-api-monitoringAndLogs-listGroupProcessDisks: + +================================================= +atlas api monitoringAndLogs listGroupProcessDisks +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the list of disks or partitions for the specified host for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessdisks. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs listGroupProcessDisks [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupProcessDisks + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listGroupProcessDisks-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listGroupProcesses.txt b/docs/command/atlas-api-monitoringAndLogs-listGroupProcesses.txt new file mode 100644 index 0000000000..30f3a67e1d --- /dev/null +++ b/docs/command/atlas-api-monitoringAndLogs-listGroupProcesses.txt @@ -0,0 +1,110 @@ +.. _atlas-api-monitoringAndLogs-listGroupProcesses: + +============================================== +atlas api monitoringAndLogs listGroupProcesses +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details of all processes for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +A MongoDB process can be either a mongod or mongos. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocesses. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api monitoringAndLogs listGroupProcesses [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupProcesses + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listGroupProcesses-2023-01-01-list_atlas_processes.sh + :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listIndexMetrics.txt b/docs/command/atlas-api-monitoringAndLogs-listIndexMetrics.txt deleted file mode 100644 index 9801b4893b..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-listIndexMetrics.txt +++ /dev/null @@ -1,124 +0,0 @@ -.. _atlas-api-monitoringAndLogs-listIndexMetrics: - -============================================ -atlas api monitoringAndLogs listIndexMetrics -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listindexmetrics. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs listIndexMetrics [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --collectionName - - string - - true - - Human-readable label that identifies the collection. - * - --databaseName - - string - - true - - Human-readable label that identifies the database. - * - --end - - string - - false - - Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --granularity - - string - - true - - Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listIndexMetrics - * - --metrics - - stringArray - - true - - List that contains the measurements that MongoDB Atlas reports for the associated data series. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --period - - string - - false - - Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**. - * - --processId - - string - - true - - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. - * - --start - - string - - false - - Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listIndexMetrics-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs-listMetricTypes.txt b/docs/command/atlas-api-monitoringAndLogs-listMetricTypes.txt deleted file mode 100644 index 1695da8cca..0000000000 --- a/docs/command/atlas-api-monitoringAndLogs-listMetricTypes.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-monitoringAndLogs-listMetricTypes: - -=========================================== -atlas api monitoringAndLogs listMetricTypes -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Atlas Search metric types available for one process in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You must have the Project Read Only or higher role to view the Atlas Search metric types. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listmetrictypes. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api monitoringAndLogs listMetricTypes [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listMetricTypes - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --processId - - string - - true - - Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-monitoringAndLogs-listMetricTypes-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-monitoringAndLogs.txt b/docs/command/atlas-api-monitoringAndLogs.txt index 7a4ed28df9..e3458f9e6c 100644 --- a/docs/command/atlas-api-monitoringAndLogs.txt +++ b/docs/command/atlas-api-monitoringAndLogs.txt @@ -54,37 +54,37 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-monitoringAndLogs-getAtlasProcess` - `Public Preview: please provide feedback `_: Returns the processes for the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-getDatabase` - `Public Preview: please provide feedback `_: Returns one database running on the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-getDatabaseMeasurements` - `Public Preview: please provide feedback `_: Returns the measurements of one database for the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-getDiskMeasurements` - `Public Preview: please provide feedback `_: Returns the measurements of one disk or partition for the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-getHostLogs` - `Public Preview: please provide feedback `_: Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-getHostMeasurements` - `Public Preview: please provide feedback `_: Returns disk, partition, or host measurements per process for the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-getIndexMetrics` - `Public Preview: please provide feedback `_: Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. -* :ref:`atlas-api-monitoringAndLogs-getMeasurements` - `Public Preview: please provide feedback `_: Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. -* :ref:`atlas-api-monitoringAndLogs-listAtlasProcesses` - `Public Preview: please provide feedback `_: Returns details of all processes for the specified project. -* :ref:`atlas-api-monitoringAndLogs-listDatabases` - `Public Preview: please provide feedback `_: Returns the list of databases running on the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-listDiskMeasurements` - `Public Preview: please provide feedback `_: Returns measurement details for one disk or partition for the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-listDiskPartitions` - `Public Preview: please provide feedback `_: Returns the list of disks or partitions for the specified host for the specified project. -* :ref:`atlas-api-monitoringAndLogs-listIndexMetrics` - `Public Preview: please provide feedback `_: Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. -* :ref:`atlas-api-monitoringAndLogs-listMetricTypes` - `Public Preview: please provide feedback `_: Returns all Atlas Search metric types available for one process in the specified project. +* :ref:`atlas-api-monitoringAndLogs-downloadGroupClusterLog` - `Public Preview: please provide feedback `_: Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements` - `Public Preview: please provide feedback `_: Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. +* :ref:`atlas-api-monitoringAndLogs-getGroupProcess` - `Public Preview: please provide feedback `_: Returns the processes for the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-getGroupProcessDatabase` - `Public Preview: please provide feedback `_: Returns one database running on the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements` - `Public Preview: please provide feedback `_: Returns the measurements of one database for the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-getGroupProcessDisk` - `Public Preview: please provide feedback `_: Returns measurement details for one disk or partition for the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements` - `Public Preview: please provide feedback `_: Returns the measurements of one disk or partition for the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-getGroupProcessMeasurements` - `Public Preview: please provide feedback `_: Returns disk, partition, or host measurements per process for the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements` - `Public Preview: please provide feedback `_: Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. +* :ref:`atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements` - `Public Preview: please provide feedback `_: Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. +* :ref:`atlas-api-monitoringAndLogs-listGroupHostFtsMetrics` - `Public Preview: please provide feedback `_: Returns all Atlas Search metric types available for one process in the specified project. +* :ref:`atlas-api-monitoringAndLogs-listGroupProcessDatabases` - `Public Preview: please provide feedback `_: Returns the list of databases running on the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-listGroupProcessDisks` - `Public Preview: please provide feedback `_: Returns the list of disks or partitions for the specified host for the specified project. +* :ref:`atlas-api-monitoringAndLogs-listGroupProcesses` - `Public Preview: please provide feedback `_: Returns details of all processes for the specified project. .. toctree:: :titlesonly: - getAtlasProcess - getDatabase - getDatabaseMeasurements - getDiskMeasurements - getHostLogs - getHostMeasurements - getIndexMetrics - getMeasurements - listAtlasProcesses - listDatabases - listDiskMeasurements - listDiskPartitions - listIndexMetrics - listMetricTypes + downloadGroupClusterLog + getGroupHostFtsMetricIndexMeasurements + getGroupProcess + getGroupProcessDatabase + getGroupProcessDatabaseMeasurements + getGroupProcessDisk + getGroupProcessDiskMeasurements + getGroupProcessMeasurements + listGroupHostFtsMetricIndexMeasurements + listGroupHostFtsMetricMeasurements + listGroupHostFtsMetrics + listGroupProcessDatabases + listGroupProcessDisks + listGroupProcesses diff --git a/docs/command/atlas-api-networkPeering-createGroupContainer.txt b/docs/command/atlas-api-networkPeering-createGroupContainer.txt new file mode 100644 index 0000000000..66463bb81a --- /dev/null +++ b/docs/command/atlas-api-networkPeering-createGroupContainer.txt @@ -0,0 +1,97 @@ +.. _atlas-api-networkPeering-createGroupContainer: + +============================================= +atlas api networkPeering createGroupContainer +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one new network peering container in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Cloud can deploy Network Peering connections in a network peering container. GCP can have one container per project. AWS and Azure can have one container per cloud provider region. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupcontainer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering createGroupContainer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupContainer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-networkPeering-createGroupPeer.txt b/docs/command/atlas-api-networkPeering-createGroupPeer.txt new file mode 100644 index 0000000000..6c513032c2 --- /dev/null +++ b/docs/command/atlas-api-networkPeering-createGroupPeer.txt @@ -0,0 +1,97 @@ +.. _atlas-api-networkPeering-createGroupPeer: + +======================================== +atlas api networkPeering createGroupPeer +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one new network peering connection in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations and prerequisites, see the Network Peering Documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategrouppeer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering createGroupPeer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupPeer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-networkPeering-createPeeringConnection.txt b/docs/command/atlas-api-networkPeering-createPeeringConnection.txt deleted file mode 100644 index 75e4adaa33..0000000000 --- a/docs/command/atlas-api-networkPeering-createPeeringConnection.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-networkPeering-createPeeringConnection: - -================================================ -atlas api networkPeering createPeeringConnection -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one new network peering connection in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations and prerequisites, see the Network Peering Documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpeeringconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering createPeeringConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createPeeringConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-networkPeering-createPeeringContainer.txt b/docs/command/atlas-api-networkPeering-createPeeringContainer.txt deleted file mode 100644 index 1afd125531..0000000000 --- a/docs/command/atlas-api-networkPeering-createPeeringContainer.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-networkPeering-createPeeringContainer: - -=============================================== -atlas api networkPeering createPeeringContainer -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one new network peering container in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Cloud can deploy Network Peering connections in a network peering container. GCP can have one container per project. AWS and Azure can have one container per cloud provider region. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpeeringcontainer. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering createPeeringContainer [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createPeeringContainer - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-networkPeering-deleteGroupContainer.txt b/docs/command/atlas-api-networkPeering-deleteGroupContainer.txt new file mode 100644 index 0000000000..156973d70a --- /dev/null +++ b/docs/command/atlas-api-networkPeering-deleteGroupContainer.txt @@ -0,0 +1,102 @@ +.. _atlas-api-networkPeering-deleteGroupContainer: + +============================================= +atlas api networkPeering deleteGroupContainer +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one network peering container in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupcontainer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering deleteGroupContainer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --containerId + - string + - true + - Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupContainer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-networkPeering-deleteGroupContainer-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-networkPeering-deleteGroupPeer.txt b/docs/command/atlas-api-networkPeering-deleteGroupPeer.txt new file mode 100644 index 0000000000..3950e87983 --- /dev/null +++ b/docs/command/atlas-api-networkPeering-deleteGroupPeer.txt @@ -0,0 +1,102 @@ +.. _atlas-api-networkPeering-deleteGroupPeer: + +======================================== +atlas api networkPeering deleteGroupPeer +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one network peering connection in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If you Removes the last network peering connection associated with a project, MongoDB Cloud also removes any AWS security groups from the project IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegrouppeer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering deleteGroupPeer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupPeer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --peerId + - string + - true + - Unique 24-hexadecimal digit string that identifies the network peering connection that you want to delete. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-networkPeering-deleteGroupPeer-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-networkPeering-deletePeeringConnection.txt b/docs/command/atlas-api-networkPeering-deletePeeringConnection.txt deleted file mode 100644 index 01122141b3..0000000000 --- a/docs/command/atlas-api-networkPeering-deletePeeringConnection.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-networkPeering-deletePeeringConnection: - -================================================ -atlas api networkPeering deletePeeringConnection -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one network peering connection in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If you Removes the last network peering connection associated with a project, MongoDB Cloud also removes any AWS security groups from the project IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepeeringconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering deletePeeringConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deletePeeringConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --peerId - - string - - true - - Unique 24-hexadecimal digit string that identifies the network peering connection that you want to delete. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-networkPeering-deletePeeringConnection-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-networkPeering-deletePeeringContainer.txt b/docs/command/atlas-api-networkPeering-deletePeeringContainer.txt deleted file mode 100644 index a4cadcf699..0000000000 --- a/docs/command/atlas-api-networkPeering-deletePeeringContainer.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-networkPeering-deletePeeringContainer: - -=============================================== -atlas api networkPeering deletePeeringContainer -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one network peering container in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepeeringcontainer. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering deletePeeringContainer [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --containerId - - string - - true - - Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deletePeeringContainer - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-networkPeering-deletePeeringContainer-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-networkPeering-disableGroupPrivateIpModePeering.txt b/docs/command/atlas-api-networkPeering-disableGroupPrivateIpModePeering.txt new file mode 100644 index 0000000000..5b405f95c9 --- /dev/null +++ b/docs/command/atlas-api-networkPeering-disableGroupPrivateIpModePeering.txt @@ -0,0 +1,97 @@ +.. _atlas-api-networkPeering-disableGroupPrivateIpModePeering: + +========================================================= +atlas api networkPeering disableGroupPrivateIpModePeering +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Disables Connect via Peering Only mode for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablegroupprivateipmodepeering. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering disableGroupPrivateIpModePeering [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for disableGroupPrivateIpModePeering + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-networkPeering-disablePeering.txt b/docs/command/atlas-api-networkPeering-disablePeering.txt deleted file mode 100644 index 9807f5cd4c..0000000000 --- a/docs/command/atlas-api-networkPeering-disablePeering.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-networkPeering-disablePeering: - -======================================= -atlas api networkPeering disablePeering -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Disables Connect via Peering Only mode for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablepeering. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering disablePeering [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for disablePeering - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-networkPeering-getGroupContainer.txt b/docs/command/atlas-api-networkPeering-getGroupContainer.txt new file mode 100644 index 0000000000..cf1454996f --- /dev/null +++ b/docs/command/atlas-api-networkPeering-getGroupContainer.txt @@ -0,0 +1,102 @@ +.. _atlas-api-networkPeering-getGroupContainer: + +========================================== +atlas api networkPeering getGroupContainer +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about one network peering container in one specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupcontainer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering getGroupContainer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --containerId + - string + - true + - Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupContainer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-networkPeering-getGroupContainer-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-networkPeering-getGroupPeer.txt b/docs/command/atlas-api-networkPeering-getGroupPeer.txt new file mode 100644 index 0000000000..36a11f2d5f --- /dev/null +++ b/docs/command/atlas-api-networkPeering-getGroupPeer.txt @@ -0,0 +1,102 @@ +.. _atlas-api-networkPeering-getGroupPeer: + +===================================== +atlas api networkPeering getGroupPeer +===================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about one specified network peering connection in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouppeer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering getGroupPeer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupPeer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --peerId + - string + - true + - Unique 24-hexadecimal digit string that identifies the network peering connection that you want to retrieve. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-networkPeering-getGroupPeer-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-networkPeering-getPeeringConnection.txt b/docs/command/atlas-api-networkPeering-getPeeringConnection.txt deleted file mode 100644 index 3b4b7d1f7e..0000000000 --- a/docs/command/atlas-api-networkPeering-getPeeringConnection.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-networkPeering-getPeeringConnection: - -============================================= -atlas api networkPeering getPeeringConnection -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about one specified network peering connection in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpeeringconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering getPeeringConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getPeeringConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --peerId - - string - - true - - Unique 24-hexadecimal digit string that identifies the network peering connection that you want to retrieve. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-networkPeering-getPeeringConnection-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-networkPeering-getPeeringContainer.txt b/docs/command/atlas-api-networkPeering-getPeeringContainer.txt deleted file mode 100644 index 8c993bda16..0000000000 --- a/docs/command/atlas-api-networkPeering-getPeeringContainer.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-networkPeering-getPeeringContainer: - -============================================ -atlas api networkPeering getPeeringContainer -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about one network peering container in one specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpeeringcontainer. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering getPeeringContainer [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --containerId - - string - - true - - Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getPeeringContainer - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-networkPeering-getPeeringContainer-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-networkPeering-listGroupContainerAll.txt b/docs/command/atlas-api-networkPeering-listGroupContainerAll.txt new file mode 100644 index 0000000000..cf674ed69b --- /dev/null +++ b/docs/command/atlas-api-networkPeering-listGroupContainerAll.txt @@ -0,0 +1,110 @@ +.. _atlas-api-networkPeering-listGroupContainerAll: + +============================================== +atlas api networkPeering listGroupContainerAll +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about all network peering containers in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcontainerall. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering listGroupContainerAll [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupContainerAll + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-networkPeering-listGroupContainerAll-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-networkPeering-listGroupContainers.txt b/docs/command/atlas-api-networkPeering-listGroupContainers.txt new file mode 100644 index 0000000000..eb8408381e --- /dev/null +++ b/docs/command/atlas-api-networkPeering-listGroupContainers.txt @@ -0,0 +1,114 @@ +.. _atlas-api-networkPeering-listGroupContainers: + +============================================ +atlas api networkPeering listGroupContainers +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about all network peering containers in the specified project for the specified cloud provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If you do not specify the cloud provider, MongoDB Cloud returns details about all network peering containers in the project for Amazon Web Services (AWS). To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcontainers. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering listGroupContainers [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupContainers + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --providerName + - string + - true + - Cloud service provider that serves the desired network peering containers. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-networkPeering-listGroupContainers-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-networkPeering-listGroupPeers.txt b/docs/command/atlas-api-networkPeering-listGroupPeers.txt new file mode 100644 index 0000000000..7cfc59a740 --- /dev/null +++ b/docs/command/atlas-api-networkPeering-listGroupPeers.txt @@ -0,0 +1,114 @@ +.. _atlas-api-networkPeering-listGroupPeers: + +======================================= +atlas api networkPeering listGroupPeers +======================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about all network peering connections in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouppeers. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering listGroupPeers [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupPeers + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --providerName + - string + - false + - Cloud service provider to use for this VPC peering connection. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-networkPeering-listGroupPeers-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-networkPeering-listPeeringConnections.txt b/docs/command/atlas-api-networkPeering-listPeeringConnections.txt deleted file mode 100644 index 6ad10aad1c..0000000000 --- a/docs/command/atlas-api-networkPeering-listPeeringConnections.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-networkPeering-listPeeringConnections: - -=============================================== -atlas api networkPeering listPeeringConnections -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about all network peering connections in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringconnections. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering listPeeringConnections [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listPeeringConnections - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --providerName - - string - - false - - Cloud service provider to use for this VPC peering connection. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-networkPeering-listPeeringConnections-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-networkPeering-listPeeringContainerByCloudProvider.txt b/docs/command/atlas-api-networkPeering-listPeeringContainerByCloudProvider.txt deleted file mode 100644 index 0e31b61106..0000000000 --- a/docs/command/atlas-api-networkPeering-listPeeringContainerByCloudProvider.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-networkPeering-listPeeringContainerByCloudProvider: - -============================================================ -atlas api networkPeering listPeeringContainerByCloudProvider -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about all network peering containers in the specified project for the specified cloud provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If you do not specify the cloud provider, MongoDB Cloud returns details about all network peering containers in the project for Amazon Web Services (AWS). To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringcontainerbycloudprovider. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering listPeeringContainerByCloudProvider [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listPeeringContainerByCloudProvider - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --providerName - - string - - true - - Cloud service provider that serves the desired network peering containers. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-networkPeering-listPeeringContainerByCloudProvider-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-networkPeering-listPeeringContainers.txt b/docs/command/atlas-api-networkPeering-listPeeringContainers.txt deleted file mode 100644 index 8271d86a6d..0000000000 --- a/docs/command/atlas-api-networkPeering-listPeeringContainers.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-networkPeering-listPeeringContainers: - -============================================== -atlas api networkPeering listPeeringContainers -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about all network peering containers in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringcontainers. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering listPeeringContainers [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listPeeringContainers - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-networkPeering-listPeeringContainers-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-networkPeering-updateGroupContainer.txt b/docs/command/atlas-api-networkPeering-updateGroupContainer.txt new file mode 100644 index 0000000000..fa95f10f4c --- /dev/null +++ b/docs/command/atlas-api-networkPeering-updateGroupContainer.txt @@ -0,0 +1,101 @@ +.. _atlas-api-networkPeering-updateGroupContainer: + +============================================= +atlas api networkPeering updateGroupContainer +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the network details and labels of one specified network peering container in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupcontainer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering updateGroupContainer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --containerId + - string + - true + - Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupContainer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-networkPeering-updateGroupPeer.txt b/docs/command/atlas-api-networkPeering-updateGroupPeer.txt new file mode 100644 index 0000000000..896695a5ef --- /dev/null +++ b/docs/command/atlas-api-networkPeering-updateGroupPeer.txt @@ -0,0 +1,101 @@ +.. _atlas-api-networkPeering-updateGroupPeer: + +======================================== +atlas api networkPeering updateGroupPeer +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one specified network peering connection in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategrouppeer. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering updateGroupPeer [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupPeer + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --peerId + - string + - true + - Unique 24-hexadecimal digit string that identifies the network peering connection that you want to update. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-networkPeering-updatePeeringConnection.txt b/docs/command/atlas-api-networkPeering-updatePeeringConnection.txt deleted file mode 100644 index 57359ff737..0000000000 --- a/docs/command/atlas-api-networkPeering-updatePeeringConnection.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-networkPeering-updatePeeringConnection: - -================================================ -atlas api networkPeering updatePeeringConnection -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one specified network peering connection in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepeeringconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering updatePeeringConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updatePeeringConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --peerId - - string - - true - - Unique 24-hexadecimal digit string that identifies the network peering connection that you want to update. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-networkPeering-updatePeeringContainer.txt b/docs/command/atlas-api-networkPeering-updatePeeringContainer.txt deleted file mode 100644 index 9bc0eea78e..0000000000 --- a/docs/command/atlas-api-networkPeering-updatePeeringContainer.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-networkPeering-updatePeeringContainer: - -=============================================== -atlas api networkPeering updatePeeringContainer -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the network details and labels of one specified network peering container in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepeeringcontainer. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering updatePeeringContainer [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --containerId - - string - - true - - Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updatePeeringContainer - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject.txt b/docs/command/atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject.txt deleted file mode 100644 index 909cc084a0..0000000000 --- a/docs/command/atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject: - -===================================================================== -atlas api networkPeering verifyConnectViaPeeringOnlyModeForOneProject -===================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Verifies if someone set the specified project to Connect via Peering Only mode. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifyconnectviapeeringonlymodeforoneproject. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api networkPeering verifyConnectViaPeeringOnlyModeForOneProject [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for verifyConnectViaPeeringOnlyModeForOneProject - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-networkPeering-verifyGroupPrivateIpMode.txt b/docs/command/atlas-api-networkPeering-verifyGroupPrivateIpMode.txt new file mode 100644 index 0000000000..f19de52254 --- /dev/null +++ b/docs/command/atlas-api-networkPeering-verifyGroupPrivateIpMode.txt @@ -0,0 +1,98 @@ +.. _atlas-api-networkPeering-verifyGroupPrivateIpMode: + +================================================= +atlas api networkPeering verifyGroupPrivateIpMode +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Verifies if someone set the specified project to Connect via Peering Only mode. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifygroupprivateipmode. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api networkPeering verifyGroupPrivateIpMode [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for verifyGroupPrivateIpMode + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-networkPeering-verifyGroupPrivateIpMode-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-networkPeering.txt b/docs/command/atlas-api-networkPeering.txt index c18ba278bc..c257fa4289 100644 --- a/docs/command/atlas-api-networkPeering.txt +++ b/docs/command/atlas-api-networkPeering.txt @@ -54,35 +54,35 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-networkPeering-createPeeringConnection` - `Public Preview: please provide feedback `_: Creates one new network peering connection in the specified project. -* :ref:`atlas-api-networkPeering-createPeeringContainer` - `Public Preview: please provide feedback `_: Creates one new network peering container in the specified project. -* :ref:`atlas-api-networkPeering-deletePeeringConnection` - `Public Preview: please provide feedback `_: Removes one network peering connection in the specified project. -* :ref:`atlas-api-networkPeering-deletePeeringContainer` - `Public Preview: please provide feedback `_: Removes one network peering container in the specified project. -* :ref:`atlas-api-networkPeering-disablePeering` - `Public Preview: please provide feedback `_: Disables Connect via Peering Only mode for the specified project. -* :ref:`atlas-api-networkPeering-getPeeringConnection` - `Public Preview: please provide feedback `_: Returns details about one specified network peering connection in the specified project. -* :ref:`atlas-api-networkPeering-getPeeringContainer` - `Public Preview: please provide feedback `_: Returns details about one network peering container in one specified project. -* :ref:`atlas-api-networkPeering-listPeeringConnections` - `Public Preview: please provide feedback `_: Returns details about all network peering connections in the specified project. -* :ref:`atlas-api-networkPeering-listPeeringContainerByCloudProvider` - `Public Preview: please provide feedback `_: Returns details about all network peering containers in the specified project for the specified cloud provider. -* :ref:`atlas-api-networkPeering-listPeeringContainers` - `Public Preview: please provide feedback `_: Returns details about all network peering containers in the specified project. -* :ref:`atlas-api-networkPeering-updatePeeringConnection` - `Public Preview: please provide feedback `_: Updates one specified network peering connection in the specified project. -* :ref:`atlas-api-networkPeering-updatePeeringContainer` - `Public Preview: please provide feedback `_: Updates the network details and labels of one specified network peering container in the specified project. -* :ref:`atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject` - `Public Preview: please provide feedback `_: Verifies if someone set the specified project to Connect via Peering Only mode. +* :ref:`atlas-api-networkPeering-createGroupContainer` - `Public Preview: please provide feedback `_: Creates one new network peering container in the specified project. +* :ref:`atlas-api-networkPeering-createGroupPeer` - `Public Preview: please provide feedback `_: Creates one new network peering connection in the specified project. +* :ref:`atlas-api-networkPeering-deleteGroupContainer` - `Public Preview: please provide feedback `_: Removes one network peering container in the specified project. +* :ref:`atlas-api-networkPeering-deleteGroupPeer` - `Public Preview: please provide feedback `_: Removes one network peering connection in the specified project. +* :ref:`atlas-api-networkPeering-disableGroupPrivateIpModePeering` - `Public Preview: please provide feedback `_: Disables Connect via Peering Only mode for the specified project. +* :ref:`atlas-api-networkPeering-getGroupContainer` - `Public Preview: please provide feedback `_: Returns details about one network peering container in one specified project. +* :ref:`atlas-api-networkPeering-getGroupPeer` - `Public Preview: please provide feedback `_: Returns details about one specified network peering connection in the specified project. +* :ref:`atlas-api-networkPeering-listGroupContainerAll` - `Public Preview: please provide feedback `_: Returns details about all network peering containers in the specified project. +* :ref:`atlas-api-networkPeering-listGroupContainers` - `Public Preview: please provide feedback `_: Returns details about all network peering containers in the specified project for the specified cloud provider. +* :ref:`atlas-api-networkPeering-listGroupPeers` - `Public Preview: please provide feedback `_: Returns details about all network peering connections in the specified project. +* :ref:`atlas-api-networkPeering-updateGroupContainer` - `Public Preview: please provide feedback `_: Updates the network details and labels of one specified network peering container in the specified project. +* :ref:`atlas-api-networkPeering-updateGroupPeer` - `Public Preview: please provide feedback `_: Updates one specified network peering connection in the specified project. +* :ref:`atlas-api-networkPeering-verifyGroupPrivateIpMode` - `Public Preview: please provide feedback `_: Verifies if someone set the specified project to Connect via Peering Only mode. .. toctree:: :titlesonly: - createPeeringConnection - createPeeringContainer - deletePeeringConnection - deletePeeringContainer - disablePeering - getPeeringConnection - getPeeringContainer - listPeeringConnections - listPeeringContainerByCloudProvider - listPeeringContainers - updatePeeringConnection - updatePeeringContainer - verifyConnectViaPeeringOnlyModeForOneProject + createGroupContainer + createGroupPeer + deleteGroupContainer + deleteGroupPeer + disableGroupPrivateIpModePeering + getGroupContainer + getGroupPeer + listGroupContainerAll + listGroupContainers + listGroupPeers + updateGroupContainer + updateGroupPeer + verifyGroupPrivateIpMode diff --git a/docs/command/atlas-api-onlineArchive-createGroupClusterOnlineArchive.txt b/docs/command/atlas-api-onlineArchive-createGroupClusterOnlineArchive.txt new file mode 100644 index 0000000000..5de21d57f9 --- /dev/null +++ b/docs/command/atlas-api-onlineArchive-createGroupClusterOnlineArchive.txt @@ -0,0 +1,109 @@ +.. _atlas-api-onlineArchive-createGroupClusterOnlineArchive: + +======================================================= +atlas api onlineArchive createGroupClusterOnlineArchive +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one online archive. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusteronlinearchive. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api onlineArchive createGroupClusterOnlineArchive [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that contains the collection for which you want to create one online archive. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterOnlineArchive + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-onlineArchive-createOnlineArchive.txt b/docs/command/atlas-api-onlineArchive-createOnlineArchive.txt deleted file mode 100644 index 4617498e57..0000000000 --- a/docs/command/atlas-api-onlineArchive-createOnlineArchive.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-onlineArchive-createOnlineArchive: - -=========================================== -atlas api onlineArchive createOnlineArchive -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one online archive. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createonlinearchive. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api onlineArchive createOnlineArchive [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that contains the collection for which you want to create one online archive. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createOnlineArchive - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-onlineArchive-deleteGroupClusterOnlineArchive.txt b/docs/command/atlas-api-onlineArchive-deleteGroupClusterOnlineArchive.txt new file mode 100644 index 0000000000..79069af22a --- /dev/null +++ b/docs/command/atlas-api-onlineArchive-deleteGroupClusterOnlineArchive.txt @@ -0,0 +1,114 @@ +.. _atlas-api-onlineArchive-deleteGroupClusterOnlineArchive: + +======================================================= +atlas api onlineArchive deleteGroupClusterOnlineArchive +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one online archive. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusteronlinearchive. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api onlineArchive deleteGroupClusterOnlineArchive [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --archiveId + - string + - true + - Unique 24-hexadecimal digit string that identifies the online archive to delete. + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that contains the collection from which you want to remove an online archive. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupClusterOnlineArchive + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-onlineArchive-deleteGroupClusterOnlineArchive-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-onlineArchive-deleteOnlineArchive.txt b/docs/command/atlas-api-onlineArchive-deleteOnlineArchive.txt deleted file mode 100644 index 7d07246800..0000000000 --- a/docs/command/atlas-api-onlineArchive-deleteOnlineArchive.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-onlineArchive-deleteOnlineArchive: - -=========================================== -atlas api onlineArchive deleteOnlineArchive -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one online archive. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteonlinearchive. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api onlineArchive deleteOnlineArchive [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --archiveId - - string - - true - - Unique 24-hexadecimal digit string that identifies the online archive to delete. - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that contains the collection from which you want to remove an online archive. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteOnlineArchive - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-onlineArchive-deleteOnlineArchive-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs.txt b/docs/command/atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs.txt new file mode 100644 index 0000000000..2f095d1a1e --- /dev/null +++ b/docs/command/atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs.txt @@ -0,0 +1,110 @@ +.. _atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs: + +================================================================== +atlas api onlineArchive downloadGroupClusterOnlineArchiveQueryLogs +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Downloads query logs for the specified online archive. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupclusteronlinearchivequerylogs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api onlineArchive downloadGroupClusterOnlineArchiveQueryLogs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --archiveOnly + - + - false + - Flag that indicates whether to download logs for queries against your online archive only or both your online archive and cluster. + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that contains the collection for which you want to return the query logs from one online archive. + * - --endDate + - int + - false + - Date and time that specifies the end point for the range of log messages to return. This resource expresses this value in the number of seconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for downloadGroupClusterOnlineArchiveQueryLogs + * - -o, --output + - string + - false + - preferred api format, can be ["gzip"] This value defaults to "gzip". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --startDate + - int + - false + - Date and time that specifies the starting point for the range of log messages to return. This resource expresses this value in the number of seconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs.txt b/docs/command/atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs.txt deleted file mode 100644 index c06c643bac..0000000000 --- a/docs/command/atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs: - -====================================================== -atlas api onlineArchive downloadOnlineArchiveQueryLogs -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Downloads query logs for the specified online archive. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadonlinearchivequerylogs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api onlineArchive downloadOnlineArchiveQueryLogs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --archiveOnly - - - - false - - Flag that indicates whether to download logs for queries against your online archive only or both your online archive and cluster. - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that contains the collection for which you want to return the query logs from one online archive. - * - --endDate - - int - - false - - Date and time that specifies the end point for the range of log messages to return. This resource expresses this value in the number of seconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for downloadOnlineArchiveQueryLogs - * - -o, --output - - string - - false - - preferred api format, can be ["gzip"] This value defaults to "gzip". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --startDate - - int - - false - - Date and time that specifies the starting point for the range of log messages to return. This resource expresses this value in the number of seconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-onlineArchive-getGroupClusterOnlineArchive.txt b/docs/command/atlas-api-onlineArchive-getGroupClusterOnlineArchive.txt new file mode 100644 index 0000000000..f37c4bcf5e --- /dev/null +++ b/docs/command/atlas-api-onlineArchive-getGroupClusterOnlineArchive.txt @@ -0,0 +1,106 @@ +.. _atlas-api-onlineArchive-getGroupClusterOnlineArchive: + +==================================================== +atlas api onlineArchive getGroupClusterOnlineArchive +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one online archive for one cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusteronlinearchive. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api onlineArchive getGroupClusterOnlineArchive [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --archiveId + - string + - true + - Unique 24-hexadecimal digit string that identifies the online archive to return. + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that contains the specified collection from which Application created the online archive. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterOnlineArchive + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-onlineArchive-getGroupClusterOnlineArchive-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-onlineArchive-getOnlineArchive.txt b/docs/command/atlas-api-onlineArchive-getOnlineArchive.txt deleted file mode 100644 index 4913c5c8be..0000000000 --- a/docs/command/atlas-api-onlineArchive-getOnlineArchive.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-onlineArchive-getOnlineArchive: - -======================================== -atlas api onlineArchive getOnlineArchive -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one online archive for one cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getonlinearchive. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api onlineArchive getOnlineArchive [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --archiveId - - string - - true - - Unique 24-hexadecimal digit string that identifies the online archive to return. - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that contains the specified collection from which Application created the online archive. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getOnlineArchive - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-onlineArchive-getOnlineArchive-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-onlineArchive-listGroupClusterOnlineArchives.txt b/docs/command/atlas-api-onlineArchive-listGroupClusterOnlineArchives.txt new file mode 100644 index 0000000000..c2fafe187e --- /dev/null +++ b/docs/command/atlas-api-onlineArchive-listGroupClusterOnlineArchives.txt @@ -0,0 +1,114 @@ +.. _atlas-api-onlineArchive-listGroupClusterOnlineArchives: + +====================================================== +atlas api onlineArchive listGroupClusterOnlineArchives +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details of all online archives. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusteronlinearchives. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api onlineArchive listGroupClusterOnlineArchives [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that contains the collection for which you want to return the online archives. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterOnlineArchives + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-onlineArchive-listGroupClusterOnlineArchives-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-onlineArchive-listOnlineArchives.txt b/docs/command/atlas-api-onlineArchive-listOnlineArchives.txt deleted file mode 100644 index 94025ee0f9..0000000000 --- a/docs/command/atlas-api-onlineArchive-listOnlineArchives.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-onlineArchive-listOnlineArchives: - -========================================== -atlas api onlineArchive listOnlineArchives -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details of all online archives. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listonlinearchives. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api onlineArchive listOnlineArchives [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that contains the collection for which you want to return the online archives. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listOnlineArchives - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-onlineArchive-listOnlineArchives-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-onlineArchive-updateGroupClusterOnlineArchive.txt b/docs/command/atlas-api-onlineArchive-updateGroupClusterOnlineArchive.txt new file mode 100644 index 0000000000..76612ef014 --- /dev/null +++ b/docs/command/atlas-api-onlineArchive-updateGroupClusterOnlineArchive.txt @@ -0,0 +1,113 @@ +.. _atlas-api-onlineArchive-updateGroupClusterOnlineArchive: + +======================================================= +atlas api onlineArchive updateGroupClusterOnlineArchive +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates, pauses, or resumes one online archive. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusteronlinearchive. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api onlineArchive updateGroupClusterOnlineArchive [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --archiveId + - string + - true + - Unique 24-hexadecimal digit string that identifies the online archive to update. + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster that contains the specified collection from which Application created the online archive. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupClusterOnlineArchive + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-onlineArchive-updateOnlineArchive.txt b/docs/command/atlas-api-onlineArchive-updateOnlineArchive.txt deleted file mode 100644 index 6a387ba44a..0000000000 --- a/docs/command/atlas-api-onlineArchive-updateOnlineArchive.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-onlineArchive-updateOnlineArchive: - -=========================================== -atlas api onlineArchive updateOnlineArchive -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates, pauses, or resumes one online archive. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateonlinearchive. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api onlineArchive updateOnlineArchive [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --archiveId - - string - - true - - Unique 24-hexadecimal digit string that identifies the online archive to update. - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster that contains the specified collection from which Application created the online archive. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateOnlineArchive - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-onlineArchive.txt b/docs/command/atlas-api-onlineArchive.txt index 0e7fbd36ce..d7fbde14f3 100644 --- a/docs/command/atlas-api-onlineArchive.txt +++ b/docs/command/atlas-api-onlineArchive.txt @@ -54,21 +54,21 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-onlineArchive-createOnlineArchive` - `Public Preview: please provide feedback `_: Creates one online archive. -* :ref:`atlas-api-onlineArchive-deleteOnlineArchive` - `Public Preview: please provide feedback `_: Removes one online archive. -* :ref:`atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs` - `Public Preview: please provide feedback `_: Downloads query logs for the specified online archive. -* :ref:`atlas-api-onlineArchive-getOnlineArchive` - `Public Preview: please provide feedback `_: Returns one online archive for one cluster. -* :ref:`atlas-api-onlineArchive-listOnlineArchives` - `Public Preview: please provide feedback `_: Returns details of all online archives. -* :ref:`atlas-api-onlineArchive-updateOnlineArchive` - `Public Preview: please provide feedback `_: Updates, pauses, or resumes one online archive. +* :ref:`atlas-api-onlineArchive-createGroupClusterOnlineArchive` - `Public Preview: please provide feedback `_: Creates one online archive. +* :ref:`atlas-api-onlineArchive-deleteGroupClusterOnlineArchive` - `Public Preview: please provide feedback `_: Removes one online archive. +* :ref:`atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs` - `Public Preview: please provide feedback `_: Downloads query logs for the specified online archive. +* :ref:`atlas-api-onlineArchive-getGroupClusterOnlineArchive` - `Public Preview: please provide feedback `_: Returns one online archive for one cluster. +* :ref:`atlas-api-onlineArchive-listGroupClusterOnlineArchives` - `Public Preview: please provide feedback `_: Returns details of all online archives. +* :ref:`atlas-api-onlineArchive-updateGroupClusterOnlineArchive` - `Public Preview: please provide feedback `_: Updates, pauses, or resumes one online archive. .. toctree:: :titlesonly: - createOnlineArchive - deleteOnlineArchive - downloadOnlineArchiveQueryLogs - getOnlineArchive - listOnlineArchives - updateOnlineArchive + createGroupClusterOnlineArchive + deleteGroupClusterOnlineArchive + downloadGroupClusterOnlineArchiveQueryLogs + getGroupClusterOnlineArchive + listGroupClusterOnlineArchives + updateGroupClusterOnlineArchive diff --git a/docs/command/atlas-api-organizations-createOrg.txt b/docs/command/atlas-api-organizations-createOrg.txt new file mode 100644 index 0000000000..72e9e9f063 --- /dev/null +++ b/docs/command/atlas-api-organizations-createOrg.txt @@ -0,0 +1,91 @@ +.. _atlas-api-organizations-createOrg: + +================================= +atlas api organizations createOrg +================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one organization in MongoDB Cloud and links it to the requesting Service Account's or API Key's organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. The requesting Service Account's or API Key's organization must be a paying organization. To learn more, see Configure a Paying Organization in the MongoDB Atlas documentation. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorg. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations createOrg [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrg + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-organizations-createOrgInvite.txt b/docs/command/atlas-api-organizations-createOrgInvite.txt new file mode 100644 index 0000000000..128d41a1e8 --- /dev/null +++ b/docs/command/atlas-api-organizations-createOrgInvite.txt @@ -0,0 +1,98 @@ +.. _atlas-api-organizations-createOrgInvite: + +======================================= +atlas api organizations createOrgInvite +======================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Invites one MongoDB Cloud user to join the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The user must accept the invitation to access information within the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: Invitation management APIs are deprecated. Use Add One MongoDB Cloud User to One Organization to invite a user. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorginvite. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations createOrgInvite [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgInvite + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-organizations-createOrganization.txt b/docs/command/atlas-api-organizations-createOrganization.txt deleted file mode 100644 index 360108b6bc..0000000000 --- a/docs/command/atlas-api-organizations-createOrganization.txt +++ /dev/null @@ -1,91 +0,0 @@ -.. _atlas-api-organizations-createOrganization: - -========================================== -atlas api organizations createOrganization -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one organization in MongoDB Cloud and links it to the requesting Service Account's or API Key's organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. The requesting Service Account's or API Key's organization must be a paying organization. To learn more, see Configure a Paying Organization in the MongoDB Atlas documentation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorganization. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations createOrganization [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createOrganization - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-organizations-createOrganizationInvitation.txt b/docs/command/atlas-api-organizations-createOrganizationInvitation.txt deleted file mode 100644 index 9e1b2feafe..0000000000 --- a/docs/command/atlas-api-organizations-createOrganizationInvitation.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-organizations-createOrganizationInvitation: - -==================================================== -atlas api organizations createOrganizationInvitation -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Invites one MongoDB Cloud user to join the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The user must accept the invitation to access information within the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: Invitation management APIs are deprecated. Use Add One MongoDB Cloud User to One Organization to invite a user. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorganizationinvitation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations createOrganizationInvitation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createOrganizationInvitation - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-organizations-deleteOrg.txt b/docs/command/atlas-api-organizations-deleteOrg.txt new file mode 100644 index 0000000000..9ffc940803 --- /dev/null +++ b/docs/command/atlas-api-organizations-deleteOrg.txt @@ -0,0 +1,100 @@ +.. _atlas-api-organizations-deleteOrg: + +================================= +atlas api organizations deleteOrg +================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Cloud imposes the following limits on this resource: + + + +Organizations with active projects cannot be removed. + + +All projects in the organization must be removed before you can remove the organization. +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorg. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations deleteOrg [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrg + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-organizations-deleteOrg-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-organizations-deleteOrgInvite.txt b/docs/command/atlas-api-organizations-deleteOrgInvite.txt new file mode 100644 index 0000000000..129916b584 --- /dev/null +++ b/docs/command/atlas-api-organizations-deleteOrgInvite.txt @@ -0,0 +1,103 @@ +.. _atlas-api-organizations-deleteOrgInvite: + +======================================= +atlas api organizations deleteOrgInvite +======================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Cancels one pending invitation sent to the specified MongoDB Cloud user to join an organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: Invitation management APIs are deprecated. Use Remove One MongoDB Cloud User From One Organization to remove a pending user. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorginvite. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations deleteOrgInvite [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrgInvite + * - --invitationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invitation. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-organizations-deleteOrgInvite-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-organizations-deleteOrganization.txt b/docs/command/atlas-api-organizations-deleteOrganization.txt deleted file mode 100644 index fb91eb69ff..0000000000 --- a/docs/command/atlas-api-organizations-deleteOrganization.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-organizations-deleteOrganization: - -========================================== -atlas api organizations deleteOrganization -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Cloud imposes the following limits on this resource: - - - -Organizations with active projects cannot be removed. - - -All projects in the organization must be removed before you can remove the organization. -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorganization. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations deleteOrganization [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteOrganization - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-organizations-deleteOrganization-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-organizations-deleteOrganizationInvitation.txt b/docs/command/atlas-api-organizations-deleteOrganizationInvitation.txt deleted file mode 100644 index b48e734d08..0000000000 --- a/docs/command/atlas-api-organizations-deleteOrganizationInvitation.txt +++ /dev/null @@ -1,103 +0,0 @@ -.. _atlas-api-organizations-deleteOrganizationInvitation: - -==================================================== -atlas api organizations deleteOrganizationInvitation -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Cancels one pending invitation sent to the specified MongoDB Cloud user to join an organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: Invitation management APIs are deprecated. Use Remove One MongoDB Cloud User From One Organization to remove a pending user. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorganizationinvitation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations deleteOrganizationInvitation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteOrganizationInvitation - * - --invitationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invitation. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-organizations-deleteOrganizationInvitation-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-organizations-getOrg.txt b/docs/command/atlas-api-organizations-getOrg.txt new file mode 100644 index 0000000000..a6f6072dee --- /dev/null +++ b/docs/command/atlas-api-organizations-getOrg.txt @@ -0,0 +1,96 @@ +.. _atlas-api-organizations-getOrg: + +============================== +atlas api organizations getOrg +============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one organization to which the requesting Service Account or API Key has access. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorg. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations getOrg [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrg + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-organizations-getOrg-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-organizations-getOrgGroups.txt b/docs/command/atlas-api-organizations-getOrgGroups.txt new file mode 100644 index 0000000000..ab41845feb --- /dev/null +++ b/docs/command/atlas-api-organizations-getOrgGroups.txt @@ -0,0 +1,129 @@ +.. _atlas-api-organizations-getOrgGroups: + +==================================== +atlas api organizations getOrgGroups +==================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns multiple projects in the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Each organization can have multiple projects. Use projects to: + + + +Isolate different environments, such as development, test, or production environments, from each other. + + +Associate different MongoDB Cloud users or teams with different environments, or give different permission to MongoDB Cloud users in different environments. + + +Maintain separate cluster security configurations. + + +Create different alert settings. + + + +To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorggroups. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations getOrgGroups [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgGroups + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --name + - string + - false + - Human-readable label of the project to use to filter the returned list. Performs a case-insensitive search for a project within the organization which is prefixed by the specified name. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-organizations-getOrgGroups-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-organizations-getOrgInvite.txt b/docs/command/atlas-api-organizations-getOrgInvite.txt new file mode 100644 index 0000000000..fcfa0ebb9e --- /dev/null +++ b/docs/command/atlas-api-organizations-getOrgInvite.txt @@ -0,0 +1,99 @@ +.. _atlas-api-organizations-getOrgInvite: + +==================================== +atlas api organizations getOrgInvite +==================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details of one pending invitation to the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: Invitation management APIs are deprecated. Use Return One MongoDB Cloud User in One Organization to return a pending user. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorginvite. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations getOrgInvite [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgInvite + * - --invitationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invitation. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-organizations-getOrgInvite-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-organizations-getOrgSettings.txt b/docs/command/atlas-api-organizations-getOrgSettings.txt new file mode 100644 index 0000000000..f153331791 --- /dev/null +++ b/docs/command/atlas-api-organizations-getOrgSettings.txt @@ -0,0 +1,96 @@ +.. _atlas-api-organizations-getOrgSettings: + +====================================== +atlas api organizations getOrgSettings +====================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about the specified organization's settings. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgsettings. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations getOrgSettings [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgSettings + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-organizations-getOrgSettings-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-organizations-getOrganization.txt b/docs/command/atlas-api-organizations-getOrganization.txt deleted file mode 100644 index 5a7b2287d1..0000000000 --- a/docs/command/atlas-api-organizations-getOrganization.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-organizations-getOrganization: - -======================================= -atlas api organizations getOrganization -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one organization to which the requesting Service Account or API Key has access. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganization. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations getOrganization [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getOrganization - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-organizations-getOrganization-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-organizations-getOrganizationInvitation.txt b/docs/command/atlas-api-organizations-getOrganizationInvitation.txt deleted file mode 100644 index dad1c7fab1..0000000000 --- a/docs/command/atlas-api-organizations-getOrganizationInvitation.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-organizations-getOrganizationInvitation: - -================================================= -atlas api organizations getOrganizationInvitation -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details of one pending invitation to the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: Invitation management APIs are deprecated. Use Return One MongoDB Cloud User in One Organization to return a pending user. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationinvitation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations getOrganizationInvitation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getOrganizationInvitation - * - --invitationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invitation. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-organizations-getOrganizationInvitation-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-organizations-getOrganizationSettings.txt b/docs/command/atlas-api-organizations-getOrganizationSettings.txt deleted file mode 100644 index 6323add4b5..0000000000 --- a/docs/command/atlas-api-organizations-getOrganizationSettings.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-organizations-getOrganizationSettings: - -=============================================== -atlas api organizations getOrganizationSettings -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about the specified organization's settings. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationsettings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations getOrganizationSettings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getOrganizationSettings - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-organizations-getOrganizationSettings-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-organizations-listOrgInvites.txt b/docs/command/atlas-api-organizations-listOrgInvites.txt new file mode 100644 index 0000000000..cf97914ca8 --- /dev/null +++ b/docs/command/atlas-api-organizations-listOrgInvites.txt @@ -0,0 +1,103 @@ +.. _atlas-api-organizations-listOrgInvites: + +====================================== +atlas api organizations listOrgInvites +====================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all pending invitations to the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: Invitation management APIs are deprecated. Use Return All MongoDB Cloud Users in One Organization and filter by orgMembershipStatus to return all pending users. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorginvites. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations listOrgInvites [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgInvites + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - false + - Email address of the user account invited to this organization. If you exclude this parameter, this resource returns all pending invitations. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-organizations-listOrgInvites-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-organizations-listOrganizationInvitations.txt b/docs/command/atlas-api-organizations-listOrganizationInvitations.txt deleted file mode 100644 index 67c1414fc5..0000000000 --- a/docs/command/atlas-api-organizations-listOrganizationInvitations.txt +++ /dev/null @@ -1,103 +0,0 @@ -.. _atlas-api-organizations-listOrganizationInvitations: - -=================================================== -atlas api organizations listOrganizationInvitations -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all pending invitations to the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: Invitation management APIs are deprecated. Use Return All MongoDB Cloud Users in One Organization and filter by orgMembershipStatus to return all pending users. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationinvitations. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations listOrganizationInvitations [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listOrganizationInvitations - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - false - - Email address of the user account invited to this organization. If you exclude this parameter, this resource returns all pending invitations. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-organizations-listOrganizationInvitations-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-organizations-listOrganizationProjects.txt b/docs/command/atlas-api-organizations-listOrganizationProjects.txt deleted file mode 100644 index d7743085a7..0000000000 --- a/docs/command/atlas-api-organizations-listOrganizationProjects.txt +++ /dev/null @@ -1,129 +0,0 @@ -.. _atlas-api-organizations-listOrganizationProjects: - -================================================ -atlas api organizations listOrganizationProjects -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns multiple projects in the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Each organization can have multiple projects. Use projects to: - - - -Isolate different environments, such as development, test, or production environments, from each other. - - -Associate different MongoDB Cloud users or teams with different environments, or give different permission to MongoDB Cloud users in different environments. - - -Maintain separate cluster security configurations. - - -Create different alert settings. - - - -To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationprojects. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations listOrganizationProjects [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listOrganizationProjects - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --name - - string - - false - - Human-readable label of the project to use to filter the returned list. Performs a case-insensitive search for a project within the organization which is prefixed by the specified name. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-organizations-listOrganizationProjects-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-organizations-listOrganizations.txt b/docs/command/atlas-api-organizations-listOrganizations.txt deleted file mode 100644 index 44d3b692fa..0000000000 --- a/docs/command/atlas-api-organizations-listOrganizations.txt +++ /dev/null @@ -1,103 +0,0 @@ -.. _atlas-api-organizations-listOrganizations: - -========================================= -atlas api organizations listOrganizations -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all organizations to which the requesting Service Account or API Key has access. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizations. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations listOrganizations [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listOrganizations - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --name - - string - - false - - Human-readable label of the organization to use to filter the returned list. Performs a case-insensitive search for an organization that starts with the specified name. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-organizations-listOrgs.txt b/docs/command/atlas-api-organizations-listOrgs.txt new file mode 100644 index 0000000000..e1c11015b3 --- /dev/null +++ b/docs/command/atlas-api-organizations-listOrgs.txt @@ -0,0 +1,103 @@ +.. _atlas-api-organizations-listOrgs: + +================================ +atlas api organizations listOrgs +================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all organizations to which the requesting Service Account or API Key has access. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations listOrgs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgs + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --name + - string + - false + - Human-readable label of the organization to use to filter the returned list. Performs a case-insensitive search for an organization that starts with the specified name. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-organizations-updateOrg.txt b/docs/command/atlas-api-organizations-updateOrg.txt new file mode 100644 index 0000000000..f2c8ed154b --- /dev/null +++ b/docs/command/atlas-api-organizations-updateOrg.txt @@ -0,0 +1,95 @@ +.. _atlas-api-organizations-updateOrg: + +================================= +atlas api organizations updateOrg +================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorg. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations updateOrg [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateOrg + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-organizations-updateOrgInviteById.txt b/docs/command/atlas-api-organizations-updateOrgInviteById.txt new file mode 100644 index 0000000000..a15406a732 --- /dev/null +++ b/docs/command/atlas-api-organizations-updateOrgInviteById.txt @@ -0,0 +1,99 @@ +.. _atlas-api-organizations-updateOrgInviteById: + +=========================================== +atlas api organizations updateOrgInviteById +=========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by its unique ID, to the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Use the Return All Organization Invitations endpoint to retrieve IDs for all pending organization invitations. To use this resource, the requesting API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorginvitebyid. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations updateOrgInviteById [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateOrgInviteById + * - --invitationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invitation. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-organizations-updateOrgInvites.txt b/docs/command/atlas-api-organizations-updateOrgInvites.txt new file mode 100644 index 0000000000..8ae9169713 --- /dev/null +++ b/docs/command/atlas-api-organizations-updateOrgInvites.txt @@ -0,0 +1,95 @@ +.. _atlas-api-organizations-updateOrgInvites: + +======================================== +atlas api organizations updateOrgInvites +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by the username of the invited user, to the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorginvites. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations updateOrgInvites [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateOrgInvites + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-organizations-updateOrgSettings.txt b/docs/command/atlas-api-organizations-updateOrgSettings.txt new file mode 100644 index 0000000000..9d4cee7082 --- /dev/null +++ b/docs/command/atlas-api-organizations-updateOrgSettings.txt @@ -0,0 +1,95 @@ +.. _atlas-api-organizations-updateOrgSettings: + +========================================= +atlas api organizations updateOrgSettings +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the organization's settings. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorgsettings. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations updateOrgSettings [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateOrgSettings + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-organizations-updateOrgUserRoles.txt b/docs/command/atlas-api-organizations-updateOrgUserRoles.txt new file mode 100644 index 0000000000..e89d976908 --- /dev/null +++ b/docs/command/atlas-api-organizations-updateOrgUserRoles.txt @@ -0,0 +1,99 @@ +.. _atlas-api-organizations-updateOrgUserRoles: + +========================================== +atlas api organizations updateOrgUserRoles +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the roles of the specified user in the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization User Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorguserroles. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api organizations updateOrgUserRoles [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateOrgUserRoles + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the user to modify. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-organizations-updateOrganization.txt b/docs/command/atlas-api-organizations-updateOrganization.txt deleted file mode 100644 index cc7ef4f679..0000000000 --- a/docs/command/atlas-api-organizations-updateOrganization.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-organizations-updateOrganization: - -========================================== -atlas api organizations updateOrganization -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganization. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations updateOrganization [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateOrganization - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-organizations-updateOrganizationInvitation.txt b/docs/command/atlas-api-organizations-updateOrganizationInvitation.txt deleted file mode 100644 index fdeed3d05a..0000000000 --- a/docs/command/atlas-api-organizations-updateOrganizationInvitation.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-organizations-updateOrganizationInvitation: - -==================================================== -atlas api organizations updateOrganizationInvitation -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by the username of the invited user, to the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationinvitation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations updateOrganizationInvitation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateOrganizationInvitation - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-organizations-updateOrganizationInvitationById.txt b/docs/command/atlas-api-organizations-updateOrganizationInvitationById.txt deleted file mode 100644 index 97b96ce5d5..0000000000 --- a/docs/command/atlas-api-organizations-updateOrganizationInvitationById.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-organizations-updateOrganizationInvitationById: - -======================================================== -atlas api organizations updateOrganizationInvitationById -======================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by its unique ID, to the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Use the Return All Organization Invitations endpoint to retrieve IDs for all pending organization invitations. To use this resource, the requesting API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationinvitationbyid. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations updateOrganizationInvitationById [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateOrganizationInvitationById - * - --invitationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invitation. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-organizations-updateOrganizationRoles.txt b/docs/command/atlas-api-organizations-updateOrganizationRoles.txt deleted file mode 100644 index b7df785369..0000000000 --- a/docs/command/atlas-api-organizations-updateOrganizationRoles.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-organizations-updateOrganizationRoles: - -=============================================== -atlas api organizations updateOrganizationRoles -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the roles of the specified user in the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization User Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationroles. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations updateOrganizationRoles [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateOrganizationRoles - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the user to modify. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-organizations-updateOrganizationSettings.txt b/docs/command/atlas-api-organizations-updateOrganizationSettings.txt deleted file mode 100644 index 938c3e176a..0000000000 --- a/docs/command/atlas-api-organizations-updateOrganizationSettings.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-organizations-updateOrganizationSettings: - -================================================== -atlas api organizations updateOrganizationSettings -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the organization's settings. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationsettings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api organizations updateOrganizationSettings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateOrganizationSettings - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-organizations.txt b/docs/command/atlas-api-organizations.txt index 8466aa5ef6..cc99a1e3fa 100644 --- a/docs/command/atlas-api-organizations.txt +++ b/docs/command/atlas-api-organizations.txt @@ -54,39 +54,39 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-organizations-createOrganization` - `Public Preview: please provide feedback `_: Creates one organization in MongoDB Cloud and links it to the requesting Service Account's or API Key's organization. -* :ref:`atlas-api-organizations-createOrganizationInvitation` - `Public Preview: please provide feedback `_: Invites one MongoDB Cloud user to join the specified organization. -* :ref:`atlas-api-organizations-deleteOrganization` - `Public Preview: please provide feedback `_: Removes one specified organization. -* :ref:`atlas-api-organizations-deleteOrganizationInvitation` - `Public Preview: please provide feedback `_: Cancels one pending invitation sent to the specified MongoDB Cloud user to join an organization. -* :ref:`atlas-api-organizations-getOrganization` - `Public Preview: please provide feedback `_: Returns one organization to which the requesting Service Account or API Key has access. -* :ref:`atlas-api-organizations-getOrganizationInvitation` - `Public Preview: please provide feedback `_: Returns the details of one pending invitation to the specified organization. -* :ref:`atlas-api-organizations-getOrganizationSettings` - `Public Preview: please provide feedback `_: Returns details about the specified organization's settings. -* :ref:`atlas-api-organizations-listOrganizationInvitations` - `Public Preview: please provide feedback `_: Returns all pending invitations to the specified organization. -* :ref:`atlas-api-organizations-listOrganizationProjects` - `Public Preview: please provide feedback `_: Returns multiple projects in the specified organization. -* :ref:`atlas-api-organizations-listOrganizations` - `Public Preview: please provide feedback `_: Returns all organizations to which the requesting Service Account or API Key has access. -* :ref:`atlas-api-organizations-updateOrganization` - `Public Preview: please provide feedback `_: Updates one organization. -* :ref:`atlas-api-organizations-updateOrganizationInvitation` - `Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by the username of the invited user, to the specified organization. -* :ref:`atlas-api-organizations-updateOrganizationInvitationById` - `Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by its unique ID, to the specified organization. -* :ref:`atlas-api-organizations-updateOrganizationRoles` - `Public Preview: please provide feedback `_: Updates the roles of the specified user in the specified organization. -* :ref:`atlas-api-organizations-updateOrganizationSettings` - `Public Preview: please provide feedback `_: Updates the organization's settings. +* :ref:`atlas-api-organizations-createOrg` - `Public Preview: please provide feedback `_: Creates one organization in MongoDB Cloud and links it to the requesting Service Account's or API Key's organization. +* :ref:`atlas-api-organizations-createOrgInvite` - `Public Preview: please provide feedback `_: Invites one MongoDB Cloud user to join the specified organization. +* :ref:`atlas-api-organizations-deleteOrg` - `Public Preview: please provide feedback `_: Removes one specified organization. +* :ref:`atlas-api-organizations-deleteOrgInvite` - `Public Preview: please provide feedback `_: Cancels one pending invitation sent to the specified MongoDB Cloud user to join an organization. +* :ref:`atlas-api-organizations-getOrg` - `Public Preview: please provide feedback `_: Returns one organization to which the requesting Service Account or API Key has access. +* :ref:`atlas-api-organizations-getOrgGroups` - `Public Preview: please provide feedback `_: Returns multiple projects in the specified organization. +* :ref:`atlas-api-organizations-getOrgInvite` - `Public Preview: please provide feedback `_: Returns the details of one pending invitation to the specified organization. +* :ref:`atlas-api-organizations-getOrgSettings` - `Public Preview: please provide feedback `_: Returns details about the specified organization's settings. +* :ref:`atlas-api-organizations-listOrgInvites` - `Public Preview: please provide feedback `_: Returns all pending invitations to the specified organization. +* :ref:`atlas-api-organizations-listOrgs` - `Public Preview: please provide feedback `_: Returns all organizations to which the requesting Service Account or API Key has access. +* :ref:`atlas-api-organizations-updateOrg` - `Public Preview: please provide feedback `_: Updates one organization. +* :ref:`atlas-api-organizations-updateOrgInviteById` - `Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by its unique ID, to the specified organization. +* :ref:`atlas-api-organizations-updateOrgInvites` - `Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by the username of the invited user, to the specified organization. +* :ref:`atlas-api-organizations-updateOrgSettings` - `Public Preview: please provide feedback `_: Updates the organization's settings. +* :ref:`atlas-api-organizations-updateOrgUserRoles` - `Public Preview: please provide feedback `_: Updates the roles of the specified user in the specified organization. .. toctree:: :titlesonly: - createOrganization - createOrganizationInvitation - deleteOrganization - deleteOrganizationInvitation - getOrganization - getOrganizationInvitation - getOrganizationSettings - listOrganizationInvitations - listOrganizationProjects - listOrganizations - updateOrganization - updateOrganizationInvitation - updateOrganizationInvitationById - updateOrganizationRoles - updateOrganizationSettings + createOrg + createOrgInvite + deleteOrg + deleteOrgInvite + getOrg + getOrgGroups + getOrgInvite + getOrgSettings + listOrgInvites + listOrgs + updateOrg + updateOrgInviteById + updateOrgInvites + updateOrgSettings + updateOrgUserRoles diff --git a/docs/command/atlas-api-performanceAdvisor-disableGroupManagedSlowMs.txt b/docs/command/atlas-api-performanceAdvisor-disableGroupManagedSlowMs.txt new file mode 100644 index 0000000000..90607f8957 --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-disableGroupManagedSlowMs.txt @@ -0,0 +1,98 @@ +.. _atlas-api-performanceAdvisor-disableGroupManagedSlowMs: + +====================================================== +atlas api performanceAdvisor disableGroupManagedSlowMs +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Disables the slow operation threshold that MongoDB Cloud calculated for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablegroupmanagedslowms. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor disableGroupManagedSlowMs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for disableGroupManagedSlowMs + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-disableGroupManagedSlowMs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-disableSlowOperationThresholding.txt b/docs/command/atlas-api-performanceAdvisor-disableSlowOperationThresholding.txt deleted file mode 100644 index bfacd308af..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-disableSlowOperationThresholding.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-performanceAdvisor-disableSlowOperationThresholding: - -============================================================= -atlas api performanceAdvisor disableSlowOperationThresholding -============================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Disables the slow operation threshold that MongoDB Cloud calculated for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disableslowoperationthresholding. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor disableSlowOperationThresholding [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for disableSlowOperationThresholding - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-disableSlowOperationThresholding-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-enableGroupManagedSlowMs.txt b/docs/command/atlas-api-performanceAdvisor-enableGroupManagedSlowMs.txt new file mode 100644 index 0000000000..905525d011 --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-enableGroupManagedSlowMs.txt @@ -0,0 +1,98 @@ +.. _atlas-api-performanceAdvisor-enableGroupManagedSlowMs: + +===================================================== +atlas api performanceAdvisor enableGroupManagedSlowMs +===================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Enables MongoDB Cloud to use its slow operation threshold for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-enablegroupmanagedslowms. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor enableGroupManagedSlowMs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for enableGroupManagedSlowMs + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-enableGroupManagedSlowMs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-enableSlowOperationThresholding.txt b/docs/command/atlas-api-performanceAdvisor-enableSlowOperationThresholding.txt deleted file mode 100644 index aa6b6525be..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-enableSlowOperationThresholding.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-performanceAdvisor-enableSlowOperationThresholding: - -============================================================ -atlas api performanceAdvisor enableSlowOperationThresholding -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Enables MongoDB Cloud to use its slow operation threshold for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-enableslowoperationthresholding. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor enableSlowOperationThresholding [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for enableSlowOperationThresholding - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-enableSlowOperationThresholding-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-getGroupManagedSlowMs.txt b/docs/command/atlas-api-performanceAdvisor-getGroupManagedSlowMs.txt new file mode 100644 index 0000000000..4e0b0ee6f9 --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-getGroupManagedSlowMs.txt @@ -0,0 +1,96 @@ +.. _atlas-api-performanceAdvisor-getGroupManagedSlowMs: + +================================================== +atlas api performanceAdvisor getGroupManagedSlowMs +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Get whether the Managed Slow MS feature is enabled. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupmanagedslowms. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor getGroupManagedSlowMs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupManagedSlowMs + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-getGroupManagedSlowMs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing.txt b/docs/command/atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing.txt new file mode 100644 index 0000000000..4f1f199bd1 --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing.txt @@ -0,0 +1,102 @@ +.. _atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing: + +============================================================================= +atlas api performanceAdvisor getGroupServerlessPerformanceAdvisorAutoIndexing +============================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Get whether the Serverless Auto Indexing feature is enabled. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This endpoint returns a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserverlessperformanceadvisorautoindexing. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor getGroupServerlessPerformanceAdvisorAutoIndexing [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupServerlessPerformanceAdvisorAutoIndexing + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-getManagedSlowMs.txt b/docs/command/atlas-api-performanceAdvisor-getManagedSlowMs.txt deleted file mode 100644 index 714eea5f31..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-getManagedSlowMs.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-performanceAdvisor-getManagedSlowMs: - -============================================= -atlas api performanceAdvisor getManagedSlowMs -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Get whether the Managed Slow MS feature is enabled. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmanagedslowms. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor getManagedSlowMs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getManagedSlowMs - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-getManagedSlowMs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-getServerlessAutoIndexing.txt b/docs/command/atlas-api-performanceAdvisor-getServerlessAutoIndexing.txt deleted file mode 100644 index 923b3da69c..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-getServerlessAutoIndexing.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-performanceAdvisor-getServerlessAutoIndexing: - -====================================================== -atlas api performanceAdvisor getServerlessAutoIndexing -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Get whether the Serverless Auto Indexing feature is enabled. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This endpoint returns a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessautoindexing. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor getServerlessAutoIndexing [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getServerlessAutoIndexing - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-getServerlessAutoIndexing-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listClusterSuggestedIndexes.txt b/docs/command/atlas-api-performanceAdvisor-listClusterSuggestedIndexes.txt deleted file mode 100644 index 98aff293b5..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-listClusterSuggestedIndexes.txt +++ /dev/null @@ -1,116 +0,0 @@ -.. _atlas-api-performanceAdvisor-listClusterSuggestedIndexes: - -======================================================== -atlas api performanceAdvisor listClusterSuggestedIndexes -======================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclustersuggestedindexes. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor listClusterSuggestedIndexes [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listClusterSuggestedIndexes - * - --namespaces - - . - - false - - Namespaces from which to retrieve suggested indexes. A namespace consists of one database and one collection resource written as .: ``.``. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (`&`) between each namespace. Omit this parameter to return results for all namespaces. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --processIds - - mongod - - false - - ProcessIds from which to retrieve suggested indexes. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (`&`) between each processId. - * - --since - - int - - false - - Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - - - If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. - - If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours. - * - --until - - int - - false - - Date and time up until which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - - - If you specify the **until** parameter, you must specify the **since** parameter. - - If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listClusterSuggestedIndexes-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listDropIndexes.txt b/docs/command/atlas-api-performanceAdvisor-listDropIndexes.txt deleted file mode 100644 index a4a8cc4d81..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-listDropIndexes.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-performanceAdvisor-listDropIndexes: - -============================================ -atlas api performanceAdvisor listDropIndexes -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests to drop. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The Performance Advisor suggests dropping unused, redundant, and hidden indexes to improve write performance and increase storage space. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdropindexes. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor listDropIndexes [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listDropIndexes - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listDropIndexes-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions.txt b/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions.txt new file mode 100644 index 0000000000..7cd20cb5e1 --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions.txt @@ -0,0 +1,94 @@ +.. _atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions: + +=================================================================================== +atlas api performanceAdvisor listGroupClusterPerformanceAdvisorDropIndexSuggestions +=================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests to drop. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The Performance Advisor suggests dropping unused, redundant, and hidden indexes to improve write performance and increase storage space. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterperformanceadvisordropindexsuggestions. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor listGroupClusterPerformanceAdvisorDropIndexSuggestions [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterPerformanceAdvisorDropIndexSuggestions + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice.txt b/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice.txt new file mode 100644 index 0000000000..76eac729ee --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice.txt @@ -0,0 +1,94 @@ +.. _atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice: + +=========================================================================== +atlas api performanceAdvisor listGroupClusterPerformanceAdvisorSchemaAdvice +=========================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the schema suggestions that the Performance Advisor detects. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The Performance Advisor provides holistic schema recommendations for your cluster by sampling documents in your most active collections and collections with slow-running queries. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterperformanceadvisorschemaadvice. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor listGroupClusterPerformanceAdvisorSchemaAdvice [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterPerformanceAdvisorSchemaAdvice + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes.txt b/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes.txt new file mode 100644 index 0000000000..20647fca4b --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes.txt @@ -0,0 +1,116 @@ +.. _atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes: + +=============================================================================== +atlas api performanceAdvisor listGroupClusterPerformanceAdvisorSuggestedIndexes +=============================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterperformanceadvisorsuggestedindexes. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor listGroupClusterPerformanceAdvisorSuggestedIndexes [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterPerformanceAdvisorSuggestedIndexes + * - --namespaces + - . + - false + - Namespaces from which to retrieve suggested indexes. A namespace consists of one database and one collection resource written as .: ``.``. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (`&`) between each namespace. Omit this parameter to return results for all namespaces. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --processIds + - mongod + - false + - ProcessIds from which to retrieve suggested indexes. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (`&`) between each processId. + * - --since + - int + - false + - Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + + - If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. + - If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours. + * - --until + - int + - false + - Date and time up until which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + + - If you specify the **until** parameter, you must specify the **since** parameter. + - If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces.txt b/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces.txt new file mode 100644 index 0000000000..707f41480b --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces.txt @@ -0,0 +1,116 @@ +.. _atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces: + +========================================================================= +atlas api performanceAdvisor listGroupProcessPerformanceAdvisorNamespaces +========================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns up to 20 namespaces for collections experiencing slow queries on the specified host. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If you specify a secondary member of a replica set that hasn't received any database read operations, the endpoint doesn't return any namespaces. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessperformanceadvisornamespaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor listGroupProcessPerformanceAdvisorNamespaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --duration + - int + - false + - Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. + + - If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. + - If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupProcessPerformanceAdvisorNamespaces + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --since + - int + - false + - Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + + - If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. + - If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs.txt b/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs.txt new file mode 100644 index 0000000000..f31bf154f7 --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs.txt @@ -0,0 +1,136 @@ +.. _atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs: + +============================================================================ +atlas api performanceAdvisor listGroupProcessPerformanceAdvisorSlowQueryLogs +============================================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns log lines for slow queries that the Performance Advisor and Query Profiler identified. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. MongoDB Cloud bases the threshold for slow queries on the average time of operations on your cluster. This enables workload-relevant recommendations. To use this resource, the requesting Service Account or API Key must have any Project Data Access role or the Project Observability Viewer role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessperformanceadvisorslowquerylogs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor listGroupProcessPerformanceAdvisorSlowQueryLogs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --duration + - int + - false + - Length of time expressed during which the query finds slow queries among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. + + - If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. + - If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupProcessPerformanceAdvisorSlowQueryLogs + * - --includeMetrics + - + - false + - Whether or not to include metrics extracted from the slow query log as separate fields. + * - --includeOpType + - + - false + - Whether or not to include the operation type (read/write/command) extracted from the slow query log as a separate field. + * - --includeReplicaState + - + - false + - Whether or not to include the replica state of the host when the slow query log was generated as a separate field. + * - --nLogs + - int + - false + - Maximum number of lines from the log to return. + * - --namespaces + - . + - false + - Namespaces from which to retrieve slow queries. A namespace consists of one database and one collection resource written as .: ``.``. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (`&`) between each namespace. Omit this parameter to return results for all namespaces. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --since + - int + - false + - Date and time from which the query retrieves the slow queries. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + + - If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. + - If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes.txt b/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes.txt new file mode 100644 index 0000000000..467f4cc957 --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes.txt @@ -0,0 +1,140 @@ +.. _atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes: + +=============================================================================== +atlas api performanceAdvisor listGroupProcessPerformanceAdvisorSuggestedIndexes +=============================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessperformanceadvisorsuggestedindexes. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor listGroupProcessPerformanceAdvisorSuggestedIndexes [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --duration + - int + - false + - Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. + + - If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. + - If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupProcessPerformanceAdvisorSuggestedIndexes + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --nExamples + - int + - false + - Maximum number of example queries that benefit from the suggested index. + * - --nIndexes + - int + - false + - Number that indicates the maximum indexes to suggest. + * - --namespaces + - . + - false + - Namespaces from which to retrieve suggested indexes. A namespace consists of one database and one collection resource written as .: ``.``. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (`&`) between each namespace. Omit this parameter to return results for all namespaces. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processId + - mongod + - true + - Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. + * - --since + - int + - false + - Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + + - If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. + - If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listSchemaAdvice.txt b/docs/command/atlas-api-performanceAdvisor-listSchemaAdvice.txt deleted file mode 100644 index ba37e40c89..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-listSchemaAdvice.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-performanceAdvisor-listSchemaAdvice: - -============================================= -atlas api performanceAdvisor listSchemaAdvice -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the schema suggestions that the Performance Advisor detects. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The Performance Advisor provides holistic schema recommendations for your cluster by sampling documents in your most active collections and collections with slow-running queries. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listschemaadvice. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor listSchemaAdvice [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listSchemaAdvice - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listSchemaAdvice-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listSlowQueries.txt b/docs/command/atlas-api-performanceAdvisor-listSlowQueries.txt deleted file mode 100644 index 2f9e4201c3..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-listSlowQueries.txt +++ /dev/null @@ -1,136 +0,0 @@ -.. _atlas-api-performanceAdvisor-listSlowQueries: - -============================================ -atlas api performanceAdvisor listSlowQueries -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns log lines for slow queries that the Performance Advisor and Query Profiler identified. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. MongoDB Cloud bases the threshold for slow queries on the average time of operations on your cluster. This enables workload-relevant recommendations. To use this resource, the requesting Service Account or API Key must have any Project Data Access role or the Project Observability Viewer role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listslowqueries. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor listSlowQueries [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --duration - - int - - false - - Length of time expressed during which the query finds slow queries among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. - - - If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. - - If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listSlowQueries - * - --includeMetrics - - - - false - - Whether or not to include metrics extracted from the slow query log as separate fields. - * - --includeOpType - - - - false - - Whether or not to include the operation type (read/write/command) extracted from the slow query log as a separate field. - * - --includeReplicaState - - - - false - - Whether or not to include the replica state of the host when the slow query log was generated as a separate field. - * - --nLogs - - int - - false - - Maximum number of lines from the log to return. - * - --namespaces - - . - - false - - Namespaces from which to retrieve slow queries. A namespace consists of one database and one collection resource written as .: ``.``. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (`&`) between each namespace. Omit this parameter to return results for all namespaces. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --since - - int - - false - - Date and time from which the query retrieves the slow queries. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - - - If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. - - If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listSlowQueries-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listSlowQueryNamespaces.txt b/docs/command/atlas-api-performanceAdvisor-listSlowQueryNamespaces.txt deleted file mode 100644 index 011610c5cf..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-listSlowQueryNamespaces.txt +++ /dev/null @@ -1,116 +0,0 @@ -.. _atlas-api-performanceAdvisor-listSlowQueryNamespaces: - -==================================================== -atlas api performanceAdvisor listSlowQueryNamespaces -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns up to 20 namespaces for collections experiencing slow queries on the specified host. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If you specify a secondary member of a replica set that hasn't received any database read operations, the endpoint doesn't return any namespaces. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listslowquerynamespaces. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor listSlowQueryNamespaces [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --duration - - int - - false - - Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. - - - If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. - - If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listSlowQueryNamespaces - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --since - - int - - false - - Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - - - If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. - - If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listSlowQueryNamespaces-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-listSuggestedIndexes.txt b/docs/command/atlas-api-performanceAdvisor-listSuggestedIndexes.txt deleted file mode 100644 index 4801247f36..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-listSuggestedIndexes.txt +++ /dev/null @@ -1,140 +0,0 @@ -.. _atlas-api-performanceAdvisor-listSuggestedIndexes: - -================================================= -atlas api performanceAdvisor listSuggestedIndexes -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsuggestedindexes. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor listSuggestedIndexes [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --duration - - int - - false - - Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. - - - If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. - - If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listSuggestedIndexes - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --nExamples - - int - - false - - Maximum number of example queries that benefit from the suggested index. - * - --nIndexes - - int - - false - - Number that indicates the maximum indexes to suggest. - * - --namespaces - - . - - false - - Namespaces from which to retrieve suggested indexes. A namespace consists of one database and one collection resource written as .: ``.``. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (`&`) between each namespace. Omit this parameter to return results for all namespaces. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processId - - mongod - - true - - Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. - * - --since - - int - - false - - Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - - - If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. - - If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-listSuggestedIndexes-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing.txt b/docs/command/atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing.txt new file mode 100644 index 0000000000..a8f8ec1d65 --- /dev/null +++ b/docs/command/atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing.txt @@ -0,0 +1,102 @@ +.. _atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing: + +============================================================================= +atlas api performanceAdvisor setGroupServerlessPerformanceAdvisorAutoIndexing +============================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Set whether the Serverless Auto Indexing feature is enabled. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This endpoint sets a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setgroupserverlessperformanceadvisorautoindexing. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api performanceAdvisor setGroupServerlessPerformanceAdvisorAutoIndexing [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --enable + - + - true + - Value that we want to set for the Serverless Auto Indexing toggle. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for setGroupServerlessPerformanceAdvisorAutoIndexing + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor-setServerlessAutoIndexing.txt b/docs/command/atlas-api-performanceAdvisor-setServerlessAutoIndexing.txt deleted file mode 100644 index 2d56acc5ca..0000000000 --- a/docs/command/atlas-api-performanceAdvisor-setServerlessAutoIndexing.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-performanceAdvisor-setServerlessAutoIndexing: - -====================================================== -atlas api performanceAdvisor setServerlessAutoIndexing -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Set whether the Serverless Auto Indexing feature is enabled. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This endpoint sets a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setserverlessautoindexing. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api performanceAdvisor setServerlessAutoIndexing [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --enable - - - - true - - Value that we want to set for the Serverless Auto Indexing toggle. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for setServerlessAutoIndexing - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-performanceAdvisor-setServerlessAutoIndexing-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-performanceAdvisor.txt b/docs/command/atlas-api-performanceAdvisor.txt index c1187dfdf8..5e88156fd9 100644 --- a/docs/command/atlas-api-performanceAdvisor.txt +++ b/docs/command/atlas-api-performanceAdvisor.txt @@ -54,31 +54,31 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-performanceAdvisor-disableSlowOperationThresholding` - `Public Preview: please provide feedback `_: Disables the slow operation threshold that MongoDB Cloud calculated for the specified project. -* :ref:`atlas-api-performanceAdvisor-enableSlowOperationThresholding` - `Public Preview: please provide feedback `_: Enables MongoDB Cloud to use its slow operation threshold for the specified project. -* :ref:`atlas-api-performanceAdvisor-getManagedSlowMs` - `Public Preview: please provide feedback `_: Get whether the Managed Slow MS feature is enabled. -* :ref:`atlas-api-performanceAdvisor-getServerlessAutoIndexing` - `Public Preview: please provide feedback `_: Get whether the Serverless Auto Indexing feature is enabled. -* :ref:`atlas-api-performanceAdvisor-listClusterSuggestedIndexes` - `Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests. -* :ref:`atlas-api-performanceAdvisor-listDropIndexes` - `Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests to drop. -* :ref:`atlas-api-performanceAdvisor-listSchemaAdvice` - `Public Preview: please provide feedback `_: Returns the schema suggestions that the Performance Advisor detects. -* :ref:`atlas-api-performanceAdvisor-listSlowQueries` - `Public Preview: please provide feedback `_: Returns log lines for slow queries that the Performance Advisor and Query Profiler identified. -* :ref:`atlas-api-performanceAdvisor-listSlowQueryNamespaces` - `Public Preview: please provide feedback `_: Returns up to 20 namespaces for collections experiencing slow queries on the specified host. -* :ref:`atlas-api-performanceAdvisor-listSuggestedIndexes` - `Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests. -* :ref:`atlas-api-performanceAdvisor-setServerlessAutoIndexing` - `Public Preview: please provide feedback `_: Set whether the Serverless Auto Indexing feature is enabled. +* :ref:`atlas-api-performanceAdvisor-disableGroupManagedSlowMs` - `Public Preview: please provide feedback `_: Disables the slow operation threshold that MongoDB Cloud calculated for the specified project. +* :ref:`atlas-api-performanceAdvisor-enableGroupManagedSlowMs` - `Public Preview: please provide feedback `_: Enables MongoDB Cloud to use its slow operation threshold for the specified project. +* :ref:`atlas-api-performanceAdvisor-getGroupManagedSlowMs` - `Public Preview: please provide feedback `_: Get whether the Managed Slow MS feature is enabled. +* :ref:`atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing` - `Public Preview: please provide feedback `_: Get whether the Serverless Auto Indexing feature is enabled. +* :ref:`atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions` - `Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests to drop. +* :ref:`atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice` - `Public Preview: please provide feedback `_: Returns the schema suggestions that the Performance Advisor detects. +* :ref:`atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes` - `Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests. +* :ref:`atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces` - `Public Preview: please provide feedback `_: Returns up to 20 namespaces for collections experiencing slow queries on the specified host. +* :ref:`atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs` - `Public Preview: please provide feedback `_: Returns log lines for slow queries that the Performance Advisor and Query Profiler identified. +* :ref:`atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes` - `Public Preview: please provide feedback `_: Returns the indexes that the Performance Advisor suggests. +* :ref:`atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing` - `Public Preview: please provide feedback `_: Set whether the Serverless Auto Indexing feature is enabled. .. toctree:: :titlesonly: - disableSlowOperationThresholding - enableSlowOperationThresholding - getManagedSlowMs - getServerlessAutoIndexing - listClusterSuggestedIndexes - listDropIndexes - listSchemaAdvice - listSlowQueries - listSlowQueryNamespaces - listSuggestedIndexes - setServerlessAutoIndexing + disableGroupManagedSlowMs + enableGroupManagedSlowMs + getGroupManagedSlowMs + getGroupServerlessPerformanceAdvisorAutoIndexing + listGroupClusterPerformanceAdvisorDropIndexSuggestions + listGroupClusterPerformanceAdvisorSchemaAdvice + listGroupClusterPerformanceAdvisorSuggestedIndexes + listGroupProcessPerformanceAdvisorNamespaces + listGroupProcessPerformanceAdvisorSlowQueryLogs + listGroupProcessPerformanceAdvisorSuggestedIndexes + setGroupServerlessPerformanceAdvisorAutoIndexing diff --git a/docs/command/atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointService.txt b/docs/command/atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointService.txt new file mode 100644 index 0000000000..d48c7b1ace --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointService.txt @@ -0,0 +1,105 @@ +.. _atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointService: + +=========================================================================== +atlas api privateEndpointServices createGroupPrivateEndpointEndpointService +=========================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one private endpoint service for the specified cloud service provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This cloud service provider manages the private endpoint service for the project. When you create a private endpoint service, MongoDB Cloud creates a network container in the project for the cloud provider for which you create the private endpoint service if one doesn't already exist. To learn more about private endpoint terminology in MongoDB Cloud, see Private Endpoint Concepts. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupprivateendpointendpointservice. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices createGroupPrivateEndpointEndpointService [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupPrivateEndpointEndpointService + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointServiceEndpoint.txt b/docs/command/atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointServiceEndpoint.txt new file mode 100644 index 0000000000..ae0bcb3913 --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointServiceEndpoint.txt @@ -0,0 +1,105 @@ +.. _atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointServiceEndpoint: + +=================================================================================== +atlas api privateEndpointServices createGroupPrivateEndpointEndpointServiceEndpoint +=================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one private endpoint for the specified cloud service provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This cloud service provider manages the private endpoint service, which in turn manages the private endpoints for the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations, limitations, and prerequisites, see the MongoDB documentation for setting up a private endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupprivateendpointendpointserviceendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices createGroupPrivateEndpointEndpointServiceEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Cloud service provider that manages this private endpoint. + * - --endpointServiceId + - string + - true + - Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to create a private endpoint. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupPrivateEndpointEndpointServiceEndpoint + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-privateEndpointServices-createPrivateEndpoint.txt b/docs/command/atlas-api-privateEndpointServices-createPrivateEndpoint.txt deleted file mode 100644 index a1a2b5a8fb..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-createPrivateEndpoint.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-privateEndpointServices-createPrivateEndpoint: - -======================================================= -atlas api privateEndpointServices createPrivateEndpoint -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one private endpoint for the specified cloud service provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This cloud service provider manages the private endpoint service, which in turn manages the private endpoints for the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations, limitations, and prerequisites, see the MongoDB documentation for setting up a private endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices createPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Cloud service provider that manages this private endpoint. - * - --endpointServiceId - - string - - true - - Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to create a private endpoint. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createPrivateEndpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-privateEndpointServices-createPrivateEndpointService.txt b/docs/command/atlas-api-privateEndpointServices-createPrivateEndpointService.txt deleted file mode 100644 index 083b4ef385..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-createPrivateEndpointService.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-privateEndpointServices-createPrivateEndpointService: - -============================================================== -atlas api privateEndpointServices createPrivateEndpointService -============================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one private endpoint service for the specified cloud service provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This cloud service provider manages the private endpoint service for the project. When you create a private endpoint service, MongoDB Cloud creates a network container in the project for the cloud provider for which you create the private endpoint service if one doesn't already exist. To learn more about private endpoint terminology in MongoDB Cloud, see Private Endpoint Concepts. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivateendpointservice. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices createPrivateEndpointService [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createPrivateEndpointService - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService.txt b/docs/command/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService.txt new file mode 100644 index 0000000000..b1e673d492 --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService.txt @@ -0,0 +1,114 @@ +.. _atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService: + +=========================================================================== +atlas api privateEndpointServices deleteGroupPrivateEndpointEndpointService +=========================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one private endpoint service from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This cloud service provider manages the private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupprivateendpointendpointservice. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices deleteGroupPrivateEndpointEndpointService [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Cloud service provider that manages this private endpoint service. + * - --endpointServiceId + - string + - true + - Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to delete. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupPrivateEndpointEndpointService + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint.txt b/docs/command/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint.txt new file mode 100644 index 0000000000..5f9b3015b2 --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint.txt @@ -0,0 +1,110 @@ +.. _atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint: + +=================================================================================== +atlas api privateEndpointServices deleteGroupPrivateEndpointEndpointServiceEndpoint +=================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one private endpoint from the specified project and private endpoint service, as managed by the specified cloud service provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +When the last private endpoint is removed from a given private endpoint service, that private endpoint service is also removed. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupprivateendpointendpointserviceendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices deleteGroupPrivateEndpointEndpointServiceEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Cloud service provider that manages this private endpoint. + * - --endpointId + - string + - true + - Unique string that identifies the private endpoint you want to delete. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints. + * - --endpointServiceId + - string + - true + - Unique 24-hexadecimal digit string that identifies the private endpoint service from which you want to delete a private endpoint. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupPrivateEndpointEndpointServiceEndpoint + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-deletePrivateEndpoint.txt b/docs/command/atlas-api-privateEndpointServices-deletePrivateEndpoint.txt deleted file mode 100644 index 57635b889c..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-deletePrivateEndpoint.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-privateEndpointServices-deletePrivateEndpoint: - -======================================================= -atlas api privateEndpointServices deletePrivateEndpoint -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one private endpoint from the specified project and private endpoint service, as managed by the specified cloud service provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -When the last private endpoint is removed from a given private endpoint service, that private endpoint service is also removed. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices deletePrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Cloud service provider that manages this private endpoint. - * - --endpointId - - string - - true - - Unique string that identifies the private endpoint you want to delete. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints. - * - --endpointServiceId - - string - - true - - Unique 24-hexadecimal digit string that identifies the private endpoint service from which you want to delete a private endpoint. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deletePrivateEndpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-deletePrivateEndpoint-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-deletePrivateEndpointService.txt b/docs/command/atlas-api-privateEndpointServices-deletePrivateEndpointService.txt deleted file mode 100644 index 7208a88a90..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-deletePrivateEndpointService.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-privateEndpointServices-deletePrivateEndpointService: - -============================================================== -atlas api privateEndpointServices deletePrivateEndpointService -============================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one private endpoint service from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This cloud service provider manages the private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivateendpointservice. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices deletePrivateEndpointService [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Cloud service provider that manages this private endpoint service. - * - --endpointServiceId - - string - - true - - Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to delete. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deletePrivateEndpointService - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-deletePrivateEndpointService-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService.txt b/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService.txt new file mode 100644 index 0000000000..b42e23ef5b --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService.txt @@ -0,0 +1,106 @@ +.. _atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService: + +======================================================================== +atlas api privateEndpointServices getGroupPrivateEndpointEndpointService +======================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the name, interfaces, and state of the specified private endpoint service from one project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The cloud service provider hosted this private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivateendpointendpointservice. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices getGroupPrivateEndpointEndpointService [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Cloud service provider that manages this private endpoint service. + * - --endpointServiceId + - string + - true + - Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupPrivateEndpointEndpointService + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint.txt b/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint.txt new file mode 100644 index 0000000000..5035a87de6 --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint.txt @@ -0,0 +1,110 @@ +.. _atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint: + +================================================================================ +atlas api privateEndpointServices getGroupPrivateEndpointEndpointServiceEndpoint +================================================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the connection state of the specified private endpoint. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The private endpoint service manages this private endpoint which belongs to one project hosted from one cloud service provider. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivateendpointendpointserviceendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices getGroupPrivateEndpointEndpointServiceEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Cloud service provider that manages this private endpoint. + * - --endpointId + - string + - true + - Unique string that identifies the private endpoint you want to return. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints. + * - --endpointServiceId + - string + - true + - Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to return a private endpoint. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupPrivateEndpointEndpointServiceEndpoint + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode.txt b/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode.txt new file mode 100644 index 0000000000..df67ffc8da --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode.txt @@ -0,0 +1,98 @@ +.. _atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode: + +===================================================================== +atlas api privateEndpointServices getGroupPrivateEndpointRegionalMode +===================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The cloud service provider manages the private endpoint for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivateendpointregionalmode. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices getGroupPrivateEndpointRegionalMode [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupPrivateEndpointRegionalMode + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-getPrivateEndpoint.txt b/docs/command/atlas-api-privateEndpointServices-getPrivateEndpoint.txt deleted file mode 100644 index 1cbaa0057e..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-getPrivateEndpoint.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-privateEndpointServices-getPrivateEndpoint: - -==================================================== -atlas api privateEndpointServices getPrivateEndpoint -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the connection state of the specified private endpoint. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The private endpoint service manages this private endpoint which belongs to one project hosted from one cloud service provider. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices getPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Cloud service provider that manages this private endpoint. - * - --endpointId - - string - - true - - Unique string that identifies the private endpoint you want to return. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints. - * - --endpointServiceId - - string - - true - - Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to return a private endpoint. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getPrivateEndpoint - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-getPrivateEndpoint-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-getPrivateEndpointService.txt b/docs/command/atlas-api-privateEndpointServices-getPrivateEndpointService.txt deleted file mode 100644 index 01ad4be3fd..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-getPrivateEndpointService.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-privateEndpointServices-getPrivateEndpointService: - -=========================================================== -atlas api privateEndpointServices getPrivateEndpointService -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the name, interfaces, and state of the specified private endpoint service from one project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The cloud service provider hosted this private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivateendpointservice. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices getPrivateEndpointService [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Cloud service provider that manages this private endpoint service. - * - --endpointServiceId - - string - - true - - Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getPrivateEndpointService - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-getPrivateEndpointService-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting.txt b/docs/command/atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting.txt deleted file mode 100644 index df378d1f1c..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting: - -======================================================================= -atlas api privateEndpointServices getRegionalizedPrivateEndpointSetting -======================================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The cloud service provider manages the private endpoint for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getregionalizedprivateendpointsetting. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices getRegionalizedPrivateEndpointSetting [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getRegionalizedPrivateEndpointSetting - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService.txt b/docs/command/atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService.txt new file mode 100644 index 0000000000..9b86b9fbdf --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService.txt @@ -0,0 +1,102 @@ +.. _atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService: + +========================================================================= +atlas api privateEndpointServices listGroupPrivateEndpointEndpointService +========================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This cloud service provider manages the private endpoint service for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprivateendpointendpointservice. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices listGroupPrivateEndpointEndpointService [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - Cloud service provider that manages this private endpoint service. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupPrivateEndpointEndpointService + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-listPrivateEndpointServices.txt b/docs/command/atlas-api-privateEndpointServices-listPrivateEndpointServices.txt deleted file mode 100644 index e526d9318e..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-listPrivateEndpointServices.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-privateEndpointServices-listPrivateEndpointServices: - -============================================================= -atlas api privateEndpointServices listPrivateEndpointServices -============================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This cloud service provider manages the private endpoint service for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprivateendpointservices. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices listPrivateEndpointServices [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - Cloud service provider that manages this private endpoint service. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listPrivateEndpointServices - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-privateEndpointServices-listPrivateEndpointServices-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-privateEndpointServices-toggleGroupPrivateEndpointRegionalMode.txt b/docs/command/atlas-api-privateEndpointServices-toggleGroupPrivateEndpointRegionalMode.txt new file mode 100644 index 0000000000..6546ab8be6 --- /dev/null +++ b/docs/command/atlas-api-privateEndpointServices-toggleGroupPrivateEndpointRegionalMode.txt @@ -0,0 +1,97 @@ +.. _atlas-api-privateEndpointServices-toggleGroupPrivateEndpointRegionalMode: + +======================================================================== +atlas api privateEndpointServices toggleGroupPrivateEndpointRegionalMode +======================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The cloud service provider manages the private endpoints for the project. Connection strings to existing multi-region and global sharded clusters change when you enable this setting. You must update your applications to use the new connection strings. This might cause downtime. To use this resource, the requesting Service Account or API Key must have the Project Owner role and all clusters in the deployment must be sharded clusters. Once enabled, you cannot create replica sets. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglegroupprivateendpointregionalmode. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api privateEndpointServices toggleGroupPrivateEndpointRegionalMode [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for toggleGroupPrivateEndpointRegionalMode + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-privateEndpointServices-toggleRegionalizedPrivateEndpointSetting.txt b/docs/command/atlas-api-privateEndpointServices-toggleRegionalizedPrivateEndpointSetting.txt deleted file mode 100644 index 99f1f75538..0000000000 --- a/docs/command/atlas-api-privateEndpointServices-toggleRegionalizedPrivateEndpointSetting.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-privateEndpointServices-toggleRegionalizedPrivateEndpointSetting: - -========================================================================== -atlas api privateEndpointServices toggleRegionalizedPrivateEndpointSetting -========================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The cloud service provider manages the private endpoints for the project. Connection strings to existing multi-region and global sharded clusters change when you enable this setting. You must update your applications to use the new connection strings. This might cause downtime. To use this resource, the requesting Service Account or API Key must have the Project Owner role and all clusters in the deployment must be sharded clusters. Once enabled, you cannot create replica sets. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-toggleregionalizedprivateendpointsetting. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api privateEndpointServices toggleRegionalizedPrivateEndpointSetting [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for toggleRegionalizedPrivateEndpointSetting - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-privateEndpointServices.txt b/docs/command/atlas-api-privateEndpointServices.txt index 0037af955e..2fce1bf685 100644 --- a/docs/command/atlas-api-privateEndpointServices.txt +++ b/docs/command/atlas-api-privateEndpointServices.txt @@ -54,27 +54,27 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-privateEndpointServices-createPrivateEndpoint` - `Public Preview: please provide feedback `_: Creates one private endpoint for the specified cloud service provider. -* :ref:`atlas-api-privateEndpointServices-createPrivateEndpointService` - `Public Preview: please provide feedback `_: Creates one private endpoint service for the specified cloud service provider. -* :ref:`atlas-api-privateEndpointServices-deletePrivateEndpoint` - `Public Preview: please provide feedback `_: Removes one private endpoint from the specified project and private endpoint service, as managed by the specified cloud service provider. -* :ref:`atlas-api-privateEndpointServices-deletePrivateEndpointService` - `Public Preview: please provide feedback `_: Removes one private endpoint service from the specified project. -* :ref:`atlas-api-privateEndpointServices-getPrivateEndpoint` - `Public Preview: please provide feedback `_: Returns the connection state of the specified private endpoint. -* :ref:`atlas-api-privateEndpointServices-getPrivateEndpointService` - `Public Preview: please provide feedback `_: Returns the name, interfaces, and state of the specified private endpoint service from one project. -* :ref:`atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting` - `Public Preview: please provide feedback `_: Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. -* :ref:`atlas-api-privateEndpointServices-listPrivateEndpointServices` - `Public Preview: please provide feedback `_: Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. -* :ref:`atlas-api-privateEndpointServices-toggleRegionalizedPrivateEndpointSetting` - `Public Preview: please provide feedback `_: Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. +* :ref:`atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointService` - `Public Preview: please provide feedback `_: Creates one private endpoint service for the specified cloud service provider. +* :ref:`atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointServiceEndpoint` - `Public Preview: please provide feedback `_: Creates one private endpoint for the specified cloud service provider. +* :ref:`atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService` - `Public Preview: please provide feedback `_: Removes one private endpoint service from the specified project. +* :ref:`atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint` - `Public Preview: please provide feedback `_: Removes one private endpoint from the specified project and private endpoint service, as managed by the specified cloud service provider. +* :ref:`atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService` - `Public Preview: please provide feedback `_: Returns the name, interfaces, and state of the specified private endpoint service from one project. +* :ref:`atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint` - `Public Preview: please provide feedback `_: Returns the connection state of the specified private endpoint. +* :ref:`atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode` - `Public Preview: please provide feedback `_: Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. +* :ref:`atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService` - `Public Preview: please provide feedback `_: Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. +* :ref:`atlas-api-privateEndpointServices-toggleGroupPrivateEndpointRegionalMode` - `Public Preview: please provide feedback `_: Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. .. toctree:: :titlesonly: - createPrivateEndpoint - createPrivateEndpointService - deletePrivateEndpoint - deletePrivateEndpointService - getPrivateEndpoint - getPrivateEndpointService - getRegionalizedPrivateEndpointSetting - listPrivateEndpointServices - toggleRegionalizedPrivateEndpointSetting + createGroupPrivateEndpointEndpointService + createGroupPrivateEndpointEndpointServiceEndpoint + deleteGroupPrivateEndpointEndpointService + deleteGroupPrivateEndpointEndpointServiceEndpoint + getGroupPrivateEndpointEndpointService + getGroupPrivateEndpointEndpointServiceEndpoint + getGroupPrivateEndpointRegionalMode + listGroupPrivateEndpointEndpointService + toggleGroupPrivateEndpointRegionalMode diff --git a/docs/command/atlas-api-programmaticApiKeys-addGroupApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-addGroupApiKey.txt new file mode 100644 index 0000000000..c61795cfe2 --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-addGroupApiKey.txt @@ -0,0 +1,101 @@ +.. _atlas-api-programmaticApiKeys-addGroupApiKey: + +============================================ +atlas api programmaticApiKeys addGroupApiKey +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Assigns the specified organization API key to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Users with the Project Owner role in the project associated with the API key can then use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupapikey. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys addGroupApiKey [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key that you want to assign to one project. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for addGroupApiKey + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-programmaticApiKeys-addProjectApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-addProjectApiKey.txt deleted file mode 100644 index d5793d1532..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-addProjectApiKey.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-programmaticApiKeys-addProjectApiKey: - -============================================== -atlas api programmaticApiKeys addProjectApiKey -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Assigns the specified organization API key to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Users with the Project Owner role in the project associated with the API key can then use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectapikey. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys addProjectApiKey [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key that you want to assign to one project. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for addProjectApiKey - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-programmaticApiKeys-createApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-createApiKey.txt deleted file mode 100644 index acab8b8b97..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-createApiKey.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-programmaticApiKeys-createApiKey: - -========================================== -atlas api programmaticApiKeys createApiKey -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one API key for the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -An organization API key grants programmatic access to an organization. You can't use the API key to log into the console. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikey. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys createApiKey [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createApiKey - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-programmaticApiKeys-createApiKeyAccessList.txt b/docs/command/atlas-api-programmaticApiKeys-createApiKeyAccessList.txt deleted file mode 100644 index 7f6eb76980..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-createApiKeyAccessList.txt +++ /dev/null @@ -1,111 +0,0 @@ -.. _atlas-api-programmaticApiKeys-createApiKeyAccessList: - -==================================================== -atlas api programmaticApiKeys createApiKeyAccessList -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates the access list entries for the specified organization API key. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikeyaccesslist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys createApiKeyAccessList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key for which you want to create a new access list entry. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createApiKeyAccessList - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-programmaticApiKeys-createGroupApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-createGroupApiKey.txt new file mode 100644 index 0000000000..e14bc671eb --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-createGroupApiKey.txt @@ -0,0 +1,97 @@ +.. _atlas-api-programmaticApiKeys-createGroupApiKey: + +=============================================== +atlas api programmaticApiKeys createGroupApiKey +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates and assigns the specified organization API key to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupapikey. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys createGroupApiKey [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupApiKey + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-programmaticApiKeys-createOrgApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-createOrgApiKey.txt new file mode 100644 index 0000000000..e240d76abb --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-createOrgApiKey.txt @@ -0,0 +1,95 @@ +.. _atlas-api-programmaticApiKeys-createOrgApiKey: + +============================================= +atlas api programmaticApiKeys createOrgApiKey +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one API key for the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +An organization API key grants programmatic access to an organization. You can't use the API key to log into the console. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgapikey. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys createOrgApiKey [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgApiKey + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-programmaticApiKeys-createOrgApiKeyAccessListEntry.txt b/docs/command/atlas-api-programmaticApiKeys-createOrgApiKeyAccessListEntry.txt new file mode 100644 index 0000000000..f48957a27c --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-createOrgApiKeyAccessListEntry.txt @@ -0,0 +1,111 @@ +.. _atlas-api-programmaticApiKeys-createOrgApiKeyAccessListEntry: + +============================================================ +atlas api programmaticApiKeys createOrgApiKeyAccessListEntry +============================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates the access list entries for the specified organization API key. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgapikeyaccesslistentry. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys createOrgApiKeyAccessListEntry [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key for which you want to create a new access list entry. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgApiKeyAccessListEntry + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-programmaticApiKeys-createProjectApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-createProjectApiKey.txt deleted file mode 100644 index 17eb818b26..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-createProjectApiKey.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-programmaticApiKeys-createProjectApiKey: - -================================================= -atlas api programmaticApiKeys createProjectApiKey -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates and assigns the specified organization API key to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectapikey. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys createProjectApiKey [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createProjectApiKey - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-programmaticApiKeys-deleteApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-deleteApiKey.txt deleted file mode 100644 index 0fd7e0b8f9..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-deleteApiKey.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-programmaticApiKeys-deleteApiKey: - -========================================== -atlas api programmaticApiKeys deleteApiKey -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one organization API key from the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -When you remove an API key from an organization, MongoDB Cloud also removes that key from any projects that use that key. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteapikey. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys deleteApiKey [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteApiKey - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-deleteApiKey-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry.txt b/docs/command/atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry.txt deleted file mode 100644 index 6861dd4278..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry: - -========================================================= -atlas api programmaticApiKeys deleteApiKeyAccessListEntry -========================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the specified access list entry from the specified organization API key. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Resources require all API requests originate from the IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. In addition, you cannot remove the requesting IP address from the requesting organization API key. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteapikeyaccesslistentry. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys deleteApiKeyAccessListEntry [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key for which you want to remove access list entries. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteApiKeyAccessListEntry - * - --ipAddress - - string - - true - - One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-deleteOrgApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-deleteOrgApiKey.txt new file mode 100644 index 0000000000..c4025c55ae --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-deleteOrgApiKey.txt @@ -0,0 +1,100 @@ +.. _atlas-api-programmaticApiKeys-deleteOrgApiKey: + +============================================= +atlas api programmaticApiKeys deleteOrgApiKey +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one organization API key from the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +When you remove an API key from an organization, MongoDB Cloud also removes that key from any projects that use that key. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgapikey. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys deleteOrgApiKey [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrgApiKey + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-deleteOrgApiKey-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry.txt b/docs/command/atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry.txt new file mode 100644 index 0000000000..0fe890f3ff --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry.txt @@ -0,0 +1,104 @@ +.. _atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry: + +============================================================ +atlas api programmaticApiKeys deleteOrgApiKeyAccessListEntry +============================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the specified access list entry from the specified organization API key. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Resources require all API requests originate from the IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. In addition, you cannot remove the requesting IP address from the requesting organization API key. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgapikeyaccesslistentry. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys deleteOrgApiKeyAccessListEntry [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key for which you want to remove access list entries. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrgApiKeyAccessListEntry + * - --ipAddress + - string + - true + - One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-getApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-getApiKey.txt deleted file mode 100644 index 6bcfc5bd65..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-getApiKey.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-programmaticApiKeys-getApiKey: - -======================================= -atlas api programmaticApiKeys getApiKey -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one organization API key. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the user interface. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getapikey. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys getApiKey [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key that you want to update. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getApiKey - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-getApiKey-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-getApiKeyAccessList.txt b/docs/command/atlas-api-programmaticApiKeys-getApiKeyAccessList.txt deleted file mode 100644 index f61221d3d0..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-getApiKeyAccessList.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-programmaticApiKeys-getApiKeyAccessList: - -================================================= -atlas api programmaticApiKeys getApiKeyAccessList -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one access list entry for the specified organization API key. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getapikeyaccesslist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys getApiKeyAccessList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getApiKeyAccessList - * - --ipAddress - - string - - true - - One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-getApiKeyAccessList-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-getOrgApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-getOrgApiKey.txt new file mode 100644 index 0000000000..bc8094ba95 --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-getOrgApiKey.txt @@ -0,0 +1,100 @@ +.. _atlas-api-programmaticApiKeys-getOrgApiKey: + +========================================== +atlas api programmaticApiKeys getOrgApiKey +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one organization API key. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the user interface. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgapikey. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys getOrgApiKey [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key that you want to update. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgApiKey + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-getOrgApiKey-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry.txt b/docs/command/atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry.txt new file mode 100644 index 0000000000..c642129c64 --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry.txt @@ -0,0 +1,104 @@ +.. _atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry: + +========================================================= +atlas api programmaticApiKeys getOrgApiKeyAccessListEntry +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one access list entry for the specified organization API key. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgapikeyaccesslistentry. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys getOrgApiKeyAccessListEntry [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgApiKeyAccessListEntry + * - --ipAddress + - string + - true + - One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries.txt b/docs/command/atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries.txt deleted file mode 100644 index 9efc5458dc..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries.txt +++ /dev/null @@ -1,112 +0,0 @@ -.. _atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries: - -========================================================== -atlas api programmaticApiKeys listApiKeyAccessListsEntries -========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified organization API key. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listapikeyaccesslistsentries. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys listApiKeyAccessListsEntries [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listApiKeyAccessListsEntries - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-listApiKeys.txt b/docs/command/atlas-api-programmaticApiKeys-listApiKeys.txt deleted file mode 100644 index 91d3bac2a3..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-listApiKeys.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-programmaticApiKeys-listApiKeys: - -========================================= -atlas api programmaticApiKeys listApiKeys -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all organization API keys for the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the console. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listapikeys. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys listApiKeys [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listApiKeys - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-listApiKeys-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-listGroupApiKeys.txt b/docs/command/atlas-api-programmaticApiKeys-listGroupApiKeys.txt new file mode 100644 index 0000000000..869f3763a2 --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-listGroupApiKeys.txt @@ -0,0 +1,110 @@ +.. _atlas-api-programmaticApiKeys-listGroupApiKeys: + +============================================== +atlas api programmaticApiKeys listGroupApiKeys +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all organization API keys that you assigned to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupapikeys. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys listGroupApiKeys [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupApiKeys + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-listGroupApiKeys-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries.txt b/docs/command/atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries.txt new file mode 100644 index 0000000000..1255714f83 --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries.txt @@ -0,0 +1,112 @@ +.. _atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries: + +============================================================ +atlas api programmaticApiKeys listOrgApiKeyAccessListEntries +============================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified organization API key. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgapikeyaccesslistentries. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys listOrgApiKeyAccessListEntries [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgApiKeyAccessListEntries + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-listOrgApiKeys.txt b/docs/command/atlas-api-programmaticApiKeys-listOrgApiKeys.txt new file mode 100644 index 0000000000..543f9dec3d --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-listOrgApiKeys.txt @@ -0,0 +1,108 @@ +.. _atlas-api-programmaticApiKeys-listOrgApiKeys: + +============================================ +atlas api programmaticApiKeys listOrgApiKeys +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all organization API keys for the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the console. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgapikeys. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys listOrgApiKeys [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgApiKeys + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-listOrgApiKeys-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-listProjectApiKeys.txt b/docs/command/atlas-api-programmaticApiKeys-listProjectApiKeys.txt deleted file mode 100644 index 8082b5463c..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-listProjectApiKeys.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-programmaticApiKeys-listProjectApiKeys: - -================================================ -atlas api programmaticApiKeys listProjectApiKeys -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all organization API keys that you assigned to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectapikeys. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys listProjectApiKeys [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectApiKeys - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-listProjectApiKeys-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-removeGroupApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-removeGroupApiKey.txt new file mode 100644 index 0000000000..5f25eefa98 --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-removeGroupApiKey.txt @@ -0,0 +1,102 @@ +.. _atlas-api-programmaticApiKeys-removeGroupApiKey: + +=============================================== +atlas api programmaticApiKeys removeGroupApiKey +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one organization API key from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removegroupapikey. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys removeGroupApiKey [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for removeGroupApiKey + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-removeGroupApiKey-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-removeProjectApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-removeProjectApiKey.txt deleted file mode 100644 index b0df2d311d..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-removeProjectApiKey.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-programmaticApiKeys-removeProjectApiKey: - -================================================= -atlas api programmaticApiKeys removeProjectApiKey -================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one organization API key from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectapikey. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys removeProjectApiKey [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for removeProjectApiKey - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-programmaticApiKeys-removeProjectApiKey-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-programmaticApiKeys-updateApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-updateApiKey.txt deleted file mode 100644 index 1b8fbcfc10..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-updateApiKey.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-programmaticApiKeys-updateApiKey: - -========================================== -atlas api programmaticApiKeys updateApiKey -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one organization API key in the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The organization API keys grant programmatic access to an organization. To use this resource, the requesting API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateapikey. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys updateApiKey [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key you want to update. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateApiKey - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-programmaticApiKeys-updateApiKeyRoles.txt b/docs/command/atlas-api-programmaticApiKeys-updateApiKeyRoles.txt deleted file mode 100644 index 34eee224cf..0000000000 --- a/docs/command/atlas-api-programmaticApiKeys-updateApiKeyRoles.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-programmaticApiKeys-updateApiKeyRoles: - -=============================================== -atlas api programmaticApiKeys updateApiKeyRoles -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the roles of the organization API key that you specify for the project that you specify. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You must specify at least one valid role for the project. The application removes any roles that you do not include in this request if they were previously set in the organization API key that you specify for the project. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateapikeyroles. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api programmaticApiKeys updateApiKeyRoles [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --apiUserId - - string - - true - - Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateApiKeyRoles - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-programmaticApiKeys-updateGroupApiKeyRoles.txt b/docs/command/atlas-api-programmaticApiKeys-updateGroupApiKeyRoles.txt new file mode 100644 index 0000000000..acd03a693f --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-updateGroupApiKeyRoles.txt @@ -0,0 +1,113 @@ +.. _atlas-api-programmaticApiKeys-updateGroupApiKeyRoles: + +==================================================== +atlas api programmaticApiKeys updateGroupApiKeyRoles +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the roles of the organization API key that you specify for the project that you specify. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You must specify at least one valid role for the project. The application removes any roles that you do not include in this request if they were previously set in the organization API key that you specify for the project. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupapikeyroles. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys updateGroupApiKeyRoles [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupApiKeyRoles + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-programmaticApiKeys-updateOrgApiKey.txt b/docs/command/atlas-api-programmaticApiKeys-updateOrgApiKey.txt new file mode 100644 index 0000000000..a3dd14b3ed --- /dev/null +++ b/docs/command/atlas-api-programmaticApiKeys-updateOrgApiKey.txt @@ -0,0 +1,99 @@ +.. _atlas-api-programmaticApiKeys-updateOrgApiKey: + +============================================= +atlas api programmaticApiKeys updateOrgApiKey +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one organization API key in the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The organization API keys grant programmatic access to an organization. To use this resource, the requesting API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorgapikey. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api programmaticApiKeys updateOrgApiKey [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --apiUserId + - string + - true + - Unique 24-hexadecimal digit string that identifies this organization API key you want to update. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateOrgApiKey + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-programmaticApiKeys.txt b/docs/command/atlas-api-programmaticApiKeys.txt index e7f963ed8b..0e3968c98a 100644 --- a/docs/command/atlas-api-programmaticApiKeys.txt +++ b/docs/command/atlas-api-programmaticApiKeys.txt @@ -54,37 +54,37 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-programmaticApiKeys-addProjectApiKey` - `Public Preview: please provide feedback `_: Assigns the specified organization API key to the specified project. -* :ref:`atlas-api-programmaticApiKeys-createApiKey` - `Public Preview: please provide feedback `_: Creates one API key for the specified organization. -* :ref:`atlas-api-programmaticApiKeys-createApiKeyAccessList` - `Public Preview: please provide feedback `_: Creates the access list entries for the specified organization API key. -* :ref:`atlas-api-programmaticApiKeys-createProjectApiKey` - `Public Preview: please provide feedback `_: Creates and assigns the specified organization API key to the specified project. -* :ref:`atlas-api-programmaticApiKeys-deleteApiKey` - `Public Preview: please provide feedback `_: Removes one organization API key from the specified organization. -* :ref:`atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry` - `Public Preview: please provide feedback `_: Removes the specified access list entry from the specified organization API key. -* :ref:`atlas-api-programmaticApiKeys-getApiKey` - `Public Preview: please provide feedback `_: Returns one organization API key. -* :ref:`atlas-api-programmaticApiKeys-getApiKeyAccessList` - `Public Preview: please provide feedback `_: Returns one access list entry for the specified organization API key. -* :ref:`atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries` - `Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified organization API key. -* :ref:`atlas-api-programmaticApiKeys-listApiKeys` - `Public Preview: please provide feedback `_: Returns all organization API keys for the specified organization. -* :ref:`atlas-api-programmaticApiKeys-listProjectApiKeys` - `Public Preview: please provide feedback `_: Returns all organization API keys that you assigned to the specified project. -* :ref:`atlas-api-programmaticApiKeys-removeProjectApiKey` - `Public Preview: please provide feedback `_: Removes one organization API key from the specified project. -* :ref:`atlas-api-programmaticApiKeys-updateApiKey` - `Public Preview: please provide feedback `_: Updates one organization API key in the specified organization. -* :ref:`atlas-api-programmaticApiKeys-updateApiKeyRoles` - `Public Preview: please provide feedback `_: Updates the roles of the organization API key that you specify for the project that you specify. +* :ref:`atlas-api-programmaticApiKeys-addGroupApiKey` - `Public Preview: please provide feedback `_: Assigns the specified organization API key to the specified project. +* :ref:`atlas-api-programmaticApiKeys-createGroupApiKey` - `Public Preview: please provide feedback `_: Creates and assigns the specified organization API key to the specified project. +* :ref:`atlas-api-programmaticApiKeys-createOrgApiKey` - `Public Preview: please provide feedback `_: Creates one API key for the specified organization. +* :ref:`atlas-api-programmaticApiKeys-createOrgApiKeyAccessListEntry` - `Public Preview: please provide feedback `_: Creates the access list entries for the specified organization API key. +* :ref:`atlas-api-programmaticApiKeys-deleteOrgApiKey` - `Public Preview: please provide feedback `_: Removes one organization API key from the specified organization. +* :ref:`atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry` - `Public Preview: please provide feedback `_: Removes the specified access list entry from the specified organization API key. +* :ref:`atlas-api-programmaticApiKeys-getOrgApiKey` - `Public Preview: please provide feedback `_: Returns one organization API key. +* :ref:`atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry` - `Public Preview: please provide feedback `_: Returns one access list entry for the specified organization API key. +* :ref:`atlas-api-programmaticApiKeys-listGroupApiKeys` - `Public Preview: please provide feedback `_: Returns all organization API keys that you assigned to the specified project. +* :ref:`atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries` - `Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified organization API key. +* :ref:`atlas-api-programmaticApiKeys-listOrgApiKeys` - `Public Preview: please provide feedback `_: Returns all organization API keys for the specified organization. +* :ref:`atlas-api-programmaticApiKeys-removeGroupApiKey` - `Public Preview: please provide feedback `_: Removes one organization API key from the specified project. +* :ref:`atlas-api-programmaticApiKeys-updateGroupApiKeyRoles` - `Public Preview: please provide feedback `_: Updates the roles of the organization API key that you specify for the project that you specify. +* :ref:`atlas-api-programmaticApiKeys-updateOrgApiKey` - `Public Preview: please provide feedback `_: Updates one organization API key in the specified organization. .. toctree:: :titlesonly: - addProjectApiKey - createApiKey - createApiKeyAccessList - createProjectApiKey - deleteApiKey - deleteApiKeyAccessListEntry - getApiKey - getApiKeyAccessList - listApiKeyAccessListsEntries - listApiKeys - listProjectApiKeys - removeProjectApiKey - updateApiKey - updateApiKeyRoles + addGroupApiKey + createGroupApiKey + createOrgApiKey + createOrgApiKeyAccessListEntry + deleteOrgApiKey + deleteOrgApiKeyAccessListEntry + getOrgApiKey + getOrgApiKeyAccessListEntry + listGroupApiKeys + listOrgApiKeyAccessListEntries + listOrgApiKeys + removeGroupApiKey + updateGroupApiKeyRoles + updateOrgApiKey diff --git a/docs/command/atlas-api-projectIpAccessList-createGroupAccessListEntry.txt b/docs/command/atlas-api-projectIpAccessList-createGroupAccessListEntry.txt new file mode 100644 index 0000000000..18f5c9cd7b --- /dev/null +++ b/docs/command/atlas-api-projectIpAccessList-createGroupAccessListEntry.txt @@ -0,0 +1,122 @@ +.. _atlas-api-projectIpAccessList-createGroupAccessListEntry: + +======================================================== +atlas api projectIpAccessList createGroupAccessListEntry +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one or more access list entries to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. Write each entry as either one IP address or one CIDR-notated block of IP addresses. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. This endpoint doesn't support concurrent POST requests. You must submit multiple POST requests synchronously. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupaccesslistentry. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projectIpAccessList createGroupAccessListEntry [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupAccessListEntry + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +Adds multiple access list entries to the specified project + +Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-createGroupAccessListEntry-2023-01-01-project_ip_access_list_add-payload.json + :language: shell +After creating ``payload.json``, run the command below in the same directory. + +.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-createGroupAccessListEntry-2023-01-01-project_ip_access_list_add.sh + :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-createProjectIpAccessList.txt b/docs/command/atlas-api-projectIpAccessList-createProjectIpAccessList.txt deleted file mode 100644 index d9630ba120..0000000000 --- a/docs/command/atlas-api-projectIpAccessList-createProjectIpAccessList.txt +++ /dev/null @@ -1,122 +0,0 @@ -.. _atlas-api-projectIpAccessList-createProjectIpAccessList: - -======================================================= -atlas api projectIpAccessList createProjectIpAccessList -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one or more access list entries to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. Write each entry as either one IP address or one CIDR-notated block of IP addresses. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. This endpoint doesn't support concurrent POST requests. You must submit multiple POST requests synchronously. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectipaccesslist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projectIpAccessList createProjectIpAccessList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createProjectIpAccessList - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -Adds multiple access list entries to the specified project - -Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-createProjectIpAccessList-2023-01-01-project_ip_access_list_add-payload.json - :language: shell -After creating ``payload.json``, run the command below in the same directory. - -.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-createProjectIpAccessList-2023-01-01-project_ip_access_list_add.sh - :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-deleteGroupAccessListEntry.txt b/docs/command/atlas-api-projectIpAccessList-deleteGroupAccessListEntry.txt new file mode 100644 index 0000000000..149f3ea8df --- /dev/null +++ b/docs/command/atlas-api-projectIpAccessList-deleteGroupAccessListEntry.txt @@ -0,0 +1,106 @@ +.. _atlas-api-projectIpAccessList-deleteGroupAccessListEntry: + +======================================================== +atlas api projectIpAccessList deleteGroupAccessListEntry +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one access list entry from the specified project's IP access list. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Each entry in the project's IP access list contains one IP address, one CIDR-notated block of IP addresses, or one AWS Security Group ID. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupaccesslistentry. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projectIpAccessList deleteGroupAccessListEntry [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --entryValue + - / + - true + - Access list entry that you want to remove from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (/) with its URL-encoded value (`%2F`). When you remove an entry from the IP access list, existing connections from the removed address or addresses may remain open for a variable amount of time. The amount of time it takes MongoDB Cloud to close the connection depends upon several factors, including: + + - how your application established the connection, + - how MongoDB Cloud or the driver using the address behaves, and + - which protocol (like TCP or UDP) the connection uses. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupAccessListEntry + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-deleteGroupAccessListEntry-2023-01-01-project_ip_access_list_delete.sh + :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-deleteProjectIpAccessList.txt b/docs/command/atlas-api-projectIpAccessList-deleteProjectIpAccessList.txt deleted file mode 100644 index 8cc4e2f1fa..0000000000 --- a/docs/command/atlas-api-projectIpAccessList-deleteProjectIpAccessList.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-projectIpAccessList-deleteProjectIpAccessList: - -======================================================= -atlas api projectIpAccessList deleteProjectIpAccessList -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one access list entry from the specified project's IP access list. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Each entry in the project's IP access list contains one IP address, one CIDR-notated block of IP addresses, or one AWS Security Group ID. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectipaccesslist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projectIpAccessList deleteProjectIpAccessList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --entryValue - - / - - true - - Access list entry that you want to remove from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (/) with its URL-encoded value (`%2F`). When you remove an entry from the IP access list, existing connections from the removed address or addresses may remain open for a variable amount of time. The amount of time it takes MongoDB Cloud to close the connection depends upon several factors, including: - - - how your application established the connection, - - how MongoDB Cloud or the driver using the address behaves, and - - which protocol (like TCP or UDP) the connection uses. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteProjectIpAccessList - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-deleteProjectIpAccessList-2023-01-01-project_ip_access_list_delete.sh - :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-getGroupAccessListEntry.txt b/docs/command/atlas-api-projectIpAccessList-getGroupAccessListEntry.txt new file mode 100644 index 0000000000..fd76c4f124 --- /dev/null +++ b/docs/command/atlas-api-projectIpAccessList-getGroupAccessListEntry.txt @@ -0,0 +1,102 @@ +.. _atlas-api-projectIpAccessList-getGroupAccessListEntry: + +===================================================== +atlas api projectIpAccessList getGroupAccessListEntry +===================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one access list entry from the specified project's IP access list. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. This endpoint (/groups/{GROUP-ID}/accessList) manages the Project IP Access List. It doesn't manage the access list for MongoDB Cloud organizations. TheProgrammatic API Keys endpoint (/orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist) manages those access lists. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupaccesslistentry. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projectIpAccessList getGroupAccessListEntry [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --entryValue + - / + - true + - Access list entry that you want to return from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (/) with its URL-encoded value (`%2F`). + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupAccessListEntry + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-getGroupAccessListEntry-2023-01-01-project_ip_access_list_get.sh + :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-getGroupAccessListStatus.txt b/docs/command/atlas-api-projectIpAccessList-getGroupAccessListStatus.txt new file mode 100644 index 0000000000..d8f4c63863 --- /dev/null +++ b/docs/command/atlas-api-projectIpAccessList-getGroupAccessListStatus.txt @@ -0,0 +1,102 @@ +.. _atlas-api-projectIpAccessList-getGroupAccessListStatus: + +====================================================== +atlas api projectIpAccessList getGroupAccessListStatus +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the status of one project IP access list entry. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This resource checks if the provided project IP access list entry applies to all cloud providers serving clusters from the specified project. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupaccessliststatus. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projectIpAccessList getGroupAccessListStatus [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --entryValue + - string + - true + - Network address or cloud provider security construct that identifies which project access list entry to be verified. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupAccessListStatus + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-getGroupAccessListStatus-2023-01-01-project_ip_access_list_get_status.sh + :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-getProjectIpAccessListStatus.txt b/docs/command/atlas-api-projectIpAccessList-getProjectIpAccessListStatus.txt deleted file mode 100644 index 0e5ea34acb..0000000000 --- a/docs/command/atlas-api-projectIpAccessList-getProjectIpAccessListStatus.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-projectIpAccessList-getProjectIpAccessListStatus: - -========================================================== -atlas api projectIpAccessList getProjectIpAccessListStatus -========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the status of one project IP access list entry. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This resource checks if the provided project IP access list entry applies to all cloud providers serving clusters from the specified project. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectipaccessliststatus. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projectIpAccessList getProjectIpAccessListStatus [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --entryValue - - string - - true - - Network address or cloud provider security construct that identifies which project access list entry to be verified. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectIpAccessListStatus - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-getProjectIpAccessListStatus-2023-01-01-project_ip_access_list_get_status.sh - :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-getProjectIpList.txt b/docs/command/atlas-api-projectIpAccessList-getProjectIpList.txt deleted file mode 100644 index 65e9d2535e..0000000000 --- a/docs/command/atlas-api-projectIpAccessList-getProjectIpList.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-projectIpAccessList-getProjectIpList: - -============================================== -atlas api projectIpAccessList getProjectIpList -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one access list entry from the specified project's IP access list. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. This endpoint (/groups/{GROUP-ID}/accessList) manages the Project IP Access List. It doesn't manage the access list for MongoDB Cloud organizations. TheProgrammatic API Keys endpoint (/orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist) manages those access lists. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectiplist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projectIpAccessList getProjectIpList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --entryValue - - / - - true - - Access list entry that you want to return from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (/) with its URL-encoded value (`%2F`). - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectIpList - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-getProjectIpList-2023-01-01-project_ip_access_list_get.sh - :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-listGroupAccessListEntries.txt b/docs/command/atlas-api-projectIpAccessList-listGroupAccessListEntries.txt new file mode 100644 index 0000000000..c1cfc68a39 --- /dev/null +++ b/docs/command/atlas-api-projectIpAccessList-listGroupAccessListEntries.txt @@ -0,0 +1,110 @@ +.. _atlas-api-projectIpAccessList-listGroupAccessListEntries: + +======================================================== +atlas api projectIpAccessList listGroupAccessListEntries +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all access list entries from the specified project's IP access list. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupaccesslistentries. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projectIpAccessList listGroupAccessListEntries [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupAccessListEntries + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-listGroupAccessListEntries-2023-01-01-project_ip_access_list_list.sh + :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList-listProjectIpAccessLists.txt b/docs/command/atlas-api-projectIpAccessList-listProjectIpAccessLists.txt deleted file mode 100644 index d120d99cd5..0000000000 --- a/docs/command/atlas-api-projectIpAccessList-listProjectIpAccessLists.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-projectIpAccessList-listProjectIpAccessLists: - -====================================================== -atlas api projectIpAccessList listProjectIpAccessLists -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all access list entries from the specified project's IP access list. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectipaccesslists. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projectIpAccessList listProjectIpAccessLists [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectIpAccessLists - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projectIpAccessList-listProjectIpAccessLists-2023-01-01-project_ip_access_list_list.sh - :language: shell diff --git a/docs/command/atlas-api-projectIpAccessList.txt b/docs/command/atlas-api-projectIpAccessList.txt index 37826ecffb..8a117f6a88 100644 --- a/docs/command/atlas-api-projectIpAccessList.txt +++ b/docs/command/atlas-api-projectIpAccessList.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-projectIpAccessList-createProjectIpAccessList` - `Public Preview: please provide feedback `_: Adds one or more access list entries to the specified project. -* :ref:`atlas-api-projectIpAccessList-deleteProjectIpAccessList` - `Public Preview: please provide feedback `_: Removes one access list entry from the specified project's IP access list. -* :ref:`atlas-api-projectIpAccessList-getProjectIpAccessListStatus` - `Public Preview: please provide feedback `_: Returns the status of one project IP access list entry. -* :ref:`atlas-api-projectIpAccessList-getProjectIpList` - `Public Preview: please provide feedback `_: Returns one access list entry from the specified project's IP access list. -* :ref:`atlas-api-projectIpAccessList-listProjectIpAccessLists` - `Public Preview: please provide feedback `_: Returns all access list entries from the specified project's IP access list. +* :ref:`atlas-api-projectIpAccessList-createGroupAccessListEntry` - `Public Preview: please provide feedback `_: Adds one or more access list entries to the specified project. +* :ref:`atlas-api-projectIpAccessList-deleteGroupAccessListEntry` - `Public Preview: please provide feedback `_: Removes one access list entry from the specified project's IP access list. +* :ref:`atlas-api-projectIpAccessList-getGroupAccessListEntry` - `Public Preview: please provide feedback `_: Returns one access list entry from the specified project's IP access list. +* :ref:`atlas-api-projectIpAccessList-getGroupAccessListStatus` - `Public Preview: please provide feedback `_: Returns the status of one project IP access list entry. +* :ref:`atlas-api-projectIpAccessList-listGroupAccessListEntries` - `Public Preview: please provide feedback `_: Returns all access list entries from the specified project's IP access list. .. toctree:: :titlesonly: - createProjectIpAccessList - deleteProjectIpAccessList - getProjectIpAccessListStatus - getProjectIpList - listProjectIpAccessLists + createGroupAccessListEntry + deleteGroupAccessListEntry + getGroupAccessListEntry + getGroupAccessListStatus + listGroupAccessListEntries diff --git a/docs/command/atlas-api-projects-addGroupAccessUser.txt b/docs/command/atlas-api-projects-addGroupAccessUser.txt new file mode 100644 index 0000000000..5f5ae51041 --- /dev/null +++ b/docs/command/atlas-api-projects-addGroupAccessUser.txt @@ -0,0 +1,97 @@ +.. _atlas-api-projects-addGroupAccessUser: + +===================================== +atlas api projects addGroupAccessUser +===================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +If the MongoDB Cloud user is not a member of the project's organization, then the user must accept their invitation to the organization to access information within the specified project. If the MongoDB Cloud User is already a member of the project's organization, then they will be added to the project immediately and an invitation will not be returned by this resource. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupaccessuser. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects addGroupAccessUser [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for addGroupAccessUser + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-addUserToProject.txt b/docs/command/atlas-api-projects-addUserToProject.txt deleted file mode 100644 index 182bc943ce..0000000000 --- a/docs/command/atlas-api-projects-addUserToProject.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-projects-addUserToProject: - -=================================== -atlas api projects addUserToProject -=================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -If the MongoDB Cloud user is not a member of the project's organization, then the user must accept their invitation to the organization to access information within the specified project. If the MongoDB Cloud User is already a member of the project's organization, then they will be added to the project immediately and an invitation will not be returned by this resource. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addusertoproject. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects addUserToProject [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for addUserToProject - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects-createGroup.txt b/docs/command/atlas-api-projects-createGroup.txt new file mode 100644 index 0000000000..64a42a7497 --- /dev/null +++ b/docs/command/atlas-api-projects-createGroup.txt @@ -0,0 +1,108 @@ +.. _atlas-api-projects-createGroup: + +============================== +atlas api projects createGroup +============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Read Write role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroup. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects createGroup [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createGroup + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --projectOwnerId + - string + - false + - Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user to whom to grant the Project Owner role on the specified project. If you set this parameter, it overrides the default value of the oldest Organization Owner. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +Creates a new project named "MongoTube" with an environment tag set to "e2e" + +Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-projects-createGroup-2023-01-01-create_project-payload.json + :language: shell +After creating ``payload.json``, run the command below in the same directory. + +.. literalinclude:: /includes/examples/atlas-api-projects-createGroup-2023-01-01-create_project.sh + :language: shell diff --git a/docs/command/atlas-api-projects-createGroupInvite.txt b/docs/command/atlas-api-projects-createGroupInvite.txt new file mode 100644 index 0000000000..f285dabfff --- /dev/null +++ b/docs/command/atlas-api-projects-createGroupInvite.txt @@ -0,0 +1,97 @@ +.. _atlas-api-projects-createGroupInvite: + +==================================== +atlas api projects createGroupInvite +==================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Invites one MongoDB Cloud user to join the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The MongoDB Cloud user must accept the invitation to access information within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupinvite. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects createGroupInvite [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupInvite + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-createProject.txt b/docs/command/atlas-api-projects-createProject.txt deleted file mode 100644 index ac1f04409b..0000000000 --- a/docs/command/atlas-api-projects-createProject.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-projects-createProject: - -================================ -atlas api projects createProject -================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Read Write role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createproject. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects createProject [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createProject - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --projectOwnerId - - string - - false - - Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user to whom to grant the Project Owner role on the specified project. If you set this parameter, it overrides the default value of the oldest Organization Owner. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -Creates a new project named "MongoTube" with an environment tag set to "e2e" - -Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-projects-createProject-2023-01-01-create_project-payload.json - :language: shell -After creating ``payload.json``, run the command below in the same directory. - -.. literalinclude:: /includes/examples/atlas-api-projects-createProject-2023-01-01-create_project.sh - :language: shell diff --git a/docs/command/atlas-api-projects-createProjectInvitation.txt b/docs/command/atlas-api-projects-createProjectInvitation.txt deleted file mode 100644 index 6b51c40577..0000000000 --- a/docs/command/atlas-api-projects-createProjectInvitation.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-projects-createProjectInvitation: - -========================================== -atlas api projects createProjectInvitation -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Invites one MongoDB Cloud user to join the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The MongoDB Cloud user must accept the invitation to access information within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectinvitation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects createProjectInvitation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createProjectInvitation - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects-deleteGroup.txt b/docs/command/atlas-api-projects-deleteGroup.txt new file mode 100644 index 0000000000..e27b043590 --- /dev/null +++ b/docs/command/atlas-api-projects-deleteGroup.txt @@ -0,0 +1,98 @@ +.. _atlas-api-projects-deleteGroup: + +============================== +atlas api projects deleteGroup +============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. You can delete a project only if there are no Online Archives for the clusters in the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroup. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects deleteGroup [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroup + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-deleteGroup-2023-01-01-delete_project.sh + :language: shell diff --git a/docs/command/atlas-api-projects-deleteGroupInvite.txt b/docs/command/atlas-api-projects-deleteGroupInvite.txt new file mode 100644 index 0000000000..c6a57b7cce --- /dev/null +++ b/docs/command/atlas-api-projects-deleteGroupInvite.txt @@ -0,0 +1,98 @@ +.. _atlas-api-projects-deleteGroupInvite: + +==================================== +atlas api projects deleteGroupInvite +==================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupinvite. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects deleteGroupInvite [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupInvite + * - --invitationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invitation. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-deleteGroupInvite-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-deleteGroupLimit.txt b/docs/command/atlas-api-projects-deleteGroupLimit.txt new file mode 100644 index 0000000000..1ae38852cf --- /dev/null +++ b/docs/command/atlas-api-projects-deleteGroupLimit.txt @@ -0,0 +1,118 @@ +.. _atlas-api-projects-deleteGroupLimit: + +=================================== +atlas api projects deleteGroupLimit +=================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the specified project limit. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Depending on the limit, Atlas either resets the limit to its default value or removes the limit entirely. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegrouplimit. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects deleteGroupLimit [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupLimit + * - --limitName + - string + - true + - Human-readable label that identifies this project limit. + + | Limit Name | Description | Default | API Override Limit | + | --- | --- | --- | --- | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | + | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | + | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | + | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | + | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | + | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | + | dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | + | dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | + | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | + | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| + | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| + + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-deleteGroupLimit-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-deleteProject.txt b/docs/command/atlas-api-projects-deleteProject.txt deleted file mode 100644 index 997fe6bbce..0000000000 --- a/docs/command/atlas-api-projects-deleteProject.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-projects-deleteProject: - -================================ -atlas api projects deleteProject -================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. You can delete a project only if there are no Online Archives for the clusters in the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteproject. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects deleteProject [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteProject - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-deleteProject-2023-01-01-delete_project.sh - :language: shell diff --git a/docs/command/atlas-api-projects-deleteProjectInvitation.txt b/docs/command/atlas-api-projects-deleteProjectInvitation.txt deleted file mode 100644 index b278ce5454..0000000000 --- a/docs/command/atlas-api-projects-deleteProjectInvitation.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-projects-deleteProjectInvitation: - -========================================== -atlas api projects deleteProjectInvitation -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectinvitation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects deleteProjectInvitation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteProjectInvitation - * - --invitationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invitation. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-deleteProjectInvitation-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-deleteProjectLimit.txt b/docs/command/atlas-api-projects-deleteProjectLimit.txt deleted file mode 100644 index faac32558f..0000000000 --- a/docs/command/atlas-api-projects-deleteProjectLimit.txt +++ /dev/null @@ -1,119 +0,0 @@ -.. _atlas-api-projects-deleteProjectLimit: - -===================================== -atlas api projects deleteProjectLimit -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the specified project limit. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Depending on the limit, Atlas either resets the limit to its default value or removes the limit entirely. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectlimit. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects deleteProjectLimit [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteProjectLimit - * - --limitName - - string - - true - - Human-readable label that identifies this project limit. - - | Limit Name | Description | Default | API Override Limit | - | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | - | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | - | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | - | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | - | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | - | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | - | dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | - | dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | - | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | - | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| - | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | - - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-deleteProjectLimit-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-getGroup.txt b/docs/command/atlas-api-projects-getGroup.txt new file mode 100644 index 0000000000..cbb159a565 --- /dev/null +++ b/docs/command/atlas-api-projects-getGroup.txt @@ -0,0 +1,98 @@ +.. _atlas-api-projects-getGroup: + +=========================== +atlas api projects getGroup +=========================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroup. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects getGroup [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroup + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-getGroup-2023-01-01-get_project.sh + :language: shell diff --git a/docs/command/atlas-api-projects-getGroupByName.txt b/docs/command/atlas-api-projects-getGroupByName.txt new file mode 100644 index 0000000000..fb35fec89a --- /dev/null +++ b/docs/command/atlas-api-projects-getGroupByName.txt @@ -0,0 +1,91 @@ +.. _atlas-api-projects-getGroupByName: + +================================= +atlas api projects getGroupByName +================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about the project identified by its name. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupbyname. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects getGroupByName [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupName + - string + - true + - Human-readable label that identifies this project. + * - -h, --help + - + - false + - help for getGroupByName + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-getGroupInvite.txt b/docs/command/atlas-api-projects-getGroupInvite.txt new file mode 100644 index 0000000000..1ce38363b0 --- /dev/null +++ b/docs/command/atlas-api-projects-getGroupInvite.txt @@ -0,0 +1,102 @@ +.. _atlas-api-projects-getGroupInvite: + +================================= +atlas api projects getGroupInvite +================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details of one pending invitation to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupinvite. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects getGroupInvite [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupInvite + * - --invitationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invitation. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-getGroupInvite-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-getGroupIpAddresses.txt b/docs/command/atlas-api-projects-getGroupIpAddresses.txt new file mode 100644 index 0000000000..2479b922ca --- /dev/null +++ b/docs/command/atlas-api-projects-getGroupIpAddresses.txt @@ -0,0 +1,98 @@ +.. _atlas-api-projects-getGroupIpAddresses: + +====================================== +atlas api projects getGroupIpAddresses +====================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all IP addresses for this project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupipaddresses. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects getGroupIpAddresses [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupIpAddresses + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-getGroupIpAddresses-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-getGroupLimit.txt b/docs/command/atlas-api-projects-getGroupLimit.txt new file mode 100644 index 0000000000..b5376d3eb7 --- /dev/null +++ b/docs/command/atlas-api-projects-getGroupLimit.txt @@ -0,0 +1,118 @@ +.. _atlas-api-projects-getGroupLimit: + +================================ +atlas api projects getGroupLimit +================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the specified limit for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouplimit. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects getGroupLimit [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupLimit + * - --limitName + - string + - true + - Human-readable label that identifies this project limit. + + | Limit Name | Description | Default | API Override Limit | + | --- | --- | --- | --- | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | + | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | + | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | + | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | + | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | + | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | + | dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | + | dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | + | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | + | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| + | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| + + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-getGroupLimit-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-getGroupMongoDbVersions.txt b/docs/command/atlas-api-projects-getGroupMongoDbVersions.txt new file mode 100644 index 0000000000..eb7e43ce56 --- /dev/null +++ b/docs/command/atlas-api-projects-getGroupMongoDbVersions.txt @@ -0,0 +1,116 @@ +.. _atlas-api-projects-getGroupMongoDbVersions: + +========================================== +atlas api projects getGroupMongoDbVersions +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the MongoDB Long Term Support Major Versions available to new clusters in this project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupmongodbversions. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects getGroupMongoDbVersions [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - false + - Filter results to only one cloud provider. + * - --defaultStatus + - string + - false + - Filter results to only the default values per tier. This value must be DEFAULT. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupMongoDbVersions + * - --instanceSize + - string + - false + - Filter results to only one instance size. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-getGroupMongoDbVersions-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-getGroupSettings.txt b/docs/command/atlas-api-projects-getGroupSettings.txt new file mode 100644 index 0000000000..b134bcc683 --- /dev/null +++ b/docs/command/atlas-api-projects-getGroupSettings.txt @@ -0,0 +1,98 @@ +.. _atlas-api-projects-getGroupSettings: + +=================================== +atlas api projects getGroupSettings +=================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about the specified project's settings. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupsettings. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects getGroupSettings [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupSettings + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-getGroupSettings-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-getProject.txt b/docs/command/atlas-api-projects-getProject.txt deleted file mode 100644 index 644c311e1c..0000000000 --- a/docs/command/atlas-api-projects-getProject.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-projects-getProject: - -============================= -atlas api projects getProject -============================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getproject. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects getProject [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProject - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-getProject-2023-01-01-get_project.sh - :language: shell diff --git a/docs/command/atlas-api-projects-getProjectByName.txt b/docs/command/atlas-api-projects-getProjectByName.txt deleted file mode 100644 index e908ca1b3c..0000000000 --- a/docs/command/atlas-api-projects-getProjectByName.txt +++ /dev/null @@ -1,91 +0,0 @@ -.. _atlas-api-projects-getProjectByName: - -=================================== -atlas api projects getProjectByName -=================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about the project identified by its name. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectbyname. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects getProjectByName [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupName - - string - - true - - Human-readable label that identifies this project. - * - -h, --help - - - - false - - help for getProjectByName - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects-getProjectInvitation.txt b/docs/command/atlas-api-projects-getProjectInvitation.txt deleted file mode 100644 index 516f8130eb..0000000000 --- a/docs/command/atlas-api-projects-getProjectInvitation.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-projects-getProjectInvitation: - -======================================= -atlas api projects getProjectInvitation -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details of one pending invitation to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectinvitation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects getProjectInvitation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectInvitation - * - --invitationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invitation. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-getProjectInvitation-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-getProjectLimit.txt b/docs/command/atlas-api-projects-getProjectLimit.txt deleted file mode 100644 index 0dbaa1007f..0000000000 --- a/docs/command/atlas-api-projects-getProjectLimit.txt +++ /dev/null @@ -1,119 +0,0 @@ -.. _atlas-api-projects-getProjectLimit: - -================================== -atlas api projects getProjectLimit -================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the specified limit for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectlimit. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects getProjectLimit [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectLimit - * - --limitName - - string - - true - - Human-readable label that identifies this project limit. - - | Limit Name | Description | Default | API Override Limit | - | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | - | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | - | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | - | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | - | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | - | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | - | dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | - | dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | - | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | - | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| - | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | - - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-getProjectLimit-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-getProjectLtsVersions.txt b/docs/command/atlas-api-projects-getProjectLtsVersions.txt deleted file mode 100644 index d2d76c2682..0000000000 --- a/docs/command/atlas-api-projects-getProjectLtsVersions.txt +++ /dev/null @@ -1,116 +0,0 @@ -.. _atlas-api-projects-getProjectLtsVersions: - -======================================== -atlas api projects getProjectLtsVersions -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the MongoDB Long Term Support Major Versions available to new clusters in this project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectltsversions. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects getProjectLtsVersions [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - false - - Filter results to only one cloud provider. - * - --defaultStatus - - string - - false - - Filter results to only the default values per tier. This value must be DEFAULT. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectLtsVersions - * - --instanceSize - - string - - false - - Filter results to only one instance size. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-getProjectLtsVersions-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-getProjectSettings.txt b/docs/command/atlas-api-projects-getProjectSettings.txt deleted file mode 100644 index 98c61a2a69..0000000000 --- a/docs/command/atlas-api-projects-getProjectSettings.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-projects-getProjectSettings: - -===================================== -atlas api projects getProjectSettings -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about the specified project's settings. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectsettings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects getProjectSettings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectSettings - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-getProjectSettings-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-listGroupInvites.txt b/docs/command/atlas-api-projects-listGroupInvites.txt new file mode 100644 index 0000000000..490d686199 --- /dev/null +++ b/docs/command/atlas-api-projects-listGroupInvites.txt @@ -0,0 +1,102 @@ +.. _atlas-api-projects-listGroupInvites: + +=================================== +atlas api projects listGroupInvites +=================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all pending invitations to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupinvites. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects listGroupInvites [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupInvites + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - false + - Email address of the user account invited to this project. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-listGroupInvites-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-listGroupLimits.txt b/docs/command/atlas-api-projects-listGroupLimits.txt new file mode 100644 index 0000000000..e37fdb1afa --- /dev/null +++ b/docs/command/atlas-api-projects-listGroupLimits.txt @@ -0,0 +1,98 @@ +.. _atlas-api-projects-listGroupLimits: + +================================== +atlas api projects listGroupLimits +================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all the limits for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouplimits. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects listGroupLimits [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupLimits + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-listGroupLimits-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-projects-listGroups.txt b/docs/command/atlas-api-projects-listGroups.txt new file mode 100644 index 0000000000..e14dce6e09 --- /dev/null +++ b/docs/command/atlas-api-projects-listGroups.txt @@ -0,0 +1,104 @@ +.. _atlas-api-projects-listGroups: + +============================= +atlas api projects listGroups +============================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details about all projects. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Organization Read Only role or higher. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroups. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects listGroups [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listGroups + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-projects-listGroups-2023-01-01-list_projects.sh + :language: shell diff --git a/docs/command/atlas-api-projects-listProjectInvitations.txt b/docs/command/atlas-api-projects-listProjectInvitations.txt deleted file mode 100644 index 0555601f85..0000000000 --- a/docs/command/atlas-api-projects-listProjectInvitations.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-projects-listProjectInvitations: - -========================================= -atlas api projects listProjectInvitations -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all pending invitations to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectinvitations. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects listProjectInvitations [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectInvitations - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - false - - Email address of the user account invited to this project. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-listProjectInvitations-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-listProjectLimits.txt b/docs/command/atlas-api-projects-listProjectLimits.txt deleted file mode 100644 index 9101ded3fb..0000000000 --- a/docs/command/atlas-api-projects-listProjectLimits.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-projects-listProjectLimits: - -==================================== -atlas api projects listProjectLimits -==================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all the limits for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectlimits. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects listProjectLimits [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectLimits - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-listProjectLimits-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-listProjects.txt b/docs/command/atlas-api-projects-listProjects.txt deleted file mode 100644 index aa590eab5b..0000000000 --- a/docs/command/atlas-api-projects-listProjects.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-projects-listProjects: - -=============================== -atlas api projects listProjects -=============================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details about all projects. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Organization Read Only role or higher. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojects. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects listProjects [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listProjects - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-listProjects-2023-01-01-list_projects.sh - :language: shell diff --git a/docs/command/atlas-api-projects-migrateGroup.txt b/docs/command/atlas-api-projects-migrateGroup.txt new file mode 100644 index 0000000000..275f86efab --- /dev/null +++ b/docs/command/atlas-api-projects-migrateGroup.txt @@ -0,0 +1,93 @@ +.. _atlas-api-projects-migrateGroup: + +=============================== +atlas api projects migrateGroup +=============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Migrates a project from its current organization to another organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +All project users and their roles will be copied to the same project in the destination organization. You must include an organization API key with the Organization Owner role for the destination organization to verify access to the destination organization when you authenticate with Programmatic API Keys. Otherwise, the requesting user must have the Organization Owner role in both organizations. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-migrategroup. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects migrateGroup [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for migrateGroup + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-migrateProjectToAnotherOrg.txt b/docs/command/atlas-api-projects-migrateProjectToAnotherOrg.txt deleted file mode 100644 index 1b17684c2f..0000000000 --- a/docs/command/atlas-api-projects-migrateProjectToAnotherOrg.txt +++ /dev/null @@ -1,93 +0,0 @@ -.. _atlas-api-projects-migrateProjectToAnotherOrg: - -============================================= -atlas api projects migrateProjectToAnotherOrg -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Migrates a project from its current organization to another organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -All project users and their roles will be copied to the same project in the destination organization. You must include an organization API key with the Organization Owner role for the destination organization to verify access to the destination organization when you authenticate with Programmatic API Keys. Otherwise, the requesting user must have the Organization Owner role in both organizations. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-migrateprojecttoanotherorg. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects migrateProjectToAnotherOrg [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for migrateProjectToAnotherOrg - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects-returnAllIpAddresses.txt b/docs/command/atlas-api-projects-returnAllIpAddresses.txt deleted file mode 100644 index d6ae34a02c..0000000000 --- a/docs/command/atlas-api-projects-returnAllIpAddresses.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-projects-returnAllIpAddresses: - -======================================= -atlas api projects returnAllIpAddresses -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all IP addresses for this project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnallipaddresses. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects returnAllIpAddresses [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for returnAllIpAddresses - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-projects-returnAllIpAddresses-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-projects-setGroupLimit.txt b/docs/command/atlas-api-projects-setGroupLimit.txt new file mode 100644 index 0000000000..5a98a9164a --- /dev/null +++ b/docs/command/atlas-api-projects-setGroupLimit.txt @@ -0,0 +1,120 @@ +.. _atlas-api-projects-setGroupLimit: + +================================ +atlas api projects setGroupLimit +================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Sets the specified project limit. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +NOTE: Increasing the following configuration limits might lead to slower response times in the MongoDB Cloud UI or increased user management overhead leading to authentication or authorization re-architecture. If possible, we recommend that you create additional projects to gain access to more of these resources for a more sustainable growth pattern. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setgrouplimit. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects setGroupLimit [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for setGroupLimit + * - --limitName + - string + - true + - Human-readable label that identifies this project limit. + + | Limit Name | Description | Default | API Override Limit | + | --- | --- | --- | --- | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | + | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | + | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | + | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | + | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | + | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | + | dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | + | dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | + | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | + | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| + | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| + + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-setProjectLimit.txt b/docs/command/atlas-api-projects-setProjectLimit.txt deleted file mode 100644 index df7aa391e3..0000000000 --- a/docs/command/atlas-api-projects-setProjectLimit.txt +++ /dev/null @@ -1,121 +0,0 @@ -.. _atlas-api-projects-setProjectLimit: - -================================== -atlas api projects setProjectLimit -================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Sets the specified project limit. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -NOTE: Increasing the following configuration limits might lead to slower response times in the MongoDB Cloud UI or increased user management overhead leading to authentication or authorization re-architecture. If possible, we recommend that you create additional projects to gain access to more of these resources for a more sustainable growth pattern. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setprojectlimit. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects setProjectLimit [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for setProjectLimit - * - --limitName - - string - - true - - Human-readable label that identifies this project limit. - - | Limit Name | Description | Default | API Override Limit | - | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | - | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | - | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | - | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | - | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | - | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | - | dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | - | dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | - | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | - | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| - | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | - - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects-updateGroup.txt b/docs/command/atlas-api-projects-updateGroup.txt new file mode 100644 index 0000000000..ee34d7d5ba --- /dev/null +++ b/docs/command/atlas-api-projects-updateGroup.txt @@ -0,0 +1,110 @@ +.. _atlas-api-projects-updateGroup: + +============================== +atlas api projects updateGroup +============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the human-readable label that identifies the specified project, or the tags associated with the project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroup. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects updateGroup [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroup + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +Update the value of the existing project to "MongoTube - Production" and change the tags to an environment tag set to "production" + +Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-projects-updateGroup-2023-01-01-update_project-payload.json + :language: shell +After creating ``payload.json``, run the command below in the same directory. + +.. literalinclude:: /includes/examples/atlas-api-projects-updateGroup-2023-01-01-update_project.sh + :language: shell diff --git a/docs/command/atlas-api-projects-updateGroupInviteById.txt b/docs/command/atlas-api-projects-updateGroupInviteById.txt new file mode 100644 index 0000000000..6c8163baa4 --- /dev/null +++ b/docs/command/atlas-api-projects-updateGroupInviteById.txt @@ -0,0 +1,97 @@ +.. _atlas-api-projects-updateGroupInviteById: + +======================================== +atlas api projects updateGroupInviteById +======================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by its unique ID, to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Use the Return All Project Invitations endpoint to retrieve IDs for all pending project invitations. To use this resource, the requesting API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupinvitebyid. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects updateGroupInviteById [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupInviteById + * - --invitationId + - string + - true + - Unique 24-hexadecimal digit string that identifies the invitation. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-updateGroupInvites.txt b/docs/command/atlas-api-projects-updateGroupInvites.txt new file mode 100644 index 0000000000..e71cfda376 --- /dev/null +++ b/docs/command/atlas-api-projects-updateGroupInvites.txt @@ -0,0 +1,97 @@ +.. _atlas-api-projects-updateGroupInvites: + +===================================== +atlas api projects updateGroupInvites +===================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by the username of the invited user, to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupinvites. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects updateGroupInvites [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupInvites + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-updateGroupSettings.txt b/docs/command/atlas-api-projects-updateGroupSettings.txt new file mode 100644 index 0000000000..a1e7f48ee3 --- /dev/null +++ b/docs/command/atlas-api-projects-updateGroupSettings.txt @@ -0,0 +1,97 @@ +.. _atlas-api-projects-updateGroupSettings: + +====================================== +atlas api projects updateGroupSettings +====================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the settings of the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can update any of the options available. MongoDB cloud only updates the options provided in the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupsettings. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects updateGroupSettings [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupSettings + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-updateGroupUserRoles.txt b/docs/command/atlas-api-projects-updateGroupUserRoles.txt new file mode 100644 index 0000000000..c1a556050e --- /dev/null +++ b/docs/command/atlas-api-projects-updateGroupUserRoles.txt @@ -0,0 +1,101 @@ +.. _atlas-api-projects-updateGroupUserRoles: + +======================================= +atlas api projects updateGroupUserRoles +======================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the roles of the specified user in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified project. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupuserroles. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api projects updateGroupUserRoles [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupUserRoles + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies the user to modify. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-projects-updateProject.txt b/docs/command/atlas-api-projects-updateProject.txt deleted file mode 100644 index 7ca4525d06..0000000000 --- a/docs/command/atlas-api-projects-updateProject.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-projects-updateProject: - -================================ -atlas api projects updateProject -================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the human-readable label that identifies the specified project, or the tags associated with the project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateproject. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects updateProject [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateProject - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -Update the value of the existing project to "MongoTube - Production" and change the tags to an environment tag set to "production" - -Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-projects-updateProject-2023-01-01-update_project-payload.json - :language: shell -After creating ``payload.json``, run the command below in the same directory. - -.. literalinclude:: /includes/examples/atlas-api-projects-updateProject-2023-01-01-update_project.sh - :language: shell diff --git a/docs/command/atlas-api-projects-updateProjectInvitation.txt b/docs/command/atlas-api-projects-updateProjectInvitation.txt deleted file mode 100644 index 81bf7b07f1..0000000000 --- a/docs/command/atlas-api-projects-updateProjectInvitation.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-projects-updateProjectInvitation: - -========================================== -atlas api projects updateProjectInvitation -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by the username of the invited user, to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectinvitation. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects updateProjectInvitation [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateProjectInvitation - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects-updateProjectInvitationById.txt b/docs/command/atlas-api-projects-updateProjectInvitationById.txt deleted file mode 100644 index 7c5a80b5e3..0000000000 --- a/docs/command/atlas-api-projects-updateProjectInvitationById.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-projects-updateProjectInvitationById: - -============================================== -atlas api projects updateProjectInvitationById -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by its unique ID, to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Use the Return All Project Invitations endpoint to retrieve IDs for all pending project invitations. To use this resource, the requesting API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectinvitationbyid. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects updateProjectInvitationById [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateProjectInvitationById - * - --invitationId - - string - - true - - Unique 24-hexadecimal digit string that identifies the invitation. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects-updateProjectRoles.txt b/docs/command/atlas-api-projects-updateProjectRoles.txt deleted file mode 100644 index 3735b9ac22..0000000000 --- a/docs/command/atlas-api-projects-updateProjectRoles.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-projects-updateProjectRoles: - -===================================== -atlas api projects updateProjectRoles -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the roles of the specified user in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified project. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectroles. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects updateProjectRoles [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateProjectRoles - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies the user to modify. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects-updateProjectSettings.txt b/docs/command/atlas-api-projects-updateProjectSettings.txt deleted file mode 100644 index e6b41c5e07..0000000000 --- a/docs/command/atlas-api-projects-updateProjectSettings.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-projects-updateProjectSettings: - -======================================== -atlas api projects updateProjectSettings -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the settings of the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can update any of the options available. MongoDB cloud only updates the options provided in the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectsettings. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api projects updateProjectSettings [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateProjectSettings - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-projects.txt b/docs/command/atlas-api-projects.txt index 8e2e8501eb..d0f3fe6b7e 100644 --- a/docs/command/atlas-api-projects.txt +++ b/docs/command/atlas-api-projects.txt @@ -54,55 +54,55 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-projects-addUserToProject` - `Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to the specified project. -* :ref:`atlas-api-projects-createProject` - `Public Preview: please provide feedback `_: Creates one project. -* :ref:`atlas-api-projects-createProjectInvitation` - `Public Preview: please provide feedback `_: Invites one MongoDB Cloud user to join the specified project. -* :ref:`atlas-api-projects-deleteProject` - `Public Preview: please provide feedback `_: Removes the specified project. -* :ref:`atlas-api-projects-deleteProjectInvitation` - `Public Preview: please provide feedback `_: Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. -* :ref:`atlas-api-projects-deleteProjectLimit` - `Public Preview: please provide feedback `_: Removes the specified project limit. -* :ref:`atlas-api-projects-getProject` - `Public Preview: please provide feedback `_: Returns details about the specified project. -* :ref:`atlas-api-projects-getProjectByName` - `Public Preview: please provide feedback `_: Returns details about the project identified by its name. -* :ref:`atlas-api-projects-getProjectInvitation` - `Public Preview: please provide feedback `_: Returns the details of one pending invitation to the specified project. -* :ref:`atlas-api-projects-getProjectLimit` - `Public Preview: please provide feedback `_: Returns the specified limit for the specified project. -* :ref:`atlas-api-projects-getProjectLtsVersions` - `Public Preview: please provide feedback `_: Returns the MongoDB Long Term Support Major Versions available to new clusters in this project. -* :ref:`atlas-api-projects-getProjectSettings` - `Public Preview: please provide feedback `_: Returns details about the specified project's settings. -* :ref:`atlas-api-projects-listProjectInvitations` - `Public Preview: please provide feedback `_: Returns all pending invitations to the specified project. -* :ref:`atlas-api-projects-listProjectLimits` - `Public Preview: please provide feedback `_: Returns all the limits for the specified project. -* :ref:`atlas-api-projects-listProjects` - `Public Preview: please provide feedback `_: Returns details about all projects. -* :ref:`atlas-api-projects-migrateProjectToAnotherOrg` - `Public Preview: please provide feedback `_: Migrates a project from its current organization to another organization. -* :ref:`atlas-api-projects-returnAllIpAddresses` - `Public Preview: please provide feedback `_: Returns all IP addresses for this project. -* :ref:`atlas-api-projects-setProjectLimit` - `Public Preview: please provide feedback `_: Sets the specified project limit. -* :ref:`atlas-api-projects-updateProject` - `Public Preview: please provide feedback `_: Updates the human-readable label that identifies the specified project, or the tags associated with the project. -* :ref:`atlas-api-projects-updateProjectInvitation` - `Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by the username of the invited user, to the specified project. -* :ref:`atlas-api-projects-updateProjectInvitationById` - `Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by its unique ID, to the specified project. -* :ref:`atlas-api-projects-updateProjectRoles` - `Public Preview: please provide feedback `_: Updates the roles of the specified user in the specified project. -* :ref:`atlas-api-projects-updateProjectSettings` - `Public Preview: please provide feedback `_: Updates the settings of the specified project. +* :ref:`atlas-api-projects-addGroupAccessUser` - `Public Preview: please provide feedback `_: Adds one MongoDB Cloud user to the specified project. +* :ref:`atlas-api-projects-createGroup` - `Public Preview: please provide feedback `_: Creates one project. +* :ref:`atlas-api-projects-createGroupInvite` - `Public Preview: please provide feedback `_: Invites one MongoDB Cloud user to join the specified project. +* :ref:`atlas-api-projects-deleteGroup` - `Public Preview: please provide feedback `_: Removes the specified project. +* :ref:`atlas-api-projects-deleteGroupInvite` - `Public Preview: please provide feedback `_: Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. +* :ref:`atlas-api-projects-deleteGroupLimit` - `Public Preview: please provide feedback `_: Removes the specified project limit. +* :ref:`atlas-api-projects-getGroup` - `Public Preview: please provide feedback `_: Returns details about the specified project. +* :ref:`atlas-api-projects-getGroupByName` - `Public Preview: please provide feedback `_: Returns details about the project identified by its name. +* :ref:`atlas-api-projects-getGroupInvite` - `Public Preview: please provide feedback `_: Returns the details of one pending invitation to the specified project. +* :ref:`atlas-api-projects-getGroupIpAddresses` - `Public Preview: please provide feedback `_: Returns all IP addresses for this project. +* :ref:`atlas-api-projects-getGroupLimit` - `Public Preview: please provide feedback `_: Returns the specified limit for the specified project. +* :ref:`atlas-api-projects-getGroupMongoDbVersions` - `Public Preview: please provide feedback `_: Returns the MongoDB Long Term Support Major Versions available to new clusters in this project. +* :ref:`atlas-api-projects-getGroupSettings` - `Public Preview: please provide feedback `_: Returns details about the specified project's settings. +* :ref:`atlas-api-projects-listGroupInvites` - `Public Preview: please provide feedback `_: Returns all pending invitations to the specified project. +* :ref:`atlas-api-projects-listGroupLimits` - `Public Preview: please provide feedback `_: Returns all the limits for the specified project. +* :ref:`atlas-api-projects-listGroups` - `Public Preview: please provide feedback `_: Returns details about all projects. +* :ref:`atlas-api-projects-migrateGroup` - `Public Preview: please provide feedback `_: Migrates a project from its current organization to another organization. +* :ref:`atlas-api-projects-setGroupLimit` - `Public Preview: please provide feedback `_: Sets the specified project limit. +* :ref:`atlas-api-projects-updateGroup` - `Public Preview: please provide feedback `_: Updates the human-readable label that identifies the specified project, or the tags associated with the project. +* :ref:`atlas-api-projects-updateGroupInviteById` - `Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by its unique ID, to the specified project. +* :ref:`atlas-api-projects-updateGroupInvites` - `Public Preview: please provide feedback `_: Updates the details of one pending invitation, identified by the username of the invited user, to the specified project. +* :ref:`atlas-api-projects-updateGroupSettings` - `Public Preview: please provide feedback `_: Updates the settings of the specified project. +* :ref:`atlas-api-projects-updateGroupUserRoles` - `Public Preview: please provide feedback `_: Updates the roles of the specified user in the specified project. .. toctree:: :titlesonly: - addUserToProject - createProject - createProjectInvitation - deleteProject - deleteProjectInvitation - deleteProjectLimit - getProject - getProjectByName - getProjectInvitation - getProjectLimit - getProjectLtsVersions - getProjectSettings - listProjectInvitations - listProjectLimits - listProjects - migrateProjectToAnotherOrg - returnAllIpAddresses - setProjectLimit - updateProject - updateProjectInvitation - updateProjectInvitationById - updateProjectRoles - updateProjectSettings + addGroupAccessUser + createGroup + createGroupInvite + deleteGroup + deleteGroupInvite + deleteGroupLimit + getGroup + getGroupByName + getGroupInvite + getGroupIpAddresses + getGroupLimit + getGroupMongoDbVersions + getGroupSettings + listGroupInvites + listGroupLimits + listGroups + migrateGroup + setGroupLimit + updateGroup + updateGroupInviteById + updateGroupInvites + updateGroupSettings + updateGroupUserRoles diff --git a/docs/command/atlas-api-pushBasedLogExport-createGroupPushBasedLogExport.txt b/docs/command/atlas-api-pushBasedLogExport-createGroupPushBasedLogExport.txt new file mode 100644 index 0000000000..f930af500c --- /dev/null +++ b/docs/command/atlas-api-pushBasedLogExport-createGroupPushBasedLogExport.txt @@ -0,0 +1,95 @@ +.. _atlas-api-pushBasedLogExport-createGroupPushBasedLogExport: + +========================================================== +atlas api pushBasedLogExport createGroupPushBasedLogExport +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Configures the project level settings for the push-based log export feature. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategrouppushbasedlogexport. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api pushBasedLogExport createGroupPushBasedLogExport [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupPushBasedLogExport + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-pushBasedLogExport-createPushBasedLogConfiguration.txt b/docs/command/atlas-api-pushBasedLogExport-createPushBasedLogConfiguration.txt deleted file mode 100644 index 984ba6b066..0000000000 --- a/docs/command/atlas-api-pushBasedLogExport-createPushBasedLogConfiguration.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-pushBasedLogExport-createPushBasedLogConfiguration: - -============================================================ -atlas api pushBasedLogExport createPushBasedLogConfiguration -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Configures the project level settings for the push-based log export feature. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpushbasedlogconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api pushBasedLogExport createPushBasedLogConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createPushBasedLogConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport.txt b/docs/command/atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport.txt new file mode 100644 index 0000000000..e610ba7bc4 --- /dev/null +++ b/docs/command/atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport.txt @@ -0,0 +1,96 @@ +.. _atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport: + +========================================================== +atlas api pushBasedLogExport deleteGroupPushBasedLogExport +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Disables the push-based log export feature by resetting the project level settings to its default configuration. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegrouppushbasedlogexport. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api pushBasedLogExport deleteGroupPushBasedLogExport [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupPushBasedLogExport + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration.txt b/docs/command/atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration.txt deleted file mode 100644 index 093f6e2790..0000000000 --- a/docs/command/atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration: - -============================================================ -atlas api pushBasedLogExport deletePushBasedLogConfiguration -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Disables the push-based log export feature by resetting the project level settings to its default configuration. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepushbasedlogconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api pushBasedLogExport deletePushBasedLogConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deletePushBasedLogConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-pushBasedLogExport-getGroupPushBasedLogExport.txt b/docs/command/atlas-api-pushBasedLogExport-getGroupPushBasedLogExport.txt new file mode 100644 index 0000000000..8dcadd5640 --- /dev/null +++ b/docs/command/atlas-api-pushBasedLogExport-getGroupPushBasedLogExport.txt @@ -0,0 +1,96 @@ +.. _atlas-api-pushBasedLogExport-getGroupPushBasedLogExport: + +======================================================= +atlas api pushBasedLogExport getGroupPushBasedLogExport +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Fetches the current project level settings for the push-based log export feature. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouppushbasedlogexport. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api pushBasedLogExport getGroupPushBasedLogExport [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupPushBasedLogExport + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-pushBasedLogExport-getGroupPushBasedLogExport-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-pushBasedLogExport-getPushBasedLogConfiguration.txt b/docs/command/atlas-api-pushBasedLogExport-getPushBasedLogConfiguration.txt deleted file mode 100644 index c7b6ff3158..0000000000 --- a/docs/command/atlas-api-pushBasedLogExport-getPushBasedLogConfiguration.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-pushBasedLogExport-getPushBasedLogConfiguration: - -========================================================= -atlas api pushBasedLogExport getPushBasedLogConfiguration -========================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Fetches the current project level settings for the push-based log export feature. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpushbasedlogconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api pushBasedLogExport getPushBasedLogConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getPushBasedLogConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-pushBasedLogExport-getPushBasedLogConfiguration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-pushBasedLogExport-updateGroupPushBasedLogExport.txt b/docs/command/atlas-api-pushBasedLogExport-updateGroupPushBasedLogExport.txt new file mode 100644 index 0000000000..ebe66621e1 --- /dev/null +++ b/docs/command/atlas-api-pushBasedLogExport-updateGroupPushBasedLogExport.txt @@ -0,0 +1,95 @@ +.. _atlas-api-pushBasedLogExport-updateGroupPushBasedLogExport: + +========================================================== +atlas api pushBasedLogExport updateGroupPushBasedLogExport +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the project level settings for the push-based log export feature. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategrouppushbasedlogexport. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api pushBasedLogExport updateGroupPushBasedLogExport [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupPushBasedLogExport + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-pushBasedLogExport-updatePushBasedLogConfiguration.txt b/docs/command/atlas-api-pushBasedLogExport-updatePushBasedLogConfiguration.txt deleted file mode 100644 index c67865b591..0000000000 --- a/docs/command/atlas-api-pushBasedLogExport-updatePushBasedLogConfiguration.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-pushBasedLogExport-updatePushBasedLogConfiguration: - -============================================================ -atlas api pushBasedLogExport updatePushBasedLogConfiguration -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the project level settings for the push-based log export feature. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepushbasedlogconfiguration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api pushBasedLogExport updatePushBasedLogConfiguration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updatePushBasedLogConfiguration - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-pushBasedLogExport.txt b/docs/command/atlas-api-pushBasedLogExport.txt index ddfafcf669..9bbc7825ff 100644 --- a/docs/command/atlas-api-pushBasedLogExport.txt +++ b/docs/command/atlas-api-pushBasedLogExport.txt @@ -54,17 +54,17 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-pushBasedLogExport-createPushBasedLogConfiguration` - `Public Preview: please provide feedback `_: Configures the project level settings for the push-based log export feature. -* :ref:`atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration` - `Public Preview: please provide feedback `_: Disables the push-based log export feature by resetting the project level settings to its default configuration. -* :ref:`atlas-api-pushBasedLogExport-getPushBasedLogConfiguration` - `Public Preview: please provide feedback `_: Fetches the current project level settings for the push-based log export feature. -* :ref:`atlas-api-pushBasedLogExport-updatePushBasedLogConfiguration` - `Public Preview: please provide feedback `_: Updates the project level settings for the push-based log export feature. +* :ref:`atlas-api-pushBasedLogExport-createGroupPushBasedLogExport` - `Public Preview: please provide feedback `_: Configures the project level settings for the push-based log export feature. +* :ref:`atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport` - `Public Preview: please provide feedback `_: Disables the push-based log export feature by resetting the project level settings to its default configuration. +* :ref:`atlas-api-pushBasedLogExport-getGroupPushBasedLogExport` - `Public Preview: please provide feedback `_: Fetches the current project level settings for the push-based log export feature. +* :ref:`atlas-api-pushBasedLogExport-updateGroupPushBasedLogExport` - `Public Preview: please provide feedback `_: Updates the project level settings for the push-based log export feature. .. toctree:: :titlesonly: - createPushBasedLogConfiguration - deletePushBasedLogConfiguration - getPushBasedLogConfiguration - updatePushBasedLogConfiguration + createGroupPushBasedLogExport + deleteGroupPushBasedLogExport + getGroupPushBasedLogExport + updateGroupPushBasedLogExport diff --git a/docs/command/atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries.txt b/docs/command/atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries.txt deleted file mode 100644 index f61a0f7c3b..0000000000 --- a/docs/command/atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries.txt +++ /dev/null @@ -1,140 +0,0 @@ -.. _atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries: - -====================================================================== -atlas api queryShapeInsights getGroupClusterQueryShapeInsightSummaries -====================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns a list of query shape statistics summaries for a given cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Query shape statistics provide performance insights about MongoDB queries, helping users identify problematic query patterns and potential optimizations. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterqueryshapeinsightsummaries. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api queryShapeInsights getGroupClusterQueryShapeInsightSummaries [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --commands - - & - - false - - Retrieve query shape statistics matching specified MongoDB commands. To include multiple commands, pass the parameter multiple times delimited with an ampersand (&) between each command. The currently supported parameters are find, distinct, and aggregate. Omit this parameter to return results for all supported commands. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getGroupClusterQueryShapeInsightSummaries - * - --nSummaries - - int - - false - - Maximum number of query statistic summaries to return. - * - --namespaces - - . - - false - - Namespaces from which to retrieve query shape statistics. A namespace consists of one database and one collection resource written as .: ``.``. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (`&`) between each namespace. Omit this parameter to return results for all namespaces. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processIds - - mongod - - false - - ProcessIds from which to retrieve query shape statistics. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (`&`) between each processId. - * - --queryShapeHashes - - & - - false - - A list of SHA256 hashes of desired query shapes, output by MongoDB commands like $queryStats and $explain or slow query logs. To include multiple series, pass the parameter multiple times delimited with an ampersand (&) between each series. Omit this parameter to return results for all available series. - * - --series - - & - - false - - Query shape statistics data series to retrieve. A series represents a specific metric about query execution. To include multiple series, pass the parameter multiple times delimited with an ampersand (&) between each series. Omit this parameter to return results for all available series. - * - --since - - int - - false - - Date and time from which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - - - If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. - - If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours. - * - --until - - int - - false - - Date and time up until which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - - - If you specify the **until** parameter, you must specify the **since** parameter. - - If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-03-12"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-03-12". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries-2025-03-12-default.sh - :language: shell diff --git a/docs/command/atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries.txt b/docs/command/atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries.txt new file mode 100644 index 0000000000..a4665ebb03 --- /dev/null +++ b/docs/command/atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries.txt @@ -0,0 +1,140 @@ +.. _atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries: + +======================================================================= +atlas api queryShapeInsights listGroupClusterQueryShapeInsightSummaries +======================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns a list of query shape statistics summaries for a given cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Query shape statistics provide performance insights about MongoDB queries, helping users identify problematic query patterns and potential optimizations. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterqueryshapeinsightsummaries. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api queryShapeInsights listGroupClusterQueryShapeInsightSummaries [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --commands + - & + - false + - Retrieve query shape statistics matching specified MongoDB commands. To include multiple commands, pass the parameter multiple times delimited with an ampersand (&) between each command. The currently supported parameters are find, distinct, and aggregate. Omit this parameter to return results for all supported commands. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterQueryShapeInsightSummaries + * - --nSummaries + - int + - false + - Maximum number of query statistic summaries to return. + * - --namespaces + - . + - false + - Namespaces from which to retrieve query shape statistics. A namespace consists of one database and one collection resource written as .: ``.``. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (`&`) between each namespace. Omit this parameter to return results for all namespaces. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processIds + - mongod + - false + - ProcessIds from which to retrieve query shape statistics. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or `mongos`). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (`&`) between each processId. + * - --queryShapeHashes + - & + - false + - A list of SHA256 hashes of desired query shapes, output by MongoDB commands like $queryStats and $explain or slow query logs. To include multiple series, pass the parameter multiple times delimited with an ampersand (&) between each series. Omit this parameter to return results for all available series. + * - --series + - & + - false + - Query shape statistics data series to retrieve. A series represents a specific metric about query execution. To include multiple series, pass the parameter multiple times delimited with an ampersand (&) between each series. Omit this parameter to return results for all available series. + * - --since + - int + - false + - Date and time from which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + + - If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. + - If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours. + * - --until + - int + - false + - Date and time up until which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + + - If you specify the **until** parameter, you must specify the **since** parameter. + - If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-03-12"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-03-12". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries-2025-03-12-default.sh + :language: shell diff --git a/docs/command/atlas-api-queryShapeInsights.txt b/docs/command/atlas-api-queryShapeInsights.txt index 8aa62bb13b..c2130504fd 100644 --- a/docs/command/atlas-api-queryShapeInsights.txt +++ b/docs/command/atlas-api-queryShapeInsights.txt @@ -55,12 +55,12 @@ Related Commands ---------------- * :ref:`atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightDetails` - `Public Preview: please provide feedback `_: Returns the metadata and statistics summary for a given query shape hash. -* :ref:`atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries` - `Public Preview: please provide feedback `_: Returns a list of query shape statistics summaries for a given cluster. +* :ref:`atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries` - `Public Preview: please provide feedback `_: Returns a list of query shape statistics summaries for a given cluster. .. toctree:: :titlesonly: getGroupClusterQueryShapeInsightDetails - getGroupClusterQueryShapeInsightSummaries + listGroupClusterQueryShapeInsightSummaries diff --git a/docs/command/atlas-api-resourcePolicies-getOrgNonCompliantResources.txt b/docs/command/atlas-api-resourcePolicies-getOrgNonCompliantResources.txt new file mode 100644 index 0000000000..60108e8e35 --- /dev/null +++ b/docs/command/atlas-api-resourcePolicies-getOrgNonCompliantResources.txt @@ -0,0 +1,94 @@ +.. _atlas-api-resourcePolicies-getOrgNonCompliantResources: + +====================================================== +atlas api resourcePolicies getOrgNonCompliantResources +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Return all non-compliant resources for an org. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgnoncompliantresources. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api resourcePolicies getOrgNonCompliantResources [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgNonCompliantResources + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-resourcePolicies-getOrgNonCompliantResources-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-resourcePolicies-getResourcesNonCompliant.txt b/docs/command/atlas-api-resourcePolicies-getResourcesNonCompliant.txt deleted file mode 100644 index 51b3e1f8e8..0000000000 --- a/docs/command/atlas-api-resourcePolicies-getResourcesNonCompliant.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-resourcePolicies-getResourcesNonCompliant: - -=================================================== -atlas api resourcePolicies getResourcesNonCompliant -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Return all non-compliant resources for an org. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getresourcesnoncompliant. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api resourcePolicies getResourcesNonCompliant [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getResourcesNonCompliant - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-resourcePolicies-getResourcesNonCompliant-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-resourcePolicies-validateAtlasResourcePolicy.txt b/docs/command/atlas-api-resourcePolicies-validateAtlasResourcePolicy.txt deleted file mode 100644 index d34aca07b8..0000000000 --- a/docs/command/atlas-api-resourcePolicies-validateAtlasResourcePolicy.txt +++ /dev/null @@ -1,93 +0,0 @@ -.. _atlas-api-resourcePolicies-validateAtlasResourcePolicy: - -====================================================== -atlas api resourcePolicies validateAtlasResourcePolicy -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Validate one Atlas Resource Policy for an org. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validateatlasresourcepolicy. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api resourcePolicies validateAtlasResourcePolicy [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for validateAtlasResourcePolicy - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-resourcePolicies-validateOrgResourcePolicies.txt b/docs/command/atlas-api-resourcePolicies-validateOrgResourcePolicies.txt new file mode 100644 index 0000000000..83f0df55fe --- /dev/null +++ b/docs/command/atlas-api-resourcePolicies-validateOrgResourcePolicies.txt @@ -0,0 +1,93 @@ +.. _atlas-api-resourcePolicies-validateOrgResourcePolicies: + +====================================================== +atlas api resourcePolicies validateOrgResourcePolicies +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Validate one Atlas Resource Policy for an org. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validateorgresourcepolicies. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api resourcePolicies validateOrgResourcePolicies [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for validateOrgResourcePolicies + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-resourcePolicies.txt b/docs/command/atlas-api-resourcePolicies.txt index 6d8d4e3537..8be717181e 100644 --- a/docs/command/atlas-api-resourcePolicies.txt +++ b/docs/command/atlas-api-resourcePolicies.txt @@ -56,11 +56,11 @@ Related Commands * :ref:`atlas-api-resourcePolicies-createOrgResourcePolicy` - `Public Preview: please provide feedback `_: Create one Atlas Resource Policy for an org. * :ref:`atlas-api-resourcePolicies-deleteOrgResourcePolicy` - `Public Preview: please provide feedback `_: Delete one Atlas Resource Policy for an org. +* :ref:`atlas-api-resourcePolicies-getOrgNonCompliantResources` - `Public Preview: please provide feedback `_: Return all non-compliant resources for an org. * :ref:`atlas-api-resourcePolicies-getOrgResourcePolicy` - `Public Preview: please provide feedback `_: Return one Atlas Resource Policy for an org. -* :ref:`atlas-api-resourcePolicies-getResourcesNonCompliant` - `Public Preview: please provide feedback `_: Return all non-compliant resources for an org. * :ref:`atlas-api-resourcePolicies-listOrgResourcePolicies` - `Public Preview: please provide feedback `_: Return all Atlas Resource Policies for the org. * :ref:`atlas-api-resourcePolicies-updateOrgResourcePolicy` - `Public Preview: please provide feedback `_: Update one Atlas Resource Policy for an org. -* :ref:`atlas-api-resourcePolicies-validateAtlasResourcePolicy` - `Public Preview: please provide feedback `_: Validate one Atlas Resource Policy for an org. +* :ref:`atlas-api-resourcePolicies-validateOrgResourcePolicies` - `Public Preview: please provide feedback `_: Validate one Atlas Resource Policy for an org. .. toctree:: @@ -68,9 +68,9 @@ Related Commands createOrgResourcePolicy deleteOrgResourcePolicy + getOrgNonCompliantResources getOrgResourcePolicy - getResourcesNonCompliant listOrgResourcePolicies updateOrgResourcePolicy - validateAtlasResourcePolicy + validateOrgResourcePolicies diff --git a/docs/command/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex.txt b/docs/command/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex.txt new file mode 100644 index 0000000000..da1e89a288 --- /dev/null +++ b/docs/command/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex.txt @@ -0,0 +1,145 @@ +.. _atlas-api-rollingIndex-createGroupClusterIndexRollingIndex: + +========================================================== +atlas api rollingIndex createGroupClusterIndexRollingIndex +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates an index on the cluster identified by its name in a rolling manner. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Creating the index in this way allows index builds on one replica set member as a standalone at a time, starting with the secondary members. Creating indexes in this way requires at least one replica set election. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterindexrollingindex. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api rollingIndex createGroupClusterIndexRollingIndex [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster on which MongoDB Cloud creates an index. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterIndexRollingIndex + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. tabs:: + + .. tab:: Example + :tabid: 2023-01-01_2dspere_index + + 2dspere Index + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-2dspere_index-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-2dspere_index.sh + :language: shell + .. tab:: Example 1 + :tabid: 2023-01-01_partial_index + + Partial Index + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-partial_index-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-partial_index.sh + :language: shell + .. tab:: Example 2 + :tabid: 2023-01-01_sparse_index + + Sparse Index + + Create the file below and save it as ``payload.json`` + + .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-sparse_index-payload.json + :language: shell + After creating ``payload.json``, run the command below in the same directory. + + .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-sparse_index.sh + :language: shell diff --git a/docs/command/atlas-api-rollingIndex-createRollingIndex.txt b/docs/command/atlas-api-rollingIndex-createRollingIndex.txt deleted file mode 100644 index 719c820d85..0000000000 --- a/docs/command/atlas-api-rollingIndex-createRollingIndex.txt +++ /dev/null @@ -1,145 +0,0 @@ -.. _atlas-api-rollingIndex-createRollingIndex: - -========================================= -atlas api rollingIndex createRollingIndex -========================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates an index on the cluster identified by its name in a rolling manner. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Creating the index in this way allows index builds on one replica set member as a standalone at a time, starting with the secondary members. Creating indexes in this way requires at least one replica set election. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createrollingindex. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api rollingIndex createRollingIndex [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster on which MongoDB Cloud creates an index. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createRollingIndex - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. tabs:: - - .. tab:: Example - :tabid: 2023-01-01_2dspere_index - - 2dspere Index - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createRollingIndex-2023-01-01-2dspere_index-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createRollingIndex-2023-01-01-2dspere_index.sh - :language: shell - .. tab:: Example 1 - :tabid: 2023-01-01_partial_index - - Partial Index - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createRollingIndex-2023-01-01-partial_index-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createRollingIndex-2023-01-01-partial_index.sh - :language: shell - .. tab:: Example 2 - :tabid: 2023-01-01_sparse_index - - Sparse Index - - Create the file below and save it as ``payload.json`` - - .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createRollingIndex-2023-01-01-sparse_index-payload.json - :language: shell - After creating ``payload.json``, run the command below in the same directory. - - .. literalinclude:: /includes/examples/atlas-api-rollingIndex-createRollingIndex-2023-01-01-sparse_index.sh - :language: shell diff --git a/docs/command/atlas-api-rollingIndex.txt b/docs/command/atlas-api-rollingIndex.txt index 56cbda56f4..25b08a9f1d 100644 --- a/docs/command/atlas-api-rollingIndex.txt +++ b/docs/command/atlas-api-rollingIndex.txt @@ -54,11 +54,11 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-rollingIndex-createRollingIndex` - `Public Preview: please provide feedback `_: Creates an index on the cluster identified by its name in a rolling manner. +* :ref:`atlas-api-rollingIndex-createGroupClusterIndexRollingIndex` - `Public Preview: please provide feedback `_: Creates an index on the cluster identified by its name in a rolling manner. .. toctree:: :titlesonly: - createRollingIndex + createGroupClusterIndexRollingIndex diff --git a/docs/command/atlas-api-root-listControlPlaneIpAddresses.txt b/docs/command/atlas-api-root-listControlPlaneIpAddresses.txt new file mode 100644 index 0000000000..6a671515ae --- /dev/null +++ b/docs/command/atlas-api-root-listControlPlaneIpAddresses.txt @@ -0,0 +1,81 @@ +.. _atlas-api-root-listControlPlaneIpAddresses: + +========================================== +atlas api root listControlPlaneIpAddresses +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all control plane IP addresses. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcontrolplaneipaddresses. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api root listControlPlaneIpAddresses [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listControlPlaneIpAddresses + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-root-returnAllControlPlaneIpAddresses.txt b/docs/command/atlas-api-root-returnAllControlPlaneIpAddresses.txt deleted file mode 100644 index 9b4e9dea7b..0000000000 --- a/docs/command/atlas-api-root-returnAllControlPlaneIpAddresses.txt +++ /dev/null @@ -1,81 +0,0 @@ -.. _atlas-api-root-returnAllControlPlaneIpAddresses: - -=============================================== -atlas api root returnAllControlPlaneIpAddresses -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all control plane IP addresses. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnallcontrolplaneipaddresses. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api root returnAllControlPlaneIpAddresses [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for returnAllControlPlaneIpAddresses - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-11-15"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-11-15". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-root.txt b/docs/command/atlas-api-root.txt index 67d2f2e32d..84017454e0 100644 --- a/docs/command/atlas-api-root.txt +++ b/docs/command/atlas-api-root.txt @@ -55,12 +55,12 @@ Related Commands ---------------- * :ref:`atlas-api-root-getSystemStatus` - `Public Preview: please provide feedback `_: This resource returns information about the MongoDB application along with API key meta data. -* :ref:`atlas-api-root-returnAllControlPlaneIpAddresses` - `Public Preview: please provide feedback `_: Returns all control plane IP addresses. +* :ref:`atlas-api-root-listControlPlaneIpAddresses` - `Public Preview: please provide feedback `_: Returns all control plane IP addresses. .. toctree:: :titlesonly: getSystemStatus - returnAllControlPlaneIpAddresses + listControlPlaneIpAddresses diff --git a/docs/command/atlas-api-serverlessInstances-createGroupServerlessInstance.txt b/docs/command/atlas-api-serverlessInstances-createGroupServerlessInstance.txt new file mode 100644 index 0000000000..bb6776cd3f --- /dev/null +++ b/docs/command/atlas-api-serverlessInstances-createGroupServerlessInstance.txt @@ -0,0 +1,108 @@ +.. _atlas-api-serverlessInstances-createGroupServerlessInstance: + +=========================================================== +atlas api serverlessInstances createGroupServerlessInstance +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Update as of Feb 2025: This endpoint now creates a Flex cluster instead. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This endpoint will no longer be supported starting January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect. Please use the createFlexCluster endpoint instead. + + +Creates one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserverlessinstance. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessInstances createGroupServerlessInstance [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupServerlessInstance + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serverlessInstances-createServerlessInstance.txt b/docs/command/atlas-api-serverlessInstances-createServerlessInstance.txt deleted file mode 100644 index 03cd6e46cf..0000000000 --- a/docs/command/atlas-api-serverlessInstances-createServerlessInstance.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-serverlessInstances-createServerlessInstance: - -====================================================== -atlas api serverlessInstances createServerlessInstance -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Update as of Feb 2025: This endpoint now creates a Flex cluster instead. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This endpoint will no longer be supported starting January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect. Please use the createFlexCluster endpoint instead. - - -Creates one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserverlessinstance. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessInstances createServerlessInstance [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createServerlessInstance - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serverlessInstances-deleteGroupServerlessInstance.txt b/docs/command/atlas-api-serverlessInstances-deleteGroupServerlessInstance.txt new file mode 100644 index 0000000000..5f8f8af590 --- /dev/null +++ b/docs/command/atlas-api-serverlessInstances-deleteGroupServerlessInstance.txt @@ -0,0 +1,113 @@ +.. _atlas-api-serverlessInstances-deleteGroupServerlessInstance: + +=========================================================== +atlas api serverlessInstances deleteGroupServerlessInstance +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one serverless instance from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The serverless instance must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the deleteFlexCluster endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupserverlessinstance. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessInstances deleteGroupServerlessInstance [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupServerlessInstance + * - --name + - string + - true + - Human-readable label that identifies the serverless instance. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serverlessInstances-deleteGroupServerlessInstance-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-serverlessInstances-deleteServerlessInstance.txt b/docs/command/atlas-api-serverlessInstances-deleteServerlessInstance.txt deleted file mode 100644 index 22b0c71e1c..0000000000 --- a/docs/command/atlas-api-serverlessInstances-deleteServerlessInstance.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-serverlessInstances-deleteServerlessInstance: - -====================================================== -atlas api serverlessInstances deleteServerlessInstance -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one serverless instance from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The serverless instance must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the deleteFlexCluster endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserverlessinstance. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessInstances deleteServerlessInstance [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteServerlessInstance - * - --name - - string - - true - - Human-readable label that identifies the serverless instance. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serverlessInstances-deleteServerlessInstance-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-serverlessInstances-getGroupServerlessInstance.txt b/docs/command/atlas-api-serverlessInstances-getGroupServerlessInstance.txt new file mode 100644 index 0000000000..58ebccc951 --- /dev/null +++ b/docs/command/atlas-api-serverlessInstances-getGroupServerlessInstance.txt @@ -0,0 +1,105 @@ +.. _atlas-api-serverlessInstances-getGroupServerlessInstance: + +======================================================== +atlas api serverlessInstances getGroupServerlessInstance +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details for one serverless instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. This endpoint will be sunset in January 2026. Please use the getFlexCluster endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserverlessinstance. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessInstances getGroupServerlessInstance [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupServerlessInstance + * - --name + - string + - true + - Human-readable label that identifies the serverless instance. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serverlessInstances-getGroupServerlessInstance-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-serverlessInstances-getServerlessInstance.txt b/docs/command/atlas-api-serverlessInstances-getServerlessInstance.txt deleted file mode 100644 index 955b148798..0000000000 --- a/docs/command/atlas-api-serverlessInstances-getServerlessInstance.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-serverlessInstances-getServerlessInstance: - -=================================================== -atlas api serverlessInstances getServerlessInstance -=================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details for one serverless instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. This endpoint will be sunset in January 2026. Please use the getFlexCluster endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessinstance. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessInstances getServerlessInstance [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getServerlessInstance - * - --name - - string - - true - - Human-readable label that identifies the serverless instance. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serverlessInstances-getServerlessInstance-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-serverlessInstances-listGroupServerlessInstances.txt b/docs/command/atlas-api-serverlessInstances-listGroupServerlessInstances.txt new file mode 100644 index 0000000000..5933c68605 --- /dev/null +++ b/docs/command/atlas-api-serverlessInstances-listGroupServerlessInstances.txt @@ -0,0 +1,113 @@ +.. _atlas-api-serverlessInstances-listGroupServerlessInstances: + +========================================================== +atlas api serverlessInstances listGroupServerlessInstances +========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details for all serverless instances in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This endpoint also lists Flex clusters that were created using the createServerlessInstance endpoint or former Serverless instances that have been migrated to Flex clusters, until January 2026 after which this endpoint will be sunset. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. Please use the listFlexClusters endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserverlessinstances. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessInstances listGroupServerlessInstances [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupServerlessInstances + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serverlessInstances-listGroupServerlessInstances-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-serverlessInstances-listServerlessInstances.txt b/docs/command/atlas-api-serverlessInstances-listServerlessInstances.txt deleted file mode 100644 index 01c9ed7829..0000000000 --- a/docs/command/atlas-api-serverlessInstances-listServerlessInstances.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-serverlessInstances-listServerlessInstances: - -===================================================== -atlas api serverlessInstances listServerlessInstances -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details for all serverless instances in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This endpoint also lists Flex clusters that were created using the createServerlessInstance endpoint or former Serverless instances that have been migrated to Flex clusters, until January 2026 after which this endpoint will be sunset. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. Please use the listFlexClusters endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserverlessinstances. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessInstances listServerlessInstances [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listServerlessInstances - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serverlessInstances-listServerlessInstances-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-serverlessInstances-updateGroupServerlessInstance.txt b/docs/command/atlas-api-serverlessInstances-updateGroupServerlessInstance.txt new file mode 100644 index 0000000000..ca70d65217 --- /dev/null +++ b/docs/command/atlas-api-serverlessInstances-updateGroupServerlessInstance.txt @@ -0,0 +1,112 @@ +.. _atlas-api-serverlessInstances-updateGroupServerlessInstance: + +=========================================================== +atlas api serverlessInstances updateGroupServerlessInstance +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one serverless instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. Please use the updateFlexCluster endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupserverlessinstance. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessInstances updateGroupServerlessInstance [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupServerlessInstance + * - --name + - string + - true + - Human-readable label that identifies the serverless instance. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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 +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serverlessInstances-updateServerlessInstance.txt b/docs/command/atlas-api-serverlessInstances-updateServerlessInstance.txt deleted file mode 100644 index 0351e4f0ff..0000000000 --- a/docs/command/atlas-api-serverlessInstances-updateServerlessInstance.txt +++ /dev/null @@ -1,112 +0,0 @@ -.. _atlas-api-serverlessInstances-updateServerlessInstance: - -====================================================== -atlas api serverlessInstances updateServerlessInstance -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one serverless instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. Please use the updateFlexCluster endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateserverlessinstance. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessInstances updateServerlessInstance [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateServerlessInstance - * - --name - - string - - true - - Human-readable label that identifies the serverless instance. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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 ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serverlessInstances.txt b/docs/command/atlas-api-serverlessInstances.txt index 36c57106e1..a57bebd233 100644 --- a/docs/command/atlas-api-serverlessInstances.txt +++ b/docs/command/atlas-api-serverlessInstances.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-serverlessInstances-createServerlessInstance` - `Public Preview: please provide feedback `_: Update as of Feb 2025: This endpoint now creates a Flex cluster instead. -* :ref:`atlas-api-serverlessInstances-deleteServerlessInstance` - `Public Preview: please provide feedback `_: Removes one serverless instance from the specified project. -* :ref:`atlas-api-serverlessInstances-getServerlessInstance` - `Public Preview: please provide feedback `_: Returns details for one serverless instance in the specified project. -* :ref:`atlas-api-serverlessInstances-listServerlessInstances` - `Public Preview: please provide feedback `_: Returns details for all serverless instances in the specified project. -* :ref:`atlas-api-serverlessInstances-updateServerlessInstance` - `Public Preview: please provide feedback `_: Updates one serverless instance in the specified project. +* :ref:`atlas-api-serverlessInstances-createGroupServerlessInstance` - `Public Preview: please provide feedback `_: Update as of Feb 2025: This endpoint now creates a Flex cluster instead. +* :ref:`atlas-api-serverlessInstances-deleteGroupServerlessInstance` - `Public Preview: please provide feedback `_: Removes one serverless instance from the specified project. +* :ref:`atlas-api-serverlessInstances-getGroupServerlessInstance` - `Public Preview: please provide feedback `_: Returns details for one serverless instance in the specified project. +* :ref:`atlas-api-serverlessInstances-listGroupServerlessInstances` - `Public Preview: please provide feedback `_: Returns details for all serverless instances in the specified project. +* :ref:`atlas-api-serverlessInstances-updateGroupServerlessInstance` - `Public Preview: please provide feedback `_: Updates one serverless instance in the specified project. .. toctree:: :titlesonly: - createServerlessInstance - deleteServerlessInstance - getServerlessInstance - listServerlessInstances - updateServerlessInstance + createGroupServerlessInstance + deleteGroupServerlessInstance + getGroupServerlessInstance + listGroupServerlessInstances + updateGroupServerlessInstance diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-createGroupPrivateEndpointServerlessInstanceEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-createGroupPrivateEndpointServerlessInstanceEndpoint.txt new file mode 100644 index 0000000000..960bcfbf2e --- /dev/null +++ b/docs/command/atlas-api-serverlessPrivateEndpoints-createGroupPrivateEndpointServerlessInstanceEndpoint.txt @@ -0,0 +1,103 @@ +.. _atlas-api-serverlessPrivateEndpoints-createGroupPrivateEndpointServerlessInstanceEndpoint: + +========================================================================================= +atlas api serverlessPrivateEndpoints createGroupPrivateEndpointServerlessInstanceEndpoint +========================================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one private endpoint for one serverless instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +A new endpoint won't be immediately available after creation. Read the steps in the linked tutorial for detailed guidance. + + +This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupprivateendpointserverlessinstanceendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessPrivateEndpoints createGroupPrivateEndpointServerlessInstanceEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupPrivateEndpointServerlessInstanceEndpoint + * - --instanceName + - string + - true + - Human-readable label that identifies the serverless instance for which the tenant endpoint will be created. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-createServerlessPrivateEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-createServerlessPrivateEndpoint.txt deleted file mode 100644 index c5bd612603..0000000000 --- a/docs/command/atlas-api-serverlessPrivateEndpoints-createServerlessPrivateEndpoint.txt +++ /dev/null @@ -1,103 +0,0 @@ -.. _atlas-api-serverlessPrivateEndpoints-createServerlessPrivateEndpoint: - -==================================================================== -atlas api serverlessPrivateEndpoints createServerlessPrivateEndpoint -==================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one private endpoint for one serverless instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -A new endpoint won't be immediately available after creation. Read the steps in the linked tutorial for detailed guidance. - - -This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserverlessprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessPrivateEndpoints createServerlessPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createServerlessPrivateEndpoint - * - --instanceName - - string - - true - - Human-readable label that identifies the serverless instance for which the tenant endpoint will be created. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint.txt new file mode 100644 index 0000000000..d87c6f52b9 --- /dev/null +++ b/docs/command/atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint.txt @@ -0,0 +1,105 @@ +.. _atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint: + +========================================================================================= +atlas api serverlessPrivateEndpoints deleteGroupPrivateEndpointServerlessInstanceEndpoint +========================================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Remove one private endpoint from one serverless instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupprivateendpointserverlessinstanceendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessPrivateEndpoints deleteGroupPrivateEndpointServerlessInstanceEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --endpointId + - string + - true + - Unique 24-hexadecimal digit string that identifies the tenant endpoint which will be removed. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupPrivateEndpointServerlessInstanceEndpoint + * - --instanceName + - string + - true + - Human-readable label that identifies the serverless instance from which the tenant endpoint will be removed. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint.txt deleted file mode 100644 index 58a1a9488f..0000000000 --- a/docs/command/atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint: - -==================================================================== -atlas api serverlessPrivateEndpoints deleteServerlessPrivateEndpoint -==================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Remove one private endpoint from one serverless instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserverlessprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessPrivateEndpoints deleteServerlessPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --endpointId - - string - - true - - Unique 24-hexadecimal digit string that identifies the tenant endpoint which will be removed. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteServerlessPrivateEndpoint - * - --instanceName - - string - - true - - Human-readable label that identifies the serverless instance from which the tenant endpoint will be removed. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint.txt new file mode 100644 index 0000000000..abd77473af --- /dev/null +++ b/docs/command/atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint.txt @@ -0,0 +1,105 @@ +.. _atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint: + +====================================================================================== +atlas api serverlessPrivateEndpoints getGroupPrivateEndpointServerlessInstanceEndpoint +====================================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Return one private endpoint for one serverless instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Identify this endpoint using its unique ID. You must have at least the Project Read Only role for the project to successfully call this resource. + + +This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivateendpointserverlessinstanceendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessPrivateEndpoints getGroupPrivateEndpointServerlessInstanceEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --endpointId + - string + - true + - Unique 24-hexadecimal digit string that identifies the tenant endpoint. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupPrivateEndpointServerlessInstanceEndpoint + * - --instanceName + - string + - true + - Human-readable label that identifies the serverless instance associated with the tenant endpoint. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint.txt deleted file mode 100644 index ed322f1146..0000000000 --- a/docs/command/atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint: - -================================================================= -atlas api serverlessPrivateEndpoints getServerlessPrivateEndpoint -================================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Return one private endpoint for one serverless instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Identify this endpoint using its unique ID. You must have at least the Project Read Only role for the project to successfully call this resource. - - -This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessPrivateEndpoints getServerlessPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --endpointId - - string - - true - - Unique 24-hexadecimal digit string that identifies the tenant endpoint. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getServerlessPrivateEndpoint - * - --instanceName - - string - - true - - Human-readable label that identifies the serverless instance associated with the tenant endpoint. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint.txt new file mode 100644 index 0000000000..78b7fb03dd --- /dev/null +++ b/docs/command/atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint.txt @@ -0,0 +1,101 @@ +.. _atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint: + +======================================================================================= +atlas api serverlessPrivateEndpoints listGroupPrivateEndpointServerlessInstanceEndpoint +======================================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all private endpoints for one serverless instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You must have at least the Project Read Only role for the project to successfully call this resource. + + +This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprivateendpointserverlessinstanceendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessPrivateEndpoints listGroupPrivateEndpointServerlessInstanceEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupPrivateEndpointServerlessInstanceEndpoint + * - --instanceName + - string + - true + - Human-readable label that identifies the serverless instance associated with the tenant endpoint. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints.txt deleted file mode 100644 index 1c9e8225f0..0000000000 --- a/docs/command/atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints: - -=================================================================== -atlas api serverlessPrivateEndpoints listServerlessPrivateEndpoints -=================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all private endpoints for one serverless instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You must have at least the Project Read Only role for the project to successfully call this resource. - - -This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserverlessprivateendpoints. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessPrivateEndpoints listServerlessPrivateEndpoints [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listServerlessPrivateEndpoints - * - --instanceName - - string - - true - - Human-readable label that identifies the serverless instance associated with the tenant endpoint. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-updateGroupPrivateEndpointServerlessInstanceEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-updateGroupPrivateEndpointServerlessInstanceEndpoint.txt new file mode 100644 index 0000000000..ec2f359a37 --- /dev/null +++ b/docs/command/atlas-api-serverlessPrivateEndpoints-updateGroupPrivateEndpointServerlessInstanceEndpoint.txt @@ -0,0 +1,104 @@ +.. _atlas-api-serverlessPrivateEndpoints-updateGroupPrivateEndpointServerlessInstanceEndpoint: + +========================================================================================= +atlas api serverlessPrivateEndpoints updateGroupPrivateEndpointServerlessInstanceEndpoint +========================================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one private endpoint for one serverless instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupprivateendpointserverlessinstanceendpoint. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serverlessPrivateEndpoints updateGroupPrivateEndpointServerlessInstanceEndpoint [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --endpointId + - string + - true + - Unique 24-hexadecimal digit string that identifies the tenant endpoint which will be updated. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupPrivateEndpointServerlessInstanceEndpoint + * - --instanceName + - string + - true + - Human-readable label that identifies the serverless instance associated with the tenant endpoint that will be updated. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints-updateServerlessPrivateEndpoint.txt b/docs/command/atlas-api-serverlessPrivateEndpoints-updateServerlessPrivateEndpoint.txt deleted file mode 100644 index a8163382aa..0000000000 --- a/docs/command/atlas-api-serverlessPrivateEndpoints-updateServerlessPrivateEndpoint.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-serverlessPrivateEndpoints-updateServerlessPrivateEndpoint: - -==================================================================== -atlas api serverlessPrivateEndpoints updateServerlessPrivateEndpoint -==================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one private endpoint for one serverless instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateserverlessprivateendpoint. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serverlessPrivateEndpoints updateServerlessPrivateEndpoint [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --endpointId - - string - - true - - Unique 24-hexadecimal digit string that identifies the tenant endpoint which will be updated. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateServerlessPrivateEndpoint - * - --instanceName - - string - - true - - Human-readable label that identifies the serverless instance associated with the tenant endpoint that will be updated. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serverlessPrivateEndpoints.txt b/docs/command/atlas-api-serverlessPrivateEndpoints.txt index 712bc39b39..6f5f844c5a 100644 --- a/docs/command/atlas-api-serverlessPrivateEndpoints.txt +++ b/docs/command/atlas-api-serverlessPrivateEndpoints.txt @@ -54,19 +54,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-serverlessPrivateEndpoints-createServerlessPrivateEndpoint` - `Public Preview: please provide feedback `_: Creates one private endpoint for one serverless instance. -* :ref:`atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint` - `Public Preview: please provide feedback `_: Remove one private endpoint from one serverless instance. -* :ref:`atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint` - `Public Preview: please provide feedback `_: Return one private endpoint for one serverless instance. -* :ref:`atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints` - `Public Preview: please provide feedback `_: Returns all private endpoints for one serverless instance. -* :ref:`atlas-api-serverlessPrivateEndpoints-updateServerlessPrivateEndpoint` - `Public Preview: please provide feedback `_: Updates one private endpoint for one serverless instance. +* :ref:`atlas-api-serverlessPrivateEndpoints-createGroupPrivateEndpointServerlessInstanceEndpoint` - `Public Preview: please provide feedback `_: Creates one private endpoint for one serverless instance. +* :ref:`atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint` - `Public Preview: please provide feedback `_: Remove one private endpoint from one serverless instance. +* :ref:`atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint` - `Public Preview: please provide feedback `_: Return one private endpoint for one serverless instance. +* :ref:`atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint` - `Public Preview: please provide feedback `_: Returns all private endpoints for one serverless instance. +* :ref:`atlas-api-serverlessPrivateEndpoints-updateGroupPrivateEndpointServerlessInstanceEndpoint` - `Public Preview: please provide feedback `_: Updates one private endpoint for one serverless instance. .. toctree:: :titlesonly: - createServerlessPrivateEndpoint - deleteServerlessPrivateEndpoint - getServerlessPrivateEndpoint - listServerlessPrivateEndpoints - updateServerlessPrivateEndpoint + createGroupPrivateEndpointServerlessInstanceEndpoint + deleteGroupPrivateEndpointServerlessInstanceEndpoint + getGroupPrivateEndpointServerlessInstanceEndpoint + listGroupPrivateEndpointServerlessInstanceEndpoint + updateGroupPrivateEndpointServerlessInstanceEndpoint diff --git a/docs/command/atlas-api-serviceAccounts-addProjectServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-addProjectServiceAccount.txt deleted file mode 100644 index a2600ac471..0000000000 --- a/docs/command/atlas-api-serviceAccounts-addProjectServiceAccount.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-serviceAccounts-addProjectServiceAccount: - -================================================== -atlas api serviceAccounts addProjectServiceAccount -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Assigns the specified Service Account to the specified Project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts addProjectServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for addProjectServiceAccount - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts-createGroupServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-createGroupServiceAccount.txt new file mode 100644 index 0000000000..2cd176c225 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-createGroupServiceAccount.txt @@ -0,0 +1,97 @@ +.. _atlas-api-serviceAccounts-createGroupServiceAccount: + +=================================================== +atlas api serviceAccounts createGroupServiceAccount +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one Service Account for the specified Project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The Service Account will automatically be added as an Organization Member to the Organization that the specified Project is a part of. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts createGroupServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupServiceAccount + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-createGroupServiceAccountAccessList.txt b/docs/command/atlas-api-serviceAccounts-createGroupServiceAccountAccessList.txt new file mode 100644 index 0000000000..29e87496e7 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-createGroupServiceAccountAccessList.txt @@ -0,0 +1,113 @@ +.. _atlas-api-serviceAccounts-createGroupServiceAccountAccessList: + +============================================================= +atlas api serviceAccounts createGroupServiceAccountAccessList +============================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Add Access List Entries for the specified Service Account for the project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Resources require all API requests to originate from IP addresses on the API access list. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserviceaccountaccesslist. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts createGroupServiceAccountAccessList [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupServiceAccountAccessList + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-createGroupServiceAccountSecret.txt b/docs/command/atlas-api-serviceAccounts-createGroupServiceAccountSecret.txt new file mode 100644 index 0000000000..526539e1c2 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-createGroupServiceAccountSecret.txt @@ -0,0 +1,99 @@ +.. _atlas-api-serviceAccounts-createGroupServiceAccountSecret: + +========================================================= +atlas api serviceAccounts createGroupServiceAccountSecret +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Create a secret for the specified Service Account in the specified Project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserviceaccountsecret. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts createGroupServiceAccountSecret [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupServiceAccountSecret + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-createOrgServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-createOrgServiceAccount.txt new file mode 100644 index 0000000000..85cd75275f --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-createOrgServiceAccount.txt @@ -0,0 +1,93 @@ +.. _atlas-api-serviceAccounts-createOrgServiceAccount: + +================================================= +atlas api serviceAccounts createOrgServiceAccount +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one Service Account for the specified Organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts createOrgServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgServiceAccount + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-createOrgServiceAccountAccessList.txt b/docs/command/atlas-api-serviceAccounts-createOrgServiceAccountAccessList.txt new file mode 100644 index 0000000000..9b1098c9bb --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-createOrgServiceAccountAccessList.txt @@ -0,0 +1,111 @@ +.. _atlas-api-serviceAccounts-createOrgServiceAccountAccessList: + +=========================================================== +atlas api serviceAccounts createOrgServiceAccountAccessList +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Add Access List Entries for the specified Service Account for the organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Resources require all API requests to originate from IP addresses on the API access list. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgserviceaccountaccesslist. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts createOrgServiceAccountAccessList [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgServiceAccountAccessList + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-createOrgServiceAccountSecret.txt b/docs/command/atlas-api-serviceAccounts-createOrgServiceAccountSecret.txt new file mode 100644 index 0000000000..acead49e1a --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-createOrgServiceAccountSecret.txt @@ -0,0 +1,97 @@ +.. _atlas-api-serviceAccounts-createOrgServiceAccountSecret: + +======================================================= +atlas api serviceAccounts createOrgServiceAccountSecret +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Create a secret for the specified Service Account. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgserviceaccountsecret. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts createOrgServiceAccountSecret [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgServiceAccountSecret + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-createProjectServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-createProjectServiceAccount.txt deleted file mode 100644 index 4791ce6352..0000000000 --- a/docs/command/atlas-api-serviceAccounts-createProjectServiceAccount.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-serviceAccounts-createProjectServiceAccount: - -===================================================== -atlas api serviceAccounts createProjectServiceAccount -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one Service Account for the specified Project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The Service Account will automatically be added as an Organization Member to the Organization that the specified Project is a part of. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts createProjectServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createProjectServiceAccount - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts-createProjectServiceAccountAccessList.txt b/docs/command/atlas-api-serviceAccounts-createProjectServiceAccountAccessList.txt deleted file mode 100644 index 036bfef5e0..0000000000 --- a/docs/command/atlas-api-serviceAccounts-createProjectServiceAccountAccessList.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-serviceAccounts-createProjectServiceAccountAccessList: - -=============================================================== -atlas api serviceAccounts createProjectServiceAccountAccessList -=============================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Add Access List Entries for the specified Service Account for the project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Resources require all API requests to originate from IP addresses on the API access list. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccountaccesslist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts createProjectServiceAccountAccessList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createProjectServiceAccountAccessList - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts-createProjectServiceAccountSecret.txt b/docs/command/atlas-api-serviceAccounts-createProjectServiceAccountSecret.txt deleted file mode 100644 index 29370926b6..0000000000 --- a/docs/command/atlas-api-serviceAccounts-createProjectServiceAccountSecret.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-serviceAccounts-createProjectServiceAccountSecret: - -=========================================================== -atlas api serviceAccounts createProjectServiceAccountSecret -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Create a secret for the specified Service Account in the specified Project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccountsecret. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts createProjectServiceAccountSecret [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createProjectServiceAccountSecret - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts-createServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-createServiceAccount.txt deleted file mode 100644 index 3a66468d61..0000000000 --- a/docs/command/atlas-api-serviceAccounts-createServiceAccount.txt +++ /dev/null @@ -1,93 +0,0 @@ -.. _atlas-api-serviceAccounts-createServiceAccount: - -============================================== -atlas api serviceAccounts createServiceAccount -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one Service Account for the specified Organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts createServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createServiceAccount - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts-createServiceAccountAccessList.txt b/docs/command/atlas-api-serviceAccounts-createServiceAccountAccessList.txt deleted file mode 100644 index 7b6a464945..0000000000 --- a/docs/command/atlas-api-serviceAccounts-createServiceAccountAccessList.txt +++ /dev/null @@ -1,111 +0,0 @@ -.. _atlas-api-serviceAccounts-createServiceAccountAccessList: - -======================================================== -atlas api serviceAccounts createServiceAccountAccessList -======================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Add Access List Entries for the specified Service Account for the organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Resources require all API requests to originate from IP addresses on the API access list. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccountaccesslist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts createServiceAccountAccessList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createServiceAccountAccessList - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts-createServiceAccountSecret.txt b/docs/command/atlas-api-serviceAccounts-createServiceAccountSecret.txt deleted file mode 100644 index bdfdf7f3f7..0000000000 --- a/docs/command/atlas-api-serviceAccounts-createServiceAccountSecret.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-serviceAccounts-createServiceAccountSecret: - -==================================================== -atlas api serviceAccounts createServiceAccountSecret -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Create a secret for the specified Service Account. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccountsecret. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts createServiceAccountSecret [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createServiceAccountSecret - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccount.txt new file mode 100644 index 0000000000..7b8b2c3e90 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccount.txt @@ -0,0 +1,102 @@ +.. _atlas-api-serviceAccounts-deleteGroupServiceAccount: + +=================================================== +atlas api serviceAccounts deleteGroupServiceAccount +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the specified Service Account from the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +The Service Account will still be a part of the Organization it was created in, and the credentials will remain active until expired or manually revoked. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts deleteGroupServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupServiceAccount + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteGroupServiceAccount-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry.txt b/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry.txt new file mode 100644 index 0000000000..fa189e012f --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry.txt @@ -0,0 +1,106 @@ +.. _atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry: + +================================================================== +atlas api serviceAccounts deleteGroupServiceAccountAccessListEntry +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the specified access list entry from the specified Service Account for the project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can't remove the requesting IP address from the access list. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupserviceaccountaccesslistentry. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts deleteGroupServiceAccountAccessListEntry [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupServiceAccountAccessListEntry + * - --ipAddress + - string + - true + - One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccountSecret.txt b/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccountSecret.txt new file mode 100644 index 0000000000..6ecea96b23 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-deleteGroupServiceAccountSecret.txt @@ -0,0 +1,104 @@ +.. _atlas-api-serviceAccounts-deleteGroupServiceAccountSecret: + +========================================================= +atlas api serviceAccounts deleteGroupServiceAccountSecret +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes the specified Service Account secret. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupserviceaccountsecret. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts deleteGroupServiceAccountSecret [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupServiceAccountSecret + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --secretId + - string + - true + - Unique 24-hexadecimal digit string that identifies the secret. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteGroupServiceAccountSecret-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccount.txt new file mode 100644 index 0000000000..381ab5b4da --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccount.txt @@ -0,0 +1,98 @@ +.. _atlas-api-serviceAccounts-deleteOrgServiceAccount: + +================================================= +atlas api serviceAccounts deleteOrgServiceAccount +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes the specified Service Account. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts deleteOrgServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrgServiceAccount + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteOrgServiceAccount-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry.txt b/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry.txt new file mode 100644 index 0000000000..5df79b1fad --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry.txt @@ -0,0 +1,104 @@ +.. _atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry: + +================================================================ +atlas api serviceAccounts deleteOrgServiceAccountAccessListEntry +================================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the specified access list entry from the specified Service Account for the organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can't remove the requesting IP address from the access list. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgserviceaccountaccesslistentry. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts deleteOrgServiceAccountAccessListEntry [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrgServiceAccountAccessListEntry + * - --ipAddress + - string + - true + - One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccountSecret.txt b/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccountSecret.txt new file mode 100644 index 0000000000..0fed128e5d --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-deleteOrgServiceAccountSecret.txt @@ -0,0 +1,102 @@ +.. _atlas-api-serviceAccounts-deleteOrgServiceAccountSecret: + +======================================================= +atlas api serviceAccounts deleteOrgServiceAccountSecret +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes the specified Service Account secret. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgserviceaccountsecret. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts deleteOrgServiceAccountSecret [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrgServiceAccountSecret + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --secretId + - string + - true + - Unique 24-hexadecimal digit string that identifies the secret. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteOrgServiceAccountSecret-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccount.txt deleted file mode 100644 index 238957ffb0..0000000000 --- a/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccount.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-serviceAccounts-deleteProjectServiceAccount: - -===================================================== -atlas api serviceAccounts deleteProjectServiceAccount -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the specified Service Account from the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -The Service Account will still be a part of the Organization it was created in, and the credentials will remain active until expired or manually revoked. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts deleteProjectServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteProjectServiceAccount - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteProjectServiceAccount-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry.txt b/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry.txt deleted file mode 100644 index 74ee28ff84..0000000000 --- a/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry: - -==================================================================== -atlas api serviceAccounts deleteProjectServiceAccountAccessListEntry -==================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the specified access list entry from the specified Service Account for the project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can't remove the requesting IP address from the access list. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccountaccesslistentry. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts deleteProjectServiceAccountAccessListEntry [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteProjectServiceAccountAccessListEntry - * - --ipAddress - - string - - true - - One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccountSecret.txt b/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccountSecret.txt deleted file mode 100644 index afcc6335fa..0000000000 --- a/docs/command/atlas-api-serviceAccounts-deleteProjectServiceAccountSecret.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-serviceAccounts-deleteProjectServiceAccountSecret: - -=========================================================== -atlas api serviceAccounts deleteProjectServiceAccountSecret -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes the specified Service Account secret. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccountsecret. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts deleteProjectServiceAccountSecret [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteProjectServiceAccountSecret - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --secretId - - string - - true - - Unique 24-hexadecimal digit string that identifies the secret. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteProjectServiceAccountSecret-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-deleteServiceAccount.txt deleted file mode 100644 index cbd4396190..0000000000 --- a/docs/command/atlas-api-serviceAccounts-deleteServiceAccount.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-serviceAccounts-deleteServiceAccount: - -============================================== -atlas api serviceAccounts deleteServiceAccount -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes the specified Service Account. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts deleteServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteServiceAccount - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteServiceAccount-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry.txt b/docs/command/atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry.txt deleted file mode 100644 index 385906c69d..0000000000 --- a/docs/command/atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry: - -============================================================= -atlas api serviceAccounts deleteServiceAccountAccessListEntry -============================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the specified access list entry from the specified Service Account for the organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can't remove the requesting IP address from the access list. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccountaccesslistentry. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts deleteServiceAccountAccessListEntry [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteServiceAccountAccessListEntry - * - --ipAddress - - string - - true - - One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-deleteServiceAccountSecret.txt b/docs/command/atlas-api-serviceAccounts-deleteServiceAccountSecret.txt deleted file mode 100644 index fb485459ca..0000000000 --- a/docs/command/atlas-api-serviceAccounts-deleteServiceAccountSecret.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-serviceAccounts-deleteServiceAccountSecret: - -==================================================== -atlas api serviceAccounts deleteServiceAccountSecret -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes the specified Service Account secret. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccountsecret. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts deleteServiceAccountSecret [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteServiceAccountSecret - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --secretId - - string - - true - - Unique 24-hexadecimal digit string that identifies the secret. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-deleteServiceAccountSecret-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-getGroupServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-getGroupServiceAccount.txt new file mode 100644 index 0000000000..690cb56db8 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-getGroupServiceAccount.txt @@ -0,0 +1,100 @@ +.. _atlas-api-serviceAccounts-getGroupServiceAccount: + +================================================ +atlas api serviceAccounts getGroupServiceAccount +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one Service Account in the specified Project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts getGroupServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupServiceAccount + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-getGroupServiceAccount-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-getOrgServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-getOrgServiceAccount.txt new file mode 100644 index 0000000000..b93fb2519b --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-getOrgServiceAccount.txt @@ -0,0 +1,98 @@ +.. _atlas-api-serviceAccounts-getOrgServiceAccount: + +============================================== +atlas api serviceAccounts getOrgServiceAccount +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the specified Service Account. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts getOrgServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgServiceAccount + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-getOrgServiceAccount-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-getOrgServiceAccountGroups.txt b/docs/command/atlas-api-serviceAccounts-getOrgServiceAccountGroups.txt new file mode 100644 index 0000000000..c4e775c2d6 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-getOrgServiceAccountGroups.txt @@ -0,0 +1,106 @@ +.. _atlas-api-serviceAccounts-getOrgServiceAccountGroups: + +==================================================== +atlas api serviceAccounts getOrgServiceAccountGroups +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns a list of all projects the specified Service Account is a part of. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgserviceaccountgroups. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts getOrgServiceAccountGroups [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgServiceAccountGroups + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-getOrgServiceAccountGroups-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-getProjectServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-getProjectServiceAccount.txt deleted file mode 100644 index 26d5c7e87e..0000000000 --- a/docs/command/atlas-api-serviceAccounts-getProjectServiceAccount.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-serviceAccounts-getProjectServiceAccount: - -================================================== -atlas api serviceAccounts getProjectServiceAccount -================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one Service Account in the specified Project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts getProjectServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectServiceAccount - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-getProjectServiceAccount-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-getServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-getServiceAccount.txt deleted file mode 100644 index 0d8532b1cb..0000000000 --- a/docs/command/atlas-api-serviceAccounts-getServiceAccount.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-serviceAccounts-getServiceAccount: - -=========================================== -atlas api serviceAccounts getServiceAccount -=========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the specified Service Account. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts getServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getServiceAccount - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-getServiceAccount-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-inviteGroupServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-inviteGroupServiceAccount.txt new file mode 100644 index 0000000000..8ba9201a0e --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-inviteGroupServiceAccount.txt @@ -0,0 +1,99 @@ +.. _atlas-api-serviceAccounts-inviteGroupServiceAccount: + +=================================================== +atlas api serviceAccounts inviteGroupServiceAccount +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Assigns the specified Service Account to the specified Project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-invitegroupserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts inviteGroupServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for inviteGroupServiceAccount + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-listGroupServiceAccountAccessList.txt b/docs/command/atlas-api-serviceAccounts-listGroupServiceAccountAccessList.txt new file mode 100644 index 0000000000..7161561fe7 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-listGroupServiceAccountAccessList.txt @@ -0,0 +1,112 @@ +.. _atlas-api-serviceAccounts-listGroupServiceAccountAccessList: + +=========================================================== +atlas api serviceAccounts listGroupServiceAccountAccessList +=========================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified Service Account for the project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserviceaccountaccesslist. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts listGroupServiceAccountAccessList [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupServiceAccountAccessList + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listGroupServiceAccountAccessList-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-listGroupServiceAccounts.txt b/docs/command/atlas-api-serviceAccounts-listGroupServiceAccounts.txt new file mode 100644 index 0000000000..564d750216 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-listGroupServiceAccounts.txt @@ -0,0 +1,104 @@ +.. _atlas-api-serviceAccounts-listGroupServiceAccounts: + +================================================== +atlas api serviceAccounts listGroupServiceAccounts +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Service Accounts for the specified Project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserviceaccounts. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts listGroupServiceAccounts [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupServiceAccounts + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listGroupServiceAccounts-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-listOrgServiceAccountAccessList.txt b/docs/command/atlas-api-serviceAccounts-listOrgServiceAccountAccessList.txt new file mode 100644 index 0000000000..bdfd0bd2aa --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-listOrgServiceAccountAccessList.txt @@ -0,0 +1,110 @@ +.. _atlas-api-serviceAccounts-listOrgServiceAccountAccessList: + +========================================================= +atlas api serviceAccounts listOrgServiceAccountAccessList +========================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified Service Account for the organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgserviceaccountaccesslist. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts listOrgServiceAccountAccessList [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgServiceAccountAccessList + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listOrgServiceAccountAccessList-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-listOrgServiceAccounts.txt b/docs/command/atlas-api-serviceAccounts-listOrgServiceAccounts.txt new file mode 100644 index 0000000000..58f2d76c1a --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-listOrgServiceAccounts.txt @@ -0,0 +1,102 @@ +.. _atlas-api-serviceAccounts-listOrgServiceAccounts: + +================================================ +atlas api serviceAccounts listOrgServiceAccounts +================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Service Accounts for the specified Organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgserviceaccounts. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts listOrgServiceAccounts [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgServiceAccounts + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listOrgServiceAccounts-2024-08-05-default.sh + :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-listProjectServiceAccountAccessList.txt b/docs/command/atlas-api-serviceAccounts-listProjectServiceAccountAccessList.txt deleted file mode 100644 index c797f1e5f0..0000000000 --- a/docs/command/atlas-api-serviceAccounts-listProjectServiceAccountAccessList.txt +++ /dev/null @@ -1,112 +0,0 @@ -.. _atlas-api-serviceAccounts-listProjectServiceAccountAccessList: - -============================================================= -atlas api serviceAccounts listProjectServiceAccountAccessList -============================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified Service Account for the project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectserviceaccountaccesslist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts listProjectServiceAccountAccessList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectServiceAccountAccessList - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listProjectServiceAccountAccessList-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-listProjectServiceAccounts.txt b/docs/command/atlas-api-serviceAccounts-listProjectServiceAccounts.txt deleted file mode 100644 index 983f86171c..0000000000 --- a/docs/command/atlas-api-serviceAccounts-listProjectServiceAccounts.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-serviceAccounts-listProjectServiceAccounts: - -==================================================== -atlas api serviceAccounts listProjectServiceAccounts -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Service Accounts for the specified Project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectserviceaccounts. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts listProjectServiceAccounts [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectServiceAccounts - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listProjectServiceAccounts-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-listServiceAccountAccessList.txt b/docs/command/atlas-api-serviceAccounts-listServiceAccountAccessList.txt deleted file mode 100644 index 53b20167f2..0000000000 --- a/docs/command/atlas-api-serviceAccounts-listServiceAccountAccessList.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-serviceAccounts-listServiceAccountAccessList: - -====================================================== -atlas api serviceAccounts listServiceAccountAccessList -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified Service Account for the organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccountaccesslist. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts listServiceAccountAccessList [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listServiceAccountAccessList - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listServiceAccountAccessList-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-listServiceAccountProjects.txt b/docs/command/atlas-api-serviceAccounts-listServiceAccountProjects.txt deleted file mode 100644 index 92e17db425..0000000000 --- a/docs/command/atlas-api-serviceAccounts-listServiceAccountProjects.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-serviceAccounts-listServiceAccountProjects: - -==================================================== -atlas api serviceAccounts listServiceAccountProjects -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns a list of all projects the specified Service Account is a part of. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccountprojects. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts listServiceAccountProjects [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listServiceAccountProjects - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listServiceAccountProjects-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-listServiceAccounts.txt b/docs/command/atlas-api-serviceAccounts-listServiceAccounts.txt deleted file mode 100644 index 163c286179..0000000000 --- a/docs/command/atlas-api-serviceAccounts-listServiceAccounts.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-serviceAccounts-listServiceAccounts: - -============================================= -atlas api serviceAccounts listServiceAccounts -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Service Accounts for the specified Organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccounts. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts listServiceAccounts [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listServiceAccounts - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-serviceAccounts-listServiceAccounts-2024-08-05-default.sh - :language: shell diff --git a/docs/command/atlas-api-serviceAccounts-updateGroupServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-updateGroupServiceAccount.txt new file mode 100644 index 0000000000..537fe37a94 --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-updateGroupServiceAccount.txt @@ -0,0 +1,99 @@ +.. _atlas-api-serviceAccounts-updateGroupServiceAccount: + +=================================================== +atlas api serviceAccounts updateGroupServiceAccount +=================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates one Service Account in the specified Project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts updateGroupServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupServiceAccount + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-updateOrgServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-updateOrgServiceAccount.txt new file mode 100644 index 0000000000..3f36e2e73a --- /dev/null +++ b/docs/command/atlas-api-serviceAccounts-updateOrgServiceAccount.txt @@ -0,0 +1,97 @@ +.. _atlas-api-serviceAccounts-updateOrgServiceAccount: + +================================================= +atlas api serviceAccounts updateOrgServiceAccount +================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the specified Service Account in the specified Organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorgserviceaccount. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api serviceAccounts updateOrgServiceAccount [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clientId + - string + - true + - The Client ID of the Service Account. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for updateOrgServiceAccount + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-serviceAccounts-updateProjectServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-updateProjectServiceAccount.txt deleted file mode 100644 index 07b2363bf7..0000000000 --- a/docs/command/atlas-api-serviceAccounts-updateProjectServiceAccount.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-serviceAccounts-updateProjectServiceAccount: - -===================================================== -atlas api serviceAccounts updateProjectServiceAccount -===================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates one Service Account in the specified Project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts updateProjectServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateProjectServiceAccount - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts-updateServiceAccount.txt b/docs/command/atlas-api-serviceAccounts-updateServiceAccount.txt deleted file mode 100644 index 8496481e24..0000000000 --- a/docs/command/atlas-api-serviceAccounts-updateServiceAccount.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-serviceAccounts-updateServiceAccount: - -============================================== -atlas api serviceAccounts updateServiceAccount -============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the specified Service Account in the specified Organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateserviceaccount. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api serviceAccounts updateServiceAccount [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clientId - - string - - true - - The Client ID of the Service Account. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for updateServiceAccount - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-serviceAccounts.txt b/docs/command/atlas-api-serviceAccounts.txt index 3029a8904e..818a44cb08 100644 --- a/docs/command/atlas-api-serviceAccounts.txt +++ b/docs/command/atlas-api-serviceAccounts.txt @@ -54,53 +54,53 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-serviceAccounts-addProjectServiceAccount` - `Public Preview: please provide feedback `_: Assigns the specified Service Account to the specified Project. -* :ref:`atlas-api-serviceAccounts-createProjectServiceAccount` - `Public Preview: please provide feedback `_: Creates one Service Account for the specified Project. -* :ref:`atlas-api-serviceAccounts-createProjectServiceAccountAccessList` - `Public Preview: please provide feedback `_: Add Access List Entries for the specified Service Account for the project. -* :ref:`atlas-api-serviceAccounts-createProjectServiceAccountSecret` - `Public Preview: please provide feedback `_: Create a secret for the specified Service Account in the specified Project. -* :ref:`atlas-api-serviceAccounts-createServiceAccount` - `Public Preview: please provide feedback `_: Creates one Service Account for the specified Organization. -* :ref:`atlas-api-serviceAccounts-createServiceAccountAccessList` - `Public Preview: please provide feedback `_: Add Access List Entries for the specified Service Account for the organization. -* :ref:`atlas-api-serviceAccounts-createServiceAccountSecret` - `Public Preview: please provide feedback `_: Create a secret for the specified Service Account. -* :ref:`atlas-api-serviceAccounts-deleteProjectServiceAccount` - `Public Preview: please provide feedback `_: Removes the specified Service Account from the specified project. -* :ref:`atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry` - `Public Preview: please provide feedback `_: Removes the specified access list entry from the specified Service Account for the project. -* :ref:`atlas-api-serviceAccounts-deleteProjectServiceAccountSecret` - `Public Preview: please provide feedback `_: Deletes the specified Service Account secret. -* :ref:`atlas-api-serviceAccounts-deleteServiceAccount` - `Public Preview: please provide feedback `_: Deletes the specified Service Account. -* :ref:`atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry` - `Public Preview: please provide feedback `_: Removes the specified access list entry from the specified Service Account for the organization. -* :ref:`atlas-api-serviceAccounts-deleteServiceAccountSecret` - `Public Preview: please provide feedback `_: Deletes the specified Service Account secret. -* :ref:`atlas-api-serviceAccounts-getProjectServiceAccount` - `Public Preview: please provide feedback `_: Returns one Service Account in the specified Project. -* :ref:`atlas-api-serviceAccounts-getServiceAccount` - `Public Preview: please provide feedback `_: Returns the specified Service Account. -* :ref:`atlas-api-serviceAccounts-listProjectServiceAccountAccessList` - `Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified Service Account for the project. -* :ref:`atlas-api-serviceAccounts-listProjectServiceAccounts` - `Public Preview: please provide feedback `_: Returns all Service Accounts for the specified Project. -* :ref:`atlas-api-serviceAccounts-listServiceAccountAccessList` - `Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified Service Account for the organization. -* :ref:`atlas-api-serviceAccounts-listServiceAccountProjects` - `Public Preview: please provide feedback `_: Returns a list of all projects the specified Service Account is a part of. -* :ref:`atlas-api-serviceAccounts-listServiceAccounts` - `Public Preview: please provide feedback `_: Returns all Service Accounts for the specified Organization. -* :ref:`atlas-api-serviceAccounts-updateProjectServiceAccount` - `Public Preview: please provide feedback `_: Updates one Service Account in the specified Project. -* :ref:`atlas-api-serviceAccounts-updateServiceAccount` - `Public Preview: please provide feedback `_: Updates the specified Service Account in the specified Organization. +* :ref:`atlas-api-serviceAccounts-createGroupServiceAccount` - `Public Preview: please provide feedback `_: Creates one Service Account for the specified Project. +* :ref:`atlas-api-serviceAccounts-createGroupServiceAccountAccessList` - `Public Preview: please provide feedback `_: Add Access List Entries for the specified Service Account for the project. +* :ref:`atlas-api-serviceAccounts-createGroupServiceAccountSecret` - `Public Preview: please provide feedback `_: Create a secret for the specified Service Account in the specified Project. +* :ref:`atlas-api-serviceAccounts-createOrgServiceAccount` - `Public Preview: please provide feedback `_: Creates one Service Account for the specified Organization. +* :ref:`atlas-api-serviceAccounts-createOrgServiceAccountAccessList` - `Public Preview: please provide feedback `_: Add Access List Entries for the specified Service Account for the organization. +* :ref:`atlas-api-serviceAccounts-createOrgServiceAccountSecret` - `Public Preview: please provide feedback `_: Create a secret for the specified Service Account. +* :ref:`atlas-api-serviceAccounts-deleteGroupServiceAccount` - `Public Preview: please provide feedback `_: Removes the specified Service Account from the specified project. +* :ref:`atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry` - `Public Preview: please provide feedback `_: Removes the specified access list entry from the specified Service Account for the project. +* :ref:`atlas-api-serviceAccounts-deleteGroupServiceAccountSecret` - `Public Preview: please provide feedback `_: Deletes the specified Service Account secret. +* :ref:`atlas-api-serviceAccounts-deleteOrgServiceAccount` - `Public Preview: please provide feedback `_: Deletes the specified Service Account. +* :ref:`atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry` - `Public Preview: please provide feedback `_: Removes the specified access list entry from the specified Service Account for the organization. +* :ref:`atlas-api-serviceAccounts-deleteOrgServiceAccountSecret` - `Public Preview: please provide feedback `_: Deletes the specified Service Account secret. +* :ref:`atlas-api-serviceAccounts-getGroupServiceAccount` - `Public Preview: please provide feedback `_: Returns one Service Account in the specified Project. +* :ref:`atlas-api-serviceAccounts-getOrgServiceAccount` - `Public Preview: please provide feedback `_: Returns the specified Service Account. +* :ref:`atlas-api-serviceAccounts-getOrgServiceAccountGroups` - `Public Preview: please provide feedback `_: Returns a list of all projects the specified Service Account is a part of. +* :ref:`atlas-api-serviceAccounts-inviteGroupServiceAccount` - `Public Preview: please provide feedback `_: Assigns the specified Service Account to the specified Project. +* :ref:`atlas-api-serviceAccounts-listGroupServiceAccountAccessList` - `Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified Service Account for the project. +* :ref:`atlas-api-serviceAccounts-listGroupServiceAccounts` - `Public Preview: please provide feedback `_: Returns all Service Accounts for the specified Project. +* :ref:`atlas-api-serviceAccounts-listOrgServiceAccountAccessList` - `Public Preview: please provide feedback `_: Returns all access list entries that you configured for the specified Service Account for the organization. +* :ref:`atlas-api-serviceAccounts-listOrgServiceAccounts` - `Public Preview: please provide feedback `_: Returns all Service Accounts for the specified Organization. +* :ref:`atlas-api-serviceAccounts-updateGroupServiceAccount` - `Public Preview: please provide feedback `_: Updates one Service Account in the specified Project. +* :ref:`atlas-api-serviceAccounts-updateOrgServiceAccount` - `Public Preview: please provide feedback `_: Updates the specified Service Account in the specified Organization. .. toctree:: :titlesonly: - addProjectServiceAccount - createProjectServiceAccount - createProjectServiceAccountAccessList - createProjectServiceAccountSecret - createServiceAccount - createServiceAccountAccessList - createServiceAccountSecret - deleteProjectServiceAccount - deleteProjectServiceAccountAccessListEntry - deleteProjectServiceAccountSecret - deleteServiceAccount - deleteServiceAccountAccessListEntry - deleteServiceAccountSecret - getProjectServiceAccount - getServiceAccount - listProjectServiceAccountAccessList - listProjectServiceAccounts - listServiceAccountAccessList - listServiceAccountProjects - listServiceAccounts - updateProjectServiceAccount - updateServiceAccount + createGroupServiceAccount + createGroupServiceAccountAccessList + createGroupServiceAccountSecret + createOrgServiceAccount + createOrgServiceAccountAccessList + createOrgServiceAccountSecret + deleteGroupServiceAccount + deleteGroupServiceAccountAccessListEntry + deleteGroupServiceAccountSecret + deleteOrgServiceAccount + deleteOrgServiceAccountAccessListEntry + deleteOrgServiceAccountSecret + getGroupServiceAccount + getOrgServiceAccount + getOrgServiceAccountGroups + inviteGroupServiceAccount + listGroupServiceAccountAccessList + listGroupServiceAccounts + listOrgServiceAccountAccessList + listOrgServiceAccounts + updateGroupServiceAccount + updateOrgServiceAccount diff --git a/docs/command/atlas-api-sharedTierRestoreJobs-createGroupClusterBackupTenantRestore.txt b/docs/command/atlas-api-sharedTierRestoreJobs-createGroupClusterBackupTenantRestore.txt new file mode 100644 index 0000000000..a10078d4db --- /dev/null +++ b/docs/command/atlas-api-sharedTierRestoreJobs-createGroupClusterBackupTenantRestore.txt @@ -0,0 +1,104 @@ +.. _atlas-api-sharedTierRestoreJobs-createGroupClusterBackupTenantRestore: + +===================================================================== +atlas api sharedTierRestoreJobs createGroupClusterBackupTenantRestore +===================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Restores the specified M2 or M5 cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +MongoDB Cloud limits which clusters can be the target clusters of a restore. The target cluster can't use encryption at rest, run a major release MongoDB version different than the snapshot, or receive client requests during restores. MongoDB Cloud deletes all existing data on the target cluster prior to the restore operation. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the createFlexBackupRestoreJob endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterbackuptenantrestore. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api sharedTierRestoreJobs createGroupClusterBackupTenantRestore [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupClusterBackupTenantRestore + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-sharedTierRestoreJobs-createSharedClusterBackupRestoreJob.txt b/docs/command/atlas-api-sharedTierRestoreJobs-createSharedClusterBackupRestoreJob.txt deleted file mode 100644 index fc0cf174cf..0000000000 --- a/docs/command/atlas-api-sharedTierRestoreJobs-createSharedClusterBackupRestoreJob.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-sharedTierRestoreJobs-createSharedClusterBackupRestoreJob: - -=================================================================== -atlas api sharedTierRestoreJobs createSharedClusterBackupRestoreJob -=================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Restores the specified M2 or M5 cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -MongoDB Cloud limits which clusters can be the target clusters of a restore. The target cluster can't use encryption at rest, run a major release MongoDB version different than the snapshot, or receive client requests during restores. MongoDB Cloud deletes all existing data on the target cluster prior to the restore operation. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the createFlexBackupRestoreJob endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createsharedclusterbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api sharedTierRestoreJobs createSharedClusterBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createSharedClusterBackupRestoreJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore.txt b/docs/command/atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore.txt new file mode 100644 index 0000000000..466b089662 --- /dev/null +++ b/docs/command/atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore.txt @@ -0,0 +1,109 @@ +.. _atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore: + +================================================================== +atlas api sharedTierRestoreJobs getGroupClusterBackupTenantRestore +================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the specified restore job for the specified M2 or M5 cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the getFlexBackupRestoreJob endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackuptenantrestore. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api sharedTierRestoreJobs getGroupClusterBackupTenantRestore [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterBackupTenantRestore + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --restoreId + - string + - true + - Unique 24-hexadecimal digit string that identifies the restore job to return. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob.txt b/docs/command/atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob.txt deleted file mode 100644 index bc0a98933c..0000000000 --- a/docs/command/atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob: - -================================================================ -atlas api sharedTierRestoreJobs getSharedClusterBackupRestoreJob -================================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the specified restore job for the specified M2 or M5 cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the getFlexBackupRestoreJob endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getsharedclusterbackuprestorejob. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api sharedTierRestoreJobs getSharedClusterBackupRestoreJob [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getSharedClusterBackupRestoreJob - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --restoreId - - string - - true - - Unique 24-hexadecimal digit string that identifies the restore job to return. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores.txt b/docs/command/atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores.txt new file mode 100644 index 0000000000..90293c2ee5 --- /dev/null +++ b/docs/command/atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores.txt @@ -0,0 +1,105 @@ +.. _atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores: + +==================================================================== +atlas api sharedTierRestoreJobs listGroupClusterBackupTenantRestores +==================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all restore jobs for the specified M2 or M5 cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Restore jobs restore a cluster using a snapshot. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the listFlexBackupRestoreJobs endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackuptenantrestores. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api sharedTierRestoreJobs listGroupClusterBackupTenantRestores [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterBackupTenantRestores + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs.txt b/docs/command/atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs.txt deleted file mode 100644 index 169f534980..0000000000 --- a/docs/command/atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs: - -================================================================== -atlas api sharedTierRestoreJobs listSharedClusterBackupRestoreJobs -================================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all restore jobs for the specified M2 or M5 cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Restore jobs restore a cluster using a snapshot. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the listFlexBackupRestoreJobs endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsharedclusterbackuprestorejobs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api sharedTierRestoreJobs listSharedClusterBackupRestoreJobs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listSharedClusterBackupRestoreJobs - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-sharedTierRestoreJobs.txt b/docs/command/atlas-api-sharedTierRestoreJobs.txt index f6bd328115..8eb2487bac 100644 --- a/docs/command/atlas-api-sharedTierRestoreJobs.txt +++ b/docs/command/atlas-api-sharedTierRestoreJobs.txt @@ -54,15 +54,15 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-sharedTierRestoreJobs-createSharedClusterBackupRestoreJob` - `Public Preview: please provide feedback `_: Restores the specified M2 or M5 cluster. -* :ref:`atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob` - `Public Preview: please provide feedback `_: Returns the specified restore job for the specified M2 or M5 cluster. -* :ref:`atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs` - `Public Preview: please provide feedback `_: Returns all restore jobs for the specified M2 or M5 cluster. +* :ref:`atlas-api-sharedTierRestoreJobs-createGroupClusterBackupTenantRestore` - `Public Preview: please provide feedback `_: Restores the specified M2 or M5 cluster. +* :ref:`atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore` - `Public Preview: please provide feedback `_: Returns the specified restore job for the specified M2 or M5 cluster. +* :ref:`atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores` - `Public Preview: please provide feedback `_: Returns all restore jobs for the specified M2 or M5 cluster. .. toctree:: :titlesonly: - createSharedClusterBackupRestoreJob - getSharedClusterBackupRestoreJob - listSharedClusterBackupRestoreJobs + createGroupClusterBackupTenantRestore + getGroupClusterBackupTenantRestore + listGroupClusterBackupTenantRestores diff --git a/docs/command/atlas-api-sharedTierSnapshots-downloadGroupClusterBackupTenant.txt b/docs/command/atlas-api-sharedTierSnapshots-downloadGroupClusterBackupTenant.txt new file mode 100644 index 0000000000..65d15da0c9 --- /dev/null +++ b/docs/command/atlas-api-sharedTierSnapshots-downloadGroupClusterBackupTenant.txt @@ -0,0 +1,104 @@ +.. _atlas-api-sharedTierSnapshots-downloadGroupClusterBackupTenant: + +============================================================== +atlas api sharedTierSnapshots downloadGroupClusterBackupTenant +============================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Requests one snapshot for the specified shared cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This resource returns a snapshotURL that you can use to download the snapshot. This snapshotURL remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the downloadFlexBackup endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupclusterbackuptenant. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api sharedTierSnapshots downloadGroupClusterBackupTenant [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for downloadGroupClusterBackupTenant + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-sharedTierSnapshots-downloadSharedClusterBackup.txt b/docs/command/atlas-api-sharedTierSnapshots-downloadSharedClusterBackup.txt deleted file mode 100644 index 3995b61f2c..0000000000 --- a/docs/command/atlas-api-sharedTierSnapshots-downloadSharedClusterBackup.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-sharedTierSnapshots-downloadSharedClusterBackup: - -========================================================= -atlas api sharedTierSnapshots downloadSharedClusterBackup -========================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Requests one snapshot for the specified shared cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This resource returns a snapshotURL that you can use to download the snapshot. This snapshotURL remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the downloadFlexBackup endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadsharedclusterbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api sharedTierSnapshots downloadSharedClusterBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for downloadSharedClusterBackup - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot.txt b/docs/command/atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot.txt new file mode 100644 index 0000000000..5eb2463025 --- /dev/null +++ b/docs/command/atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot.txt @@ -0,0 +1,109 @@ +.. _atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot: + +================================================================= +atlas api sharedTierSnapshots getGroupClusterBackupTenantSnapshot +================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details for one snapshot for the specified shared cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the getFlexBackup endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackuptenantsnapshot. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api sharedTierSnapshots getGroupClusterBackupTenantSnapshot [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupClusterBackupTenantSnapshot + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --snapshotId + - string + - true + - Unique 24-hexadecimal digit string that identifies the desired snapshot. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-sharedTierSnapshots-getSharedClusterBackup.txt b/docs/command/atlas-api-sharedTierSnapshots-getSharedClusterBackup.txt deleted file mode 100644 index d40ea4ac7b..0000000000 --- a/docs/command/atlas-api-sharedTierSnapshots-getSharedClusterBackup.txt +++ /dev/null @@ -1,109 +0,0 @@ -.. _atlas-api-sharedTierSnapshots-getSharedClusterBackup: - -==================================================== -atlas api sharedTierSnapshots getSharedClusterBackup -==================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details for one snapshot for the specified shared cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the getFlexBackup endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getsharedclusterbackup. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api sharedTierSnapshots getSharedClusterBackup [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getSharedClusterBackup - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --snapshotId - - string - - true - - Unique 24-hexadecimal digit string that identifies the desired snapshot. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-sharedTierSnapshots-getSharedClusterBackup-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots.txt b/docs/command/atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots.txt new file mode 100644 index 0000000000..041299028a --- /dev/null +++ b/docs/command/atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots.txt @@ -0,0 +1,105 @@ +.. _atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots: + +=================================================================== +atlas api sharedTierSnapshots listGroupClusterBackupTenantSnapshots +=================================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns details for all snapshots for the specified shared cluster. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This API also works for Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters, until January 2026, after which this endpoint will be sunset. Please use the listFlexBackups endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackuptenantsnapshots. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api sharedTierSnapshots listGroupClusterBackupTenantSnapshots [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --clusterName + - string + - true + - Human-readable label that identifies the cluster. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupClusterBackupTenantSnapshots + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-sharedTierSnapshots-listSharedClusterBackups.txt b/docs/command/atlas-api-sharedTierSnapshots-listSharedClusterBackups.txt deleted file mode 100644 index 89db5a6a04..0000000000 --- a/docs/command/atlas-api-sharedTierSnapshots-listSharedClusterBackups.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-sharedTierSnapshots-listSharedClusterBackups: - -====================================================== -atlas api sharedTierSnapshots listSharedClusterBackups -====================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns details for all snapshots for the specified shared cluster. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This API also works for Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters, until January 2026, after which this endpoint will be sunset. Please use the listFlexBackups endpoint instead. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsharedclusterbackups. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api sharedTierSnapshots listSharedClusterBackups [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --clusterName - - string - - true - - Human-readable label that identifies the cluster. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listSharedClusterBackups - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-sharedTierSnapshots-listSharedClusterBackups-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-sharedTierSnapshots.txt b/docs/command/atlas-api-sharedTierSnapshots.txt index f17a3e93d3..4cef664f22 100644 --- a/docs/command/atlas-api-sharedTierSnapshots.txt +++ b/docs/command/atlas-api-sharedTierSnapshots.txt @@ -54,15 +54,15 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-sharedTierSnapshots-downloadSharedClusterBackup` - `Public Preview: please provide feedback `_: Requests one snapshot for the specified shared cluster. -* :ref:`atlas-api-sharedTierSnapshots-getSharedClusterBackup` - `Public Preview: please provide feedback `_: Returns details for one snapshot for the specified shared cluster. -* :ref:`atlas-api-sharedTierSnapshots-listSharedClusterBackups` - `Public Preview: please provide feedback `_: Returns details for all snapshots for the specified shared cluster. +* :ref:`atlas-api-sharedTierSnapshots-downloadGroupClusterBackupTenant` - `Public Preview: please provide feedback `_: Requests one snapshot for the specified shared cluster. +* :ref:`atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot` - `Public Preview: please provide feedback `_: Returns details for one snapshot for the specified shared cluster. +* :ref:`atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots` - `Public Preview: please provide feedback `_: Returns details for all snapshots for the specified shared cluster. .. toctree:: :titlesonly: - downloadSharedClusterBackup - getSharedClusterBackup - listSharedClusterBackups + downloadGroupClusterBackupTenant + getGroupClusterBackupTenantSnapshot + listGroupClusterBackupTenantSnapshots diff --git a/docs/command/atlas-api-streams-acceptGroupStreamVpcPeeringConnection.txt b/docs/command/atlas-api-streams-acceptGroupStreamVpcPeeringConnection.txt new file mode 100644 index 0000000000..62c3d4fef4 --- /dev/null +++ b/docs/command/atlas-api-streams-acceptGroupStreamVpcPeeringConnection.txt @@ -0,0 +1,95 @@ +.. _atlas-api-streams-acceptGroupStreamVpcPeeringConnection: + +======================================================= +atlas api streams acceptGroupStreamVpcPeeringConnection +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Requests the acceptance of an incoming VPC Peering connection. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acceptgroupstreamvpcpeeringconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams acceptGroupStreamVpcPeeringConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for acceptGroupStreamVpcPeeringConnection + * - --id + - string + - true + - The VPC Peering Connection id. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-acceptVpcPeeringConnection.txt b/docs/command/atlas-api-streams-acceptVpcPeeringConnection.txt deleted file mode 100644 index 2198d24ef3..0000000000 --- a/docs/command/atlas-api-streams-acceptVpcPeeringConnection.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-streams-acceptVpcPeeringConnection: - -============================================ -atlas api streams acceptVpcPeeringConnection -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Requests the acceptance of an incoming VPC Peering connection. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acceptvpcpeeringconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams acceptVpcPeeringConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for acceptVpcPeeringConnection - * - --id - - string - - true - - The VPC Peering Connection id. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-createGroupStreamConnection.txt b/docs/command/atlas-api-streams-createGroupStreamConnection.txt new file mode 100644 index 0000000000..384b687e74 --- /dev/null +++ b/docs/command/atlas-api-streams-createGroupStreamConnection.txt @@ -0,0 +1,101 @@ +.. _atlas-api-streams-createGroupStreamConnection: + +============================================= +atlas api streams createGroupStreamConnection +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one connection for a stream instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupstreamconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams createGroupStreamConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupStreamConnection + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-createGroupStreamPrivateLinkConnection.txt b/docs/command/atlas-api-streams-createGroupStreamPrivateLinkConnection.txt new file mode 100644 index 0000000000..f297576c24 --- /dev/null +++ b/docs/command/atlas-api-streams-createGroupStreamPrivateLinkConnection.txt @@ -0,0 +1,97 @@ +.. _atlas-api-streams-createGroupStreamPrivateLinkConnection: + +======================================================== +atlas api streams createGroupStreamPrivateLinkConnection +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one Private Link in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupstreamprivatelinkconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams createGroupStreamPrivateLinkConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupStreamPrivateLinkConnection + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-createGroupStreamProcessor.txt b/docs/command/atlas-api-streams-createGroupStreamProcessor.txt new file mode 100644 index 0000000000..8fc05e6093 --- /dev/null +++ b/docs/command/atlas-api-streams-createGroupStreamProcessor.txt @@ -0,0 +1,101 @@ +.. _atlas-api-streams-createGroupStreamProcessor: + +============================================ +atlas api streams createGroupStreamProcessor +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Create one Stream Processor within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupstreamprocessor. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams createGroupStreamProcessor [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupStreamProcessor + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-createGroupStreamWorkspace.txt b/docs/command/atlas-api-streams-createGroupStreamWorkspace.txt new file mode 100644 index 0000000000..74342b0bc9 --- /dev/null +++ b/docs/command/atlas-api-streams-createGroupStreamWorkspace.txt @@ -0,0 +1,97 @@ +.. _atlas-api-streams-createGroupStreamWorkspace: + +============================================ +atlas api streams createGroupStreamWorkspace +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one stream instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupstreamworkspace. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams createGroupStreamWorkspace [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupStreamWorkspace + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-createPrivateLinkConnection.txt b/docs/command/atlas-api-streams-createPrivateLinkConnection.txt deleted file mode 100644 index cceb8f3186..0000000000 --- a/docs/command/atlas-api-streams-createPrivateLinkConnection.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-streams-createPrivateLinkConnection: - -============================================= -atlas api streams createPrivateLinkConnection -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one Private Link in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivatelinkconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams createPrivateLinkConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createPrivateLinkConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-createStreamConnection.txt b/docs/command/atlas-api-streams-createStreamConnection.txt deleted file mode 100644 index a1bd998485..0000000000 --- a/docs/command/atlas-api-streams-createStreamConnection.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-streams-createStreamConnection: - -======================================== -atlas api streams createStreamConnection -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one connection for a stream instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreamconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams createStreamConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createStreamConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-createStreamInstance.txt b/docs/command/atlas-api-streams-createStreamInstance.txt deleted file mode 100644 index bc299ac7ff..0000000000 --- a/docs/command/atlas-api-streams-createStreamInstance.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-streams-createStreamInstance: - -====================================== -atlas api streams createStreamInstance -====================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one stream instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreaminstance. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams createStreamInstance [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createStreamInstance - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-createStreamInstanceWithSampleConnections.txt b/docs/command/atlas-api-streams-createStreamInstanceWithSampleConnections.txt deleted file mode 100644 index fcfdc80a2f..0000000000 --- a/docs/command/atlas-api-streams-createStreamInstanceWithSampleConnections.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-streams-createStreamInstanceWithSampleConnections: - -=========================================================== -atlas api streams createStreamInstanceWithSampleConnections -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one stream instance in the specified project with sample connections. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreaminstancewithsampleconnections. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams createStreamInstanceWithSampleConnections [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createStreamInstanceWithSampleConnections - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-createStreamProcessor.txt b/docs/command/atlas-api-streams-createStreamProcessor.txt deleted file mode 100644 index efaff9c7d9..0000000000 --- a/docs/command/atlas-api-streams-createStreamProcessor.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-streams-createStreamProcessor: - -======================================= -atlas api streams createStreamProcessor -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Create one Stream Processor within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreamprocessor. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams createStreamProcessor [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createStreamProcessor - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-deleteGroupStreamConnection.txt b/docs/command/atlas-api-streams-deleteGroupStreamConnection.txt new file mode 100644 index 0000000000..334d313ef6 --- /dev/null +++ b/docs/command/atlas-api-streams-deleteGroupStreamConnection.txt @@ -0,0 +1,106 @@ +.. _atlas-api-streams-deleteGroupStreamConnection: + +============================================= +atlas api streams deleteGroupStreamConnection +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Delete one connection of the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams deleteGroupStreamConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --connectionName + - string + - true + - Human-readable label that identifies the stream connection. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupStreamConnection + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-deleteGroupStreamConnection-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-deleteGroupStreamPrivateLinkConnection.txt b/docs/command/atlas-api-streams-deleteGroupStreamPrivateLinkConnection.txt new file mode 100644 index 0000000000..889f57a7e4 --- /dev/null +++ b/docs/command/atlas-api-streams-deleteGroupStreamPrivateLinkConnection.txt @@ -0,0 +1,102 @@ +.. _atlas-api-streams-deleteGroupStreamPrivateLinkConnection: + +======================================================== +atlas api streams deleteGroupStreamPrivateLinkConnection +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes one Private Link in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamprivatelinkconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams deleteGroupStreamPrivateLinkConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --connectionId + - string + - true + - Unique ID that identifies the Private Link connection. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupStreamPrivateLinkConnection + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-deleteGroupStreamPrivateLinkConnection-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-deleteGroupStreamProcessor.txt b/docs/command/atlas-api-streams-deleteGroupStreamProcessor.txt new file mode 100644 index 0000000000..dd71ea397a --- /dev/null +++ b/docs/command/atlas-api-streams-deleteGroupStreamProcessor.txt @@ -0,0 +1,106 @@ +.. _atlas-api-streams-deleteGroupStreamProcessor: + +============================================ +atlas api streams deleteGroupStreamProcessor +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Delete a Stream Processor within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamprocessor. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams deleteGroupStreamProcessor [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupStreamProcessor + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processorName + - string + - true + - Human-readable label that identifies the stream processor. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-deleteGroupStreamProcessor-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-deleteGroupStreamVpcPeeringConnection.txt b/docs/command/atlas-api-streams-deleteGroupStreamVpcPeeringConnection.txt new file mode 100644 index 0000000000..0c46491584 --- /dev/null +++ b/docs/command/atlas-api-streams-deleteGroupStreamVpcPeeringConnection.txt @@ -0,0 +1,96 @@ +.. _atlas-api-streams-deleteGroupStreamVpcPeeringConnection: + +======================================================= +atlas api streams deleteGroupStreamVpcPeeringConnection +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Deletes an incoming VPC Peering connection. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamvpcpeeringconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams deleteGroupStreamVpcPeeringConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupStreamVpcPeeringConnection + * - --id + - string + - true + - The VPC Peering Connection id. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-deleteGroupStreamVpcPeeringConnection-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-deleteGroupStreamWorkspace.txt b/docs/command/atlas-api-streams-deleteGroupStreamWorkspace.txt new file mode 100644 index 0000000000..416fc82119 --- /dev/null +++ b/docs/command/atlas-api-streams-deleteGroupStreamWorkspace.txt @@ -0,0 +1,102 @@ +.. _atlas-api-streams-deleteGroupStreamWorkspace: + +============================================ +atlas api streams deleteGroupStreamWorkspace +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Delete one stream instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamworkspace. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams deleteGroupStreamWorkspace [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupStreamWorkspace + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance to delete. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-deleteGroupStreamWorkspace-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-deletePrivateLinkConnection.txt b/docs/command/atlas-api-streams-deletePrivateLinkConnection.txt deleted file mode 100644 index 0db1e34da0..0000000000 --- a/docs/command/atlas-api-streams-deletePrivateLinkConnection.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-streams-deletePrivateLinkConnection: - -============================================= -atlas api streams deletePrivateLinkConnection -============================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes one Private Link in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivatelinkconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams deletePrivateLinkConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --connectionId - - string - - true - - Unique ID that identifies the Private Link connection. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deletePrivateLinkConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-deletePrivateLinkConnection-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-deleteStreamConnection.txt b/docs/command/atlas-api-streams-deleteStreamConnection.txt deleted file mode 100644 index 7f914fed72..0000000000 --- a/docs/command/atlas-api-streams-deleteStreamConnection.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-streams-deleteStreamConnection: - -======================================== -atlas api streams deleteStreamConnection -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Delete one connection of the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreamconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams deleteStreamConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --connectionName - - string - - true - - Human-readable label that identifies the stream connection. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteStreamConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-deleteStreamConnection-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-deleteStreamInstance.txt b/docs/command/atlas-api-streams-deleteStreamInstance.txt deleted file mode 100644 index c558f4e57c..0000000000 --- a/docs/command/atlas-api-streams-deleteStreamInstance.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-streams-deleteStreamInstance: - -====================================== -atlas api streams deleteStreamInstance -====================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Delete one stream instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreaminstance. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams deleteStreamInstance [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteStreamInstance - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance to delete. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-deleteStreamInstance-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-deleteStreamProcessor.txt b/docs/command/atlas-api-streams-deleteStreamProcessor.txt deleted file mode 100644 index d2774f544f..0000000000 --- a/docs/command/atlas-api-streams-deleteStreamProcessor.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-streams-deleteStreamProcessor: - -======================================= -atlas api streams deleteStreamProcessor -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Delete a Stream Processor within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreamprocessor. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams deleteStreamProcessor [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteStreamProcessor - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processorName - - string - - true - - Human-readable label that identifies the stream processor. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-deleteStreamProcessor-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-deleteVpcPeeringConnection.txt b/docs/command/atlas-api-streams-deleteVpcPeeringConnection.txt deleted file mode 100644 index 582daeac5e..0000000000 --- a/docs/command/atlas-api-streams-deleteVpcPeeringConnection.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-streams-deleteVpcPeeringConnection: - -============================================ -atlas api streams deleteVpcPeeringConnection -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Deletes an incoming VPC Peering connection. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletevpcpeeringconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams deleteVpcPeeringConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteVpcPeeringConnection - * - --id - - string - - true - - The VPC Peering Connection id. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-deleteVpcPeeringConnection-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-downloadGroupStreamAuditLogs.txt b/docs/command/atlas-api-streams-downloadGroupStreamAuditLogs.txt new file mode 100644 index 0000000000..fa51bcb0d1 --- /dev/null +++ b/docs/command/atlas-api-streams-downloadGroupStreamAuditLogs.txt @@ -0,0 +1,106 @@ +.. _atlas-api-streams-downloadGroupStreamAuditLogs: + +============================================== +atlas api streams downloadGroupStreamAuditLogs +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Downloads the audit logs for the specified Atlas Streams Processing instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +By default, logs cover periods of 30 days. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupstreamauditlogs. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams downloadGroupStreamAuditLogs [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --endDate + - int + - false + - Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for downloadGroupStreamAuditLogs + * - -o, --output + - string + - false + - preferred api format, can be ["gzip"] This value defaults to "gzip". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --startDate + - int + - false + - Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-downloadGroupStreamAuditLogs-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-downloadStreamTenantAuditLogs.txt b/docs/command/atlas-api-streams-downloadStreamTenantAuditLogs.txt deleted file mode 100644 index 8b72350d1c..0000000000 --- a/docs/command/atlas-api-streams-downloadStreamTenantAuditLogs.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-streams-downloadStreamTenantAuditLogs: - -=============================================== -atlas api streams downloadStreamTenantAuditLogs -=============================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Downloads the audit logs for the specified Atlas Streams Processing instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -By default, logs cover periods of 30 days. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadstreamtenantauditlogs. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams downloadStreamTenantAuditLogs [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --endDate - - int - - false - - Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for downloadStreamTenantAuditLogs - * - -o, --output - - string - - false - - preferred api format, can be ["gzip"] This value defaults to "gzip". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --startDate - - int - - false - - Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-downloadStreamTenantAuditLogs-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-getAccountDetails.txt b/docs/command/atlas-api-streams-getAccountDetails.txt deleted file mode 100644 index d97b08149e..0000000000 --- a/docs/command/atlas-api-streams-getAccountDetails.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-streams-getAccountDetails: - -=================================== -atlas api streams getAccountDetails -=================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the Account ID, and the VPC ID for the group and region specified. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getaccountdetails. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams getAccountDetails [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --cloudProvider - - string - - true - - One of "aws", "azure" or "gcp". - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getAccountDetails - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --regionName - - string - - true - - The cloud provider specific region name, i.e. "US_EAST_1" for cloud provider "aws". - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-getAccountDetails-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-getActiveVpcPeeringConnections.txt b/docs/command/atlas-api-streams-getActiveVpcPeeringConnections.txt deleted file mode 100644 index f5949bac6d..0000000000 --- a/docs/command/atlas-api-streams-getActiveVpcPeeringConnections.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-streams-getActiveVpcPeeringConnections: - -================================================ -atlas api streams getActiveVpcPeeringConnections -================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns a list of active incoming VPC Peering Connections. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getactivevpcpeeringconnections. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams getActiveVpcPeeringConnections [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getActiveVpcPeeringConnections - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-getActiveVpcPeeringConnections-2024-11-13-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-getGroupStreamAccountDetails.txt b/docs/command/atlas-api-streams-getGroupStreamAccountDetails.txt new file mode 100644 index 0000000000..ef002c3a9d --- /dev/null +++ b/docs/command/atlas-api-streams-getGroupStreamAccountDetails.txt @@ -0,0 +1,100 @@ +.. _atlas-api-streams-getGroupStreamAccountDetails: + +============================================== +atlas api streams getGroupStreamAccountDetails +============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the Account ID, and the VPC ID for the group and region specified. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamaccountdetails. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams getGroupStreamAccountDetails [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --cloudProvider + - string + - true + - One of "aws", "azure" or "gcp". + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupStreamAccountDetails + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --regionName + - string + - true + - The cloud provider specific region name, i.e. "US_EAST_1" for cloud provider "aws". + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-getGroupStreamAccountDetails-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-getGroupStreamConnection.txt b/docs/command/atlas-api-streams-getGroupStreamConnection.txt new file mode 100644 index 0000000000..ccef291a01 --- /dev/null +++ b/docs/command/atlas-api-streams-getGroupStreamConnection.txt @@ -0,0 +1,102 @@ +.. _atlas-api-streams-getGroupStreamConnection: + +========================================== +atlas api streams getGroupStreamConnection +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details of one stream connection within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams getGroupStreamConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --connectionName + - string + - true + - Human-readable label that identifies the stream connection to return. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupStreamConnection + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance to return. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-getGroupStreamConnection-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-getGroupStreamPrivateLinkConnection.txt b/docs/command/atlas-api-streams-getGroupStreamPrivateLinkConnection.txt new file mode 100644 index 0000000000..7f5ded108e --- /dev/null +++ b/docs/command/atlas-api-streams-getGroupStreamPrivateLinkConnection.txt @@ -0,0 +1,98 @@ +.. _atlas-api-streams-getGroupStreamPrivateLinkConnection: + +===================================================== +atlas api streams getGroupStreamPrivateLinkConnection +===================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details of one Private Link connection within the project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamprivatelinkconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams getGroupStreamPrivateLinkConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --connectionId + - string + - true + - Unique ID that identifies the Private Link connection. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupStreamPrivateLinkConnection + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-getGroupStreamPrivateLinkConnection-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-getGroupStreamProcessor.txt b/docs/command/atlas-api-streams-getGroupStreamProcessor.txt new file mode 100644 index 0000000000..dac336f469 --- /dev/null +++ b/docs/command/atlas-api-streams-getGroupStreamProcessor.txt @@ -0,0 +1,106 @@ +.. _atlas-api-streams-getGroupStreamProcessor: + +========================================= +atlas api streams getGroupStreamProcessor +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Get one Stream Processor within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamprocessor. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams getGroupStreamProcessor [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupStreamProcessor + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processorName + - string + - true + - Human-readable label that identifies the stream processor. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-getGroupStreamProcessor-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-getGroupStreamProcessors.txt b/docs/command/atlas-api-streams-getGroupStreamProcessors.txt new file mode 100644 index 0000000000..627598c828 --- /dev/null +++ b/docs/command/atlas-api-streams-getGroupStreamProcessors.txt @@ -0,0 +1,114 @@ +.. _atlas-api-streams-getGroupStreamProcessors: + +========================================== +atlas api streams getGroupStreamProcessors +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Stream Processors within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamprocessors. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams getGroupStreamProcessors [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupStreamProcessors + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-getGroupStreamProcessors-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-getGroupStreamWorkspace.txt b/docs/command/atlas-api-streams-getGroupStreamWorkspace.txt new file mode 100644 index 0000000000..ac6bd4c96a --- /dev/null +++ b/docs/command/atlas-api-streams-getGroupStreamWorkspace.txt @@ -0,0 +1,102 @@ +.. _atlas-api-streams-getGroupStreamWorkspace: + +========================================= +atlas api streams getGroupStreamWorkspace +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the details of one stream instance within the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamworkspace. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams getGroupStreamWorkspace [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupStreamWorkspace + * - --includeConnections + - + - false + - Flag to indicate whether connections information should be included in the stream instance. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance to return. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-getGroupStreamWorkspace-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-getPrivateLinkConnection.txt b/docs/command/atlas-api-streams-getPrivateLinkConnection.txt deleted file mode 100644 index 35dd098ca2..0000000000 --- a/docs/command/atlas-api-streams-getPrivateLinkConnection.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-streams-getPrivateLinkConnection: - -========================================== -atlas api streams getPrivateLinkConnection -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details of one Private Link connection within the project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivatelinkconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams getPrivateLinkConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --connectionId - - string - - true - - Unique ID that identifies the Private Link connection. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getPrivateLinkConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-getPrivateLinkConnection-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-getStreamConnection.txt b/docs/command/atlas-api-streams-getStreamConnection.txt deleted file mode 100644 index bd7eeb39c0..0000000000 --- a/docs/command/atlas-api-streams-getStreamConnection.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-streams-getStreamConnection: - -===================================== -atlas api streams getStreamConnection -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details of one stream connection within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreamconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams getStreamConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --connectionName - - string - - true - - Human-readable label that identifies the stream connection to return. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getStreamConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance to return. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-getStreamConnection-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-getStreamInstance.txt b/docs/command/atlas-api-streams-getStreamInstance.txt deleted file mode 100644 index fcd09fcbca..0000000000 --- a/docs/command/atlas-api-streams-getStreamInstance.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-streams-getStreamInstance: - -=================================== -atlas api streams getStreamInstance -=================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the details of one stream instance within the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreaminstance. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams getStreamInstance [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getStreamInstance - * - --includeConnections - - - - false - - Flag to indicate whether connections information should be included in the stream instance. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance to return. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-getStreamInstance-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-getStreamProcessor.txt b/docs/command/atlas-api-streams-getStreamProcessor.txt deleted file mode 100644 index b904ab586d..0000000000 --- a/docs/command/atlas-api-streams-getStreamProcessor.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-streams-getStreamProcessor: - -==================================== -atlas api streams getStreamProcessor -==================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Get one Stream Processor within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreamprocessor. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams getStreamProcessor [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getStreamProcessor - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processorName - - string - - true - - Human-readable label that identifies the stream processor. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-getStreamProcessor-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-getVpcPeeringConnections.txt b/docs/command/atlas-api-streams-getVpcPeeringConnections.txt deleted file mode 100644 index 4fb9db7a37..0000000000 --- a/docs/command/atlas-api-streams-getVpcPeeringConnections.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-streams-getVpcPeeringConnections: - -========================================== -atlas api streams getVpcPeeringConnections -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns a list of incoming VPC Peering Connections. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getvpcpeeringconnections. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams getVpcPeeringConnections [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getVpcPeeringConnections - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --requesterAccountId - - string - - true - - The Account ID of the VPC Peering connection/s. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-getVpcPeeringConnections-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-listGroupStreamActiveVpcPeeringConnections.txt b/docs/command/atlas-api-streams-listGroupStreamActiveVpcPeeringConnections.txt new file mode 100644 index 0000000000..b28cba4dbf --- /dev/null +++ b/docs/command/atlas-api-streams-listGroupStreamActiveVpcPeeringConnections.txt @@ -0,0 +1,104 @@ +.. _atlas-api-streams-listGroupStreamActiveVpcPeeringConnections: + +============================================================ +atlas api streams listGroupStreamActiveVpcPeeringConnections +============================================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns a list of active incoming VPC Peering Connections. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamactivevpcpeeringconnections. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams listGroupStreamActiveVpcPeeringConnections [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupStreamActiveVpcPeeringConnections + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-11-13"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-11-13". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-listGroupStreamActiveVpcPeeringConnections-2024-11-13-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-listGroupStreamConnections.txt b/docs/command/atlas-api-streams-listGroupStreamConnections.txt new file mode 100644 index 0000000000..da54aeace9 --- /dev/null +++ b/docs/command/atlas-api-streams-listGroupStreamConnections.txt @@ -0,0 +1,110 @@ +.. _atlas-api-streams-listGroupStreamConnections: + +============================================ +atlas api streams listGroupStreamConnections +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all connections of the stream instance for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamconnections. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams listGroupStreamConnections [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupStreamConnections + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-listGroupStreamConnections-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-listGroupStreamPrivateLinkConnections.txt b/docs/command/atlas-api-streams-listGroupStreamPrivateLinkConnections.txt new file mode 100644 index 0000000000..f9bdd04c97 --- /dev/null +++ b/docs/command/atlas-api-streams-listGroupStreamPrivateLinkConnections.txt @@ -0,0 +1,106 @@ +.. _atlas-api-streams-listGroupStreamPrivateLinkConnections: + +======================================================= +atlas api streams listGroupStreamPrivateLinkConnections +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all Private Link connections for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamprivatelinkconnections. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams listGroupStreamPrivateLinkConnections [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupStreamPrivateLinkConnections + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-listGroupStreamPrivateLinkConnections-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-listGroupStreamVpcPeeringConnections.txt b/docs/command/atlas-api-streams-listGroupStreamVpcPeeringConnections.txt new file mode 100644 index 0000000000..6efb6c77a9 --- /dev/null +++ b/docs/command/atlas-api-streams-listGroupStreamVpcPeeringConnections.txt @@ -0,0 +1,108 @@ +.. _atlas-api-streams-listGroupStreamVpcPeeringConnections: + +====================================================== +atlas api streams listGroupStreamVpcPeeringConnections +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns a list of incoming VPC Peering Connections. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamvpcpeeringconnections. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams listGroupStreamVpcPeeringConnections [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupStreamVpcPeeringConnections + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --requesterAccountId + - string + - true + - The Account ID of the VPC Peering connection/s. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-listGroupStreamVpcPeeringConnections-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-listGroupStreamWorkspaces.txt b/docs/command/atlas-api-streams-listGroupStreamWorkspaces.txt new file mode 100644 index 0000000000..801487d772 --- /dev/null +++ b/docs/command/atlas-api-streams-listGroupStreamWorkspaces.txt @@ -0,0 +1,104 @@ +.. _atlas-api-streams-listGroupStreamWorkspaces: + +=========================================== +atlas api streams listGroupStreamWorkspaces +=========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all stream instances for the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamworkspaces. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams listGroupStreamWorkspaces [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupStreamWorkspaces + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-listGroupStreamWorkspaces-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-listPrivateLinkConnections.txt b/docs/command/atlas-api-streams-listPrivateLinkConnections.txt deleted file mode 100644 index 0710b5d669..0000000000 --- a/docs/command/atlas-api-streams-listPrivateLinkConnections.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-streams-listPrivateLinkConnections: - -============================================ -atlas api streams listPrivateLinkConnections -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Private Link connections for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprivatelinkconnections. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams listPrivateLinkConnections [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listPrivateLinkConnections - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-listPrivateLinkConnections-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-listStreamConnections.txt b/docs/command/atlas-api-streams-listStreamConnections.txt deleted file mode 100644 index 1ae2166a05..0000000000 --- a/docs/command/atlas-api-streams-listStreamConnections.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-streams-listStreamConnections: - -======================================= -atlas api streams listStreamConnections -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all connections of the stream instance for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreamconnections. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams listStreamConnections [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listStreamConnections - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-listStreamConnections-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-listStreamInstances.txt b/docs/command/atlas-api-streams-listStreamInstances.txt deleted file mode 100644 index 0a332a8461..0000000000 --- a/docs/command/atlas-api-streams-listStreamInstances.txt +++ /dev/null @@ -1,104 +0,0 @@ -.. _atlas-api-streams-listStreamInstances: - -===================================== -atlas api streams listStreamInstances -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all stream instances for the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreaminstances. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams listStreamInstances [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listStreamInstances - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-listStreamInstances-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-listStreamProcessors.txt b/docs/command/atlas-api-streams-listStreamProcessors.txt deleted file mode 100644 index d93d491baf..0000000000 --- a/docs/command/atlas-api-streams-listStreamProcessors.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-streams-listStreamProcessors: - -====================================== -atlas api streams listStreamProcessors -====================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all Stream Processors within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreamprocessors. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams listStreamProcessors [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listStreamProcessors - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-listStreamProcessors-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-modifyStreamProcessor.txt b/docs/command/atlas-api-streams-modifyStreamProcessor.txt deleted file mode 100644 index b027103910..0000000000 --- a/docs/command/atlas-api-streams-modifyStreamProcessor.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-streams-modifyStreamProcessor: - -======================================= -atlas api streams modifyStreamProcessor -======================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Modify one existing Stream Processor within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-modifystreamprocessor. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams modifyStreamProcessor [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for modifyStreamProcessor - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processorName - - string - - true - - Human-readable label that identifies the stream processor. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-rejectGroupStreamVpcPeeringConnection.txt b/docs/command/atlas-api-streams-rejectGroupStreamVpcPeeringConnection.txt new file mode 100644 index 0000000000..67f45c5743 --- /dev/null +++ b/docs/command/atlas-api-streams-rejectGroupStreamVpcPeeringConnection.txt @@ -0,0 +1,96 @@ +.. _atlas-api-streams-rejectGroupStreamVpcPeeringConnection: + +======================================================= +atlas api streams rejectGroupStreamVpcPeeringConnection +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Requests the rejection of an incoming VPC Peering connection. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-rejectgroupstreamvpcpeeringconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams rejectGroupStreamVpcPeeringConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for rejectGroupStreamVpcPeeringConnection + * - --id + - string + - true + - The VPC Peering Connection id. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-rejectGroupStreamVpcPeeringConnection-2023-02-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-rejectVpcPeeringConnection.txt b/docs/command/atlas-api-streams-rejectVpcPeeringConnection.txt deleted file mode 100644 index 37d3acb9b6..0000000000 --- a/docs/command/atlas-api-streams-rejectVpcPeeringConnection.txt +++ /dev/null @@ -1,96 +0,0 @@ -.. _atlas-api-streams-rejectVpcPeeringConnection: - -============================================ -atlas api streams rejectVpcPeeringConnection -============================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Requests the rejection of an incoming VPC Peering connection. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-rejectvpcpeeringconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams rejectVpcPeeringConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for rejectVpcPeeringConnection - * - --id - - string - - true - - The VPC Peering Connection id. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-rejectVpcPeeringConnection-2023-02-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-startGroupStreamProcessor.txt b/docs/command/atlas-api-streams-startGroupStreamProcessor.txt new file mode 100644 index 0000000000..b345dfc358 --- /dev/null +++ b/docs/command/atlas-api-streams-startGroupStreamProcessor.txt @@ -0,0 +1,106 @@ +.. _atlas-api-streams-startGroupStreamProcessor: + +=========================================== +atlas api streams startGroupStreamProcessor +=========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Start a Stream Processor within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startgroupstreamprocessor. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams startGroupStreamProcessor [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for startGroupStreamProcessor + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processorName + - string + - true + - Human-readable label that identifies the stream processor. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-startGroupStreamProcessor-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-startGroupStreamProcessorWith.txt b/docs/command/atlas-api-streams-startGroupStreamProcessorWith.txt new file mode 100644 index 0000000000..e54d1ebf9c --- /dev/null +++ b/docs/command/atlas-api-streams-startGroupStreamProcessorWith.txt @@ -0,0 +1,105 @@ +.. _atlas-api-streams-startGroupStreamProcessorWith: + +=============================================== +atlas api streams startGroupStreamProcessorWith +=============================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Start a Stream Processor within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startgroupstreamprocessorwith. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams startGroupStreamProcessorWith [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for startGroupStreamProcessorWith + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processorName + - string + - true + - Human-readable label that identifies the stream processor. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2025-03-12"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-03-12". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-startStreamProcessor.txt b/docs/command/atlas-api-streams-startStreamProcessor.txt deleted file mode 100644 index ceeb684aaf..0000000000 --- a/docs/command/atlas-api-streams-startStreamProcessor.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-streams-startStreamProcessor: - -====================================== -atlas api streams startStreamProcessor -====================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Start a Stream Processor within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startstreamprocessor. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams startStreamProcessor [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for startStreamProcessor - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processorName - - string - - true - - Human-readable label that identifies the stream processor. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-startStreamProcessor-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-startStreamProcessorWith.txt b/docs/command/atlas-api-streams-startStreamProcessorWith.txt deleted file mode 100644 index 2ddc56bc6c..0000000000 --- a/docs/command/atlas-api-streams-startStreamProcessorWith.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-streams-startStreamProcessorWith: - -========================================== -atlas api streams startStreamProcessorWith -========================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Start a Stream Processor within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startstreamprocessorwith. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams startStreamProcessorWith [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for startStreamProcessorWith - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processorName - - string - - true - - Human-readable label that identifies the stream processor. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2025-03-12"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2025-03-12". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-stopGroupStreamProcessor.txt b/docs/command/atlas-api-streams-stopGroupStreamProcessor.txt new file mode 100644 index 0000000000..e71594aa90 --- /dev/null +++ b/docs/command/atlas-api-streams-stopGroupStreamProcessor.txt @@ -0,0 +1,106 @@ +.. _atlas-api-streams-stopGroupStreamProcessor: + +========================================== +atlas api streams stopGroupStreamProcessor +========================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Stop a Stream Processor within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-stopgroupstreamprocessor. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams stopGroupStreamProcessor [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for stopGroupStreamProcessor + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processorName + - string + - true + - Human-readable label that identifies the stream processor. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-streams-stopGroupStreamProcessor-2024-05-30-default.sh + :language: shell diff --git a/docs/command/atlas-api-streams-stopStreamProcessor.txt b/docs/command/atlas-api-streams-stopStreamProcessor.txt deleted file mode 100644 index 436b63a575..0000000000 --- a/docs/command/atlas-api-streams-stopStreamProcessor.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. _atlas-api-streams-stopStreamProcessor: - -===================================== -atlas api streams stopStreamProcessor -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Stop a Stream Processor within the specified stream instance. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-stopstreamprocessor. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams stopStreamProcessor [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for stopStreamProcessor - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --processorName - - string - - true - - Human-readable label that identifies the stream processor. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-streams-stopStreamProcessor-2024-05-30-default.sh - :language: shell diff --git a/docs/command/atlas-api-streams-updateGroupStreamConnection.txt b/docs/command/atlas-api-streams-updateGroupStreamConnection.txt new file mode 100644 index 0000000000..2e51587fd3 --- /dev/null +++ b/docs/command/atlas-api-streams-updateGroupStreamConnection.txt @@ -0,0 +1,105 @@ +.. _atlas-api-streams-updateGroupStreamConnection: + +============================================= +atlas api streams updateGroupStreamConnection +============================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Update one connection for the specified stream instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupstreamconnection. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams updateGroupStreamConnection [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --connectionName + - string + - true + - Human-readable label that identifies the stream connection. + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupStreamConnection + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-updateGroupStreamProcessor.txt b/docs/command/atlas-api-streams-updateGroupStreamProcessor.txt new file mode 100644 index 0000000000..21d0460465 --- /dev/null +++ b/docs/command/atlas-api-streams-updateGroupStreamProcessor.txt @@ -0,0 +1,105 @@ +.. _atlas-api-streams-updateGroupStreamProcessor: + +============================================ +atlas api streams updateGroupStreamProcessor +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Modify one existing Stream Processor within the specified stream instance. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupstreamprocessor. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams updateGroupStreamProcessor [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupStreamProcessor + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --processorName + - string + - true + - Human-readable label that identifies the stream processor. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-05-30"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-05-30". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-updateGroupStreamWorkspace.txt b/docs/command/atlas-api-streams-updateGroupStreamWorkspace.txt new file mode 100644 index 0000000000..718df67cba --- /dev/null +++ b/docs/command/atlas-api-streams-updateGroupStreamWorkspace.txt @@ -0,0 +1,101 @@ +.. _atlas-api-streams-updateGroupStreamWorkspace: + +============================================ +atlas api streams updateGroupStreamWorkspace +============================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Update one stream instance in the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupstreamworkspace. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams updateGroupStreamWorkspace [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupStreamWorkspace + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --tenantName + - string + - true + - Human-readable label that identifies the stream instance to update. + * - --version + - string + - false + - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams-updateStreamConnection.txt b/docs/command/atlas-api-streams-updateStreamConnection.txt deleted file mode 100644 index 6d7499e2e5..0000000000 --- a/docs/command/atlas-api-streams-updateStreamConnection.txt +++ /dev/null @@ -1,105 +0,0 @@ -.. _atlas-api-streams-updateStreamConnection: - -======================================== -atlas api streams updateStreamConnection -======================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Update one connection for the specified stream instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatestreamconnection. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams updateStreamConnection [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --connectionName - - string - - true - - Human-readable label that identifies the stream connection. - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateStreamConnection - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-updateStreamInstance.txt b/docs/command/atlas-api-streams-updateStreamInstance.txt deleted file mode 100644 index 735582f880..0000000000 --- a/docs/command/atlas-api-streams-updateStreamInstance.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-streams-updateStreamInstance: - -====================================== -atlas api streams updateStreamInstance -====================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Update one stream instance in the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatestreaminstance. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api streams updateStreamInstance [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateStreamInstance - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --tenantName - - string - - true - - Human-readable label that identifies the stream instance to update. - * - --version - - string - - false - - api version to use when calling the api call [options: "2023-02-01"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2023-02-01". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-streams-withGroupStreamSampleConnections.txt b/docs/command/atlas-api-streams-withGroupStreamSampleConnections.txt new file mode 100644 index 0000000000..45e6767986 --- /dev/null +++ b/docs/command/atlas-api-streams-withGroupStreamSampleConnections.txt @@ -0,0 +1,97 @@ +.. _atlas-api-streams-withGroupStreamSampleConnections: + +================================================== +atlas api streams withGroupStreamSampleConnections +================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one stream instance in the specified project with sample connections. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-withgroupstreamsampleconnections. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api streams withGroupStreamSampleConnections [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for withGroupStreamSampleConnections + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - string + - false + - api version to use when calling the api call [options: "2024-08-05"], defaults to the latest version or the profiles api_version config value if set This value defaults to "2024-08-05". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-streams.txt b/docs/command/atlas-api-streams.txt index 86d92c142e..87f22cb2ff 100644 --- a/docs/command/atlas-api-streams.txt +++ b/docs/command/atlas-api-streams.txt @@ -54,69 +54,69 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-streams-acceptVpcPeeringConnection` - `Public Preview: please provide feedback `_: Requests the acceptance of an incoming VPC Peering connection. -* :ref:`atlas-api-streams-createPrivateLinkConnection` - `Public Preview: please provide feedback `_: Creates one Private Link in the specified project. -* :ref:`atlas-api-streams-createStreamConnection` - `Public Preview: please provide feedback `_: Creates one connection for a stream instance in the specified project. -* :ref:`atlas-api-streams-createStreamInstance` - `Public Preview: please provide feedback `_: Creates one stream instance in the specified project. -* :ref:`atlas-api-streams-createStreamInstanceWithSampleConnections` - `Public Preview: please provide feedback `_: Creates one stream instance in the specified project with sample connections. -* :ref:`atlas-api-streams-createStreamProcessor` - `Public Preview: please provide feedback `_: Create one Stream Processor within the specified stream instance. -* :ref:`atlas-api-streams-deletePrivateLinkConnection` - `Public Preview: please provide feedback `_: Deletes one Private Link in the specified project. -* :ref:`atlas-api-streams-deleteStreamConnection` - `Public Preview: please provide feedback `_: Delete one connection of the specified stream instance. -* :ref:`atlas-api-streams-deleteStreamInstance` - `Public Preview: please provide feedback `_: Delete one stream instance in the specified project. -* :ref:`atlas-api-streams-deleteStreamProcessor` - `Public Preview: please provide feedback `_: Delete a Stream Processor within the specified stream instance. -* :ref:`atlas-api-streams-deleteVpcPeeringConnection` - `Public Preview: please provide feedback `_: Deletes an incoming VPC Peering connection. -* :ref:`atlas-api-streams-downloadStreamTenantAuditLogs` - `Public Preview: please provide feedback `_: Downloads the audit logs for the specified Atlas Streams Processing instance. -* :ref:`atlas-api-streams-getAccountDetails` - `Public Preview: please provide feedback `_: Returns the Account ID, and the VPC ID for the group and region specified. -* :ref:`atlas-api-streams-getActiveVpcPeeringConnections` - `Public Preview: please provide feedback `_: Returns a list of active incoming VPC Peering Connections. -* :ref:`atlas-api-streams-getPrivateLinkConnection` - `Public Preview: please provide feedback `_: Returns the details of one Private Link connection within the project. -* :ref:`atlas-api-streams-getStreamConnection` - `Public Preview: please provide feedback `_: Returns the details of one stream connection within the specified stream instance. -* :ref:`atlas-api-streams-getStreamInstance` - `Public Preview: please provide feedback `_: Returns the details of one stream instance within the specified project. -* :ref:`atlas-api-streams-getStreamProcessor` - `Public Preview: please provide feedback `_: Get one Stream Processor within the specified stream instance. -* :ref:`atlas-api-streams-getVpcPeeringConnections` - `Public Preview: please provide feedback `_: Returns a list of incoming VPC Peering Connections. -* :ref:`atlas-api-streams-listPrivateLinkConnections` - `Public Preview: please provide feedback `_: Returns all Private Link connections for the specified project. -* :ref:`atlas-api-streams-listStreamConnections` - `Public Preview: please provide feedback `_: Returns all connections of the stream instance for the specified project. -* :ref:`atlas-api-streams-listStreamInstances` - `Public Preview: please provide feedback `_: Returns all stream instances for the specified project. -* :ref:`atlas-api-streams-listStreamProcessors` - `Public Preview: please provide feedback `_: Returns all Stream Processors within the specified stream instance. -* :ref:`atlas-api-streams-modifyStreamProcessor` - `Public Preview: please provide feedback `_: Modify one existing Stream Processor within the specified stream instance. -* :ref:`atlas-api-streams-rejectVpcPeeringConnection` - `Public Preview: please provide feedback `_: Requests the rejection of an incoming VPC Peering connection. -* :ref:`atlas-api-streams-startStreamProcessor` - `Public Preview: please provide feedback `_: Start a Stream Processor within the specified stream instance. -* :ref:`atlas-api-streams-startStreamProcessorWith` - `Public Preview: please provide feedback `_: Start a Stream Processor within the specified stream instance. -* :ref:`atlas-api-streams-stopStreamProcessor` - `Public Preview: please provide feedback `_: Stop a Stream Processor within the specified stream instance. -* :ref:`atlas-api-streams-updateStreamConnection` - `Public Preview: please provide feedback `_: Update one connection for the specified stream instance in the specified project. -* :ref:`atlas-api-streams-updateStreamInstance` - `Public Preview: please provide feedback `_: Update one stream instance in the specified project. +* :ref:`atlas-api-streams-acceptGroupStreamVpcPeeringConnection` - `Public Preview: please provide feedback `_: Requests the acceptance of an incoming VPC Peering connection. +* :ref:`atlas-api-streams-createGroupStreamConnection` - `Public Preview: please provide feedback `_: Creates one connection for a stream instance in the specified project. +* :ref:`atlas-api-streams-createGroupStreamPrivateLinkConnection` - `Public Preview: please provide feedback `_: Creates one Private Link in the specified project. +* :ref:`atlas-api-streams-createGroupStreamProcessor` - `Public Preview: please provide feedback `_: Create one Stream Processor within the specified stream instance. +* :ref:`atlas-api-streams-createGroupStreamWorkspace` - `Public Preview: please provide feedback `_: Creates one stream instance in the specified project. +* :ref:`atlas-api-streams-deleteGroupStreamConnection` - `Public Preview: please provide feedback `_: Delete one connection of the specified stream instance. +* :ref:`atlas-api-streams-deleteGroupStreamPrivateLinkConnection` - `Public Preview: please provide feedback `_: Deletes one Private Link in the specified project. +* :ref:`atlas-api-streams-deleteGroupStreamProcessor` - `Public Preview: please provide feedback `_: Delete a Stream Processor within the specified stream instance. +* :ref:`atlas-api-streams-deleteGroupStreamVpcPeeringConnection` - `Public Preview: please provide feedback `_: Deletes an incoming VPC Peering connection. +* :ref:`atlas-api-streams-deleteGroupStreamWorkspace` - `Public Preview: please provide feedback `_: Delete one stream instance in the specified project. +* :ref:`atlas-api-streams-downloadGroupStreamAuditLogs` - `Public Preview: please provide feedback `_: Downloads the audit logs for the specified Atlas Streams Processing instance. +* :ref:`atlas-api-streams-getGroupStreamAccountDetails` - `Public Preview: please provide feedback `_: Returns the Account ID, and the VPC ID for the group and region specified. +* :ref:`atlas-api-streams-getGroupStreamConnection` - `Public Preview: please provide feedback `_: Returns the details of one stream connection within the specified stream instance. +* :ref:`atlas-api-streams-getGroupStreamPrivateLinkConnection` - `Public Preview: please provide feedback `_: Returns the details of one Private Link connection within the project. +* :ref:`atlas-api-streams-getGroupStreamProcessor` - `Public Preview: please provide feedback `_: Get one Stream Processor within the specified stream instance. +* :ref:`atlas-api-streams-getGroupStreamProcessors` - `Public Preview: please provide feedback `_: Returns all Stream Processors within the specified stream instance. +* :ref:`atlas-api-streams-getGroupStreamWorkspace` - `Public Preview: please provide feedback `_: Returns the details of one stream instance within the specified project. +* :ref:`atlas-api-streams-listGroupStreamActiveVpcPeeringConnections` - `Public Preview: please provide feedback `_: Returns a list of active incoming VPC Peering Connections. +* :ref:`atlas-api-streams-listGroupStreamConnections` - `Public Preview: please provide feedback `_: Returns all connections of the stream instance for the specified project. +* :ref:`atlas-api-streams-listGroupStreamPrivateLinkConnections` - `Public Preview: please provide feedback `_: Returns all Private Link connections for the specified project. +* :ref:`atlas-api-streams-listGroupStreamVpcPeeringConnections` - `Public Preview: please provide feedback `_: Returns a list of incoming VPC Peering Connections. +* :ref:`atlas-api-streams-listGroupStreamWorkspaces` - `Public Preview: please provide feedback `_: Returns all stream instances for the specified project. +* :ref:`atlas-api-streams-rejectGroupStreamVpcPeeringConnection` - `Public Preview: please provide feedback `_: Requests the rejection of an incoming VPC Peering connection. +* :ref:`atlas-api-streams-startGroupStreamProcessor` - `Public Preview: please provide feedback `_: Start a Stream Processor within the specified stream instance. +* :ref:`atlas-api-streams-startGroupStreamProcessorWith` - `Public Preview: please provide feedback `_: Start a Stream Processor within the specified stream instance. +* :ref:`atlas-api-streams-stopGroupStreamProcessor` - `Public Preview: please provide feedback `_: Stop a Stream Processor within the specified stream instance. +* :ref:`atlas-api-streams-updateGroupStreamConnection` - `Public Preview: please provide feedback `_: Update one connection for the specified stream instance in the specified project. +* :ref:`atlas-api-streams-updateGroupStreamProcessor` - `Public Preview: please provide feedback `_: Modify one existing Stream Processor within the specified stream instance. +* :ref:`atlas-api-streams-updateGroupStreamWorkspace` - `Public Preview: please provide feedback `_: Update one stream instance in the specified project. +* :ref:`atlas-api-streams-withGroupStreamSampleConnections` - `Public Preview: please provide feedback `_: Creates one stream instance in the specified project with sample connections. .. toctree:: :titlesonly: - acceptVpcPeeringConnection - createPrivateLinkConnection - createStreamConnection - createStreamInstance - createStreamInstanceWithSampleConnections - createStreamProcessor - deletePrivateLinkConnection - deleteStreamConnection - deleteStreamInstance - deleteStreamProcessor - deleteVpcPeeringConnection - downloadStreamTenantAuditLogs - getAccountDetails - getActiveVpcPeeringConnections - getPrivateLinkConnection - getStreamConnection - getStreamInstance - getStreamProcessor - getVpcPeeringConnections - listPrivateLinkConnections - listStreamConnections - listStreamInstances - listStreamProcessors - modifyStreamProcessor - rejectVpcPeeringConnection - startStreamProcessor - startStreamProcessorWith - stopStreamProcessor - updateStreamConnection - updateStreamInstance + acceptGroupStreamVpcPeeringConnection + createGroupStreamConnection + createGroupStreamPrivateLinkConnection + createGroupStreamProcessor + createGroupStreamWorkspace + deleteGroupStreamConnection + deleteGroupStreamPrivateLinkConnection + deleteGroupStreamProcessor + deleteGroupStreamVpcPeeringConnection + deleteGroupStreamWorkspace + downloadGroupStreamAuditLogs + getGroupStreamAccountDetails + getGroupStreamConnection + getGroupStreamPrivateLinkConnection + getGroupStreamProcessor + getGroupStreamProcessors + getGroupStreamWorkspace + listGroupStreamActiveVpcPeeringConnections + listGroupStreamConnections + listGroupStreamPrivateLinkConnections + listGroupStreamVpcPeeringConnections + listGroupStreamWorkspaces + rejectGroupStreamVpcPeeringConnection + startGroupStreamProcessor + startGroupStreamProcessorWith + stopGroupStreamProcessor + updateGroupStreamConnection + updateGroupStreamProcessor + updateGroupStreamWorkspace + withGroupStreamSampleConnections diff --git a/docs/command/atlas-api-teams-addAllTeamsToProject.txt b/docs/command/atlas-api-teams-addAllTeamsToProject.txt deleted file mode 100644 index 90aa82355a..0000000000 --- a/docs/command/atlas-api-teams-addAllTeamsToProject.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. _atlas-api-teams-addAllTeamsToProject: - -==================================== -atlas api teams addAllTeamsToProject -==================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one or more teams to the specified project. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -All members of the team share the same project access. MongoDB Cloud limits the number of users to a maximum of 100 teams per project and a maximum of 250 teams per organization. To use this resource, the requesting API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addallteamstoproject. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams addAllTeamsToProject [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for addAllTeamsToProject - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-teams-addGroupTeams.txt b/docs/command/atlas-api-teams-addGroupTeams.txt new file mode 100644 index 0000000000..8bb72bc34e --- /dev/null +++ b/docs/command/atlas-api-teams-addGroupTeams.txt @@ -0,0 +1,97 @@ +.. _atlas-api-teams-addGroupTeams: + +============================= +atlas api teams addGroupTeams +============================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one or more teams to the specified project. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +All members of the team share the same project access. MongoDB Cloud limits the number of users to a maximum of 100 teams per project and a maximum of 250 teams per organization. To use this resource, the requesting API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupteams. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams addGroupTeams [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for addGroupTeams + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-teams-addOrgTeamUsers.txt b/docs/command/atlas-api-teams-addOrgTeamUsers.txt new file mode 100644 index 0000000000..7dd956f9ac --- /dev/null +++ b/docs/command/atlas-api-teams-addOrgTeamUsers.txt @@ -0,0 +1,102 @@ +.. _atlas-api-teams-addOrgTeamUsers: + +=============================== +atlas api teams addOrgTeamUsers +=============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds one or more MongoDB Cloud users from the specified organization to the specified team. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Teams enable you to grant project access roles to MongoDB Cloud users. You can assign up to 250 MongoDB Cloud users from one organization to one team. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: This endpoint is deprecated. Use Add One MongoDB Cloud User to One Team to add an active or pending user to a team. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addorgteamusers. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams addOrgTeamUsers [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for addOrgTeamUsers + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal character string that identifies the team to which you want to add MongoDB Cloud users. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-teams-addTeamUser.txt b/docs/command/atlas-api-teams-addTeamUser.txt deleted file mode 100644 index 6bcf2606d1..0000000000 --- a/docs/command/atlas-api-teams-addTeamUser.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-teams-addTeamUser: - -=========================== -atlas api teams addTeamUser -=========================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds one or more MongoDB Cloud users from the specified organization to the specified team. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Teams enable you to grant project access roles to MongoDB Cloud users. You can assign up to 250 MongoDB Cloud users from one organization to one team. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This endpoint is deprecated. Use Add One MongoDB Cloud User to One Team to add an active or pending user to a team. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addteamuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams addTeamUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for addTeamUser - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal character string that identifies the team to which you want to add MongoDB Cloud users. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-teams-createOrgTeam.txt b/docs/command/atlas-api-teams-createOrgTeam.txt new file mode 100644 index 0000000000..6ef511cc5b --- /dev/null +++ b/docs/command/atlas-api-teams-createOrgTeam.txt @@ -0,0 +1,95 @@ +.. _atlas-api-teams-createOrgTeam: + +============================= +atlas api teams createOrgTeam +============================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Creates one team in the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud limits the number of teams to a maximum of 250 teams per organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgteam. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams createOrgTeam [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for createOrgTeam + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-teams-createTeam.txt b/docs/command/atlas-api-teams-createTeam.txt deleted file mode 100644 index f1a472ad6d..0000000000 --- a/docs/command/atlas-api-teams-createTeam.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. _atlas-api-teams-createTeam: - -========================== -atlas api teams createTeam -========================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Creates one team in the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud limits the number of teams to a maximum of 250 teams per organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createteam. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams createTeam [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for createTeam - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-teams-deleteOrgTeam.txt b/docs/command/atlas-api-teams-deleteOrgTeam.txt new file mode 100644 index 0000000000..45723a6c5b --- /dev/null +++ b/docs/command/atlas-api-teams-deleteOrgTeam.txt @@ -0,0 +1,100 @@ +.. _atlas-api-teams-deleteOrgTeam: + +============================= +atlas api teams deleteOrgTeam +============================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one team specified using its unique 24-hexadecimal digit identifier from the organization specified using its unique 24-hexadecimal digit identifier. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgteam. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams deleteOrgTeam [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for deleteOrgTeam + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team that you want to delete. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-teams-deleteOrgTeam-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-teams-deleteTeam.txt b/docs/command/atlas-api-teams-deleteTeam.txt deleted file mode 100644 index 258aba48bd..0000000000 --- a/docs/command/atlas-api-teams-deleteTeam.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-teams-deleteTeam: - -========================== -atlas api teams deleteTeam -========================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one team specified using its unique 24-hexadecimal digit identifier from the organization specified using its unique 24-hexadecimal digit identifier. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteteam. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams deleteTeam [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for deleteTeam - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team that you want to delete. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-teams-deleteTeam-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-teams-getGroupTeam.txt b/docs/command/atlas-api-teams-getGroupTeam.txt new file mode 100644 index 0000000000..6708fe38e6 --- /dev/null +++ b/docs/command/atlas-api-teams-getGroupTeam.txt @@ -0,0 +1,102 @@ +.. _atlas-api-teams-getGroupTeam: + +============================ +atlas api teams getGroupTeam +============================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one team to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupteam. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams getGroupTeam [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupTeam + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team for which you want to get. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-teams-getGroupTeam-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-teams-getOrgTeam.txt b/docs/command/atlas-api-teams-getOrgTeam.txt new file mode 100644 index 0000000000..636682ebec --- /dev/null +++ b/docs/command/atlas-api-teams-getOrgTeam.txt @@ -0,0 +1,100 @@ +.. _atlas-api-teams-getOrgTeam: + +========================== +atlas api teams getOrgTeam +========================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one team that you identified using its unique 24-hexadecimal digit ID. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgteam. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams getOrgTeam [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgTeam + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team whose information you want to return. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-teams-getOrgTeam-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-teams-getOrgTeamByName.txt b/docs/command/atlas-api-teams-getOrgTeamByName.txt new file mode 100644 index 0000000000..e7cea2e9c4 --- /dev/null +++ b/docs/command/atlas-api-teams-getOrgTeamByName.txt @@ -0,0 +1,100 @@ +.. _atlas-api-teams-getOrgTeamByName: + +================================ +atlas api teams getOrgTeamByName +================================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns one team that you identified using its human-readable name. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgteambyname. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams getOrgTeamByName [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for getOrgTeamByName + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamName + - string + - true + - Name of the team whose information you want to return. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-teams-getOrgTeamByName-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-teams-getProjectTeam.txt b/docs/command/atlas-api-teams-getProjectTeam.txt deleted file mode 100644 index a7d0e952d6..0000000000 --- a/docs/command/atlas-api-teams-getProjectTeam.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-teams-getProjectTeam: - -============================== -atlas api teams getProjectTeam -============================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one team to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectteam. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams getProjectTeam [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getProjectTeam - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team for which you want to get. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-teams-getProjectTeam-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-teams-getTeamById.txt b/docs/command/atlas-api-teams-getTeamById.txt deleted file mode 100644 index bf13569fee..0000000000 --- a/docs/command/atlas-api-teams-getTeamById.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-teams-getTeamById: - -=========================== -atlas api teams getTeamById -=========================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one team that you identified using its unique 24-hexadecimal digit ID. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getteambyid. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams getTeamById [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getTeamById - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team whose information you want to return. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-teams-getTeamById-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-teams-getTeamByName.txt b/docs/command/atlas-api-teams-getTeamByName.txt deleted file mode 100644 index 8ec4b30857..0000000000 --- a/docs/command/atlas-api-teams-getTeamByName.txt +++ /dev/null @@ -1,100 +0,0 @@ -.. _atlas-api-teams-getTeamByName: - -============================= -atlas api teams getTeamByName -============================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns one team that you identified using its human-readable name. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getteambyname. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams getTeamByName [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for getTeamByName - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamName - - string - - true - - Name of the team whose information you want to return. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-teams-getTeamByName-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-teams-listGroupTeams.txt b/docs/command/atlas-api-teams-listGroupTeams.txt new file mode 100644 index 0000000000..c7b9434845 --- /dev/null +++ b/docs/command/atlas-api-teams-listGroupTeams.txt @@ -0,0 +1,110 @@ +.. _atlas-api-teams-listGroupTeams: + +============================== +atlas api teams listGroupTeams +============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupteams. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams listGroupTeams [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupTeams + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-teams-listGroupTeams-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-teams-listOrgTeams.txt b/docs/command/atlas-api-teams-listOrgTeams.txt new file mode 100644 index 0000000000..57c68a2642 --- /dev/null +++ b/docs/command/atlas-api-teams-listOrgTeams.txt @@ -0,0 +1,108 @@ +.. _atlas-api-teams-listOrgTeams: + +============================ +atlas api teams listOrgTeams +============================ + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all teams that belong to the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud only returns teams for which you have access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgteams. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams listOrgTeams [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for listOrgTeams + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-teams-listOrgTeams-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-teams-listOrganizationTeams.txt b/docs/command/atlas-api-teams-listOrganizationTeams.txt deleted file mode 100644 index 93405a80d4..0000000000 --- a/docs/command/atlas-api-teams-listOrganizationTeams.txt +++ /dev/null @@ -1,108 +0,0 @@ -.. _atlas-api-teams-listOrganizationTeams: - -===================================== -atlas api teams listOrganizationTeams -===================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all teams that belong to the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud only returns teams for which you have access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationteams. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams listOrganizationTeams [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for listOrganizationTeams - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-teams-listOrganizationTeams-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-teams-listProjectTeams.txt b/docs/command/atlas-api-teams-listProjectTeams.txt deleted file mode 100644 index 612203cb16..0000000000 --- a/docs/command/atlas-api-teams-listProjectTeams.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-teams-listProjectTeams: - -================================ -atlas api teams listProjectTeams -================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectteams. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams listProjectTeams [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listProjectTeams - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-teams-listProjectTeams-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-teams-removeGroupTeam.txt b/docs/command/atlas-api-teams-removeGroupTeam.txt new file mode 100644 index 0000000000..cfe84eb9aa --- /dev/null +++ b/docs/command/atlas-api-teams-removeGroupTeam.txt @@ -0,0 +1,98 @@ +.. _atlas-api-teams-removeGroupTeam: + +=============================== +atlas api teams removeGroupTeam +=============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one team specified using its unique 24-hexadecimal digit identifier from the project specified using its unique 24-hexadecimal digit identifier. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removegroupteam. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams removeGroupTeam [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for removeGroupTeam + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team that you want to remove from the specified project. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-teams-removeGroupTeam-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-teams-removeOrgTeamUserFromTeam.txt b/docs/command/atlas-api-teams-removeOrgTeamUserFromTeam.txt new file mode 100644 index 0000000000..c70c3d84f0 --- /dev/null +++ b/docs/command/atlas-api-teams-removeOrgTeamUserFromTeam.txt @@ -0,0 +1,107 @@ +.. _atlas-api-teams-removeOrgTeamUserFromTeam: + +========================================= +atlas api teams removeOrgTeamUserFromTeam +========================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from the specified team. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: This endpoint is deprecated. Use Remove One MongoDB Cloud User from One Team to remove an active or pending user from a team. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorgteamuserfromteam. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams removeOrgTeamUserFromTeam [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - -h, --help + - + - false + - help for removeOrgTeamUserFromTeam + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team from which you want to remove one database application user. + * - --userId + - string + - true + - Unique 24-hexadecimal digit string that identifies MongoDB Cloud user that you want to remove from the specified team. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-teams-removeOrgTeamUserFromTeam-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-teams-removeProjectTeam.txt b/docs/command/atlas-api-teams-removeProjectTeam.txt deleted file mode 100644 index 052a7ffb46..0000000000 --- a/docs/command/atlas-api-teams-removeProjectTeam.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. _atlas-api-teams-removeProjectTeam: - -================================= -atlas api teams removeProjectTeam -================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one team specified using its unique 24-hexadecimal digit identifier from the project specified using its unique 24-hexadecimal digit identifier. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectteam. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams removeProjectTeam [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for removeProjectTeam - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team that you want to remove from the specified project. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-teams-removeProjectTeam-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-teams-removeTeamUser.txt b/docs/command/atlas-api-teams-removeTeamUser.txt deleted file mode 100644 index f9cee4d3bb..0000000000 --- a/docs/command/atlas-api-teams-removeTeamUser.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-teams-removeTeamUser: - -============================== -atlas api teams removeTeamUser -============================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from the specified team. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This endpoint is deprecated. Use Remove One MongoDB Cloud User from One Team to remove an active or pending user from a team. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeteamuser. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams removeTeamUser [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - -h, --help - - - - false - - help for removeTeamUser - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team from which you want to remove one database application user. - * - --userId - - string - - true - - Unique 24-hexadecimal digit string that identifies MongoDB Cloud user that you want to remove from the specified team. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-teams-removeTeamUser-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-teams-renameOrgTeam.txt b/docs/command/atlas-api-teams-renameOrgTeam.txt new file mode 100644 index 0000000000..8c0d5628d5 --- /dev/null +++ b/docs/command/atlas-api-teams-renameOrgTeam.txt @@ -0,0 +1,99 @@ +.. _atlas-api-teams-renameOrgTeam: + +============================= +atlas api teams renameOrgTeam +============================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Renames one team in the specified organization. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-renameorgteam. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams renameOrgTeam [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - -h, --help + - + - false + - help for renameOrgTeam + * - --orgId + - string + - true + - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team that you want to rename. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-teams-renameTeam.txt b/docs/command/atlas-api-teams-renameTeam.txt deleted file mode 100644 index c2a48f8b66..0000000000 --- a/docs/command/atlas-api-teams-renameTeam.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. _atlas-api-teams-renameTeam: - -========================== -atlas api teams renameTeam -========================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Renames one team in the specified organization. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-renameteam. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams renameTeam [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - -h, --help - - - - false - - help for renameTeam - * - --orgId - - string - - true - - Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team that you want to rename. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-teams-updateGroupTeam.txt b/docs/command/atlas-api-teams-updateGroupTeam.txt new file mode 100644 index 0000000000..81ca3802da --- /dev/null +++ b/docs/command/atlas-api-teams-updateGroupTeam.txt @@ -0,0 +1,101 @@ +.. _atlas-api-teams-updateGroupTeam: + +=============================== +atlas api teams updateGroupTeam +=============================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the project roles assigned to the specified team. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +You can grant team roles for specific projects and grant project access roles to users in the team. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupteam. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api teams updateGroupTeam [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupTeam + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --teamId + - string + - true + - Unique 24-hexadecimal digit string that identifies the team for which you want to update roles. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-teams-updateTeamRoles.txt b/docs/command/atlas-api-teams-updateTeamRoles.txt deleted file mode 100644 index b1e50daced..0000000000 --- a/docs/command/atlas-api-teams-updateTeamRoles.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. _atlas-api-teams-updateTeamRoles: - -=============================== -atlas api teams updateTeamRoles -=============================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the project roles assigned to the specified team. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -You can grant team roles for specific projects and grant project access roles to users in the team. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateteamroles. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api teams updateTeamRoles [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateTeamRoles - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --teamId - - string - - true - - Unique 24-hexadecimal digit string that identifies the team for which you want to update roles. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-teams.txt b/docs/command/atlas-api-teams.txt index fda64ae254..791a015f95 100644 --- a/docs/command/atlas-api-teams.txt +++ b/docs/command/atlas-api-teams.txt @@ -54,35 +54,35 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-teams-addAllTeamsToProject` - `Public Preview: please provide feedback `_: Adds one or more teams to the specified project. -* :ref:`atlas-api-teams-addTeamUser` - `Public Preview: please provide feedback `_: Adds one or more MongoDB Cloud users from the specified organization to the specified team. -* :ref:`atlas-api-teams-createTeam` - `Public Preview: please provide feedback `_: Creates one team in the specified organization. -* :ref:`atlas-api-teams-deleteTeam` - `Public Preview: please provide feedback `_: Removes one team specified using its unique 24-hexadecimal digit identifier from the organization specified using its unique 24-hexadecimal digit identifier. -* :ref:`atlas-api-teams-getProjectTeam` - `Public Preview: please provide feedback `_: Returns one team to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. -* :ref:`atlas-api-teams-getTeamById` - `Public Preview: please provide feedback `_: Returns one team that you identified using its unique 24-hexadecimal digit ID. -* :ref:`atlas-api-teams-getTeamByName` - `Public Preview: please provide feedback `_: Returns one team that you identified using its human-readable name. -* :ref:`atlas-api-teams-listOrganizationTeams` - `Public Preview: please provide feedback `_: Returns all teams that belong to the specified organization. -* :ref:`atlas-api-teams-listProjectTeams` - `Public Preview: please provide feedback `_: Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. -* :ref:`atlas-api-teams-removeProjectTeam` - `Public Preview: please provide feedback `_: Removes one team specified using its unique 24-hexadecimal digit identifier from the project specified using its unique 24-hexadecimal digit identifier. -* :ref:`atlas-api-teams-removeTeamUser` - `Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from the specified team. -* :ref:`atlas-api-teams-renameTeam` - `Public Preview: please provide feedback `_: Renames one team in the specified organization. -* :ref:`atlas-api-teams-updateTeamRoles` - `Public Preview: please provide feedback `_: Updates the project roles assigned to the specified team. +* :ref:`atlas-api-teams-addGroupTeams` - `Public Preview: please provide feedback `_: Adds one or more teams to the specified project. +* :ref:`atlas-api-teams-addOrgTeamUsers` - `Public Preview: please provide feedback `_: Adds one or more MongoDB Cloud users from the specified organization to the specified team. +* :ref:`atlas-api-teams-createOrgTeam` - `Public Preview: please provide feedback `_: Creates one team in the specified organization. +* :ref:`atlas-api-teams-deleteOrgTeam` - `Public Preview: please provide feedback `_: Removes one team specified using its unique 24-hexadecimal digit identifier from the organization specified using its unique 24-hexadecimal digit identifier. +* :ref:`atlas-api-teams-getGroupTeam` - `Public Preview: please provide feedback `_: Returns one team to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. +* :ref:`atlas-api-teams-getOrgTeam` - `Public Preview: please provide feedback `_: Returns one team that you identified using its unique 24-hexadecimal digit ID. +* :ref:`atlas-api-teams-getOrgTeamByName` - `Public Preview: please provide feedback `_: Returns one team that you identified using its human-readable name. +* :ref:`atlas-api-teams-listGroupTeams` - `Public Preview: please provide feedback `_: Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. +* :ref:`atlas-api-teams-listOrgTeams` - `Public Preview: please provide feedback `_: Returns all teams that belong to the specified organization. +* :ref:`atlas-api-teams-removeGroupTeam` - `Public Preview: please provide feedback `_: Removes one team specified using its unique 24-hexadecimal digit identifier from the project specified using its unique 24-hexadecimal digit identifier. +* :ref:`atlas-api-teams-removeOrgTeamUserFromTeam` - `Public Preview: please provide feedback `_: Removes one MongoDB Cloud user from the specified team. +* :ref:`atlas-api-teams-renameOrgTeam` - `Public Preview: please provide feedback `_: Renames one team in the specified organization. +* :ref:`atlas-api-teams-updateGroupTeam` - `Public Preview: please provide feedback `_: Updates the project roles assigned to the specified team. .. toctree:: :titlesonly: - addAllTeamsToProject - addTeamUser - createTeam - deleteTeam - getProjectTeam - getTeamById - getTeamByName - listOrganizationTeams - listProjectTeams - removeProjectTeam - removeTeamUser - renameTeam - updateTeamRoles + addGroupTeams + addOrgTeamUsers + createOrgTeam + deleteOrgTeam + getGroupTeam + getOrgTeam + getOrgTeamByName + listGroupTeams + listOrgTeams + removeGroupTeam + removeOrgTeamUserFromTeam + renameOrgTeam + updateGroupTeam diff --git a/docs/command/atlas-api-thirdPartyIntegrations-createGroupIntegration.txt b/docs/command/atlas-api-thirdPartyIntegrations-createGroupIntegration.txt new file mode 100644 index 0000000000..a3345e61d2 --- /dev/null +++ b/docs/command/atlas-api-thirdPartyIntegrations-createGroupIntegration.txt @@ -0,0 +1,113 @@ +.. _atlas-api-thirdPartyIntegrations-createGroupIntegration: + +======================================================= +atlas api thirdPartyIntegrations createGroupIntegration +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Adds the settings for configuring one third-party service integration. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +These settings apply to all databases managed in the specified MongoDB Cloud project. Each project can have only one configuration per {INTEGRATION-TYPE}. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupintegration. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api thirdPartyIntegrations createGroupIntegration [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupIntegration + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --integrationType + - string + - true + - Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-thirdPartyIntegrations-createThirdPartyIntegration.txt b/docs/command/atlas-api-thirdPartyIntegrations-createThirdPartyIntegration.txt deleted file mode 100644 index b0bdfe85ff..0000000000 --- a/docs/command/atlas-api-thirdPartyIntegrations-createThirdPartyIntegration.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-thirdPartyIntegrations-createThirdPartyIntegration: - -============================================================ -atlas api thirdPartyIntegrations createThirdPartyIntegration -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Adds the settings for configuring one third-party service integration. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -These settings apply to all databases managed in the specified MongoDB Cloud project. Each project can have only one configuration per {INTEGRATION-TYPE}. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createthirdpartyintegration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api thirdPartyIntegrations createThirdPartyIntegration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createThirdPartyIntegration - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --integrationType - - string - - true - - Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-thirdPartyIntegrations-deleteGroupIntegration.txt b/docs/command/atlas-api-thirdPartyIntegrations-deleteGroupIntegration.txt new file mode 100644 index 0000000000..f41143f7ce --- /dev/null +++ b/docs/command/atlas-api-thirdPartyIntegrations-deleteGroupIntegration.txt @@ -0,0 +1,102 @@ +.. _atlas-api-thirdPartyIntegrations-deleteGroupIntegration: + +======================================================= +atlas api thirdPartyIntegrations deleteGroupIntegration +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Removes the settings that permit configuring one third-party service integration. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +These settings apply to all databases managed in one MongoDB Cloud project. If you delete an integration from a project, you remove that integration configuration only for that project. This action doesn't affect any other project or organization's configured {INTEGRATION-TYPE} integrations. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupintegration. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api thirdPartyIntegrations deleteGroupIntegration [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for deleteGroupIntegration + * - --integrationType + - string + - true + - Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-thirdPartyIntegrations-deleteGroupIntegration-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration.txt b/docs/command/atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration.txt deleted file mode 100644 index dd2928cbe9..0000000000 --- a/docs/command/atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration: - -============================================================ -atlas api thirdPartyIntegrations deleteThirdPartyIntegration -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Removes the settings that permit configuring one third-party service integration. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -These settings apply to all databases managed in one MongoDB Cloud project. If you delete an integration from a project, you remove that integration configuration only for that project. This action doesn't affect any other project or organization's configured {INTEGRATION-TYPE} integrations. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletethirdpartyintegration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api thirdPartyIntegrations deleteThirdPartyIntegration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for deleteThirdPartyIntegration - * - --integrationType - - string - - true - - Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-thirdPartyIntegrations-getGroupIntegration.txt b/docs/command/atlas-api-thirdPartyIntegrations-getGroupIntegration.txt new file mode 100644 index 0000000000..0cc54057af --- /dev/null +++ b/docs/command/atlas-api-thirdPartyIntegrations-getGroupIntegration.txt @@ -0,0 +1,102 @@ +.. _atlas-api-thirdPartyIntegrations-getGroupIntegration: + +==================================================== +atlas api thirdPartyIntegrations getGroupIntegration +==================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the settings for configuring integration with one third-party service. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupintegration. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api thirdPartyIntegrations getGroupIntegration [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for getGroupIntegration + * - --integrationType + - string + - true + - Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-thirdPartyIntegrations-getGroupIntegration-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-thirdPartyIntegrations-getThirdPartyIntegration.txt b/docs/command/atlas-api-thirdPartyIntegrations-getThirdPartyIntegration.txt deleted file mode 100644 index 886ece2689..0000000000 --- a/docs/command/atlas-api-thirdPartyIntegrations-getThirdPartyIntegration.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. _atlas-api-thirdPartyIntegrations-getThirdPartyIntegration: - -========================================================= -atlas api thirdPartyIntegrations getThirdPartyIntegration -========================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the settings for configuring integration with one third-party service. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getthirdpartyintegration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api thirdPartyIntegrations getThirdPartyIntegration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for getThirdPartyIntegration - * - --integrationType - - string - - true - - Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-thirdPartyIntegrations-getThirdPartyIntegration-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-thirdPartyIntegrations-listGroupIntegrations.txt b/docs/command/atlas-api-thirdPartyIntegrations-listGroupIntegrations.txt new file mode 100644 index 0000000000..c0ea2ac897 --- /dev/null +++ b/docs/command/atlas-api-thirdPartyIntegrations-listGroupIntegrations.txt @@ -0,0 +1,110 @@ +.. _atlas-api-thirdPartyIntegrations-listGroupIntegrations: + +====================================================== +atlas api thirdPartyIntegrations listGroupIntegrations +====================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns the settings that permit integrations with all configured third-party services. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupintegrations. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api thirdPartyIntegrations listGroupIntegrations [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupIntegrations + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-thirdPartyIntegrations-listGroupIntegrations-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations.txt b/docs/command/atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations.txt deleted file mode 100644 index 36a8ae815b..0000000000 --- a/docs/command/atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations.txt +++ /dev/null @@ -1,110 +0,0 @@ -.. _atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations: - -=========================================================== -atlas api thirdPartyIntegrations listThirdPartyIntegrations -=========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns the settings that permit integrations with all configured third-party services. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listthirdpartyintegrations. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api thirdPartyIntegrations listThirdPartyIntegrations [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listThirdPartyIntegrations - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-thirdPartyIntegrations-updateGroupIntegration.txt b/docs/command/atlas-api-thirdPartyIntegrations-updateGroupIntegration.txt new file mode 100644 index 0000000000..0c2e3affef --- /dev/null +++ b/docs/command/atlas-api-thirdPartyIntegrations-updateGroupIntegration.txt @@ -0,0 +1,113 @@ +.. _atlas-api-thirdPartyIntegrations-updateGroupIntegration: + +======================================================= +atlas api thirdPartyIntegrations updateGroupIntegration +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Updates the settings for configuring integration with one third-party service. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupintegration. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api thirdPartyIntegrations updateGroupIntegration [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for updateGroupIntegration + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --integrationType + - string + - true + - Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-thirdPartyIntegrations-updateThirdPartyIntegration.txt b/docs/command/atlas-api-thirdPartyIntegrations-updateThirdPartyIntegration.txt deleted file mode 100644 index 7f38b63612..0000000000 --- a/docs/command/atlas-api-thirdPartyIntegrations-updateThirdPartyIntegration.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. _atlas-api-thirdPartyIntegrations-updateThirdPartyIntegration: - -============================================================ -atlas api thirdPartyIntegrations updateThirdPartyIntegration -============================================================ - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Updates the settings for configuring integration with one third-party service. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatethirdpartyintegration. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api thirdPartyIntegrations updateThirdPartyIntegration [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for updateThirdPartyIntegration - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --integrationType - - string - - true - - Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-thirdPartyIntegrations.txt b/docs/command/atlas-api-thirdPartyIntegrations.txt index d2971d8f61..636c0bb189 100644 --- a/docs/command/atlas-api-thirdPartyIntegrations.txt +++ b/docs/command/atlas-api-thirdPartyIntegrations.txt @@ -57,19 +57,19 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-thirdPartyIntegrations-createThirdPartyIntegration` - `Public Preview: please provide feedback `_: Adds the settings for configuring one third-party service integration. -* :ref:`atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration` - `Public Preview: please provide feedback `_: Removes the settings that permit configuring one third-party service integration. -* :ref:`atlas-api-thirdPartyIntegrations-getThirdPartyIntegration` - `Public Preview: please provide feedback `_: Returns the settings for configuring integration with one third-party service. -* :ref:`atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations` - `Public Preview: please provide feedback `_: Returns the settings that permit integrations with all configured third-party services. -* :ref:`atlas-api-thirdPartyIntegrations-updateThirdPartyIntegration` - `Public Preview: please provide feedback `_: Updates the settings for configuring integration with one third-party service. +* :ref:`atlas-api-thirdPartyIntegrations-createGroupIntegration` - `Public Preview: please provide feedback `_: Adds the settings for configuring one third-party service integration. +* :ref:`atlas-api-thirdPartyIntegrations-deleteGroupIntegration` - `Public Preview: please provide feedback `_: Removes the settings that permit configuring one third-party service integration. +* :ref:`atlas-api-thirdPartyIntegrations-getGroupIntegration` - `Public Preview: please provide feedback `_: Returns the settings for configuring integration with one third-party service. +* :ref:`atlas-api-thirdPartyIntegrations-listGroupIntegrations` - `Public Preview: please provide feedback `_: Returns the settings that permit integrations with all configured third-party services. +* :ref:`atlas-api-thirdPartyIntegrations-updateGroupIntegration` - `Public Preview: please provide feedback `_: Updates the settings for configuring integration with one third-party service. .. toctree:: :titlesonly: - createThirdPartyIntegration - deleteThirdPartyIntegration - getThirdPartyIntegration - listThirdPartyIntegrations - updateThirdPartyIntegration + createGroupIntegration + deleteGroupIntegration + getGroupIntegration + listGroupIntegrations + updateGroupIntegration diff --git a/docs/command/atlas-api-x509Authentication-createDatabaseUserCertificate.txt b/docs/command/atlas-api-x509Authentication-createDatabaseUserCertificate.txt deleted file mode 100644 index ad9516b8a6..0000000000 --- a/docs/command/atlas-api-x509Authentication-createDatabaseUserCertificate.txt +++ /dev/null @@ -1,107 +0,0 @@ -.. _atlas-api-x509Authentication-createDatabaseUserCertificate: - -========================================================== -atlas api x509Authentication createDatabaseUserCertificate -========================================================== - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Generates one X.509 certificate for the specified MongoDB user. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Atlas manages the certificate and MongoDB user that belong to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -To get MongoDB Cloud to generate a managed certificate for a database user, set "x509Type" : "MANAGED" on the desired MongoDB Database User. - - -If you are managing your own Certificate Authority (CA) in Self-Managed X.509 mode, you must generate certificates for database users using your own CA. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createdatabaseusercertificate. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api x509Authentication createDatabaseUserCertificate [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --file - - string - - false - - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for createDatabaseUserCertificate - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - true - - Human-readable label that represents the MongoDB database user account for whom to create a certificate. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - diff --git a/docs/command/atlas-api-x509Authentication-createGroupDatabaseUserCert.txt b/docs/command/atlas-api-x509Authentication-createGroupDatabaseUserCert.txt new file mode 100644 index 0000000000..638d6fb0b3 --- /dev/null +++ b/docs/command/atlas-api-x509Authentication-createGroupDatabaseUserCert.txt @@ -0,0 +1,107 @@ +.. _atlas-api-x509Authentication-createGroupDatabaseUserCert: + +======================================================== +atlas api x509Authentication createGroupDatabaseUserCert +======================================================== + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Generates one X.509 certificate for the specified MongoDB user. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Atlas manages the certificate and MongoDB user that belong to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + + +To get MongoDB Cloud to generate a managed certificate for a database user, set "x509Type" : "MANAGED" on the desired MongoDB Database User. + + +If you are managing your own Certificate Authority (CA) in Self-Managed X.509 mode, you must generate certificates for database users using your own CA. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupdatabaseusercert. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api x509Authentication createGroupDatabaseUserCert [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --file + - string + - false + - path to your API request file. Leave empty to use standard input instead - you must provide one or the other, but not both. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for createGroupDatabaseUserCert + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - true + - Human-readable label that represents the MongoDB database user account for whom to create a certificate. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + diff --git a/docs/command/atlas-api-x509Authentication-disableCustomerManagedX509.txt b/docs/command/atlas-api-x509Authentication-disableCustomerManagedX509.txt deleted file mode 100644 index bb5656a513..0000000000 --- a/docs/command/atlas-api-x509Authentication-disableCustomerManagedX509.txt +++ /dev/null @@ -1,94 +0,0 @@ -.. _atlas-api-x509Authentication-disableCustomerManagedX509: - -======================================================= -atlas api x509Authentication disableCustomerManagedX509 -======================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Clears the customer-managed X.509 settings on a project, including the uploaded Certificate Authority, which disables self-managed X.509. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -Updating this configuration triggers a rolling restart of the database. You must have the Project Owner role to use this endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablecustomermanagedx509. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api x509Authentication disableCustomerManagedX509 [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for disableCustomerManagedX509 - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-x509Authentication-disableCustomerManagedX509-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509.txt b/docs/command/atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509.txt new file mode 100644 index 0000000000..dd4ddb2153 --- /dev/null +++ b/docs/command/atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509.txt @@ -0,0 +1,94 @@ +.. _atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509: + +================================================================= +atlas api x509Authentication disableGroupUserSecurityCustomerX509 +================================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Clears the customer-managed X.509 settings on a project, including the uploaded Certificate Authority, which disables self-managed X.509. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +Updating this configuration triggers a rolling restart of the database. You must have the Project Owner role to use this endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablegroupusersecuritycustomerx509. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api x509Authentication disableGroupUserSecurityCustomerX509 [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for disableGroupUserSecurityCustomerX509 + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-x509Authentication-listDatabaseUserCertificates.txt b/docs/command/atlas-api-x509Authentication-listDatabaseUserCertificates.txt deleted file mode 100644 index 8450c3c373..0000000000 --- a/docs/command/atlas-api-x509Authentication-listDatabaseUserCertificates.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. _atlas-api-x509Authentication-listDatabaseUserCertificates: - -========================================================= -atlas api x509Authentication listDatabaseUserCertificates -========================================================= - -.. default-domain:: mongodb - -.. contents:: On this page - :local: - :backlinks: none - :depth: 1 - :class: singlecol - -`Public Preview: please provide feedback `_: Returns all unexpired X.509 certificates for the specified MongoDB user. - -The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). -Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. - -This MongoDB user belongs to one project. Atlas manages these certificates and the MongoDB user. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabaseusercertificates. - -For more information and examples, see the referenced API documentation linked above. - -Syntax ------- - -.. code-block:: - :caption: Command Syntax - - atlas api x509Authentication listDatabaseUserCertificates [options] - -.. Code end marker, please don't delete this comment - -Options -------- - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - --envelope - - envelope - - false - - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. - * - --groupId - - string - - true - - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - - **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. - * - -h, --help - - - - false - - help for listDatabaseUserCertificates - * - --includeCount - - - - false - - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. - * - --itemsPerPage - - int - - false - - Number of items that the response returns per page. - * - -o, --output - - string - - false - - preferred api format, can be ["json", go-template] This value defaults to "json". - * - --outputFile - - string - - false - - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) - * - --pageNum - - int - - false - - Number of the page that displays the current set of the total objects that the response returns. - * - --pretty - - - - false - - Flag that indicates whether the response body should be in the prettyprint format. - * - --username - - string - - true - - Human-readable label that represents the MongoDB database user account whose certificates you want to return. - * - --version - - 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". - -Inherited Options ------------------ - -.. list-table:: - :header-rows: 1 - :widths: 20 10 10 60 - - * - Name - - Type - - Required - - Description - * - -P, --profile - - string - - false - - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. - -Examples --------- - -.. literalinclude:: /includes/examples/atlas-api-x509Authentication-listDatabaseUserCertificates-2023-01-01-default.sh - :language: shell diff --git a/docs/command/atlas-api-x509Authentication-listGroupDatabaseUserCerts.txt b/docs/command/atlas-api-x509Authentication-listGroupDatabaseUserCerts.txt new file mode 100644 index 0000000000..393b0e8d5f --- /dev/null +++ b/docs/command/atlas-api-x509Authentication-listGroupDatabaseUserCerts.txt @@ -0,0 +1,114 @@ +.. _atlas-api-x509Authentication-listGroupDatabaseUserCerts: + +======================================================= +atlas api x509Authentication listGroupDatabaseUserCerts +======================================================= + +.. default-domain:: mongodb + +.. contents:: On this page + :local: + :backlinks: none + :depth: 1 + :class: singlecol + +`Public Preview: please provide feedback `_: Returns all unexpired X.509 certificates for the specified MongoDB user. + +The atlas api sub-command, automatically generated from the MongoDB Atlas Admin API, offers full coverage of the Admin API and is currently in Public Preview (please provide feedback at https://feedback.mongodb.com/forums/930808-atlas-cli). +Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link. + +This MongoDB user belongs to one project. Atlas manages these certificates and the MongoDB user. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupdatabaseusercerts. + +For more information and examples, see the referenced API documentation linked above. + +Syntax +------ + +.. code-block:: + :caption: Command Syntax + + atlas api x509Authentication listGroupDatabaseUserCerts [options] + +.. Code end marker, please don't delete this comment + +Options +------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - --envelope + - envelope + - false + - Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + * - --groupId + - string + - true + - Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + * - -h, --help + - + - false + - help for listGroupDatabaseUserCerts + * - --includeCount + - + - false + - Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + * - --itemsPerPage + - int + - false + - Number of items that the response returns per page. + * - -o, --output + - string + - false + - preferred api format, can be ["json", go-template] This value defaults to "json". + * - --outputFile + - string + - false + - file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip) + * - --pageNum + - int + - false + - Number of the page that displays the current set of the total objects that the response returns. + * - --pretty + - + - false + - Flag that indicates whether the response body should be in the prettyprint format. + * - --username + - string + - true + - Human-readable label that represents the MongoDB database user account whose certificates you want to return. + * - --version + - 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". + +Inherited Options +----------------- + +.. list-table:: + :header-rows: 1 + :widths: 20 10 10 60 + + * - Name + - Type + - Required + - Description + * - -P, --profile + - string + - false + - Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. + +Examples +-------- + +.. literalinclude:: /includes/examples/atlas-api-x509Authentication-listGroupDatabaseUserCerts-2023-01-01-default.sh + :language: shell diff --git a/docs/command/atlas-api-x509Authentication.txt b/docs/command/atlas-api-x509Authentication.txt index a18b96f914..8b5cbbb47f 100644 --- a/docs/command/atlas-api-x509Authentication.txt +++ b/docs/command/atlas-api-x509Authentication.txt @@ -54,15 +54,15 @@ Inherited Options Related Commands ---------------- -* :ref:`atlas-api-x509Authentication-createDatabaseUserCertificate` - `Public Preview: please provide feedback `_: Generates one X.509 certificate for the specified MongoDB user. -* :ref:`atlas-api-x509Authentication-disableCustomerManagedX509` - `Public Preview: please provide feedback `_: Clears the customer-managed X.509 settings on a project, including the uploaded Certificate Authority, which disables self-managed X.509. -* :ref:`atlas-api-x509Authentication-listDatabaseUserCertificates` - `Public Preview: please provide feedback `_: Returns all unexpired X.509 certificates for the specified MongoDB user. +* :ref:`atlas-api-x509Authentication-createGroupDatabaseUserCert` - `Public Preview: please provide feedback `_: Generates one X.509 certificate for the specified MongoDB user. +* :ref:`atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509` - `Public Preview: please provide feedback `_: Clears the customer-managed X.509 settings on a project, including the uploaded Certificate Authority, which disables self-managed X.509. +* :ref:`atlas-api-x509Authentication-listGroupDatabaseUserCerts` - `Public Preview: please provide feedback `_: Returns all unexpired X.509 certificates for the specified MongoDB user. .. toctree:: :titlesonly: - createDatabaseUserCertificate - disableCustomerManagedX509 - listDatabaseUserCertificates + createGroupDatabaseUserCert + disableGroupUserSecurityCustomerX509 + listGroupDatabaseUserCerts diff --git a/docs/command/includes/atlas-api-accessTracking-getGroupDbAccessHistoryCluster-2023-01-01-default.sh b/docs/command/includes/atlas-api-accessTracking-getGroupDbAccessHistoryCluster-2023-01-01-default.sh new file mode 100644 index 0000000000..e8f093ead7 --- /dev/null +++ b/docs/command/includes/atlas-api-accessTracking-getGroupDbAccessHistoryCluster-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api accessTracking getGroupDbAccessHistoryCluster --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-accessTracking-getGroupDbAccessHistoryProcess-2023-01-01-default.sh b/docs/command/includes/atlas-api-accessTracking-getGroupDbAccessHistoryProcess-2023-01-01-default.sh new file mode 100644 index 0000000000..d998903454 --- /dev/null +++ b/docs/command/includes/atlas-api-accessTracking-getGroupDbAccessHistoryProcess-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api accessTracking getGroupDbAccessHistoryProcess --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --hostname [hostname] diff --git a/docs/command/includes/atlas-api-accessTracking-listAccessLogsByClusterName-2023-01-01-default.sh b/docs/command/includes/atlas-api-accessTracking-listAccessLogsByClusterName-2023-01-01-default.sh deleted file mode 100644 index 3512d4ada9..0000000000 --- a/docs/command/includes/atlas-api-accessTracking-listAccessLogsByClusterName-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api accessTracking listAccessLogsByClusterName --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-accessTracking-listAccessLogsByHostname-2023-01-01-default.sh b/docs/command/includes/atlas-api-accessTracking-listAccessLogsByHostname-2023-01-01-default.sh deleted file mode 100644 index 4a910d31fb..0000000000 --- a/docs/command/includes/atlas-api-accessTracking-listAccessLogsByHostname-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api accessTracking listAccessLogsByHostname --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --hostname [hostname] diff --git a/docs/command/includes/atlas-api-alertConfigurations-deleteAlertConfiguration-2023-01-01-default.sh b/docs/command/includes/atlas-api-alertConfigurations-deleteAlertConfiguration-2023-01-01-default.sh deleted file mode 100644 index a7ccc46ba0..0000000000 --- a/docs/command/includes/atlas-api-alertConfigurations-deleteAlertConfiguration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api alertConfigurations deleteAlertConfiguration --version 2023-01-01 --alertConfigId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alertConfigurations-deleteGroupAlertConfig-2023-01-01-default.sh b/docs/command/includes/atlas-api-alertConfigurations-deleteGroupAlertConfig-2023-01-01-default.sh new file mode 100644 index 0000000000..00927c6bb5 --- /dev/null +++ b/docs/command/includes/atlas-api-alertConfigurations-deleteGroupAlertConfig-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api alertConfigurations deleteGroupAlertConfig --version 2023-01-01 --alertConfigId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alertConfigurations-getAlertConfiguration-2023-01-01-default.sh b/docs/command/includes/atlas-api-alertConfigurations-getAlertConfiguration-2023-01-01-default.sh deleted file mode 100644 index 5cd5da2fd8..0000000000 --- a/docs/command/includes/atlas-api-alertConfigurations-getAlertConfiguration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api alertConfigurations getAlertConfiguration --version 2023-01-01 --alertConfigId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alertConfigurations-getGroupAlertAlertConfigs-2023-01-01-default.sh b/docs/command/includes/atlas-api-alertConfigurations-getGroupAlertAlertConfigs-2023-01-01-default.sh new file mode 100644 index 0000000000..04e96d26a4 --- /dev/null +++ b/docs/command/includes/atlas-api-alertConfigurations-getGroupAlertAlertConfigs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api alertConfigurations getGroupAlertAlertConfigs --version 2023-01-01 --alertId [alertId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alertConfigurations-getGroupAlertConfig-2023-01-01-default.sh b/docs/command/includes/atlas-api-alertConfigurations-getGroupAlertConfig-2023-01-01-default.sh new file mode 100644 index 0000000000..1d3088a22f --- /dev/null +++ b/docs/command/includes/atlas-api-alertConfigurations-getGroupAlertConfig-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api alertConfigurations getGroupAlertConfig --version 2023-01-01 --alertConfigId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alertConfigurations-listAlertConfigurations-2023-01-01-default.sh b/docs/command/includes/atlas-api-alertConfigurations-listAlertConfigurations-2023-01-01-default.sh deleted file mode 100644 index 69254d3ec0..0000000000 --- a/docs/command/includes/atlas-api-alertConfigurations-listAlertConfigurations-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api alertConfigurations listAlertConfigurations --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alertConfigurations-listAlertConfigurationsByAlertId-2023-01-01-default.sh b/docs/command/includes/atlas-api-alertConfigurations-listAlertConfigurationsByAlertId-2023-01-01-default.sh deleted file mode 100644 index 3be8a762b6..0000000000 --- a/docs/command/includes/atlas-api-alertConfigurations-listAlertConfigurationsByAlertId-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api alertConfigurations listAlertConfigurationsByAlertId --version 2023-01-01 --alertId [alertId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alertConfigurations-listGroupAlertConfigs-2023-01-01-default.sh b/docs/command/includes/atlas-api-alertConfigurations-listGroupAlertConfigs-2023-01-01-default.sh new file mode 100644 index 0000000000..2f01333473 --- /dev/null +++ b/docs/command/includes/atlas-api-alertConfigurations-listGroupAlertConfigs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api alertConfigurations listGroupAlertConfigs --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alerts-getAlert-2023-01-01-default.sh b/docs/command/includes/atlas-api-alerts-getAlert-2023-01-01-default.sh deleted file mode 100644 index c32fdc70ed..0000000000 --- a/docs/command/includes/atlas-api-alerts-getAlert-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api alerts getAlert --version 2023-01-01 --alertId [alertId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alerts-getGroupAlert-2023-01-01-default.sh b/docs/command/includes/atlas-api-alerts-getGroupAlert-2023-01-01-default.sh new file mode 100644 index 0000000000..318797411d --- /dev/null +++ b/docs/command/includes/atlas-api-alerts-getGroupAlert-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api alerts getGroupAlert --version 2023-01-01 --alertId [alertId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alerts-getGroupAlertConfigAlerts-2023-01-01-default.sh b/docs/command/includes/atlas-api-alerts-getGroupAlertConfigAlerts-2023-01-01-default.sh new file mode 100644 index 0000000000..e7a7a63560 --- /dev/null +++ b/docs/command/includes/atlas-api-alerts-getGroupAlertConfigAlerts-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api alerts getGroupAlertConfigAlerts --version 2023-01-01 --alertConfigId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alerts-listAlerts-2023-01-01-default.sh b/docs/command/includes/atlas-api-alerts-listAlerts-2023-01-01-default.sh deleted file mode 100644 index 6c2be4f3cc..0000000000 --- a/docs/command/includes/atlas-api-alerts-listAlerts-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api alerts listAlerts --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alerts-listAlertsByAlertConfigurationId-2023-01-01-default.sh b/docs/command/includes/atlas-api-alerts-listAlertsByAlertConfigurationId-2023-01-01-default.sh deleted file mode 100644 index de2cea655c..0000000000 --- a/docs/command/includes/atlas-api-alerts-listAlertsByAlertConfigurationId-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api alerts listAlertsByAlertConfigurationId --version 2023-01-01 --alertConfigId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-alerts-listGroupAlerts-2023-01-01-default.sh b/docs/command/includes/atlas-api-alerts-listGroupAlerts-2023-01-01-default.sh new file mode 100644 index 0000000000..ede048276e --- /dev/null +++ b/docs/command/includes/atlas-api-alerts-listGroupAlerts-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api alerts listGroupAlerts --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchDeployment-2023-01-01-default.sh b/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchDeployment-2023-01-01-default.sh deleted file mode 100644 index da761a6630..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchDeployment-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch deleteAtlasSearchDeployment --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndex-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndex-2024-05-30-default.sh deleted file mode 100644 index bb3303d50f..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndex-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch deleteAtlasSearchIndex --version 2024-05-30 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --indexId [indexId] diff --git a/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndexByName-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndexByName-2024-05-30-default.sh deleted file mode 100644 index 588d891148..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndexByName-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch deleteAtlasSearchIndexByName --version 2024-05-30 --clusterName [clusterName] --collectionName [collectionName] --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --indexName [indexName] diff --git a/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated-2023-01-01-default.sh b/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated-2023-01-01-default.sh deleted file mode 100644 index d365f85f13..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch deleteAtlasSearchIndexDeprecated --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --indexId [indexId] diff --git a/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterFtsIndex-2023-01-01-default.sh b/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterFtsIndex-2023-01-01-default.sh new file mode 100644 index 0000000000..7bc42cbd09 --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterFtsIndex-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch deleteGroupClusterFtsIndex --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --indexId [indexId] diff --git a/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchDeployment-2023-01-01-default.sh b/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchDeployment-2023-01-01-default.sh new file mode 100644 index 0000000000..78fdf1be7f --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchDeployment-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch deleteGroupClusterSearchDeployment --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchIndex-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchIndex-2024-05-30-default.sh new file mode 100644 index 0000000000..eab29c4b7e --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchIndex-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch deleteGroupClusterSearchIndex --version 2024-05-30 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --indexId [indexId] diff --git a/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName-2024-05-30-default.sh new file mode 100644 index 0000000000..bf9c9ed088 --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch deleteGroupClusterSearchIndexByName --version 2024-05-30 --clusterName [clusterName] --collectionName [collectionName] --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --indexName [indexName] diff --git a/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchDeployment-2025-03-12-default.sh b/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchDeployment-2025-03-12-default.sh deleted file mode 100644 index 353a87d4e4..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchDeployment-2025-03-12-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch getAtlasSearchDeployment --version 2025-03-12 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndex-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndex-2024-05-30-default.sh deleted file mode 100644 index 62e1582b68..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndex-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch getAtlasSearchIndex --version 2024-05-30 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --indexId [indexId] diff --git a/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndexByName-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndexByName-2024-05-30-default.sh deleted file mode 100644 index 865790e1e8..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndexByName-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch getAtlasSearchIndexByName --version 2024-05-30 --clusterName [clusterName] --collectionName [collectionName] --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --indexName [indexName] diff --git a/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndexDeprecated-2023-01-01-default.sh b/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndexDeprecated-2023-01-01-default.sh deleted file mode 100644 index 00e5f28464..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-getAtlasSearchIndexDeprecated-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch getAtlasSearchIndexDeprecated --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --indexId [indexId] diff --git a/docs/command/includes/atlas-api-atlasSearch-getGroupClusterFtsIndex-2023-01-01-default.sh b/docs/command/includes/atlas-api-atlasSearch-getGroupClusterFtsIndex-2023-01-01-default.sh new file mode 100644 index 0000000000..6380c304b2 --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-getGroupClusterFtsIndex-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch getGroupClusterFtsIndex --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --indexId [indexId] diff --git a/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchDeployment-2025-03-12-default.sh b/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchDeployment-2025-03-12-default.sh new file mode 100644 index 0000000000..6fe118293b --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchDeployment-2025-03-12-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch getGroupClusterSearchDeployment --version 2025-03-12 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchIndex-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchIndex-2024-05-30-default.sh new file mode 100644 index 0000000000..e5ddd47ed0 --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchIndex-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch getGroupClusterSearchIndex --version 2024-05-30 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --indexId [indexId] diff --git a/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchIndexByName-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchIndexByName-2024-05-30-default.sh new file mode 100644 index 0000000000..029319e7f6 --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-getGroupClusterSearchIndexByName-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch getGroupClusterSearchIndexByName --version 2024-05-30 --clusterName [clusterName] --collectionName [collectionName] --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --indexName [indexName] diff --git a/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexes-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexes-2024-05-30-default.sh deleted file mode 100644 index ea2ded5e2e..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexes-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch listAtlasSearchIndexes --version 2024-05-30 --clusterName [clusterName] --collectionName [collectionName] --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexesCluster-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexesCluster-2024-05-30-default.sh deleted file mode 100644 index bfff0921f3..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexesCluster-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch listAtlasSearchIndexesCluster --version 2024-05-30 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated-2023-01-01-default.sh b/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated-2023-01-01-default.sh deleted file mode 100644 index 9b86b797c0..0000000000 --- a/docs/command/includes/atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api atlasSearch listAtlasSearchIndexesDeprecated --version 2023-01-01 --clusterName [clusterName] --collectionName [collectionName] --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-listGroupClusterFtsIndex-2023-01-01-default.sh b/docs/command/includes/atlas-api-atlasSearch-listGroupClusterFtsIndex-2023-01-01-default.sh new file mode 100644 index 0000000000..9e39aa8b68 --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-listGroupClusterFtsIndex-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch listGroupClusterFtsIndex --version 2023-01-01 --clusterName [clusterName] --collectionName [collectionName] --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-listGroupClusterSearchIndex-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-listGroupClusterSearchIndex-2024-05-30-default.sh new file mode 100644 index 0000000000..539ef41c2d --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-listGroupClusterSearchIndex-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch listGroupClusterSearchIndex --version 2024-05-30 --clusterName [clusterName] --collectionName [collectionName] --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-atlasSearch-listGroupClusterSearchIndexes-2024-05-30-default.sh b/docs/command/includes/atlas-api-atlasSearch-listGroupClusterSearchIndexes-2024-05-30-default.sh new file mode 100644 index 0000000000..1f3ddb16c4 --- /dev/null +++ b/docs/command/includes/atlas-api-atlasSearch-listGroupClusterSearchIndexes-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api atlasSearch listGroupClusterSearchIndexes --version 2024-05-30 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-auditing-getAuditingConfiguration-2023-01-01-default.sh b/docs/command/includes/atlas-api-auditing-getAuditingConfiguration-2023-01-01-default.sh deleted file mode 100644 index bcc49321df..0000000000 --- a/docs/command/includes/atlas-api-auditing-getAuditingConfiguration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api auditing getAuditingConfiguration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-auditing-getGroupAuditLog-2023-01-01-default.sh b/docs/command/includes/atlas-api-auditing-getGroupAuditLog-2023-01-01-default.sh new file mode 100644 index 0000000000..2786b4f639 --- /dev/null +++ b/docs/command/includes/atlas-api-auditing-getGroupAuditLog-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api auditing getGroupAuditLog --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-awsClustersDns-getAwsCustomDns-2023-01-01-default.sh b/docs/command/includes/atlas-api-awsClustersDns-getAwsCustomDns-2023-01-01-default.sh deleted file mode 100644 index d4c6393be9..0000000000 --- a/docs/command/includes/atlas-api-awsClustersDns-getAwsCustomDns-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api awsClustersDns getAwsCustomDns --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-awsClustersDns-getGroupAwsCustomDns-2023-01-01-default.sh b/docs/command/includes/atlas-api-awsClustersDns-getGroupAwsCustomDns-2023-01-01-default.sh new file mode 100644 index 0000000000..4e2722ede5 --- /dev/null +++ b/docs/command/includes/atlas-api-awsClustersDns-getGroupAwsCustomDns-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api awsClustersDns getGroupAwsCustomDns --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-cancelBackupRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-cancelBackupRestoreJob-2023-01-01-default.sh deleted file mode 100644 index b20af3e7fb..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-cancelBackupRestoreJob-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups cancelBackupRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --restoreJobId [restoreJobId] diff --git a/docs/command/includes/atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob-2023-01-01-default.sh new file mode 100644 index 0000000000..68996c38ac --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups cancelGroupClusterBackupRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --restoreJobId [restoreJobId] diff --git a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2023-01-01-aws-payload.json b/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2023-01-01-aws-payload.json deleted file mode 100644 index 7358709a64..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2023-01-01-aws-payload.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "bucketName": "export-bucket", - "cloudProvider": "AWS", - "iamRoleId": "668c5f0ed436263134491592" -} \ No newline at end of file diff --git a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2023-01-01-aws.sh b/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2023-01-01-aws.sh deleted file mode 100644 index 8ab4ab0bfb..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2023-01-01-aws.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups createExportBucket --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-aws-payload.json b/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-aws-payload.json deleted file mode 100644 index 7358709a64..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-aws-payload.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "bucketName": "export-bucket", - "cloudProvider": "AWS", - "iamRoleId": "668c5f0ed436263134491592" -} \ No newline at end of file diff --git a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-aws.sh b/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-aws.sh deleted file mode 100644 index 89dcb89186..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-aws.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups createExportBucket --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-azure.sh b/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-azure.sh deleted file mode 100644 index 89dcb89186..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-azure.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups createExportBucket --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-gcp.sh b/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-gcp.sh deleted file mode 100644 index 89dcb89186..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-gcp.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups createExportBucket --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2023-01-01-aws-payload.json b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2023-01-01-aws-payload.json new file mode 100644 index 0000000000..83a2374518 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2023-01-01-aws-payload.json @@ -0,0 +1,6 @@ +{ + "bucketName": "export-bucket", + "cloudProvider": "AWS", + "iamRoleId": "668c5f0ed436263134491592", + "requirePrivateNetworking": false +} \ No newline at end of file diff --git a/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2023-01-01-aws.sh b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2023-01-01-aws.sh new file mode 100644 index 0000000000..d0cd0c36a2 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2023-01-01-aws.sh @@ -0,0 +1 @@ +atlas api cloudBackups createGroupBackupExportBucket --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-aws-payload.json b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-aws-payload.json new file mode 100644 index 0000000000..83a2374518 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-aws-payload.json @@ -0,0 +1,6 @@ +{ + "bucketName": "export-bucket", + "cloudProvider": "AWS", + "iamRoleId": "668c5f0ed436263134491592", + "requirePrivateNetworking": false +} \ No newline at end of file diff --git a/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-aws.sh b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-aws.sh new file mode 100644 index 0000000000..954e45226a --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-aws.sh @@ -0,0 +1 @@ +atlas api cloudBackups createGroupBackupExportBucket --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-azure-payload.json b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-azure-payload.json similarity index 100% rename from docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-azure-payload.json rename to docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-azure-payload.json diff --git a/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-azure.sh b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-azure.sh new file mode 100644 index 0000000000..954e45226a --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-azure.sh @@ -0,0 +1 @@ +atlas api cloudBackups createGroupBackupExportBucket --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-gcp-payload.json b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-gcp-payload.json similarity index 100% rename from docs/command/includes/atlas-api-cloudBackups-createExportBucket-2024-05-30-gcp-payload.json rename to docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-gcp-payload.json diff --git a/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-gcp.sh b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-gcp.sh new file mode 100644 index 0000000000..954e45226a --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-createGroupBackupExportBucket-2024-05-30-gcp.sh @@ -0,0 +1 @@ +atlas api cloudBackups createGroupBackupExportBucket --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-deleteAllBackupSchedules-2024-08-05-default.sh b/docs/command/includes/atlas-api-cloudBackups-deleteAllBackupSchedules-2024-08-05-default.sh deleted file mode 100644 index 6ce7c966e9..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-deleteAllBackupSchedules-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups deleteAllBackupSchedules --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-deleteExportBucket-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-deleteExportBucket-2023-01-01-default.sh deleted file mode 100644 index c3e0ecc0b2..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-deleteExportBucket-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups deleteExportBucket --version 2023-01-01 --exportBucketId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-deleteGroupBackupExportBucket-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-deleteGroupBackupExportBucket-2023-01-01-default.sh new file mode 100644 index 0000000000..648f0006b2 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-deleteGroupBackupExportBucket-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups deleteGroupBackupExportBucket --version 2023-01-01 --exportBucketId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSchedule-2024-08-05-default.sh b/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSchedule-2024-08-05-default.sh new file mode 100644 index 0000000000..1b8632faff --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSchedule-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups deleteGroupClusterBackupSchedule --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot-2023-01-01-default.sh new file mode 100644 index 0000000000..903a7251ae --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups deleteGroupClusterBackupSnapshot --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster-2023-01-01-default.sh new file mode 100644 index 0000000000..c3550df8b0 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups deleteGroupClusterBackupSnapshotShardedCluster --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-cloudBackups-deleteReplicaSetBackup-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-deleteReplicaSetBackup-2023-01-01-default.sh deleted file mode 100644 index 4ab342a64e..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-deleteReplicaSetBackup-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups deleteReplicaSetBackup --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-cloudBackups-deleteShardedClusterBackup-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-deleteShardedClusterBackup-2023-01-01-default.sh deleted file mode 100644 index 42dff83fc7..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-deleteShardedClusterBackup-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups deleteShardedClusterBackup --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-cloudBackups-disableDataProtectionSettings-2024-11-13-default.sh b/docs/command/includes/atlas-api-cloudBackups-disableDataProtectionSettings-2024-11-13-default.sh deleted file mode 100644 index ca0da10a0d..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-disableDataProtectionSettings-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups disableDataProtectionSettings --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-disableGroupBackupCompliancePolicy-2024-11-13-default.sh b/docs/command/includes/atlas-api-cloudBackups-disableGroupBackupCompliancePolicy-2024-11-13-default.sh new file mode 100644 index 0000000000..ae6fc39975 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-disableGroupBackupCompliancePolicy-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups disableGroupBackupCompliancePolicy --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getBackupExportJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getBackupExportJob-2023-01-01-default.sh deleted file mode 100644 index 594572b6e6..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getBackupExportJob-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getBackupExportJob --version 2023-01-01 --clusterName [clusterName] --exportId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getBackupRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getBackupRestoreJob-2023-01-01-default.sh deleted file mode 100644 index 0e58b7084b..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getBackupRestoreJob-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getBackupRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --restoreJobId [restoreJobId] diff --git a/docs/command/includes/atlas-api-cloudBackups-getBackupSchedule-2024-08-05-default.sh b/docs/command/includes/atlas-api-cloudBackups-getBackupSchedule-2024-08-05-default.sh deleted file mode 100644 index 45ec907f2f..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getBackupSchedule-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getBackupSchedule --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getDataProtectionSettings-2023-10-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getDataProtectionSettings-2023-10-01-default.sh deleted file mode 100644 index 1b9396c64c..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getDataProtectionSettings-2023-10-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getDataProtectionSettings --version 2023-10-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getExportBucket-2024-05-30-default.sh b/docs/command/includes/atlas-api-cloudBackups-getExportBucket-2024-05-30-default.sh deleted file mode 100644 index f6237e2d25..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getExportBucket-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getExportBucket --version 2024-05-30 --exportBucketId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupBackupCompliancePolicy-2023-10-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupBackupCompliancePolicy-2023-10-01-default.sh new file mode 100644 index 0000000000..9bfd441817 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupBackupCompliancePolicy-2023-10-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupBackupCompliancePolicy --version 2023-10-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupBackupExportBucket-2024-05-30-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupBackupExportBucket-2024-05-30-default.sh new file mode 100644 index 0000000000..6ceaae365b --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupBackupExportBucket-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupBackupExportBucket --version 2024-05-30 --exportBucketId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupExport-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupExport-2023-01-01-default.sh new file mode 100644 index 0000000000..698f0b59f5 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupExport-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupClusterBackupExport --version 2023-01-01 --clusterName [clusterName] --exportId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupRestoreJob-2023-01-01-default.sh new file mode 100644 index 0000000000..22cf33432f --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupRestoreJob-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupClusterBackupRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --restoreJobId [restoreJobId] diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSchedule-2024-08-05-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSchedule-2024-08-05-default.sh new file mode 100644 index 0000000000..dca0b8b586 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSchedule-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupClusterBackupSchedule --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSnapshot-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSnapshot-2023-01-01-default.sh new file mode 100644 index 0000000000..bf55f9c402 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSnapshot-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupClusterBackupSnapshot --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster-2023-01-01-default.sh new file mode 100644 index 0000000000..aabcd7fb25 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupClusterBackupSnapshotShardedCluster --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob-2023-01-01-default.sh new file mode 100644 index 0000000000..2fac72fa9e --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupServerlessBackupRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --restoreJobId [restoreJobId] diff --git a/docs/command/includes/atlas-api-cloudBackups-getGroupServerlessBackupSnapshot-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getGroupServerlessBackupSnapshot-2023-01-01-default.sh new file mode 100644 index 0000000000..f644eae5e5 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-getGroupServerlessBackupSnapshot-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups getGroupServerlessBackupSnapshot --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getReplicaSetBackup-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getReplicaSetBackup-2023-01-01-default.sh deleted file mode 100644 index f0d491e81d..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getReplicaSetBackup-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getReplicaSetBackup --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-cloudBackups-getServerlessBackup-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getServerlessBackup-2023-01-01-default.sh deleted file mode 100644 index 82ae132b87..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getServerlessBackup-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getServerlessBackup --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-getServerlessBackupRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getServerlessBackupRestoreJob-2023-01-01-default.sh deleted file mode 100644 index 2cdf49fec1..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getServerlessBackupRestoreJob-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getServerlessBackupRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --restoreJobId [restoreJobId] diff --git a/docs/command/includes/atlas-api-cloudBackups-getShardedClusterBackup-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-getShardedClusterBackup-2023-01-01-default.sh deleted file mode 100644 index 0e3ba8d441..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-getShardedClusterBackup-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups getShardedClusterBackup --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-cloudBackups-listBackupExportJobs-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listBackupExportJobs-2023-01-01-default.sh deleted file mode 100644 index dd03c9c1c3..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-listBackupExportJobs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups listBackupExportJobs --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listBackupRestoreJobs-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listBackupRestoreJobs-2023-01-01-default.sh deleted file mode 100644 index c5112cbcdb..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-listBackupRestoreJobs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups listBackupRestoreJobs --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listExportBuckets-2024-05-30-default.sh b/docs/command/includes/atlas-api-cloudBackups-listExportBuckets-2024-05-30-default.sh deleted file mode 100644 index aba38fbaf8..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-listExportBuckets-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups listExportBuckets --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listGroupBackupExportBuckets-2024-05-30-default.sh b/docs/command/includes/atlas-api-cloudBackups-listGroupBackupExportBuckets-2024-05-30-default.sh new file mode 100644 index 0000000000..3ffe707465 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-listGroupBackupExportBuckets-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups listGroupBackupExportBuckets --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupExports-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupExports-2023-01-01-default.sh new file mode 100644 index 0000000000..990445f326 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupExports-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups listGroupClusterBackupExports --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs-2023-01-01-default.sh new file mode 100644 index 0000000000..74d378aaba --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups listGroupClusterBackupRestoreJobs --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters-2023-01-01-default.sh new file mode 100644 index 0000000000..83d2e438ee --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups listGroupClusterBackupSnapshotShardedClusters --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupSnapshots-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupSnapshots-2023-01-01-default.sh new file mode 100644 index 0000000000..388085c90f --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-listGroupClusterBackupSnapshots-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups listGroupClusterBackupSnapshots --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs-2023-01-01-default.sh new file mode 100644 index 0000000000..997c942397 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups listGroupServerlessBackupRestoreJobs --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listGroupServerlessBackupSnapshots-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listGroupServerlessBackupSnapshots-2023-01-01-default.sh new file mode 100644 index 0000000000..8d2d40365f --- /dev/null +++ b/docs/command/includes/atlas-api-cloudBackups-listGroupServerlessBackupSnapshots-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudBackups listGroupServerlessBackupSnapshots --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listReplicaSetBackups-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listReplicaSetBackups-2023-01-01-default.sh deleted file mode 100644 index 1a1177287b..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-listReplicaSetBackups-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups listReplicaSetBackups --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listServerlessBackupRestoreJobs-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listServerlessBackupRestoreJobs-2023-01-01-default.sh deleted file mode 100644 index e2571d446f..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-listServerlessBackupRestoreJobs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups listServerlessBackupRestoreJobs --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listServerlessBackups-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listServerlessBackups-2023-01-01-default.sh deleted file mode 100644 index efba1f6be0..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-listServerlessBackups-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups listServerlessBackups --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudBackups-listShardedClusterBackups-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudBackups-listShardedClusterBackups-2023-01-01-default.sh deleted file mode 100644 index 536949088e..0000000000 --- a/docs/command/includes/atlas-api-cloudBackups-listShardedClusterBackups-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudBackups listShardedClusterBackups --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-cutoverGroupLiveMigration-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-cutoverGroupLiveMigration-2023-01-01-default.sh new file mode 100644 index 0000000000..92960209d3 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudMigrationService-cutoverGroupLiveMigration-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudMigrationService cutoverGroupLiveMigration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --liveMigrationId 6296fb4c7c7aa997cf94e9a8 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-cutoverMigration-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-cutoverMigration-2023-01-01-default.sh deleted file mode 100644 index 0b25c11ec8..0000000000 --- a/docs/command/includes/atlas-api-cloudMigrationService-cutoverMigration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudMigrationService cutoverMigration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --liveMigrationId 6296fb4c7c7aa997cf94e9a8 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-deleteLinkToken-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-deleteLinkToken-2023-01-01-default.sh deleted file mode 100644 index b32edcced8..0000000000 --- a/docs/command/includes/atlas-api-cloudMigrationService-deleteLinkToken-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudMigrationService deleteLinkToken --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens-2023-01-01-default.sh new file mode 100644 index 0000000000..7b34ec76b6 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudMigrationService deleteOrgLiveMigrationLinkTokens --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-getGroupLiveMigration-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-getGroupLiveMigration-2023-01-01-default.sh new file mode 100644 index 0000000000..36850e5825 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudMigrationService-getGroupLiveMigration-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudMigrationService getGroupLiveMigration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --liveMigrationId 6296fb4c7c7aa997cf94e9a8 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus-2023-01-01-default.sh new file mode 100644 index 0000000000..99cbf172ba --- /dev/null +++ b/docs/command/includes/atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudMigrationService getGroupLiveMigrationValidateStatus --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --validationId 507f1f77bcf86cd799439011 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-getPushMigration-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-getPushMigration-2023-01-01-default.sh deleted file mode 100644 index a3e571346f..0000000000 --- a/docs/command/includes/atlas-api-cloudMigrationService-getPushMigration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudMigrationService getPushMigration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --liveMigrationId 6296fb4c7c7aa997cf94e9a8 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-getValidationStatus-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-getValidationStatus-2023-01-01-default.sh deleted file mode 100644 index 2b3d55712e..0000000000 --- a/docs/command/includes/atlas-api-cloudMigrationService-getValidationStatus-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudMigrationService getValidationStatus --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --validationId 507f1f77bcf86cd799439011 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects-2023-01-01-default.sh new file mode 100644 index 0000000000..e6914e8492 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudMigrationService listOrgLiveMigrationAvailableProjects --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-cloudMigrationService-listSourceProjects-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudMigrationService-listSourceProjects-2023-01-01-default.sh deleted file mode 100644 index 0965f4035f..0000000000 --- a/docs/command/includes/atlas-api-cloudMigrationService-listSourceProjects-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudMigrationService listSourceProjects --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole-2023-01-01-default.sh deleted file mode 100644 index 14ffe6e499..0000000000 --- a/docs/command/includes/atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudProviderAccess deauthorizeCloudProviderAccessRole --version 2023-01-01 --cloudProvider [cloudProvider] --groupId 32b6e34b3d91647abb20e7b8 --roleId [roleId] diff --git a/docs/command/includes/atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole-2023-01-01-default.sh new file mode 100644 index 0000000000..934d67f30a --- /dev/null +++ b/docs/command/includes/atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudProviderAccess deauthorizeGroupCloudProviderAccessRole --version 2023-01-01 --cloudProvider [cloudProvider] --groupId 32b6e34b3d91647abb20e7b8 --roleId [roleId] diff --git a/docs/command/includes/atlas-api-cloudProviderAccess-getCloudProviderAccessRole-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudProviderAccess-getCloudProviderAccessRole-2023-01-01-default.sh deleted file mode 100644 index b781602b3f..0000000000 --- a/docs/command/includes/atlas-api-cloudProviderAccess-getCloudProviderAccessRole-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudProviderAccess getCloudProviderAccessRole --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --roleId [roleId] diff --git a/docs/command/includes/atlas-api-cloudProviderAccess-getGroupCloudProviderAccess-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudProviderAccess-getGroupCloudProviderAccess-2023-01-01-default.sh new file mode 100644 index 0000000000..3facb63f71 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudProviderAccess-getGroupCloudProviderAccess-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudProviderAccess getGroupCloudProviderAccess --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --roleId [roleId] diff --git a/docs/command/includes/atlas-api-cloudProviderAccess-listCloudProviderAccessRoles-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudProviderAccess-listCloudProviderAccessRoles-2023-01-01-default.sh deleted file mode 100644 index ff793afded..0000000000 --- a/docs/command/includes/atlas-api-cloudProviderAccess-listCloudProviderAccessRoles-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api cloudProviderAccess listCloudProviderAccessRoles --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-cloudProviderAccess-listGroupCloudProviderAccess-2023-01-01-default.sh b/docs/command/includes/atlas-api-cloudProviderAccess-listGroupCloudProviderAccess-2023-01-01-default.sh new file mode 100644 index 0000000000..302d0997c7 --- /dev/null +++ b/docs/command/includes/atlas-api-cloudProviderAccess-listGroupCloudProviderAccess-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api cloudProviderAccess listGroupCloudProviderAccess --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation-2023-01-01-default.sh new file mode 100644 index 0000000000..1faa169246 --- /dev/null +++ b/docs/command/includes/atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api clusterOutageSimulation endGroupClusterOutageSimulation --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusterOutageSimulation-endOutageSimulation-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusterOutageSimulation-endOutageSimulation-2023-01-01-default.sh deleted file mode 100644 index 16fb544fc8..0000000000 --- a/docs/command/includes/atlas-api-clusterOutageSimulation-endOutageSimulation-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusterOutageSimulation endOutageSimulation --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation-2023-01-01-default.sh new file mode 100644 index 0000000000..a168c26afa --- /dev/null +++ b/docs/command/includes/atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api clusterOutageSimulation getGroupClusterOutageSimulation --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusterOutageSimulation-getOutageSimulation-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusterOutageSimulation-getOutageSimulation-2023-01-01-default.sh deleted file mode 100644 index 2bf3e43484..0000000000 --- a/docs/command/includes/atlas-api-clusterOutageSimulation-getOutageSimulation-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusterOutageSimulation getOutageSimulation --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-autoGroupClusterScalingConfiguration-2024-08-05-default.sh b/docs/command/includes/atlas-api-clusters-autoGroupClusterScalingConfiguration-2024-08-05-default.sh new file mode 100644 index 0000000000..8a48ddc979 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-autoGroupClusterScalingConfiguration-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api clusters autoGroupClusterScalingConfiguration --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-autoScalingConfiguration-2024-08-05-default.sh b/docs/command/includes/atlas-api-clusters-autoScalingConfiguration-2024-08-05-default.sh deleted file mode 100644 index 344d8d07ed..0000000000 --- a/docs/command/includes/atlas-api-clusters-autoScalingConfiguration-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters autoScalingConfiguration --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-createCluster-2024-08-05-cluster.sh b/docs/command/includes/atlas-api-clusters-createCluster-2024-08-05-cluster.sh deleted file mode 100644 index 17b477eef3..0000000000 --- a/docs/command/includes/atlas-api-clusters-createCluster-2024-08-05-cluster.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters createCluster --version 2024-08-05 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-cluster.sh b/docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-cluster.sh deleted file mode 100644 index aba5ce5319..0000000000 --- a/docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-cluster.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters createCluster --version 2024-10-23 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-create_cluster.sh b/docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-create_cluster.sh deleted file mode 100644 index dfeb2fa4b5..0000000000 --- a/docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-create_cluster.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters createCluster --version 2024-10-23 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-createCluster-2024-08-05-cluster-payload.json b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-08-05-cluster-payload.json similarity index 100% rename from docs/command/includes/atlas-api-clusters-createCluster-2024-08-05-cluster-payload.json rename to docs/command/includes/atlas-api-clusters-createGroupCluster-2024-08-05-cluster-payload.json diff --git a/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-08-05-cluster.sh b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-08-05-cluster.sh new file mode 100644 index 0000000000..e33cbf65b3 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-08-05-cluster.sh @@ -0,0 +1 @@ +atlas api clusters createGroupCluster --version 2024-08-05 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-cluster-payload.json b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-cluster-payload.json similarity index 100% rename from docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-cluster-payload.json rename to docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-cluster-payload.json diff --git a/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-cluster.sh b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-cluster.sh new file mode 100644 index 0000000000..d19ccbb85c --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-cluster.sh @@ -0,0 +1 @@ +atlas api clusters createGroupCluster --version 2024-10-23 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-create_cluster-payload.json b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-create_cluster-payload.json similarity index 100% rename from docs/command/includes/atlas-api-clusters-createCluster-2024-10-23-create_cluster-payload.json rename to docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-create_cluster-payload.json diff --git a/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-create_cluster.sh b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-create_cluster.sh new file mode 100644 index 0000000000..8eaf66df8c --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-createGroupCluster-2024-10-23-create_cluster.sh @@ -0,0 +1 @@ +atlas api clusters createGroupCluster --version 2024-10-23 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-deleteCluster-2023-02-01-delete_cluster.sh b/docs/command/includes/atlas-api-clusters-deleteCluster-2023-02-01-delete_cluster.sh deleted file mode 100644 index e7591823aa..0000000000 --- a/docs/command/includes/atlas-api-clusters-deleteCluster-2023-02-01-delete_cluster.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters deleteCluster --version 2023-02-01 --clusterName [your-cluster-name] --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-deleteGroupCluster-2023-02-01-delete_cluster.sh b/docs/command/includes/atlas-api-clusters-deleteGroupCluster-2023-02-01-delete_cluster.sh new file mode 100644 index 0000000000..53e66056f9 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-deleteGroupCluster-2023-02-01-delete_cluster.sh @@ -0,0 +1 @@ +atlas api clusters deleteGroupCluster --version 2023-02-01 --clusterName [your-cluster-name] --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-getCluster-2024-08-05-get_cluster.sh b/docs/command/includes/atlas-api-clusters-getCluster-2024-08-05-get_cluster.sh deleted file mode 100644 index bd2a0eac34..0000000000 --- a/docs/command/includes/atlas-api-clusters-getCluster-2024-08-05-get_cluster.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters getCluster --version 2024-08-05 --clusterName [your-cluster-name] --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-getClusterAdvancedConfiguration-2024-08-05-default.sh b/docs/command/includes/atlas-api-clusters-getClusterAdvancedConfiguration-2024-08-05-default.sh deleted file mode 100644 index da3f0024dd..0000000000 --- a/docs/command/includes/atlas-api-clusters-getClusterAdvancedConfiguration-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters getClusterAdvancedConfiguration --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-getClusterStatus-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusters-getClusterStatus-2023-01-01-default.sh deleted file mode 100644 index 4c5a6986ff..0000000000 --- a/docs/command/includes/atlas-api-clusters-getClusterStatus-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters getClusterStatus --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-getGroupCluster-2024-08-05-get_cluster.sh b/docs/command/includes/atlas-api-clusters-getGroupCluster-2024-08-05-get_cluster.sh new file mode 100644 index 0000000000..3c8e459410 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-getGroupCluster-2024-08-05-get_cluster.sh @@ -0,0 +1 @@ +atlas api clusters getGroupCluster --version 2024-08-05 --clusterName [your-cluster-name] --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-getGroupClusterProcessArgs-2024-08-05-default.sh b/docs/command/includes/atlas-api-clusters-getGroupClusterProcessArgs-2024-08-05-default.sh new file mode 100644 index 0000000000..7c3b509845 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-getGroupClusterProcessArgs-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api clusters getGroupClusterProcessArgs --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-getGroupClusterStatus-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusters-getGroupClusterStatus-2023-01-01-default.sh new file mode 100644 index 0000000000..a8921786d1 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-getGroupClusterStatus-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api clusters getGroupClusterStatus --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-getGroupSampleDatasetLoad-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusters-getGroupSampleDatasetLoad-2023-01-01-default.sh new file mode 100644 index 0000000000..49dcd81642 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-getGroupSampleDatasetLoad-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api clusters getGroupSampleDatasetLoad --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --sampleDatasetId [sampleDatasetId] diff --git a/docs/command/includes/atlas-api-clusters-getSampleDatasetLoadStatus-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusters-getSampleDatasetLoadStatus-2023-01-01-default.sh deleted file mode 100644 index e6a79c652b..0000000000 --- a/docs/command/includes/atlas-api-clusters-getSampleDatasetLoadStatus-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters getSampleDatasetLoadStatus --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --sampleDatasetId [sampleDatasetId] diff --git a/docs/command/includes/atlas-api-clusters-listCloudProviderRegions-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusters-listCloudProviderRegions-2023-01-01-default.sh deleted file mode 100644 index 4df694a4af..0000000000 --- a/docs/command/includes/atlas-api-clusters-listCloudProviderRegions-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters listCloudProviderRegions --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-listClusters-2024-08-05-list_clusters.sh b/docs/command/includes/atlas-api-clusters-listClusters-2024-08-05-list_clusters.sh deleted file mode 100644 index 64a8b068c4..0000000000 --- a/docs/command/includes/atlas-api-clusters-listClusters-2024-08-05-list_clusters.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters listClusters --version 2024-08-05 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-listGroupClusterProviderRegions-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusters-listGroupClusterProviderRegions-2023-01-01-default.sh new file mode 100644 index 0000000000..09f69b7620 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-listGroupClusterProviderRegions-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api clusters listGroupClusterProviderRegions --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-listGroupClusters-2024-08-05-list_clusters.sh b/docs/command/includes/atlas-api-clusters-listGroupClusters-2024-08-05-list_clusters.sh new file mode 100644 index 0000000000..77b8720093 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-listGroupClusters-2024-08-05-list_clusters.sh @@ -0,0 +1 @@ +atlas api clusters listGroupClusters --version 2024-08-05 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-loadSampleDataset-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusters-loadSampleDataset-2023-01-01-default.sh deleted file mode 100644 index f567ff2bf1..0000000000 --- a/docs/command/includes/atlas-api-clusters-loadSampleDataset-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters loadSampleDataset --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-clusters-requestGroupSampleDatasetLoad-2023-01-01-default.sh b/docs/command/includes/atlas-api-clusters-requestGroupSampleDatasetLoad-2023-01-01-default.sh new file mode 100644 index 0000000000..3dfb390a3a --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-requestGroupSampleDatasetLoad-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api clusters requestGroupSampleDatasetLoad --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-clusters-restartGroupClusterPrimaries-2023-02-01-default.sh b/docs/command/includes/atlas-api-clusters-restartGroupClusterPrimaries-2023-02-01-default.sh new file mode 100644 index 0000000000..400445de93 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-restartGroupClusterPrimaries-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api clusters restartGroupClusterPrimaries --version 2023-02-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess-2024-08-05-default.sh b/docs/command/includes/atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess-2024-08-05-default.sh new file mode 100644 index 0000000000..b54c93f2dd --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api clusters revokeGroupClusterMongoDbEmployeeAccess --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-revokeMongoDbEmployeeAccess-2024-08-05-default.sh b/docs/command/includes/atlas-api-clusters-revokeMongoDbEmployeeAccess-2024-08-05-default.sh deleted file mode 100644 index b0dd40b48c..0000000000 --- a/docs/command/includes/atlas-api-clusters-revokeMongoDbEmployeeAccess-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters revokeMongoDbEmployeeAccess --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-testFailover-2023-02-01-default.sh b/docs/command/includes/atlas-api-clusters-testFailover-2023-02-01-default.sh deleted file mode 100644 index 9026eaf9c1..0000000000 --- a/docs/command/includes/atlas-api-clusters-testFailover-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters testFailover --version 2023-02-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-unpinFeatureCompatibilityVersion-2024-05-30-default.sh b/docs/command/includes/atlas-api-clusters-unpinFeatureCompatibilityVersion-2024-05-30-default.sh deleted file mode 100644 index 37619d60d0..0000000000 --- a/docs/command/includes/atlas-api-clusters-unpinFeatureCompatibilityVersion-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters unpinFeatureCompatibilityVersion --version 2024-05-30 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion-2024-05-30-default.sh b/docs/command/includes/atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion-2024-05-30-default.sh new file mode 100644 index 0000000000..220b68e129 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api clusters unpinGroupClusterFeatureCompatibilityVersion --version 2024-05-30 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-clusters-updateCluster-2024-10-23-update_cluster.sh b/docs/command/includes/atlas-api-clusters-updateCluster-2024-10-23-update_cluster.sh deleted file mode 100644 index fef8093bd6..0000000000 --- a/docs/command/includes/atlas-api-clusters-updateCluster-2024-10-23-update_cluster.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api clusters updateCluster --version 2024-10-23 --clusterName [your-cluster-name] --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-clusters-updateCluster-2024-10-23-update_cluster-payload.json b/docs/command/includes/atlas-api-clusters-updateGroupCluster-2024-10-23-update_cluster-payload.json similarity index 100% rename from docs/command/includes/atlas-api-clusters-updateCluster-2024-10-23-update_cluster-payload.json rename to docs/command/includes/atlas-api-clusters-updateGroupCluster-2024-10-23-update_cluster-payload.json diff --git a/docs/command/includes/atlas-api-clusters-updateGroupCluster-2024-10-23-update_cluster.sh b/docs/command/includes/atlas-api-clusters-updateGroupCluster-2024-10-23-update_cluster.sh new file mode 100644 index 0000000000..53f8431a59 --- /dev/null +++ b/docs/command/includes/atlas-api-clusters-updateGroupCluster-2024-10-23-update_cluster.sh @@ -0,0 +1 @@ +atlas api clusters updateGroupCluster --version 2024-10-23 --clusterName [your-cluster-name] --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements-2023-11-15-default.sh deleted file mode 100644 index 3eb2270bee..0000000000 --- a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api collectionLevelMetrics getCollStatsLatencyNamespaceClusterMeasurements --version 2023-11-15 --clusterName [clusterName] --clusterView [clusterView] --collectionName mycoll --databaseName mydb --groupId 32b6e34b3d91647abb20e7b8 --period PT10H diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements-2023-11-15-default.sh deleted file mode 100644 index 73705d9e26..0000000000 --- a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api collectionLevelMetrics getCollStatsLatencyNamespaceHostMeasurements --version 2023-11-15 --collectionName mycoll --databaseName mydb --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics-2023-11-15-default.sh deleted file mode 100644 index b2c2874c89..0000000000 --- a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api collectionLevelMetrics getCollStatsLatencyNamespaceMetrics --version 2023-11-15 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster-2023-11-15-default.sh deleted file mode 100644 index 1f534c91fc..0000000000 --- a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api collectionLevelMetrics getCollStatsLatencyNamespacesForCluster --version 2023-11-15 --clusterName [clusterName] --clusterView [clusterView] --groupId 32b6e34b3d91647abb20e7b8 --period PT10H diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost-2023-11-15-default.sh deleted file mode 100644 index 38c10a71af..0000000000 --- a/docs/command/includes/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api collectionLevelMetrics getCollStatsLatencyNamespacesForHost --version 2023-11-15 --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces-2023-11-15-default.sh new file mode 100644 index 0000000000..e31ed72a3c --- /dev/null +++ b/docs/command/includes/atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api collectionLevelMetrics getGroupClusterCollStatNamespaces --version 2023-11-15 --clusterName [clusterName] --clusterView [clusterView] --groupId 32b6e34b3d91647abb20e7b8 --period PT10H diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces-2023-11-15-default.sh new file mode 100644 index 0000000000..cefb70b3a6 --- /dev/null +++ b/docs/command/includes/atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api collectionLevelMetrics getGroupProcessCollStatNamespaces --version 2023-11-15 --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-getPinnedNamespaces-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-getPinnedNamespaces-2023-11-15-default.sh deleted file mode 100644 index 8ac83f8355..0000000000 --- a/docs/command/includes/atlas-api-collectionLevelMetrics-getPinnedNamespaces-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api collectionLevelMetrics getPinnedNamespaces --version 2023-11-15 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements-2023-11-15-default.sh new file mode 100644 index 0000000000..e9ab96ede6 --- /dev/null +++ b/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api collectionLevelMetrics listGroupClusterCollStatMeasurements --version 2023-11-15 --clusterName [clusterName] --clusterView [clusterView] --collectionName mycoll --databaseName mydb --groupId 32b6e34b3d91647abb20e7b8 --period PT10H diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces-2023-11-15-default.sh new file mode 100644 index 0000000000..1d5c2ee8fa --- /dev/null +++ b/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api collectionLevelMetrics listGroupClusterCollStatPinnedNamespaces --version 2023-11-15 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupCollStatMetrics-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupCollStatMetrics-2023-11-15-default.sh new file mode 100644 index 0000000000..89b5126650 --- /dev/null +++ b/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupCollStatMetrics-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api collectionLevelMetrics listGroupCollStatMetrics --version 2023-11-15 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements-2023-11-15-default.sh b/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements-2023-11-15-default.sh new file mode 100644 index 0000000000..1c180685ab --- /dev/null +++ b/docs/command/includes/atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api collectionLevelMetrics listGroupProcessCollStatMeasurements --version 2023-11-15 --collectionName mycoll --databaseName mydb --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-customDatabaseRoles-deleteCustomDatabaseRole-2023-01-01-default.sh b/docs/command/includes/atlas-api-customDatabaseRoles-deleteCustomDatabaseRole-2023-01-01-default.sh deleted file mode 100644 index 64b32efd1b..0000000000 --- a/docs/command/includes/atlas-api-customDatabaseRoles-deleteCustomDatabaseRole-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api customDatabaseRoles deleteCustomDatabaseRole --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --roleName [roleName] diff --git a/docs/command/includes/atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole-2023-01-01-default.sh b/docs/command/includes/atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole-2023-01-01-default.sh new file mode 100644 index 0000000000..bed69add6c --- /dev/null +++ b/docs/command/includes/atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api customDatabaseRoles deleteGroupCustomDbRoleRole --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --roleName [roleName] diff --git a/docs/command/includes/atlas-api-customDatabaseRoles-getCustomDatabaseRole-2023-01-01-default.sh b/docs/command/includes/atlas-api-customDatabaseRoles-getCustomDatabaseRole-2023-01-01-default.sh deleted file mode 100644 index 8de474a36e..0000000000 --- a/docs/command/includes/atlas-api-customDatabaseRoles-getCustomDatabaseRole-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api customDatabaseRoles getCustomDatabaseRole --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --roleName [roleName] diff --git a/docs/command/includes/atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole-2023-01-01-default.sh b/docs/command/includes/atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole-2023-01-01-default.sh new file mode 100644 index 0000000000..ce7f7fc13f --- /dev/null +++ b/docs/command/includes/atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api customDatabaseRoles getGroupCustomDbRoleRole --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --roleName [roleName] diff --git a/docs/command/includes/atlas-api-customDatabaseRoles-listCustomDatabaseRoles-2023-01-01-default.sh b/docs/command/includes/atlas-api-customDatabaseRoles-listCustomDatabaseRoles-2023-01-01-default.sh deleted file mode 100644 index a97db48bae..0000000000 --- a/docs/command/includes/atlas-api-customDatabaseRoles-listCustomDatabaseRoles-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api customDatabaseRoles listCustomDatabaseRoles --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles-2023-01-01-default.sh b/docs/command/includes/atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles-2023-01-01-default.sh new file mode 100644 index 0000000000..9dd18c840e --- /dev/null +++ b/docs/command/includes/atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api customDatabaseRoles listGroupCustomDbRoleRoles --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-deleteDataFederationPrivateEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-deleteDataFederationPrivateEndpoint-2023-01-01-default.sh deleted file mode 100644 index 44c3f820fe..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-deleteDataFederationPrivateEndpoint-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation deleteDataFederationPrivateEndpoint --version 2023-01-01 --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-deleteFederatedDatabase-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-deleteFederatedDatabase-2023-01-01-default.sh deleted file mode 100644 index ea46885bd9..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-deleteFederatedDatabase-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation deleteFederatedDatabase --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-deleteGroupDataFederation-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-deleteGroupDataFederation-2023-01-01-default.sh new file mode 100644 index 0000000000..b3e30c3b3d --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-deleteGroupDataFederation-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation deleteGroupDataFederation --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-deleteGroupDataFederationLimit-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-deleteGroupDataFederationLimit-2023-01-01-default.sh new file mode 100644 index 0000000000..9aa569997c --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-deleteGroupDataFederationLimit-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation deleteGroupDataFederationLimit --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --limitName [limitName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId-2023-01-01-default.sh new file mode 100644 index 0000000000..ac16da81c2 --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation deleteGroupPrivateNetworkSettingEndpointId --version 2023-01-01 --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit-2023-01-01-default.sh deleted file mode 100644 index f1a171360d..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation deleteOneDataFederationInstanceQueryLimit --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --limitName [limitName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs-2023-01-01-default.sh deleted file mode 100644 index 7d69a7de98..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation downloadFederatedDatabaseQueryLogs --version 2023-01-01 --endDate 1.636481348e+09 --groupId 32b6e34b3d91647abb20e7b8 --startDate 1.636466948e+09 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-downloadGroupDataFederationQueryLogs-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-downloadGroupDataFederationQueryLogs-2023-01-01-default.sh new file mode 100644 index 0000000000..5f853aec75 --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-downloadGroupDataFederationQueryLogs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation downloadGroupDataFederationQueryLogs --version 2023-01-01 --endDate 1.636481348e+09 --groupId 32b6e34b3d91647abb20e7b8 --startDate 1.636466948e+09 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-getDataFederationPrivateEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-getDataFederationPrivateEndpoint-2023-01-01-default.sh deleted file mode 100644 index 41454cb549..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-getDataFederationPrivateEndpoint-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation getDataFederationPrivateEndpoint --version 2023-01-01 --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-getFederatedDatabase-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-getFederatedDatabase-2023-01-01-default.sh deleted file mode 100644 index b6f4b2942f..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-getFederatedDatabase-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation getFederatedDatabase --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-getGroupDataFederation-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-getGroupDataFederation-2023-01-01-default.sh new file mode 100644 index 0000000000..f8d4daedb8 --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-getGroupDataFederation-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation getGroupDataFederation --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-getGroupDataFederationLimit-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-getGroupDataFederationLimit-2023-01-01-default.sh new file mode 100644 index 0000000000..f60a6d77c8 --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-getGroupDataFederationLimit-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation getGroupDataFederationLimit --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --limitName [limitName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId-2023-01-01-default.sh new file mode 100644 index 0000000000..7af73719fa --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation getGroupPrivateNetworkSettingEndpointId --version 2023-01-01 --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-listDataFederationPrivateEndpoints-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-listDataFederationPrivateEndpoints-2023-01-01-default.sh deleted file mode 100644 index d7101db6e7..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-listDataFederationPrivateEndpoints-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation listDataFederationPrivateEndpoints --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-listFederatedDatabases-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-listFederatedDatabases-2023-01-01-default.sh deleted file mode 100644 index c060ac3576..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-listFederatedDatabases-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation listFederatedDatabases --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-listGroupDataFederation-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-listGroupDataFederation-2023-01-01-default.sh new file mode 100644 index 0000000000..a85121c3d9 --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-listGroupDataFederation-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation listGroupDataFederation --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-listGroupDataFederationLimits-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-listGroupDataFederationLimits-2023-01-01-default.sh new file mode 100644 index 0000000000..a33d63bdcd --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-listGroupDataFederationLimits-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation listGroupDataFederationLimits --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds-2023-01-01-default.sh new file mode 100644 index 0000000000..2408d6e255 --- /dev/null +++ b/docs/command/includes/atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api dataFederation listGroupPrivateNetworkSettingEndpointIds --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-dataFederation-returnFederatedDatabaseQueryLimit-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-returnFederatedDatabaseQueryLimit-2023-01-01-default.sh deleted file mode 100644 index 4e0179f8bc..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-returnFederatedDatabaseQueryLimit-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation returnFederatedDatabaseQueryLimit --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --limitName [limitName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-dataFederation-returnFederatedDatabaseQueryLimits-2023-01-01-default.sh b/docs/command/includes/atlas-api-dataFederation-returnFederatedDatabaseQueryLimits-2023-01-01-default.sh deleted file mode 100644 index 75e10b7ee6..0000000000 --- a/docs/command/includes/atlas-api-dataFederation-returnFederatedDatabaseQueryLimits-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api dataFederation returnFederatedDatabaseQueryLimits --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-aws_iam_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-aws_iam_authentication.sh deleted file mode 100644 index b67ae2849a..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-aws_iam_authentication.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers createDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-ldap_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-ldap_authentication.sh deleted file mode 100644 index b67ae2849a..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-ldap_authentication.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers createDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workforce_federated_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workforce_federated_authentication.sh deleted file mode 100644 index b67ae2849a..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workforce_federated_authentication.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers createDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workload_federated_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workload_federated_authentication.sh deleted file mode 100644 index b67ae2849a..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workload_federated_authentication.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers createDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-scram-sha_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-scram-sha_authentication.sh deleted file mode 100644 index b67ae2849a..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-scram-sha_authentication.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers createDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-x509_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-x509_authentication.sh deleted file mode 100644 index b67ae2849a..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-x509_authentication.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers createDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-aws_iam_authentication-payload.json b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-aws_iam_authentication-payload.json similarity index 100% rename from docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-aws_iam_authentication-payload.json rename to docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-aws_iam_authentication-payload.json diff --git a/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-aws_iam_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-aws_iam_authentication.sh new file mode 100644 index 0000000000..ce2c1fa696 --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-aws_iam_authentication.sh @@ -0,0 +1 @@ +atlas api databaseUsers createGroupDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-ldap_authentication-payload.json b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-ldap_authentication-payload.json similarity index 100% rename from docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-ldap_authentication-payload.json rename to docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-ldap_authentication-payload.json diff --git a/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-ldap_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-ldap_authentication.sh new file mode 100644 index 0000000000..ce2c1fa696 --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-ldap_authentication.sh @@ -0,0 +1 @@ +atlas api databaseUsers createGroupDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workforce_federated_authentication-payload.json b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workforce_federated_authentication-payload.json similarity index 100% rename from docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workforce_federated_authentication-payload.json rename to docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workforce_federated_authentication-payload.json diff --git a/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workforce_federated_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workforce_federated_authentication.sh new file mode 100644 index 0000000000..ce2c1fa696 --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workforce_federated_authentication.sh @@ -0,0 +1 @@ +atlas api databaseUsers createGroupDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workload_federated_authentication-payload.json b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workload_federated_authentication-payload.json similarity index 100% rename from docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-oidc_workload_federated_authentication-payload.json rename to docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workload_federated_authentication-payload.json diff --git a/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workload_federated_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workload_federated_authentication.sh new file mode 100644 index 0000000000..ce2c1fa696 --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-oidc_workload_federated_authentication.sh @@ -0,0 +1 @@ +atlas api databaseUsers createGroupDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-scram-sha_authentication-payload.json b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-scram-sha_authentication-payload.json similarity index 100% rename from docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-scram-sha_authentication-payload.json rename to docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-scram-sha_authentication-payload.json diff --git a/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-scram-sha_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-scram-sha_authentication.sh new file mode 100644 index 0000000000..ce2c1fa696 --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-scram-sha_authentication.sh @@ -0,0 +1 @@ +atlas api databaseUsers createGroupDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-x509_authentication-payload.json b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-x509_authentication-payload.json similarity index 100% rename from docs/command/includes/atlas-api-databaseUsers-createDatabaseUser-2023-01-01-x509_authentication-payload.json rename to docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-x509_authentication-payload.json diff --git a/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-x509_authentication.sh b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-x509_authentication.sh new file mode 100644 index 0000000000..ce2c1fa696 --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-createGroupDatabaseUser-2023-01-01-x509_authentication.sh @@ -0,0 +1 @@ +atlas api databaseUsers createGroupDatabaseUser --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-deleteDatabaseUser-2023-01-01-default.sh b/docs/command/includes/atlas-api-databaseUsers-deleteDatabaseUser-2023-01-01-default.sh deleted file mode 100644 index 3af7bfd0fe..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-deleteDatabaseUser-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers deleteDatabaseUser --version 2023-01-01 --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --username SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName diff --git a/docs/command/includes/atlas-api-databaseUsers-deleteGroupDatabaseUser-2023-01-01-default.sh b/docs/command/includes/atlas-api-databaseUsers-deleteGroupDatabaseUser-2023-01-01-default.sh new file mode 100644 index 0000000000..89eb19698c --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-deleteGroupDatabaseUser-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api databaseUsers deleteGroupDatabaseUser --version 2023-01-01 --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --username SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName diff --git a/docs/command/includes/atlas-api-databaseUsers-getDatabaseUser-2023-01-01-default.sh b/docs/command/includes/atlas-api-databaseUsers-getDatabaseUser-2023-01-01-default.sh deleted file mode 100644 index f34d1c44fb..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-getDatabaseUser-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers getDatabaseUser --version 2023-01-01 --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --username SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName diff --git a/docs/command/includes/atlas-api-databaseUsers-getGroupDatabaseUser-2023-01-01-default.sh b/docs/command/includes/atlas-api-databaseUsers-getGroupDatabaseUser-2023-01-01-default.sh new file mode 100644 index 0000000000..f8854960e5 --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-getGroupDatabaseUser-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api databaseUsers getGroupDatabaseUser --version 2023-01-01 --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --username SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName diff --git a/docs/command/includes/atlas-api-databaseUsers-listDatabaseUsers-2023-01-01-default.sh b/docs/command/includes/atlas-api-databaseUsers-listDatabaseUsers-2023-01-01-default.sh deleted file mode 100644 index e2e6a4fcac..0000000000 --- a/docs/command/includes/atlas-api-databaseUsers-listDatabaseUsers-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api databaseUsers listDatabaseUsers --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-databaseUsers-listGroupDatabaseUsers-2023-01-01-default.sh b/docs/command/includes/atlas-api-databaseUsers-listGroupDatabaseUsers-2023-01-01-default.sh new file mode 100644 index 0000000000..f23ce6039c --- /dev/null +++ b/docs/command/includes/atlas-api-databaseUsers-listGroupDatabaseUsers-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api databaseUsers listGroupDatabaseUsers --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest-2023-01-01-default.sh b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest-2023-01-01-default.sh deleted file mode 100644 index d2afac28c4..0000000000 --- a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRest --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint-2023-01-01-default.sh deleted file mode 100644 index 06d2c385cd..0000000000 --- a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRestPrivateEndpoint --version 2023-01-01 --cloudProvider [cloudProvider] --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider-2023-01-01-default.sh b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider-2023-01-01-default.sh deleted file mode 100644 index a047069788..0000000000 --- a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api encryptionAtRestUsingCustomerKeyManagement getEncryptionAtRestPrivateEndpointsForCloudProvider --version 2023-01-01 --cloudProvider [cloudProvider] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest-2023-01-01-default.sh b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest-2023-01-01-default.sh new file mode 100644 index 0000000000..e7bfcc4c50 --- /dev/null +++ b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api encryptionAtRestUsingCustomerKeyManagement getGroupEncryptionAtRest --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint-2023-01-01-default.sh new file mode 100644 index 0000000000..9b2788b2fd --- /dev/null +++ b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api encryptionAtRestUsingCustomerKeyManagement getGroupEncryptionAtRestPrivateEndpoint --version 2023-01-01 --cloudProvider [cloudProvider] --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints-2023-01-01-default.sh b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints-2023-01-01-default.sh new file mode 100644 index 0000000000..291d4be4e2 --- /dev/null +++ b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api encryptionAtRestUsingCustomerKeyManagement listGroupEncryptionAtRestPrivateEndpoints --version 2023-01-01 --cloudProvider [cloudProvider] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion-2023-01-01-default.sh b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion-2023-01-01-default.sh deleted file mode 100644 index d18e5ab7fe..0000000000 --- a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api encryptionAtRestUsingCustomerKeyManagement requestEncryptionAtRestPrivateEndpointDeletion --version 2023-01-01 --cloudProvider [cloudProvider] --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion-2023-01-01-default.sh b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion-2023-01-01-default.sh new file mode 100644 index 0000000000..88635fb67a --- /dev/null +++ b/docs/command/includes/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api encryptionAtRestUsingCustomerKeyManagement requestGroupEncryptionAtRestPrivateEndpointDeletion --version 2023-01-01 --cloudProvider [cloudProvider] --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-events-getGroupEvent-2023-01-01-default.sh b/docs/command/includes/atlas-api-events-getGroupEvent-2023-01-01-default.sh new file mode 100644 index 0000000000..882294485a --- /dev/null +++ b/docs/command/includes/atlas-api-events-getGroupEvent-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api events getGroupEvent --version 2023-01-01 --eventId [eventId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-events-getOrgEvent-2023-01-01-default.sh b/docs/command/includes/atlas-api-events-getOrgEvent-2023-01-01-default.sh new file mode 100644 index 0000000000..7604a932d5 --- /dev/null +++ b/docs/command/includes/atlas-api-events-getOrgEvent-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api events getOrgEvent --version 2023-01-01 --eventId [eventId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-events-getOrganizationEvent-2023-01-01-default.sh b/docs/command/includes/atlas-api-events-getOrganizationEvent-2023-01-01-default.sh deleted file mode 100644 index 9ddc67ddb7..0000000000 --- a/docs/command/includes/atlas-api-events-getOrganizationEvent-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api events getOrganizationEvent --version 2023-01-01 --eventId [eventId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-events-getProjectEvent-2023-01-01-default.sh b/docs/command/includes/atlas-api-events-getProjectEvent-2023-01-01-default.sh deleted file mode 100644 index 4088901f34..0000000000 --- a/docs/command/includes/atlas-api-events-getProjectEvent-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api events getProjectEvent --version 2023-01-01 --eventId [eventId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-events-listGroupEvents-2023-01-01-default.sh b/docs/command/includes/atlas-api-events-listGroupEvents-2023-01-01-default.sh new file mode 100644 index 0000000000..2700d915aa --- /dev/null +++ b/docs/command/includes/atlas-api-events-listGroupEvents-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api events listGroupEvents --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-events-listOrgEvents-2023-01-01-default.sh b/docs/command/includes/atlas-api-events-listOrgEvents-2023-01-01-default.sh new file mode 100644 index 0000000000..23d41bcec4 --- /dev/null +++ b/docs/command/includes/atlas-api-events-listOrgEvents-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api events listOrgEvents --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-events-listOrganizationEvents-2023-01-01-default.sh b/docs/command/includes/atlas-api-events-listOrganizationEvents-2023-01-01-default.sh deleted file mode 100644 index 13c135e0e8..0000000000 --- a/docs/command/includes/atlas-api-events-listOrganizationEvents-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api events listOrganizationEvents --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-events-listProjectEvents-2023-01-01-default.sh b/docs/command/includes/atlas-api-events-listProjectEvents-2023-01-01-default.sh deleted file mode 100644 index cb8314b1ab..0000000000 --- a/docs/command/includes/atlas-api-events-listProjectEvents-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api events listProjectEvents --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationApp-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationApp-2023-01-01-default.sh deleted file mode 100644 index 9eb5197452..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationApp-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication deleteFederationApp --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e diff --git a/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSetting-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSetting-2023-01-01-default.sh new file mode 100644 index 0000000000..11502aaf0e --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSetting-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication deleteFederationSetting --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e diff --git a/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping-2023-01-01-default.sh new file mode 100644 index 0000000000..2d0f879114 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication deleteFederationSettingConnectedOrgConfigRoleMapping --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --id 32b6e34b3d91647abb20e7b8 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider-2023-11-15-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider-2023-11-15-default.sh new file mode 100644 index 0000000000..0c95dda00d --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication deleteFederationSettingIdentityProvider --version 2023-11-15 --federationSettingsId 55fa922fb343282757d9554e --identityProviderId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-deleteIdentityProvider-2023-11-15-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-deleteIdentityProvider-2023-11-15-default.sh deleted file mode 100644 index fc68ff4787..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-deleteIdentityProvider-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication deleteIdentityProvider --version 2023-11-15 --federationSettingsId 55fa922fb343282757d9554e --identityProviderId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-deleteRoleMapping-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-deleteRoleMapping-2023-01-01-default.sh deleted file mode 100644 index b13c9240c7..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-deleteRoleMapping-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication deleteRoleMapping --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --id 32b6e34b3d91647abb20e7b8 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getConnectedOrgConfig-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getConnectedOrgConfig-2023-01-01-default.sh deleted file mode 100644 index 431ee7aa12..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-getConnectedOrgConfig-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication getConnectedOrgConfig --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --orgId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig-2023-01-01-default.sh new file mode 100644 index 0000000000..1c6c40d0b9 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication getFederationSettingConnectedOrgConfig --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --orgId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping-2023-01-01-default.sh new file mode 100644 index 0000000000..503966f7fb --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication getFederationSettingConnectedOrgConfigRoleMapping --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --id 32b6e34b3d91647abb20e7b8 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingIdentityProvider-2023-11-15-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingIdentityProvider-2023-11-15-default.sh new file mode 100644 index 0000000000..b96121be45 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingIdentityProvider-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication getFederationSettingIdentityProvider --version 2023-11-15 --federationSettingsId 55fa922fb343282757d9554e --identityProviderId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata-2023-01-01-default.sh new file mode 100644 index 0000000000..8ed48e50e1 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication getFederationSettingIdentityProviderMetadata --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --identityProviderId c2777a9eca931f29fc2f diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettings-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettings-2023-01-01-default.sh deleted file mode 100644 index 10e606d4d0..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-getFederationSettings-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication getFederationSettings --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getIdentityProvider-2023-11-15-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getIdentityProvider-2023-11-15-default.sh deleted file mode 100644 index 2dbde250e7..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-getIdentityProvider-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication getIdentityProvider --version 2023-11-15 --federationSettingsId 55fa922fb343282757d9554e --identityProviderId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getIdentityProviderMetadata-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getIdentityProviderMetadata-2023-01-01-default.sh deleted file mode 100644 index b8e18d5f4f..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-getIdentityProviderMetadata-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication getIdentityProviderMetadata --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --identityProviderId c2777a9eca931f29fc2f diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getOrgFederationSettings-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getOrgFederationSettings-2023-01-01-default.sh new file mode 100644 index 0000000000..8e84c25b64 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-getOrgFederationSettings-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication getOrgFederationSettings --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-getRoleMapping-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-getRoleMapping-2023-01-01-default.sh deleted file mode 100644 index 4abc5e7157..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-getRoleMapping-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication getRoleMapping --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --id 32b6e34b3d91647abb20e7b8 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-listConnectedOrgConfigs-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-listConnectedOrgConfigs-2023-01-01-default.sh deleted file mode 100644 index 8a10f0ab45..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-listConnectedOrgConfigs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication listConnectedOrgConfigs --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e diff --git a/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings-2023-01-01-default.sh new file mode 100644 index 0000000000..4516e99817 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication listFederationSettingConnectedOrgConfigRoleMappings --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs-2023-01-01-default.sh new file mode 100644 index 0000000000..f7889c3165 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication listFederationSettingConnectedOrgConfigs --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e diff --git a/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingIdentityProviders-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingIdentityProviders-2023-01-01-default.sh new file mode 100644 index 0000000000..c30bebe3e6 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-listFederationSettingIdentityProviders-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication listFederationSettingIdentityProviders --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e diff --git a/docs/command/includes/atlas-api-federatedAuthentication-listIdentityProviders-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-listIdentityProviders-2023-01-01-default.sh deleted file mode 100644 index 455adea9a6..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-listIdentityProviders-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication listIdentityProviders --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e diff --git a/docs/command/includes/atlas-api-federatedAuthentication-listRoleMappings-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-listRoleMappings-2023-01-01-default.sh deleted file mode 100644 index 8a023da2b5..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-listRoleMappings-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication listRoleMappings --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-removeConnectedOrgConfig-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-removeConnectedOrgConfig-2023-01-01-default.sh deleted file mode 100644 index 924b316fa3..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-removeConnectedOrgConfig-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication removeConnectedOrgConfig --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --orgId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig-2023-01-01-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig-2023-01-01-default.sh new file mode 100644 index 0000000000..7dcb29f453 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication removeFederationSettingConnectedOrgConfig --version 2023-01-01 --federationSettingsId 55fa922fb343282757d9554e --orgId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks-2023-11-15-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks-2023-11-15-default.sh new file mode 100644 index 0000000000..20fff789b4 --- /dev/null +++ b/docs/command/includes/atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks-2023-11-15-default.sh @@ -0,0 +1 @@ +atlas api federatedAuthentication revokeFederationSettingIdentityProviderJwks --version 2023-11-15 --federationSettingsId 55fa922fb343282757d9554e --identityProviderId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider-2023-11-15-default.sh b/docs/command/includes/atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider-2023-11-15-default.sh deleted file mode 100644 index dc236d15eb..0000000000 --- a/docs/command/includes/atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider-2023-11-15-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api federatedAuthentication revokeJwksFromIdentityProvider --version 2023-11-15 --federationSettingsId 55fa922fb343282757d9554e --identityProviderId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-flexClusters-deleteFlexCluster-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexClusters-deleteFlexCluster-2024-11-13-default.sh deleted file mode 100644 index fa88e78eb4..0000000000 --- a/docs/command/includes/atlas-api-flexClusters-deleteFlexCluster-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api flexClusters deleteFlexCluster --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-flexClusters-deleteGroupFlexCluster-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexClusters-deleteGroupFlexCluster-2024-11-13-default.sh new file mode 100644 index 0000000000..b7ec9baca3 --- /dev/null +++ b/docs/command/includes/atlas-api-flexClusters-deleteGroupFlexCluster-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api flexClusters deleteGroupFlexCluster --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-flexClusters-getFlexCluster-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexClusters-getFlexCluster-2024-11-13-default.sh deleted file mode 100644 index 59ca4359e5..0000000000 --- a/docs/command/includes/atlas-api-flexClusters-getFlexCluster-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api flexClusters getFlexCluster --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-flexClusters-getGroupFlexCluster-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexClusters-getGroupFlexCluster-2024-11-13-default.sh new file mode 100644 index 0000000000..2380388d26 --- /dev/null +++ b/docs/command/includes/atlas-api-flexClusters-getGroupFlexCluster-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api flexClusters getGroupFlexCluster --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-flexClusters-listFlexClusters-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexClusters-listFlexClusters-2024-11-13-default.sh deleted file mode 100644 index 851b0d1071..0000000000 --- a/docs/command/includes/atlas-api-flexClusters-listFlexClusters-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api flexClusters listFlexClusters --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-flexClusters-listGroupFlexClusters-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexClusters-listGroupFlexClusters-2024-11-13-default.sh new file mode 100644 index 0000000000..64d7176fcc --- /dev/null +++ b/docs/command/includes/atlas-api-flexClusters-listGroupFlexClusters-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api flexClusters listGroupFlexClusters --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-flexRestoreJobs-getFlexBackupRestoreJob-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexRestoreJobs-getFlexBackupRestoreJob-2024-11-13-default.sh deleted file mode 100644 index 4c6e46fe98..0000000000 --- a/docs/command/includes/atlas-api-flexRestoreJobs-getFlexBackupRestoreJob-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api flexRestoreJobs getFlexBackupRestoreJob --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] --restoreJobId [restoreJobId] diff --git a/docs/command/includes/atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob-2024-11-13-default.sh new file mode 100644 index 0000000000..7fc999de8d --- /dev/null +++ b/docs/command/includes/atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api flexRestoreJobs getGroupFlexClusterBackupRestoreJob --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] --restoreJobId [restoreJobId] diff --git a/docs/command/includes/atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs-2024-11-13-default.sh deleted file mode 100644 index d3d0ae2ecc..0000000000 --- a/docs/command/includes/atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api flexRestoreJobs listFlexBackupRestoreJobs --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs-2024-11-13-default.sh new file mode 100644 index 0000000000..d7e1e8fe31 --- /dev/null +++ b/docs/command/includes/atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api flexRestoreJobs listGroupFlexClusterBackupRestoreJobs --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-flexSnapshots-getFlexBackup-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexSnapshots-getFlexBackup-2024-11-13-default.sh deleted file mode 100644 index 30bfa3115f..0000000000 --- a/docs/command/includes/atlas-api-flexSnapshots-getFlexBackup-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api flexSnapshots getFlexBackup --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] --snapshotId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot-2024-11-13-default.sh new file mode 100644 index 0000000000..b1b36a1e69 --- /dev/null +++ b/docs/command/includes/atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api flexSnapshots getGroupFlexClusterBackupSnapshot --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] --snapshotId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-flexSnapshots-listFlexBackups-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexSnapshots-listFlexBackups-2024-11-13-default.sh deleted file mode 100644 index e60e0b8d3d..0000000000 --- a/docs/command/includes/atlas-api-flexSnapshots-listFlexBackups-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api flexSnapshots listFlexBackups --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots-2024-11-13-default.sh b/docs/command/includes/atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots-2024-11-13-default.sh new file mode 100644 index 0000000000..93f5e56edd --- /dev/null +++ b/docs/command/includes/atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api flexSnapshots listGroupFlexClusterBackupSnapshots --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-globalClusters-deleteAllCustomZoneMappings-2024-08-05-default.sh b/docs/command/includes/atlas-api-globalClusters-deleteAllCustomZoneMappings-2024-08-05-default.sh deleted file mode 100644 index 3756545c00..0000000000 --- a/docs/command/includes/atlas-api-globalClusters-deleteAllCustomZoneMappings-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api globalClusters deleteAllCustomZoneMappings --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping-2024-08-05-default.sh b/docs/command/includes/atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping-2024-08-05-default.sh new file mode 100644 index 0000000000..85315d573e --- /dev/null +++ b/docs/command/includes/atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api globalClusters deleteGroupClusterGlobalWriteCustomZoneMapping --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces-2024-08-05-default.sh b/docs/command/includes/atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces-2024-08-05-default.sh new file mode 100644 index 0000000000..cafa9faa49 --- /dev/null +++ b/docs/command/includes/atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api globalClusters deleteGroupClusterGlobalWriteManagedNamespaces --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-globalClusters-deleteManagedNamespace-2024-08-05-default.sh b/docs/command/includes/atlas-api-globalClusters-deleteManagedNamespace-2024-08-05-default.sh deleted file mode 100644 index 8023fbe8fd..0000000000 --- a/docs/command/includes/atlas-api-globalClusters-deleteManagedNamespace-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api globalClusters deleteManagedNamespace --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-globalClusters-getGroupClusterGlobalWrites-2024-08-05-default.sh b/docs/command/includes/atlas-api-globalClusters-getGroupClusterGlobalWrites-2024-08-05-default.sh new file mode 100644 index 0000000000..5ea50cd31b --- /dev/null +++ b/docs/command/includes/atlas-api-globalClusters-getGroupClusterGlobalWrites-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api globalClusters getGroupClusterGlobalWrites --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-globalClusters-getManagedNamespace-2024-08-05-default.sh b/docs/command/includes/atlas-api-globalClusters-getManagedNamespace-2024-08-05-default.sh deleted file mode 100644 index 21ee80b6d9..0000000000 --- a/docs/command/includes/atlas-api-globalClusters-getManagedNamespace-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api globalClusters getManagedNamespace --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-invoices-downloadInvoiceCsv-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-downloadInvoiceCsv-2023-01-01-default.sh deleted file mode 100644 index 54838b1c28..0000000000 --- a/docs/command/includes/atlas-api-invoices-downloadInvoiceCsv-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api invoices downloadInvoiceCsv --version 2023-01-01 --invoiceId [invoiceId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-invoices-getCostExplorerQueryProcess-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-getCostExplorerQueryProcess-2023-01-01-default.sh deleted file mode 100644 index 098fac9ef9..0000000000 --- a/docs/command/includes/atlas-api-invoices-getCostExplorerQueryProcess-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api invoices getCostExplorerQueryProcess --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --token 4ABBE973862346D40F3AE859D4BE96E0F895764EB14EAB039E7B82F9D638C05C diff --git a/docs/command/includes/atlas-api-invoices-getInvoice-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-getInvoice-2023-01-01-default.sh deleted file mode 100644 index 9aa09aa24e..0000000000 --- a/docs/command/includes/atlas-api-invoices-getInvoice-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api invoices getInvoice --version 2023-01-01 --invoiceId [invoiceId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-invoices-getOrgBillingCostExplorerUsage-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-getOrgBillingCostExplorerUsage-2023-01-01-default.sh new file mode 100644 index 0000000000..209124f86c --- /dev/null +++ b/docs/command/includes/atlas-api-invoices-getOrgBillingCostExplorerUsage-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api invoices getOrgBillingCostExplorerUsage --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --token 4ABBE973862346D40F3AE859D4BE96E0F895764EB14EAB039E7B82F9D638C05C diff --git a/docs/command/includes/atlas-api-invoices-getOrgInvoice-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-getOrgInvoice-2023-01-01-default.sh new file mode 100644 index 0000000000..e9546fc3d0 --- /dev/null +++ b/docs/command/includes/atlas-api-invoices-getOrgInvoice-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api invoices getOrgInvoice --version 2023-01-01 --invoiceId [invoiceId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-invoices-getOrgInvoiceCsv-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-getOrgInvoiceCsv-2023-01-01-default.sh new file mode 100644 index 0000000000..929c64dfdb --- /dev/null +++ b/docs/command/includes/atlas-api-invoices-getOrgInvoiceCsv-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api invoices getOrgInvoiceCsv --version 2023-01-01 --invoiceId [invoiceId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-invoices-listInvoices-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-listInvoices-2023-01-01-default.sh deleted file mode 100644 index 837f32ef85..0000000000 --- a/docs/command/includes/atlas-api-invoices-listInvoices-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api invoices listInvoices --version 2023-01-01 --fromDate 2023-01-01 --orderBy desc --orgId 4888442a3354817a7320eb61 --toDate 2023-01-01 diff --git a/docs/command/includes/atlas-api-invoices-listOrgInvoicePending-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-listOrgInvoicePending-2023-01-01-default.sh new file mode 100644 index 0000000000..a32b81b0ca --- /dev/null +++ b/docs/command/includes/atlas-api-invoices-listOrgInvoicePending-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api invoices listOrgInvoicePending --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-invoices-listOrgInvoices-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-listOrgInvoices-2023-01-01-default.sh new file mode 100644 index 0000000000..9d7dcb4f2a --- /dev/null +++ b/docs/command/includes/atlas-api-invoices-listOrgInvoices-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api invoices listOrgInvoices --version 2023-01-01 --fromDate 2023-01-01 --orderBy desc --orgId 4888442a3354817a7320eb61 --toDate 2023-01-01 diff --git a/docs/command/includes/atlas-api-invoices-listPendingInvoices-2023-01-01-default.sh b/docs/command/includes/atlas-api-invoices-listPendingInvoices-2023-01-01-default.sh deleted file mode 100644 index 128287b365..0000000000 --- a/docs/command/includes/atlas-api-invoices-listPendingInvoices-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api invoices listPendingInvoices --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping-2023-01-01-default.sh b/docs/command/includes/atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping-2023-01-01-default.sh new file mode 100644 index 0000000000..6698143f51 --- /dev/null +++ b/docs/command/includes/atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api ldapConfiguration deleteGroupUserSecurityLdapUserToDnMapping --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-ldapConfiguration-deleteLdapConfiguration-2023-01-01-default.sh b/docs/command/includes/atlas-api-ldapConfiguration-deleteLdapConfiguration-2023-01-01-default.sh deleted file mode 100644 index ff2f5908ab..0000000000 --- a/docs/command/includes/atlas-api-ldapConfiguration-deleteLdapConfiguration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api ldapConfiguration deleteLdapConfiguration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-ldapConfiguration-getGroupUserSecurity-2023-01-01-default.sh b/docs/command/includes/atlas-api-ldapConfiguration-getGroupUserSecurity-2023-01-01-default.sh new file mode 100644 index 0000000000..4bb40c8173 --- /dev/null +++ b/docs/command/includes/atlas-api-ldapConfiguration-getGroupUserSecurity-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api ldapConfiguration getGroupUserSecurity --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify-2023-01-01-default.sh b/docs/command/includes/atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify-2023-01-01-default.sh new file mode 100644 index 0000000000..e1d136e418 --- /dev/null +++ b/docs/command/includes/atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api ldapConfiguration getGroupUserSecurityLdapVerify --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --requestId [requestId] diff --git a/docs/command/includes/atlas-api-ldapConfiguration-getLdapConfiguration-2023-01-01-default.sh b/docs/command/includes/atlas-api-ldapConfiguration-getLdapConfiguration-2023-01-01-default.sh deleted file mode 100644 index 7696c4d041..0000000000 --- a/docs/command/includes/atlas-api-ldapConfiguration-getLdapConfiguration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api ldapConfiguration getLdapConfiguration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-ldapConfiguration-getLdapConfigurationStatus-2023-01-01-default.sh b/docs/command/includes/atlas-api-ldapConfiguration-getLdapConfigurationStatus-2023-01-01-default.sh deleted file mode 100644 index bcb2c62887..0000000000 --- a/docs/command/includes/atlas-api-ldapConfiguration-getLdapConfigurationStatus-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api ldapConfiguration getLdapConfigurationStatus --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --requestId [requestId] diff --git a/docs/command/includes/atlas-api-legacyBackup-deleteGroupClusterSnapshot-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-deleteGroupClusterSnapshot-2023-01-01-default.sh new file mode 100644 index 0000000000..9a5fd421fa --- /dev/null +++ b/docs/command/includes/atlas-api-legacyBackup-deleteGroupClusterSnapshot-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api legacyBackup deleteGroupClusterSnapshot --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-legacyBackup-deleteLegacySnapshot-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-deleteLegacySnapshot-2023-01-01-default.sh deleted file mode 100644 index 50f11371f1..0000000000 --- a/docs/command/includes/atlas-api-legacyBackup-deleteLegacySnapshot-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api legacyBackup deleteLegacySnapshot --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-legacyBackup-getGroupClusterBackupCheckpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-getGroupClusterBackupCheckpoint-2023-01-01-default.sh new file mode 100644 index 0000000000..38cf8d1d13 --- /dev/null +++ b/docs/command/includes/atlas-api-legacyBackup-getGroupClusterBackupCheckpoint-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api legacyBackup getGroupClusterBackupCheckpoint --version 2023-01-01 --checkpointId [checkpointId] --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-getGroupClusterRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-getGroupClusterRestoreJob-2023-01-01-default.sh new file mode 100644 index 0000000000..d88b9f9a94 --- /dev/null +++ b/docs/command/includes/atlas-api-legacyBackup-getGroupClusterRestoreJob-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api legacyBackup getGroupClusterRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --jobId [jobId] diff --git a/docs/command/includes/atlas-api-legacyBackup-getGroupClusterSnapshot-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-getGroupClusterSnapshot-2023-01-01-default.sh new file mode 100644 index 0000000000..17346259a0 --- /dev/null +++ b/docs/command/includes/atlas-api-legacyBackup-getGroupClusterSnapshot-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api legacyBackup getGroupClusterSnapshot --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-legacyBackup-getGroupClusterSnapshotSchedule-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-getGroupClusterSnapshotSchedule-2023-01-01-default.sh new file mode 100644 index 0000000000..97da6e871f --- /dev/null +++ b/docs/command/includes/atlas-api-legacyBackup-getGroupClusterSnapshotSchedule-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api legacyBackup getGroupClusterSnapshotSchedule --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-getLegacyBackupCheckpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-getLegacyBackupCheckpoint-2023-01-01-default.sh deleted file mode 100644 index fdb6314305..0000000000 --- a/docs/command/includes/atlas-api-legacyBackup-getLegacyBackupCheckpoint-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api legacyBackup getLegacyBackupCheckpoint --version 2023-01-01 --checkpointId [checkpointId] --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-getLegacyBackupRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-getLegacyBackupRestoreJob-2023-01-01-default.sh deleted file mode 100644 index 514d4f828e..0000000000 --- a/docs/command/includes/atlas-api-legacyBackup-getLegacyBackupRestoreJob-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api legacyBackup getLegacyBackupRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --jobId [jobId] diff --git a/docs/command/includes/atlas-api-legacyBackup-getLegacySnapshot-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-getLegacySnapshot-2023-01-01-default.sh deleted file mode 100644 index 22d0742179..0000000000 --- a/docs/command/includes/atlas-api-legacyBackup-getLegacySnapshot-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api legacyBackup getLegacySnapshot --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-legacyBackup-getLegacySnapshotSchedule-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-getLegacySnapshotSchedule-2023-01-01-default.sh deleted file mode 100644 index d1603f0d07..0000000000 --- a/docs/command/includes/atlas-api-legacyBackup-getLegacySnapshotSchedule-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api legacyBackup getLegacySnapshotSchedule --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-listGroupClusterBackupCheckpoints-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-listGroupClusterBackupCheckpoints-2023-01-01-default.sh new file mode 100644 index 0000000000..19f558fe22 --- /dev/null +++ b/docs/command/includes/atlas-api-legacyBackup-listGroupClusterBackupCheckpoints-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api legacyBackup listGroupClusterBackupCheckpoints --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-listGroupClusterRestoreJobs-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-listGroupClusterRestoreJobs-2023-01-01-default.sh new file mode 100644 index 0000000000..b7b2193735 --- /dev/null +++ b/docs/command/includes/atlas-api-legacyBackup-listGroupClusterRestoreJobs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api legacyBackup listGroupClusterRestoreJobs --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-listGroupClusterSnapshots-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-listGroupClusterSnapshots-2023-01-01-default.sh new file mode 100644 index 0000000000..6267ddc5e7 --- /dev/null +++ b/docs/command/includes/atlas-api-legacyBackup-listGroupClusterSnapshots-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api legacyBackup listGroupClusterSnapshots --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-listLegacyBackupCheckpoints-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-listLegacyBackupCheckpoints-2023-01-01-default.sh deleted file mode 100644 index ddc595b44f..0000000000 --- a/docs/command/includes/atlas-api-legacyBackup-listLegacyBackupCheckpoints-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api legacyBackup listLegacyBackupCheckpoints --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-listLegacyBackupRestoreJobs-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-listLegacyBackupRestoreJobs-2023-01-01-default.sh deleted file mode 100644 index b3961ecc90..0000000000 --- a/docs/command/includes/atlas-api-legacyBackup-listLegacyBackupRestoreJobs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api legacyBackup listLegacyBackupRestoreJobs --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-legacyBackup-listLegacySnapshots-2023-01-01-default.sh b/docs/command/includes/atlas-api-legacyBackup-listLegacySnapshots-2023-01-01-default.sh deleted file mode 100644 index deefdb75cb..0000000000 --- a/docs/command/includes/atlas-api-legacyBackup-listLegacySnapshots-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api legacyBackup listLegacySnapshots --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-maintenanceWindows-deferGroupMaintenanceWindow-2023-01-01-default.sh b/docs/command/includes/atlas-api-maintenanceWindows-deferGroupMaintenanceWindow-2023-01-01-default.sh new file mode 100644 index 0000000000..39b9b61f94 --- /dev/null +++ b/docs/command/includes/atlas-api-maintenanceWindows-deferGroupMaintenanceWindow-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api maintenanceWindows deferGroupMaintenanceWindow --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-maintenanceWindows-deferMaintenanceWindow-2023-01-01-default.sh b/docs/command/includes/atlas-api-maintenanceWindows-deferMaintenanceWindow-2023-01-01-default.sh deleted file mode 100644 index 37db439561..0000000000 --- a/docs/command/includes/atlas-api-maintenanceWindows-deferMaintenanceWindow-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api maintenanceWindows deferMaintenanceWindow --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-maintenanceWindows-getGroupMaintenanceWindow-2023-01-01-default.sh b/docs/command/includes/atlas-api-maintenanceWindows-getGroupMaintenanceWindow-2023-01-01-default.sh new file mode 100644 index 0000000000..ede9356ea5 --- /dev/null +++ b/docs/command/includes/atlas-api-maintenanceWindows-getGroupMaintenanceWindow-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api maintenanceWindows getGroupMaintenanceWindow --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-maintenanceWindows-getMaintenanceWindow-2023-01-01-default.sh b/docs/command/includes/atlas-api-maintenanceWindows-getMaintenanceWindow-2023-01-01-default.sh deleted file mode 100644 index 0f72b43824..0000000000 --- a/docs/command/includes/atlas-api-maintenanceWindows-getMaintenanceWindow-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api maintenanceWindows getMaintenanceWindow --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-maintenanceWindows-resetGroupMaintenanceWindow-2023-01-01-default.sh b/docs/command/includes/atlas-api-maintenanceWindows-resetGroupMaintenanceWindow-2023-01-01-default.sh new file mode 100644 index 0000000000..014cad8b97 --- /dev/null +++ b/docs/command/includes/atlas-api-maintenanceWindows-resetGroupMaintenanceWindow-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api maintenanceWindows resetGroupMaintenanceWindow --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-maintenanceWindows-resetMaintenanceWindow-2023-01-01-default.sh b/docs/command/includes/atlas-api-maintenanceWindows-resetMaintenanceWindow-2023-01-01-default.sh deleted file mode 100644 index 5878635a21..0000000000 --- a/docs/command/includes/atlas-api-maintenanceWindows-resetMaintenanceWindow-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api maintenanceWindows resetMaintenanceWindow --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer-2023-01-01-default.sh b/docs/command/includes/atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer-2023-01-01-default.sh new file mode 100644 index 0000000000..1050c458c6 --- /dev/null +++ b/docs/command/includes/atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api maintenanceWindows toggleGroupMaintenanceWindowAutoDefer --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer-2023-01-01-default.sh b/docs/command/includes/atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer-2023-01-01-default.sh deleted file mode 100644 index 9b672f53d5..0000000000 --- a/docs/command/includes/atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api maintenanceWindows toggleMaintenanceAutoDefer --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-getGroupUser-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-getGroupUser-2025-02-19-default.sh new file mode 100644 index 0000000000..3e68303448 --- /dev/null +++ b/docs/command/includes/atlas-api-mongoDbCloudUsers-getGroupUser-2025-02-19-default.sh @@ -0,0 +1 @@ +atlas api mongoDbCloudUsers getGroupUser --version 2025-02-19 --groupId 32b6e34b3d91647abb20e7b8 --userId [userId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-getOrgUser-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-getOrgUser-2025-02-19-default.sh new file mode 100644 index 0000000000..89a4d2d8dd --- /dev/null +++ b/docs/command/includes/atlas-api-mongoDbCloudUsers-getOrgUser-2025-02-19-default.sh @@ -0,0 +1 @@ +atlas api mongoDbCloudUsers getOrgUser --version 2025-02-19 --orgId 4888442a3354817a7320eb61 --userId [userId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-getOrganizationUser-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-getOrganizationUser-2025-02-19-default.sh deleted file mode 100644 index 24e58aaa52..0000000000 --- a/docs/command/includes/atlas-api-mongoDbCloudUsers-getOrganizationUser-2025-02-19-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api mongoDbCloudUsers getOrganizationUser --version 2025-02-19 --orgId 4888442a3354817a7320eb61 --userId [userId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-getProjectUser-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-getProjectUser-2025-02-19-default.sh deleted file mode 100644 index 35c2eb353e..0000000000 --- a/docs/command/includes/atlas-api-mongoDbCloudUsers-getProjectUser-2025-02-19-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api mongoDbCloudUsers getProjectUser --version 2025-02-19 --groupId 32b6e34b3d91647abb20e7b8 --userId [userId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-listGroupUsers-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-listGroupUsers-2025-02-19-default.sh new file mode 100644 index 0000000000..4214599bb0 --- /dev/null +++ b/docs/command/includes/atlas-api-mongoDbCloudUsers-listGroupUsers-2025-02-19-default.sh @@ -0,0 +1 @@ +atlas api mongoDbCloudUsers listGroupUsers --version 2025-02-19 --groupId 32b6e34b3d91647abb20e7b8 --orgMembershipStatus ACTIVE diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrgTeamUsers-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrgTeamUsers-2025-02-19-default.sh new file mode 100644 index 0000000000..99cf808e4a --- /dev/null +++ b/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrgTeamUsers-2025-02-19-default.sh @@ -0,0 +1 @@ +atlas api mongoDbCloudUsers listOrgTeamUsers --version 2025-02-19 --orgId 4888442a3354817a7320eb61 --orgMembershipStatus ACTIVE --teamId [teamId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrgUsers-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrgUsers-2025-02-19-default.sh new file mode 100644 index 0000000000..2a4c0785af --- /dev/null +++ b/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrgUsers-2025-02-19-default.sh @@ -0,0 +1 @@ +atlas api mongoDbCloudUsers listOrgUsers --version 2025-02-19 --orgId 4888442a3354817a7320eb61 --orgMembershipStatus ACTIVE diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrganizationUsers-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrganizationUsers-2025-02-19-default.sh deleted file mode 100644 index 108f8019d8..0000000000 --- a/docs/command/includes/atlas-api-mongoDbCloudUsers-listOrganizationUsers-2025-02-19-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api mongoDbCloudUsers listOrganizationUsers --version 2025-02-19 --orgId 4888442a3354817a7320eb61 --orgMembershipStatus ACTIVE diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-listProjectUsers-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-listProjectUsers-2025-02-19-default.sh deleted file mode 100644 index 6554f026b7..0000000000 --- a/docs/command/includes/atlas-api-mongoDbCloudUsers-listProjectUsers-2025-02-19-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api mongoDbCloudUsers listProjectUsers --version 2025-02-19 --groupId 32b6e34b3d91647abb20e7b8 --orgMembershipStatus ACTIVE diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-listTeamUsers-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-listTeamUsers-2025-02-19-default.sh deleted file mode 100644 index 5cc0ce2074..0000000000 --- a/docs/command/includes/atlas-api-mongoDbCloudUsers-listTeamUsers-2025-02-19-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api mongoDbCloudUsers listTeamUsers --version 2025-02-19 --orgId 4888442a3354817a7320eb61 --orgMembershipStatus ACTIVE --teamId [teamId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-removeGroupUser-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-removeGroupUser-2025-02-19-default.sh new file mode 100644 index 0000000000..555fda81cb --- /dev/null +++ b/docs/command/includes/atlas-api-mongoDbCloudUsers-removeGroupUser-2025-02-19-default.sh @@ -0,0 +1 @@ +atlas api mongoDbCloudUsers removeGroupUser --version 2025-02-19 --groupId 32b6e34b3d91647abb20e7b8 --userId [userId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-removeOrgUser-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-removeOrgUser-2025-02-19-default.sh new file mode 100644 index 0000000000..3b95e02742 --- /dev/null +++ b/docs/command/includes/atlas-api-mongoDbCloudUsers-removeOrgUser-2025-02-19-default.sh @@ -0,0 +1 @@ +atlas api mongoDbCloudUsers removeOrgUser --version 2025-02-19 --orgId 4888442a3354817a7320eb61 --userId [userId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-removeOrganizationUser-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-removeOrganizationUser-2025-02-19-default.sh deleted file mode 100644 index 0d8a155260..0000000000 --- a/docs/command/includes/atlas-api-mongoDbCloudUsers-removeOrganizationUser-2025-02-19-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api mongoDbCloudUsers removeOrganizationUser --version 2025-02-19 --orgId 4888442a3354817a7320eb61 --userId [userId] diff --git a/docs/command/includes/atlas-api-mongoDbCloudUsers-removeProjectUser-2025-02-19-default.sh b/docs/command/includes/atlas-api-mongoDbCloudUsers-removeProjectUser-2025-02-19-default.sh deleted file mode 100644 index 260e5b2234..0000000000 --- a/docs/command/includes/atlas-api-mongoDbCloudUsers-removeProjectUser-2025-02-19-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api mongoDbCloudUsers removeProjectUser --version 2025-02-19 --groupId 32b6e34b3d91647abb20e7b8 --userId [userId] diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-downloadGroupClusterLog-2023-02-01-get_host_logs.sh b/docs/command/includes/atlas-api-monitoringAndLogs-downloadGroupClusterLog-2023-02-01-get_host_logs.sh new file mode 100644 index 0000000000..f119024bf1 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-downloadGroupClusterLog-2023-02-01-get_host_logs.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs downloadGroupClusterLog --version 2023-02-01 --endDate 1609545600 --groupId [your-project-id] --hostName [your-host-name] --logName mongodb --startDate 1609459200 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getAtlasProcess-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getAtlasProcess-2023-01-01-default.sh deleted file mode 100644 index 9fcc8aaec1..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-getAtlasProcess-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs getAtlasProcess --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getDatabase-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getDatabase-2023-01-01-default.sh deleted file mode 100644 index 6fd468fbd8..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-getDatabase-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs getDatabase --version 2023-01-01 --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getDatabaseMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getDatabaseMeasurements-2023-01-01-default.sh deleted file mode 100644 index 71c3abad94..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-getDatabaseMeasurements-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs getDatabaseMeasurements --version 2023-01-01 --databaseName [databaseName] --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getDiskMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getDiskMeasurements-2023-01-01-default.sh deleted file mode 100644 index 4436d359ee..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-getDiskMeasurements-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs getDiskMeasurements --version 2023-01-01 --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --partitionName [partitionName] --period PT10H --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements-2023-01-01-default.sh new file mode 100644 index 0000000000..cedd1128c8 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs getGroupHostFtsMetricIndexMeasurements --version 2023-01-01 --collectionName mycoll --databaseName mydb --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --indexName myindex --metrics [metrics] --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcess-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcess-2023-01-01-default.sh new file mode 100644 index 0000000000..330e1cb8d8 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcess-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs getGroupProcess --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDatabase-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDatabase-2023-01-01-default.sh new file mode 100644 index 0000000000..6d94b6b921 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDatabase-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs getGroupProcessDatabase --version 2023-01-01 --databaseName [databaseName] --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements-2023-01-01-default.sh new file mode 100644 index 0000000000..bfaffdfa8a --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs getGroupProcessDatabaseMeasurements --version 2023-01-01 --databaseName [databaseName] --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDisk-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDisk-2023-01-01-default.sh new file mode 100644 index 0000000000..904774e9ce --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDisk-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs getGroupProcessDisk --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --partitionName [partitionName] --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements-2023-01-01-default.sh new file mode 100644 index 0000000000..cd4c90bdfc --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs getGroupProcessDiskMeasurements --version 2023-01-01 --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --partitionName [partitionName] --period PT10H --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessMeasurements-2023-01-01-default.sh new file mode 100644 index 0000000000..4d9160898a --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-getGroupProcessMeasurements-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs getGroupProcessMeasurements --version 2023-01-01 --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getHostLogs-2023-02-01-get_host_logs.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getHostLogs-2023-02-01-get_host_logs.sh deleted file mode 100644 index adb7ec53fa..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-getHostLogs-2023-02-01-get_host_logs.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs getHostLogs --version 2023-02-01 --endDate 1609545600 --groupId [your-project-id] --hostName [your-host-name] --logName mongodb --startDate 1609459200 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getHostMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getHostMeasurements-2023-01-01-default.sh deleted file mode 100644 index 23b770a3bd..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-getHostMeasurements-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs getHostMeasurements --version 2023-01-01 --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --period PT10H --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getIndexMetrics-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getIndexMetrics-2023-01-01-default.sh deleted file mode 100644 index 0f87b66f43..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-getIndexMetrics-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs getIndexMetrics --version 2023-01-01 --collectionName mycoll --databaseName mydb --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --indexName myindex --metrics [metrics] --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-getMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-getMeasurements-2023-01-01-default.sh deleted file mode 100644 index 8440917671..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-getMeasurements-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs getMeasurements --version 2023-01-01 --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --metrics [metrics] --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listAtlasProcesses-2023-01-01-list_atlas_processes.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listAtlasProcesses-2023-01-01-list_atlas_processes.sh deleted file mode 100644 index 7b2c9622b5..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-listAtlasProcesses-2023-01-01-list_atlas_processes.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs listAtlasProcesses --version 2023-01-01 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listDatabases-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listDatabases-2023-01-01-default.sh deleted file mode 100644 index fbb27b61fd..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-listDatabases-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs listDatabases --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listDiskMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listDiskMeasurements-2023-01-01-default.sh deleted file mode 100644 index b89af3b78f..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-listDiskMeasurements-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs listDiskMeasurements --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --partitionName [partitionName] --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listDiskPartitions-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listDiskPartitions-2023-01-01-default.sh deleted file mode 100644 index f9d0079251..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-listDiskPartitions-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs listDiskPartitions --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements-2023-01-01-default.sh new file mode 100644 index 0000000000..5ba7f97e37 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs listGroupHostFtsMetricIndexMeasurements --version 2023-01-01 --collectionName mycoll --databaseName mydb --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --metrics [metrics] --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements-2023-01-01-default.sh new file mode 100644 index 0000000000..75c6710131 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs listGroupHostFtsMetricMeasurements --version 2023-01-01 --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --metrics [metrics] --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetrics-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetrics-2023-01-01-default.sh new file mode 100644 index 0000000000..2fdf832ee6 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupHostFtsMetrics-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs listGroupHostFtsMetrics --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcessDatabases-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcessDatabases-2023-01-01-default.sh new file mode 100644 index 0000000000..dd7efce447 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcessDatabases-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs listGroupProcessDatabases --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcessDisks-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcessDisks-2023-01-01-default.sh new file mode 100644 index 0000000000..8d86e19448 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcessDisks-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs listGroupProcessDisks --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId mongodb.example.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcesses-2023-01-01-list_atlas_processes.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcesses-2023-01-01-list_atlas_processes.sh new file mode 100644 index 0000000000..4dad6de350 --- /dev/null +++ b/docs/command/includes/atlas-api-monitoringAndLogs-listGroupProcesses-2023-01-01-list_atlas_processes.sh @@ -0,0 +1 @@ +atlas api monitoringAndLogs listGroupProcesses --version 2023-01-01 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listIndexMetrics-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listIndexMetrics-2023-01-01-default.sh deleted file mode 100644 index ef5af06d12..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-listIndexMetrics-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs listIndexMetrics --version 2023-01-01 --collectionName mycoll --databaseName mydb --granularity PT1M --groupId 32b6e34b3d91647abb20e7b8 --metrics [metrics] --period PT10H --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-monitoringAndLogs-listMetricTypes-2023-01-01-default.sh b/docs/command/includes/atlas-api-monitoringAndLogs-listMetricTypes-2023-01-01-default.sh deleted file mode 100644 index 2bfdb934ad..0000000000 --- a/docs/command/includes/atlas-api-monitoringAndLogs-listMetricTypes-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api monitoringAndLogs listMetricTypes --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId my.host.name.com:27017 diff --git a/docs/command/includes/atlas-api-networkPeering-deleteGroupContainer-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-deleteGroupContainer-2023-01-01-default.sh new file mode 100644 index 0000000000..e4347b4cdc --- /dev/null +++ b/docs/command/includes/atlas-api-networkPeering-deleteGroupContainer-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api networkPeering deleteGroupContainer --version 2023-01-01 --containerId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-deleteGroupPeer-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-deleteGroupPeer-2023-01-01-default.sh new file mode 100644 index 0000000000..a4283fab03 --- /dev/null +++ b/docs/command/includes/atlas-api-networkPeering-deleteGroupPeer-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api networkPeering deleteGroupPeer --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --peerId [peerId] diff --git a/docs/command/includes/atlas-api-networkPeering-deletePeeringConnection-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-deletePeeringConnection-2023-01-01-default.sh deleted file mode 100644 index 3134d1c29b..0000000000 --- a/docs/command/includes/atlas-api-networkPeering-deletePeeringConnection-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api networkPeering deletePeeringConnection --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --peerId [peerId] diff --git a/docs/command/includes/atlas-api-networkPeering-deletePeeringContainer-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-deletePeeringContainer-2023-01-01-default.sh deleted file mode 100644 index e91dc31f3c..0000000000 --- a/docs/command/includes/atlas-api-networkPeering-deletePeeringContainer-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api networkPeering deletePeeringContainer --version 2023-01-01 --containerId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-getGroupContainer-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-getGroupContainer-2023-01-01-default.sh new file mode 100644 index 0000000000..72af14801e --- /dev/null +++ b/docs/command/includes/atlas-api-networkPeering-getGroupContainer-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api networkPeering getGroupContainer --version 2023-01-01 --containerId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-getGroupPeer-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-getGroupPeer-2023-01-01-default.sh new file mode 100644 index 0000000000..8d03622f5c --- /dev/null +++ b/docs/command/includes/atlas-api-networkPeering-getGroupPeer-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api networkPeering getGroupPeer --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --peerId [peerId] diff --git a/docs/command/includes/atlas-api-networkPeering-getPeeringConnection-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-getPeeringConnection-2023-01-01-default.sh deleted file mode 100644 index 9109addb73..0000000000 --- a/docs/command/includes/atlas-api-networkPeering-getPeeringConnection-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api networkPeering getPeeringConnection --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --peerId [peerId] diff --git a/docs/command/includes/atlas-api-networkPeering-getPeeringContainer-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-getPeeringContainer-2023-01-01-default.sh deleted file mode 100644 index b79784797a..0000000000 --- a/docs/command/includes/atlas-api-networkPeering-getPeeringContainer-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api networkPeering getPeeringContainer --version 2023-01-01 --containerId 32b6e34b3d91647abb20e7b8 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-listGroupContainerAll-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-listGroupContainerAll-2023-01-01-default.sh new file mode 100644 index 0000000000..b4dd3e4dbb --- /dev/null +++ b/docs/command/includes/atlas-api-networkPeering-listGroupContainerAll-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api networkPeering listGroupContainerAll --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-listGroupContainers-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-listGroupContainers-2023-01-01-default.sh new file mode 100644 index 0000000000..65a309747a --- /dev/null +++ b/docs/command/includes/atlas-api-networkPeering-listGroupContainers-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api networkPeering listGroupContainers --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --providerName [providerName] diff --git a/docs/command/includes/atlas-api-networkPeering-listGroupPeers-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-listGroupPeers-2023-01-01-default.sh new file mode 100644 index 0000000000..726cf732b7 --- /dev/null +++ b/docs/command/includes/atlas-api-networkPeering-listGroupPeers-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api networkPeering listGroupPeers --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-listPeeringConnections-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-listPeeringConnections-2023-01-01-default.sh deleted file mode 100644 index 95eda33afe..0000000000 --- a/docs/command/includes/atlas-api-networkPeering-listPeeringConnections-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api networkPeering listPeeringConnections --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-listPeeringContainerByCloudProvider-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-listPeeringContainerByCloudProvider-2023-01-01-default.sh deleted file mode 100644 index e585486aa9..0000000000 --- a/docs/command/includes/atlas-api-networkPeering-listPeeringContainerByCloudProvider-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api networkPeering listPeeringContainerByCloudProvider --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --providerName [providerName] diff --git a/docs/command/includes/atlas-api-networkPeering-listPeeringContainers-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-listPeeringContainers-2023-01-01-default.sh deleted file mode 100644 index 7c648f5230..0000000000 --- a/docs/command/includes/atlas-api-networkPeering-listPeeringContainers-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api networkPeering listPeeringContainers --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject-2023-01-01-default.sh deleted file mode 100644 index 26c6d726bc..0000000000 --- a/docs/command/includes/atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api networkPeering verifyConnectViaPeeringOnlyModeForOneProject --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-networkPeering-verifyGroupPrivateIpMode-2023-01-01-default.sh b/docs/command/includes/atlas-api-networkPeering-verifyGroupPrivateIpMode-2023-01-01-default.sh new file mode 100644 index 0000000000..05acbd333b --- /dev/null +++ b/docs/command/includes/atlas-api-networkPeering-verifyGroupPrivateIpMode-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api networkPeering verifyGroupPrivateIpMode --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-onlineArchive-deleteGroupClusterOnlineArchive-2023-01-01-default.sh b/docs/command/includes/atlas-api-onlineArchive-deleteGroupClusterOnlineArchive-2023-01-01-default.sh new file mode 100644 index 0000000000..7f850b1541 --- /dev/null +++ b/docs/command/includes/atlas-api-onlineArchive-deleteGroupClusterOnlineArchive-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api onlineArchive deleteGroupClusterOnlineArchive --version 2023-01-01 --archiveId [archiveId] --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-onlineArchive-deleteOnlineArchive-2023-01-01-default.sh b/docs/command/includes/atlas-api-onlineArchive-deleteOnlineArchive-2023-01-01-default.sh deleted file mode 100644 index d463ff8e0f..0000000000 --- a/docs/command/includes/atlas-api-onlineArchive-deleteOnlineArchive-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api onlineArchive deleteOnlineArchive --version 2023-01-01 --archiveId [archiveId] --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs-2023-01-01-default.sh b/docs/command/includes/atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs-2023-01-01-default.sh new file mode 100644 index 0000000000..1b503e3a4a --- /dev/null +++ b/docs/command/includes/atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api onlineArchive downloadGroupClusterOnlineArchiveQueryLogs --version 2023-01-01 --clusterName [clusterName] --endDate 1.636481348e+09 --groupId 32b6e34b3d91647abb20e7b8 --startDate 1.636481348e+09 diff --git a/docs/command/includes/atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs-2023-01-01-default.sh b/docs/command/includes/atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs-2023-01-01-default.sh deleted file mode 100644 index 5e84f40bca..0000000000 --- a/docs/command/includes/atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api onlineArchive downloadOnlineArchiveQueryLogs --version 2023-01-01 --clusterName [clusterName] --endDate 1.636481348e+09 --groupId 32b6e34b3d91647abb20e7b8 --startDate 1.636481348e+09 diff --git a/docs/command/includes/atlas-api-onlineArchive-getGroupClusterOnlineArchive-2023-01-01-default.sh b/docs/command/includes/atlas-api-onlineArchive-getGroupClusterOnlineArchive-2023-01-01-default.sh new file mode 100644 index 0000000000..399428e3c7 --- /dev/null +++ b/docs/command/includes/atlas-api-onlineArchive-getGroupClusterOnlineArchive-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api onlineArchive getGroupClusterOnlineArchive --version 2023-01-01 --archiveId [archiveId] --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-onlineArchive-getOnlineArchive-2023-01-01-default.sh b/docs/command/includes/atlas-api-onlineArchive-getOnlineArchive-2023-01-01-default.sh deleted file mode 100644 index 823d7a566e..0000000000 --- a/docs/command/includes/atlas-api-onlineArchive-getOnlineArchive-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api onlineArchive getOnlineArchive --version 2023-01-01 --archiveId [archiveId] --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-onlineArchive-listGroupClusterOnlineArchives-2023-01-01-default.sh b/docs/command/includes/atlas-api-onlineArchive-listGroupClusterOnlineArchives-2023-01-01-default.sh new file mode 100644 index 0000000000..7818aa415e --- /dev/null +++ b/docs/command/includes/atlas-api-onlineArchive-listGroupClusterOnlineArchives-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api onlineArchive listGroupClusterOnlineArchives --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-onlineArchive-listOnlineArchives-2023-01-01-default.sh b/docs/command/includes/atlas-api-onlineArchive-listOnlineArchives-2023-01-01-default.sh deleted file mode 100644 index dc6920c9e1..0000000000 --- a/docs/command/includes/atlas-api-onlineArchive-listOnlineArchives-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api onlineArchive listOnlineArchives --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-organizations-deleteOrg-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-deleteOrg-2023-01-01-default.sh new file mode 100644 index 0000000000..a3b271afec --- /dev/null +++ b/docs/command/includes/atlas-api-organizations-deleteOrg-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api organizations deleteOrg --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-deleteOrgInvite-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-deleteOrgInvite-2023-01-01-default.sh new file mode 100644 index 0000000000..2d40cc6c21 --- /dev/null +++ b/docs/command/includes/atlas-api-organizations-deleteOrgInvite-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api organizations deleteOrgInvite --version 2023-01-01 --invitationId [invitationId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-deleteOrganization-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-deleteOrganization-2023-01-01-default.sh deleted file mode 100644 index de80fcaf42..0000000000 --- a/docs/command/includes/atlas-api-organizations-deleteOrganization-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api organizations deleteOrganization --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-deleteOrganizationInvitation-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-deleteOrganizationInvitation-2023-01-01-default.sh deleted file mode 100644 index b610cb9eb5..0000000000 --- a/docs/command/includes/atlas-api-organizations-deleteOrganizationInvitation-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api organizations deleteOrganizationInvitation --version 2023-01-01 --invitationId [invitationId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-getOrg-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-getOrg-2023-01-01-default.sh new file mode 100644 index 0000000000..c57fbdb9d3 --- /dev/null +++ b/docs/command/includes/atlas-api-organizations-getOrg-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api organizations getOrg --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-getOrgGroups-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-getOrgGroups-2023-01-01-default.sh new file mode 100644 index 0000000000..6f9e1b6d7c --- /dev/null +++ b/docs/command/includes/atlas-api-organizations-getOrgGroups-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api organizations getOrgGroups --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-getOrgInvite-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-getOrgInvite-2023-01-01-default.sh new file mode 100644 index 0000000000..22f4b0fe38 --- /dev/null +++ b/docs/command/includes/atlas-api-organizations-getOrgInvite-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api organizations getOrgInvite --version 2023-01-01 --invitationId [invitationId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-getOrgSettings-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-getOrgSettings-2023-01-01-default.sh new file mode 100644 index 0000000000..a13c37fdc4 --- /dev/null +++ b/docs/command/includes/atlas-api-organizations-getOrgSettings-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api organizations getOrgSettings --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-getOrganization-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-getOrganization-2023-01-01-default.sh deleted file mode 100644 index 6652f4677a..0000000000 --- a/docs/command/includes/atlas-api-organizations-getOrganization-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api organizations getOrganization --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-getOrganizationInvitation-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-getOrganizationInvitation-2023-01-01-default.sh deleted file mode 100644 index 141ced36f6..0000000000 --- a/docs/command/includes/atlas-api-organizations-getOrganizationInvitation-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api organizations getOrganizationInvitation --version 2023-01-01 --invitationId [invitationId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-getOrganizationSettings-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-getOrganizationSettings-2023-01-01-default.sh deleted file mode 100644 index c241b7debb..0000000000 --- a/docs/command/includes/atlas-api-organizations-getOrganizationSettings-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api organizations getOrganizationSettings --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-listOrgInvites-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-listOrgInvites-2023-01-01-default.sh new file mode 100644 index 0000000000..9cd14f8026 --- /dev/null +++ b/docs/command/includes/atlas-api-organizations-listOrgInvites-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api organizations listOrgInvites --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-listOrganizationInvitations-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-listOrganizationInvitations-2023-01-01-default.sh deleted file mode 100644 index 256026bde2..0000000000 --- a/docs/command/includes/atlas-api-organizations-listOrganizationInvitations-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api organizations listOrganizationInvitations --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-organizations-listOrganizationProjects-2023-01-01-default.sh b/docs/command/includes/atlas-api-organizations-listOrganizationProjects-2023-01-01-default.sh deleted file mode 100644 index 37f7d93cd9..0000000000 --- a/docs/command/includes/atlas-api-organizations-listOrganizationProjects-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api organizations listOrganizationProjects --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-disableGroupManagedSlowMs-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-disableGroupManagedSlowMs-2023-01-01-default.sh new file mode 100644 index 0000000000..d2c6226a30 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-disableGroupManagedSlowMs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor disableGroupManagedSlowMs --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-disableSlowOperationThresholding-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-disableSlowOperationThresholding-2023-01-01-default.sh deleted file mode 100644 index 1fe2f35b5e..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-disableSlowOperationThresholding-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor disableSlowOperationThresholding --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-enableGroupManagedSlowMs-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-enableGroupManagedSlowMs-2023-01-01-default.sh new file mode 100644 index 0000000000..68cfb98e40 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-enableGroupManagedSlowMs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor enableGroupManagedSlowMs --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-enableSlowOperationThresholding-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-enableSlowOperationThresholding-2023-01-01-default.sh deleted file mode 100644 index a63f83087f..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-enableSlowOperationThresholding-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor enableSlowOperationThresholding --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-getGroupManagedSlowMs-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-getGroupManagedSlowMs-2023-01-01-default.sh new file mode 100644 index 0000000000..cf6cc0817c --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-getGroupManagedSlowMs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor getGroupManagedSlowMs --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing-2023-01-01-default.sh new file mode 100644 index 0000000000..929a0433e8 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor getGroupServerlessPerformanceAdvisorAutoIndexing --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-getManagedSlowMs-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-getManagedSlowMs-2023-01-01-default.sh deleted file mode 100644 index 35b25acd36..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-getManagedSlowMs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor getManagedSlowMs --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-getServerlessAutoIndexing-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-getServerlessAutoIndexing-2023-01-01-default.sh deleted file mode 100644 index 90eee12166..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-getServerlessAutoIndexing-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor getServerlessAutoIndexing --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listClusterSuggestedIndexes-2024-08-05-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listClusterSuggestedIndexes-2024-08-05-default.sh deleted file mode 100644 index c17e9f66fa..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-listClusterSuggestedIndexes-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor listClusterSuggestedIndexes --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listDropIndexes-2024-08-05-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listDropIndexes-2024-08-05-default.sh deleted file mode 100644 index 3937770d4c..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-listDropIndexes-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor listDropIndexes --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions-2024-08-05-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions-2024-08-05-default.sh new file mode 100644 index 0000000000..4c673eb4b1 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor listGroupClusterPerformanceAdvisorDropIndexSuggestions --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice-2024-08-05-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice-2024-08-05-default.sh new file mode 100644 index 0000000000..ddb94fd075 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor listGroupClusterPerformanceAdvisorSchemaAdvice --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes-2024-08-05-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes-2024-08-05-default.sh new file mode 100644 index 0000000000..dc0fd23533 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor listGroupClusterPerformanceAdvisorSuggestedIndexes --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces-2023-01-01-default.sh new file mode 100644 index 0000000000..9f5d660c60 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor listGroupProcessPerformanceAdvisorNamespaces --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId [processId] diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs-2023-01-01-default.sh new file mode 100644 index 0000000000..5d7cd2caa5 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor listGroupProcessPerformanceAdvisorSlowQueryLogs --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId [processId] diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes-2023-01-01-default.sh new file mode 100644 index 0000000000..e6ca1b0454 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor listGroupProcessPerformanceAdvisorSuggestedIndexes --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId [processId] diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listSchemaAdvice-2024-08-05-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listSchemaAdvice-2024-08-05-default.sh deleted file mode 100644 index 603a06826c..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-listSchemaAdvice-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor listSchemaAdvice --version 2024-08-05 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listSlowQueries-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listSlowQueries-2023-01-01-default.sh deleted file mode 100644 index 6cda70499d..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-listSlowQueries-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor listSlowQueries --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId [processId] diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listSlowQueryNamespaces-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listSlowQueryNamespaces-2023-01-01-default.sh deleted file mode 100644 index 8379bbb678..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-listSlowQueryNamespaces-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor listSlowQueryNamespaces --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId [processId] diff --git a/docs/command/includes/atlas-api-performanceAdvisor-listSuggestedIndexes-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-listSuggestedIndexes-2023-01-01-default.sh deleted file mode 100644 index f914a7caa4..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-listSuggestedIndexes-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor listSuggestedIndexes --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --processId [processId] diff --git a/docs/command/includes/atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing-2023-01-01-default.sh new file mode 100644 index 0000000000..3b4b115509 --- /dev/null +++ b/docs/command/includes/atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api performanceAdvisor setGroupServerlessPerformanceAdvisorAutoIndexing --version 2023-01-01 --clusterName [clusterName] --enable [enable] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-performanceAdvisor-setServerlessAutoIndexing-2023-01-01-default.sh b/docs/command/includes/atlas-api-performanceAdvisor-setServerlessAutoIndexing-2023-01-01-default.sh deleted file mode 100644 index 8674c7ecd2..0000000000 --- a/docs/command/includes/atlas-api-performanceAdvisor-setServerlessAutoIndexing-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api performanceAdvisor setServerlessAutoIndexing --version 2023-01-01 --clusterName [clusterName] --enable [enable] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService-2023-01-01-default.sh new file mode 100644 index 0000000000..56d94534cf --- /dev/null +++ b/docs/command/includes/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api privateEndpointServices deleteGroupPrivateEndpointEndpointService --version 2023-01-01 --cloudProvider [cloudProvider] --endpointServiceId [endpointServiceId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint-2023-01-01-default.sh new file mode 100644 index 0000000000..6d5f236991 --- /dev/null +++ b/docs/command/includes/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api privateEndpointServices deleteGroupPrivateEndpointEndpointServiceEndpoint --version 2023-01-01 --cloudProvider [cloudProvider] --endpointId [endpointId] --endpointServiceId [endpointServiceId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-deletePrivateEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-deletePrivateEndpoint-2023-01-01-default.sh deleted file mode 100644 index 91e4ac40c7..0000000000 --- a/docs/command/includes/atlas-api-privateEndpointServices-deletePrivateEndpoint-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api privateEndpointServices deletePrivateEndpoint --version 2023-01-01 --cloudProvider [cloudProvider] --endpointId [endpointId] --endpointServiceId [endpointServiceId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-deletePrivateEndpointService-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-deletePrivateEndpointService-2023-01-01-default.sh deleted file mode 100644 index 7d2dc87e56..0000000000 --- a/docs/command/includes/atlas-api-privateEndpointServices-deletePrivateEndpointService-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api privateEndpointServices deletePrivateEndpointService --version 2023-01-01 --cloudProvider [cloudProvider] --endpointServiceId [endpointServiceId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService-2023-01-01-default.sh new file mode 100644 index 0000000000..d3deaf0905 --- /dev/null +++ b/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api privateEndpointServices getGroupPrivateEndpointEndpointService --version 2023-01-01 --cloudProvider [cloudProvider] --endpointServiceId [endpointServiceId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint-2023-01-01-default.sh new file mode 100644 index 0000000000..488f24dd2c --- /dev/null +++ b/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api privateEndpointServices getGroupPrivateEndpointEndpointServiceEndpoint --version 2023-01-01 --cloudProvider [cloudProvider] --endpointId [endpointId] --endpointServiceId [endpointServiceId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode-2023-01-01-default.sh new file mode 100644 index 0000000000..be6eb3221d --- /dev/null +++ b/docs/command/includes/atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api privateEndpointServices getGroupPrivateEndpointRegionalMode --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-getPrivateEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-getPrivateEndpoint-2023-01-01-default.sh deleted file mode 100644 index 351f38e686..0000000000 --- a/docs/command/includes/atlas-api-privateEndpointServices-getPrivateEndpoint-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api privateEndpointServices getPrivateEndpoint --version 2023-01-01 --cloudProvider [cloudProvider] --endpointId [endpointId] --endpointServiceId [endpointServiceId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-getPrivateEndpointService-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-getPrivateEndpointService-2023-01-01-default.sh deleted file mode 100644 index a60782a815..0000000000 --- a/docs/command/includes/atlas-api-privateEndpointServices-getPrivateEndpointService-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api privateEndpointServices getPrivateEndpointService --version 2023-01-01 --cloudProvider [cloudProvider] --endpointServiceId [endpointServiceId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting-2023-01-01-default.sh deleted file mode 100644 index 24fecdd5f6..0000000000 --- a/docs/command/includes/atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api privateEndpointServices getRegionalizedPrivateEndpointSetting --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService-2023-01-01-default.sh new file mode 100644 index 0000000000..d4c79de775 --- /dev/null +++ b/docs/command/includes/atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api privateEndpointServices listGroupPrivateEndpointEndpointService --version 2023-01-01 --cloudProvider [cloudProvider] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-privateEndpointServices-listPrivateEndpointServices-2023-01-01-default.sh b/docs/command/includes/atlas-api-privateEndpointServices-listPrivateEndpointServices-2023-01-01-default.sh deleted file mode 100644 index b0c0ed82b5..0000000000 --- a/docs/command/includes/atlas-api-privateEndpointServices-listPrivateEndpointServices-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api privateEndpointServices listPrivateEndpointServices --version 2023-01-01 --cloudProvider [cloudProvider] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-deleteApiKey-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-deleteApiKey-2023-01-01-default.sh deleted file mode 100644 index e4018aec8b..0000000000 --- a/docs/command/includes/atlas-api-programmaticApiKeys-deleteApiKey-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api programmaticApiKeys deleteApiKey --version 2023-01-01 --apiUserId [apiUserId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry-2023-01-01-default.sh deleted file mode 100644 index 11a6c88d65..0000000000 --- a/docs/command/includes/atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api programmaticApiKeys deleteApiKeyAccessListEntry --version 2023-01-01 --apiUserId [apiUserId] --ipAddress 192.0.2.0%2F24 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-deleteOrgApiKey-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-deleteOrgApiKey-2023-01-01-default.sh new file mode 100644 index 0000000000..58470ffb9c --- /dev/null +++ b/docs/command/includes/atlas-api-programmaticApiKeys-deleteOrgApiKey-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api programmaticApiKeys deleteOrgApiKey --version 2023-01-01 --apiUserId [apiUserId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry-2023-01-01-default.sh new file mode 100644 index 0000000000..279bf211e8 --- /dev/null +++ b/docs/command/includes/atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api programmaticApiKeys deleteOrgApiKeyAccessListEntry --version 2023-01-01 --apiUserId [apiUserId] --ipAddress 192.0.2.0%2F24 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-getApiKey-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-getApiKey-2023-01-01-default.sh deleted file mode 100644 index 055f0fa68c..0000000000 --- a/docs/command/includes/atlas-api-programmaticApiKeys-getApiKey-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api programmaticApiKeys getApiKey --version 2023-01-01 --apiUserId [apiUserId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-getApiKeyAccessList-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-getApiKeyAccessList-2023-01-01-default.sh deleted file mode 100644 index db4fd88216..0000000000 --- a/docs/command/includes/atlas-api-programmaticApiKeys-getApiKeyAccessList-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api programmaticApiKeys getApiKeyAccessList --version 2023-01-01 --apiUserId [apiUserId] --ipAddress 192.0.2.0%2F24 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-getOrgApiKey-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-getOrgApiKey-2023-01-01-default.sh new file mode 100644 index 0000000000..7b920b880f --- /dev/null +++ b/docs/command/includes/atlas-api-programmaticApiKeys-getOrgApiKey-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api programmaticApiKeys getOrgApiKey --version 2023-01-01 --apiUserId [apiUserId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry-2023-01-01-default.sh new file mode 100644 index 0000000000..853a019e04 --- /dev/null +++ b/docs/command/includes/atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api programmaticApiKeys getOrgApiKeyAccessListEntry --version 2023-01-01 --apiUserId [apiUserId] --ipAddress 192.0.2.0%2F24 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries-2023-01-01-default.sh deleted file mode 100644 index fea69f42f3..0000000000 --- a/docs/command/includes/atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api programmaticApiKeys listApiKeyAccessListsEntries --version 2023-01-01 --apiUserId [apiUserId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-listApiKeys-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-listApiKeys-2023-01-01-default.sh deleted file mode 100644 index f4731b5e32..0000000000 --- a/docs/command/includes/atlas-api-programmaticApiKeys-listApiKeys-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api programmaticApiKeys listApiKeys --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-listGroupApiKeys-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-listGroupApiKeys-2023-01-01-default.sh new file mode 100644 index 0000000000..f8aad988a2 --- /dev/null +++ b/docs/command/includes/atlas-api-programmaticApiKeys-listGroupApiKeys-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api programmaticApiKeys listGroupApiKeys --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries-2023-01-01-default.sh new file mode 100644 index 0000000000..6126340b96 --- /dev/null +++ b/docs/command/includes/atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api programmaticApiKeys listOrgApiKeyAccessListEntries --version 2023-01-01 --apiUserId [apiUserId] --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-listOrgApiKeys-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-listOrgApiKeys-2023-01-01-default.sh new file mode 100644 index 0000000000..506387234f --- /dev/null +++ b/docs/command/includes/atlas-api-programmaticApiKeys-listOrgApiKeys-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api programmaticApiKeys listOrgApiKeys --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-listProjectApiKeys-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-listProjectApiKeys-2023-01-01-default.sh deleted file mode 100644 index 7b5ed17cec..0000000000 --- a/docs/command/includes/atlas-api-programmaticApiKeys-listProjectApiKeys-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api programmaticApiKeys listProjectApiKeys --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-removeGroupApiKey-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-removeGroupApiKey-2023-01-01-default.sh new file mode 100644 index 0000000000..66dc3fe198 --- /dev/null +++ b/docs/command/includes/atlas-api-programmaticApiKeys-removeGroupApiKey-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api programmaticApiKeys removeGroupApiKey --version 2023-01-01 --apiUserId [apiUserId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-programmaticApiKeys-removeProjectApiKey-2023-01-01-default.sh b/docs/command/includes/atlas-api-programmaticApiKeys-removeProjectApiKey-2023-01-01-default.sh deleted file mode 100644 index 71c8b9dabd..0000000000 --- a/docs/command/includes/atlas-api-programmaticApiKeys-removeProjectApiKey-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api programmaticApiKeys removeProjectApiKey --version 2023-01-01 --apiUserId [apiUserId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projectIpAccessList-createProjectIpAccessList-2023-01-01-project_ip_access_list_add-payload.json b/docs/command/includes/atlas-api-projectIpAccessList-createGroupAccessListEntry-2023-01-01-project_ip_access_list_add-payload.json similarity index 100% rename from docs/command/includes/atlas-api-projectIpAccessList-createProjectIpAccessList-2023-01-01-project_ip_access_list_add-payload.json rename to docs/command/includes/atlas-api-projectIpAccessList-createGroupAccessListEntry-2023-01-01-project_ip_access_list_add-payload.json diff --git a/docs/command/includes/atlas-api-projectIpAccessList-createGroupAccessListEntry-2023-01-01-project_ip_access_list_add.sh b/docs/command/includes/atlas-api-projectIpAccessList-createGroupAccessListEntry-2023-01-01-project_ip_access_list_add.sh new file mode 100644 index 0000000000..350ee9a712 --- /dev/null +++ b/docs/command/includes/atlas-api-projectIpAccessList-createGroupAccessListEntry-2023-01-01-project_ip_access_list_add.sh @@ -0,0 +1 @@ +atlas api projectIpAccessList createGroupAccessListEntry --version 2023-01-01 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-createProjectIpAccessList-2023-01-01-project_ip_access_list_add.sh b/docs/command/includes/atlas-api-projectIpAccessList-createProjectIpAccessList-2023-01-01-project_ip_access_list_add.sh deleted file mode 100644 index 264b3c60d1..0000000000 --- a/docs/command/includes/atlas-api-projectIpAccessList-createProjectIpAccessList-2023-01-01-project_ip_access_list_add.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projectIpAccessList createProjectIpAccessList --version 2023-01-01 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-deleteGroupAccessListEntry-2023-01-01-project_ip_access_list_delete.sh b/docs/command/includes/atlas-api-projectIpAccessList-deleteGroupAccessListEntry-2023-01-01-project_ip_access_list_delete.sh new file mode 100644 index 0000000000..3214e88070 --- /dev/null +++ b/docs/command/includes/atlas-api-projectIpAccessList-deleteGroupAccessListEntry-2023-01-01-project_ip_access_list_delete.sh @@ -0,0 +1 @@ +atlas api projectIpAccessList deleteGroupAccessListEntry --version 2023-01-01 --entryValue 10.0.0.0/16 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-deleteProjectIpAccessList-2023-01-01-project_ip_access_list_delete.sh b/docs/command/includes/atlas-api-projectIpAccessList-deleteProjectIpAccessList-2023-01-01-project_ip_access_list_delete.sh deleted file mode 100644 index 86fa1bf2bc..0000000000 --- a/docs/command/includes/atlas-api-projectIpAccessList-deleteProjectIpAccessList-2023-01-01-project_ip_access_list_delete.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projectIpAccessList deleteProjectIpAccessList --version 2023-01-01 --entryValue 10.0.0.0/16 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-getGroupAccessListEntry-2023-01-01-project_ip_access_list_get.sh b/docs/command/includes/atlas-api-projectIpAccessList-getGroupAccessListEntry-2023-01-01-project_ip_access_list_get.sh new file mode 100644 index 0000000000..c1088c48ed --- /dev/null +++ b/docs/command/includes/atlas-api-projectIpAccessList-getGroupAccessListEntry-2023-01-01-project_ip_access_list_get.sh @@ -0,0 +1 @@ +atlas api projectIpAccessList getGroupAccessListEntry --version 2023-01-01 --entryValue 10.0.0.0/16 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-getGroupAccessListStatus-2023-01-01-project_ip_access_list_get_status.sh b/docs/command/includes/atlas-api-projectIpAccessList-getGroupAccessListStatus-2023-01-01-project_ip_access_list_get_status.sh new file mode 100644 index 0000000000..d2135eeb1b --- /dev/null +++ b/docs/command/includes/atlas-api-projectIpAccessList-getGroupAccessListStatus-2023-01-01-project_ip_access_list_get_status.sh @@ -0,0 +1 @@ +atlas api projectIpAccessList getGroupAccessListStatus --version 2023-01-01 --entryValue 10.0.0.0/16 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-getProjectIpAccessListStatus-2023-01-01-project_ip_access_list_get_status.sh b/docs/command/includes/atlas-api-projectIpAccessList-getProjectIpAccessListStatus-2023-01-01-project_ip_access_list_get_status.sh deleted file mode 100644 index 5492b66495..0000000000 --- a/docs/command/includes/atlas-api-projectIpAccessList-getProjectIpAccessListStatus-2023-01-01-project_ip_access_list_get_status.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projectIpAccessList getProjectIpAccessListStatus --version 2023-01-01 --entryValue 10.0.0.0/16 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-getProjectIpList-2023-01-01-project_ip_access_list_get.sh b/docs/command/includes/atlas-api-projectIpAccessList-getProjectIpList-2023-01-01-project_ip_access_list_get.sh deleted file mode 100644 index 08c1fe6901..0000000000 --- a/docs/command/includes/atlas-api-projectIpAccessList-getProjectIpList-2023-01-01-project_ip_access_list_get.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projectIpAccessList getProjectIpList --version 2023-01-01 --entryValue 10.0.0.0/16 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-listGroupAccessListEntries-2023-01-01-project_ip_access_list_list.sh b/docs/command/includes/atlas-api-projectIpAccessList-listGroupAccessListEntries-2023-01-01-project_ip_access_list_list.sh new file mode 100644 index 0000000000..283e657e30 --- /dev/null +++ b/docs/command/includes/atlas-api-projectIpAccessList-listGroupAccessListEntries-2023-01-01-project_ip_access_list_list.sh @@ -0,0 +1 @@ +atlas api projectIpAccessList listGroupAccessListEntries --version 2023-01-01 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projectIpAccessList-listProjectIpAccessLists-2023-01-01-project_ip_access_list_list.sh b/docs/command/includes/atlas-api-projectIpAccessList-listProjectIpAccessLists-2023-01-01-project_ip_access_list_list.sh deleted file mode 100644 index 17e07903b0..0000000000 --- a/docs/command/includes/atlas-api-projectIpAccessList-listProjectIpAccessLists-2023-01-01-project_ip_access_list_list.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projectIpAccessList listProjectIpAccessLists --version 2023-01-01 --groupId [your-project-id] diff --git a/docs/command/includes/atlas-api-projects-createProject-2023-01-01-create_project-payload.json b/docs/command/includes/atlas-api-projects-createGroup-2023-01-01-create_project-payload.json similarity index 100% rename from docs/command/includes/atlas-api-projects-createProject-2023-01-01-create_project-payload.json rename to docs/command/includes/atlas-api-projects-createGroup-2023-01-01-create_project-payload.json diff --git a/docs/command/includes/atlas-api-projects-createGroup-2023-01-01-create_project.sh b/docs/command/includes/atlas-api-projects-createGroup-2023-01-01-create_project.sh new file mode 100644 index 0000000000..15504d89f9 --- /dev/null +++ b/docs/command/includes/atlas-api-projects-createGroup-2023-01-01-create_project.sh @@ -0,0 +1 @@ +atlas api projects createGroup --version 2023-01-01 diff --git a/docs/command/includes/atlas-api-projects-createProject-2023-01-01-create_project.sh b/docs/command/includes/atlas-api-projects-createProject-2023-01-01-create_project.sh deleted file mode 100644 index 965c462322..0000000000 --- a/docs/command/includes/atlas-api-projects-createProject-2023-01-01-create_project.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects createProject --version 2023-01-01 diff --git a/docs/command/includes/atlas-api-projects-deleteGroup-2023-01-01-delete_project.sh b/docs/command/includes/atlas-api-projects-deleteGroup-2023-01-01-delete_project.sh new file mode 100644 index 0000000000..4207ef57cd --- /dev/null +++ b/docs/command/includes/atlas-api-projects-deleteGroup-2023-01-01-delete_project.sh @@ -0,0 +1 @@ +atlas api projects deleteGroup --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-deleteGroupInvite-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-deleteGroupInvite-2023-01-01-default.sh new file mode 100644 index 0000000000..ac7f364c22 --- /dev/null +++ b/docs/command/includes/atlas-api-projects-deleteGroupInvite-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects deleteGroupInvite --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --invitationId [invitationId] diff --git a/docs/command/includes/atlas-api-projects-deleteGroupLimit-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-deleteGroupLimit-2023-01-01-default.sh new file mode 100644 index 0000000000..5b179a59c0 --- /dev/null +++ b/docs/command/includes/atlas-api-projects-deleteGroupLimit-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects deleteGroupLimit --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --limitName [limitName] diff --git a/docs/command/includes/atlas-api-projects-deleteProject-2023-01-01-delete_project.sh b/docs/command/includes/atlas-api-projects-deleteProject-2023-01-01-delete_project.sh deleted file mode 100644 index 14c853bac6..0000000000 --- a/docs/command/includes/atlas-api-projects-deleteProject-2023-01-01-delete_project.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects deleteProject --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-deleteProjectInvitation-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-deleteProjectInvitation-2023-01-01-default.sh deleted file mode 100644 index c900f57d41..0000000000 --- a/docs/command/includes/atlas-api-projects-deleteProjectInvitation-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects deleteProjectInvitation --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --invitationId [invitationId] diff --git a/docs/command/includes/atlas-api-projects-deleteProjectLimit-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-deleteProjectLimit-2023-01-01-default.sh deleted file mode 100644 index 4badf4e907..0000000000 --- a/docs/command/includes/atlas-api-projects-deleteProjectLimit-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects deleteProjectLimit --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --limitName [limitName] diff --git a/docs/command/includes/atlas-api-projects-getGroup-2023-01-01-get_project.sh b/docs/command/includes/atlas-api-projects-getGroup-2023-01-01-get_project.sh new file mode 100644 index 0000000000..04f473bb01 --- /dev/null +++ b/docs/command/includes/atlas-api-projects-getGroup-2023-01-01-get_project.sh @@ -0,0 +1 @@ +atlas api projects getGroup --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-getGroupInvite-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getGroupInvite-2023-01-01-default.sh new file mode 100644 index 0000000000..f7b8ead85c --- /dev/null +++ b/docs/command/includes/atlas-api-projects-getGroupInvite-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects getGroupInvite --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --invitationId [invitationId] diff --git a/docs/command/includes/atlas-api-projects-getGroupIpAddresses-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getGroupIpAddresses-2023-01-01-default.sh new file mode 100644 index 0000000000..28f52b0c88 --- /dev/null +++ b/docs/command/includes/atlas-api-projects-getGroupIpAddresses-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects getGroupIpAddresses --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-getGroupLimit-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getGroupLimit-2023-01-01-default.sh new file mode 100644 index 0000000000..0cbb1a134f --- /dev/null +++ b/docs/command/includes/atlas-api-projects-getGroupLimit-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects getGroupLimit --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --limitName [limitName] diff --git a/docs/command/includes/atlas-api-projects-getGroupMongoDbVersions-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getGroupMongoDbVersions-2023-01-01-default.sh new file mode 100644 index 0000000000..3718334ada --- /dev/null +++ b/docs/command/includes/atlas-api-projects-getGroupMongoDbVersions-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects getGroupMongoDbVersions --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --instanceSize M10 --itemsPerPage 100 diff --git a/docs/command/includes/atlas-api-projects-getGroupSettings-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getGroupSettings-2023-01-01-default.sh new file mode 100644 index 0000000000..5091f2cded --- /dev/null +++ b/docs/command/includes/atlas-api-projects-getGroupSettings-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects getGroupSettings --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-getProject-2023-01-01-get_project.sh b/docs/command/includes/atlas-api-projects-getProject-2023-01-01-get_project.sh deleted file mode 100644 index fb730f530e..0000000000 --- a/docs/command/includes/atlas-api-projects-getProject-2023-01-01-get_project.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects getProject --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-getProjectInvitation-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getProjectInvitation-2023-01-01-default.sh deleted file mode 100644 index bcf60ad2c9..0000000000 --- a/docs/command/includes/atlas-api-projects-getProjectInvitation-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects getProjectInvitation --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --invitationId [invitationId] diff --git a/docs/command/includes/atlas-api-projects-getProjectLimit-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getProjectLimit-2023-01-01-default.sh deleted file mode 100644 index b0558e0468..0000000000 --- a/docs/command/includes/atlas-api-projects-getProjectLimit-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects getProjectLimit --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --limitName [limitName] diff --git a/docs/command/includes/atlas-api-projects-getProjectLtsVersions-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getProjectLtsVersions-2023-01-01-default.sh deleted file mode 100644 index c84c27e9d3..0000000000 --- a/docs/command/includes/atlas-api-projects-getProjectLtsVersions-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects getProjectLtsVersions --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --instanceSize M10 --itemsPerPage 100 diff --git a/docs/command/includes/atlas-api-projects-getProjectSettings-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-getProjectSettings-2023-01-01-default.sh deleted file mode 100644 index 3c1f200210..0000000000 --- a/docs/command/includes/atlas-api-projects-getProjectSettings-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects getProjectSettings --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-listGroupInvites-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-listGroupInvites-2023-01-01-default.sh new file mode 100644 index 0000000000..345b50b82b --- /dev/null +++ b/docs/command/includes/atlas-api-projects-listGroupInvites-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects listGroupInvites --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-listGroupLimits-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-listGroupLimits-2023-01-01-default.sh new file mode 100644 index 0000000000..dbe32d99a9 --- /dev/null +++ b/docs/command/includes/atlas-api-projects-listGroupLimits-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api projects listGroupLimits --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-listGroups-2023-01-01-list_projects.sh b/docs/command/includes/atlas-api-projects-listGroups-2023-01-01-list_projects.sh new file mode 100644 index 0000000000..28b56b4d9b --- /dev/null +++ b/docs/command/includes/atlas-api-projects-listGroups-2023-01-01-list_projects.sh @@ -0,0 +1 @@ +atlas api projects listGroups --version 2023-01-01 diff --git a/docs/command/includes/atlas-api-projects-listProjectInvitations-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-listProjectInvitations-2023-01-01-default.sh deleted file mode 100644 index 361ad8003f..0000000000 --- a/docs/command/includes/atlas-api-projects-listProjectInvitations-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects listProjectInvitations --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-listProjectLimits-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-listProjectLimits-2023-01-01-default.sh deleted file mode 100644 index bbffea94de..0000000000 --- a/docs/command/includes/atlas-api-projects-listProjectLimits-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects listProjectLimits --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-listProjects-2023-01-01-list_projects.sh b/docs/command/includes/atlas-api-projects-listProjects-2023-01-01-list_projects.sh deleted file mode 100644 index d06f2912dd..0000000000 --- a/docs/command/includes/atlas-api-projects-listProjects-2023-01-01-list_projects.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects listProjects --version 2023-01-01 diff --git a/docs/command/includes/atlas-api-projects-returnAllIpAddresses-2023-01-01-default.sh b/docs/command/includes/atlas-api-projects-returnAllIpAddresses-2023-01-01-default.sh deleted file mode 100644 index a2d9f15d46..0000000000 --- a/docs/command/includes/atlas-api-projects-returnAllIpAddresses-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects returnAllIpAddresses --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-updateProject-2023-01-01-update_project-payload.json b/docs/command/includes/atlas-api-projects-updateGroup-2023-01-01-update_project-payload.json similarity index 100% rename from docs/command/includes/atlas-api-projects-updateProject-2023-01-01-update_project-payload.json rename to docs/command/includes/atlas-api-projects-updateGroup-2023-01-01-update_project-payload.json diff --git a/docs/command/includes/atlas-api-projects-updateGroup-2023-01-01-update_project.sh b/docs/command/includes/atlas-api-projects-updateGroup-2023-01-01-update_project.sh new file mode 100644 index 0000000000..0e552d70ed --- /dev/null +++ b/docs/command/includes/atlas-api-projects-updateGroup-2023-01-01-update_project.sh @@ -0,0 +1 @@ +atlas api projects updateGroup --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-projects-updateProject-2023-01-01-update_project.sh b/docs/command/includes/atlas-api-projects-updateProject-2023-01-01-update_project.sh deleted file mode 100644 index 8cb437cff4..0000000000 --- a/docs/command/includes/atlas-api-projects-updateProject-2023-01-01-update_project.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api projects updateProject --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport-2023-01-01-default.sh b/docs/command/includes/atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport-2023-01-01-default.sh new file mode 100644 index 0000000000..91fc0442d7 --- /dev/null +++ b/docs/command/includes/atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api pushBasedLogExport deleteGroupPushBasedLogExport --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration-2023-01-01-default.sh b/docs/command/includes/atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration-2023-01-01-default.sh deleted file mode 100644 index bd8ccd3806..0000000000 --- a/docs/command/includes/atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api pushBasedLogExport deletePushBasedLogConfiguration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-pushBasedLogExport-getGroupPushBasedLogExport-2023-01-01-default.sh b/docs/command/includes/atlas-api-pushBasedLogExport-getGroupPushBasedLogExport-2023-01-01-default.sh new file mode 100644 index 0000000000..8c519d397f --- /dev/null +++ b/docs/command/includes/atlas-api-pushBasedLogExport-getGroupPushBasedLogExport-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api pushBasedLogExport getGroupPushBasedLogExport --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-pushBasedLogExport-getPushBasedLogConfiguration-2023-01-01-default.sh b/docs/command/includes/atlas-api-pushBasedLogExport-getPushBasedLogConfiguration-2023-01-01-default.sh deleted file mode 100644 index 2ef314d27c..0000000000 --- a/docs/command/includes/atlas-api-pushBasedLogExport-getPushBasedLogConfiguration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api pushBasedLogExport getPushBasedLogConfiguration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries-2025-03-12-default.sh b/docs/command/includes/atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries-2025-03-12-default.sh deleted file mode 100644 index 536a568a9e..0000000000 --- a/docs/command/includes/atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries-2025-03-12-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api queryShapeInsights getGroupClusterQueryShapeInsightSummaries --version 2025-03-12 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries-2025-03-12-default.sh b/docs/command/includes/atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries-2025-03-12-default.sh new file mode 100644 index 0000000000..f5819b897c --- /dev/null +++ b/docs/command/includes/atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries-2025-03-12-default.sh @@ -0,0 +1 @@ +atlas api queryShapeInsights listGroupClusterQueryShapeInsightSummaries --version 2025-03-12 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-resourcePolicies-getOrgNonCompliantResources-2024-08-05-default.sh b/docs/command/includes/atlas-api-resourcePolicies-getOrgNonCompliantResources-2024-08-05-default.sh new file mode 100644 index 0000000000..c6a5cc51e7 --- /dev/null +++ b/docs/command/includes/atlas-api-resourcePolicies-getOrgNonCompliantResources-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api resourcePolicies getOrgNonCompliantResources --version 2024-08-05 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-resourcePolicies-getResourcesNonCompliant-2024-08-05-default.sh b/docs/command/includes/atlas-api-resourcePolicies-getResourcesNonCompliant-2024-08-05-default.sh deleted file mode 100644 index 00430122ef..0000000000 --- a/docs/command/includes/atlas-api-resourcePolicies-getResourcesNonCompliant-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api resourcePolicies getResourcesNonCompliant --version 2024-08-05 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-2dspere_index-payload.json b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-2dspere_index-payload.json similarity index 100% rename from docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-2dspere_index-payload.json rename to docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-2dspere_index-payload.json diff --git a/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-2dspere_index.sh b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-2dspere_index.sh new file mode 100644 index 0000000000..2f576a5ced --- /dev/null +++ b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-2dspere_index.sh @@ -0,0 +1 @@ +atlas api rollingIndex createGroupClusterIndexRollingIndex --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-partial_index-payload.json b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-partial_index-payload.json similarity index 100% rename from docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-partial_index-payload.json rename to docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-partial_index-payload.json diff --git a/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-partial_index.sh b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-partial_index.sh new file mode 100644 index 0000000000..2f576a5ced --- /dev/null +++ b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-partial_index.sh @@ -0,0 +1 @@ +atlas api rollingIndex createGroupClusterIndexRollingIndex --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-sparse_index-payload.json b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-sparse_index-payload.json similarity index 100% rename from docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-sparse_index-payload.json rename to docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-sparse_index-payload.json diff --git a/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-sparse_index.sh b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-sparse_index.sh new file mode 100644 index 0000000000..2f576a5ced --- /dev/null +++ b/docs/command/includes/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex-2023-01-01-sparse_index.sh @@ -0,0 +1 @@ +atlas api rollingIndex createGroupClusterIndexRollingIndex --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-2dspere_index.sh b/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-2dspere_index.sh deleted file mode 100644 index 34923a5b9a..0000000000 --- a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-2dspere_index.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api rollingIndex createRollingIndex --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-partial_index.sh b/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-partial_index.sh deleted file mode 100644 index 34923a5b9a..0000000000 --- a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-partial_index.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api rollingIndex createRollingIndex --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-sparse_index.sh b/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-sparse_index.sh deleted file mode 100644 index 34923a5b9a..0000000000 --- a/docs/command/includes/atlas-api-rollingIndex-createRollingIndex-2023-01-01-sparse_index.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api rollingIndex createRollingIndex --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serverlessInstances-deleteGroupServerlessInstance-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessInstances-deleteGroupServerlessInstance-2023-01-01-default.sh new file mode 100644 index 0000000000..fa8f639b01 --- /dev/null +++ b/docs/command/includes/atlas-api-serverlessInstances-deleteGroupServerlessInstance-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api serverlessInstances deleteGroupServerlessInstance --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-serverlessInstances-deleteServerlessInstance-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessInstances-deleteServerlessInstance-2023-01-01-default.sh deleted file mode 100644 index 3cacdaa212..0000000000 --- a/docs/command/includes/atlas-api-serverlessInstances-deleteServerlessInstance-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serverlessInstances deleteServerlessInstance --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-serverlessInstances-getGroupServerlessInstance-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessInstances-getGroupServerlessInstance-2023-01-01-default.sh new file mode 100644 index 0000000000..713d29b7e5 --- /dev/null +++ b/docs/command/includes/atlas-api-serverlessInstances-getGroupServerlessInstance-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api serverlessInstances getGroupServerlessInstance --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-serverlessInstances-getServerlessInstance-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessInstances-getServerlessInstance-2023-01-01-default.sh deleted file mode 100644 index b1a4f42edc..0000000000 --- a/docs/command/includes/atlas-api-serverlessInstances-getServerlessInstance-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serverlessInstances getServerlessInstance --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --name [name] diff --git a/docs/command/includes/atlas-api-serverlessInstances-listGroupServerlessInstances-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessInstances-listGroupServerlessInstances-2023-01-01-default.sh new file mode 100644 index 0000000000..4e43faa0b8 --- /dev/null +++ b/docs/command/includes/atlas-api-serverlessInstances-listGroupServerlessInstances-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api serverlessInstances listGroupServerlessInstances --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serverlessInstances-listServerlessInstances-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessInstances-listServerlessInstances-2023-01-01-default.sh deleted file mode 100644 index f8951afcbb..0000000000 --- a/docs/command/includes/atlas-api-serverlessInstances-listServerlessInstances-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serverlessInstances listServerlessInstances --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh new file mode 100644 index 0000000000..568cdded56 --- /dev/null +++ b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api serverlessPrivateEndpoints deleteGroupPrivateEndpointServerlessInstanceEndpoint --version 2023-01-01 --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 --instanceName [instanceName] diff --git a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint-2023-01-01-default.sh deleted file mode 100644 index 7e1284982c..0000000000 --- a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serverlessPrivateEndpoints deleteServerlessPrivateEndpoint --version 2023-01-01 --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 --instanceName [instanceName] diff --git a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh new file mode 100644 index 0000000000..4d25c7df74 --- /dev/null +++ b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api serverlessPrivateEndpoints getGroupPrivateEndpointServerlessInstanceEndpoint --version 2023-01-01 --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 --instanceName [instanceName] diff --git a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint-2023-01-01-default.sh deleted file mode 100644 index 58fcb025c2..0000000000 --- a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serverlessPrivateEndpoints getServerlessPrivateEndpoint --version 2023-01-01 --endpointId [endpointId] --groupId 32b6e34b3d91647abb20e7b8 --instanceName [instanceName] diff --git a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh new file mode 100644 index 0000000000..8cf7eb73fb --- /dev/null +++ b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api serverlessPrivateEndpoints listGroupPrivateEndpointServerlessInstanceEndpoint --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --instanceName [instanceName] diff --git a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints-2023-01-01-default.sh b/docs/command/includes/atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints-2023-01-01-default.sh deleted file mode 100644 index 569dc30ef6..0000000000 --- a/docs/command/includes/atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serverlessPrivateEndpoints listServerlessPrivateEndpoints --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --instanceName [instanceName] diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccount-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccount-2024-08-05-default.sh new file mode 100644 index 0000000000..75e9c431f3 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccount-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts deleteGroupServiceAccount --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry-2024-08-05-default.sh new file mode 100644 index 0000000000..863891ae27 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts deleteGroupServiceAccountAccessListEntry --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 --ipAddress 192.0.2.0%2F24 diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccountSecret-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccountSecret-2024-08-05-default.sh new file mode 100644 index 0000000000..44daf921be --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-deleteGroupServiceAccountSecret-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts deleteGroupServiceAccountSecret --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 --secretId [secretId] diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccount-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccount-2024-08-05-default.sh new file mode 100644 index 0000000000..1c288c2b2f --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccount-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts deleteOrgServiceAccount --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry-2024-08-05-default.sh new file mode 100644 index 0000000000..074bd0d6c0 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts deleteOrgServiceAccountAccessListEntry --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --ipAddress 192.0.2.0%2F24 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccountSecret-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccountSecret-2024-08-05-default.sh new file mode 100644 index 0000000000..1300291e89 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-deleteOrgServiceAccountSecret-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts deleteOrgServiceAccountSecret --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 --secretId [secretId] diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccount-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccount-2024-08-05-default.sh deleted file mode 100644 index 39c33826f8..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccount-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts deleteProjectServiceAccount --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry-2024-08-05-default.sh deleted file mode 100644 index 686dd51324..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts deleteProjectServiceAccountAccessListEntry --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 --ipAddress 192.0.2.0%2F24 diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccountSecret-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccountSecret-2024-08-05-default.sh deleted file mode 100644 index 293138f4dd..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-deleteProjectServiceAccountSecret-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts deleteProjectServiceAccountSecret --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 --secretId [secretId] diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccount-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccount-2024-08-05-default.sh deleted file mode 100644 index 7dce7fe0dc..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccount-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts deleteServiceAccount --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry-2024-08-05-default.sh deleted file mode 100644 index 11f4708417..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts deleteServiceAccountAccessListEntry --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --ipAddress 192.0.2.0%2F24 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccountSecret-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccountSecret-2024-08-05-default.sh deleted file mode 100644 index 83a2f93ed3..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-deleteServiceAccountSecret-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts deleteServiceAccountSecret --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 --secretId [secretId] diff --git a/docs/command/includes/atlas-api-serviceAccounts-getGroupServiceAccount-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-getGroupServiceAccount-2024-08-05-default.sh new file mode 100644 index 0000000000..55ce1a1323 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-getGroupServiceAccount-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts getGroupServiceAccount --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serviceAccounts-getOrgServiceAccount-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-getOrgServiceAccount-2024-08-05-default.sh new file mode 100644 index 0000000000..3ad3571d98 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-getOrgServiceAccount-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts getOrgServiceAccount --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-getOrgServiceAccountGroups-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-getOrgServiceAccountGroups-2024-08-05-default.sh new file mode 100644 index 0000000000..885854011b --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-getOrgServiceAccountGroups-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts getOrgServiceAccountGroups --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-getProjectServiceAccount-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-getProjectServiceAccount-2024-08-05-default.sh deleted file mode 100644 index 8dcd191f01..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-getProjectServiceAccount-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts getProjectServiceAccount --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serviceAccounts-getServiceAccount-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-getServiceAccount-2024-08-05-default.sh deleted file mode 100644 index 5a9b6c2348..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-getServiceAccount-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts getServiceAccount --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listGroupServiceAccountAccessList-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listGroupServiceAccountAccessList-2024-08-05-default.sh new file mode 100644 index 0000000000..5484bbf751 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-listGroupServiceAccountAccessList-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts listGroupServiceAccountAccessList --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listGroupServiceAccounts-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listGroupServiceAccounts-2024-08-05-default.sh new file mode 100644 index 0000000000..0dcc4f6115 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-listGroupServiceAccounts-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts listGroupServiceAccounts --version 2024-08-05 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listOrgServiceAccountAccessList-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listOrgServiceAccountAccessList-2024-08-05-default.sh new file mode 100644 index 0000000000..8752e6d258 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-listOrgServiceAccountAccessList-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts listOrgServiceAccountAccessList --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listOrgServiceAccounts-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listOrgServiceAccounts-2024-08-05-default.sh new file mode 100644 index 0000000000..d7060553c1 --- /dev/null +++ b/docs/command/includes/atlas-api-serviceAccounts-listOrgServiceAccounts-2024-08-05-default.sh @@ -0,0 +1 @@ +atlas api serviceAccounts listOrgServiceAccounts --version 2024-08-05 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listProjectServiceAccountAccessList-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listProjectServiceAccountAccessList-2024-08-05-default.sh deleted file mode 100644 index 4796f132ca..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-listProjectServiceAccountAccessList-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts listProjectServiceAccountAccessList --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listProjectServiceAccounts-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listProjectServiceAccounts-2024-08-05-default.sh deleted file mode 100644 index 046d42bca5..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-listProjectServiceAccounts-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts listProjectServiceAccounts --version 2024-08-05 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listServiceAccountAccessList-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listServiceAccountAccessList-2024-08-05-default.sh deleted file mode 100644 index 2304bc102a..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-listServiceAccountAccessList-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts listServiceAccountAccessList --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listServiceAccountProjects-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listServiceAccountProjects-2024-08-05-default.sh deleted file mode 100644 index cdea4b4bb8..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-listServiceAccountProjects-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts listServiceAccountProjects --version 2024-08-05 --clientId mdb_sa_id_1234567890abcdef12345678 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-serviceAccounts-listServiceAccounts-2024-08-05-default.sh b/docs/command/includes/atlas-api-serviceAccounts-listServiceAccounts-2024-08-05-default.sh deleted file mode 100644 index 27e09b128f..0000000000 --- a/docs/command/includes/atlas-api-serviceAccounts-listServiceAccounts-2024-08-05-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api serviceAccounts listServiceAccounts --version 2024-08-05 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore-2023-01-01-default.sh b/docs/command/includes/atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore-2023-01-01-default.sh new file mode 100644 index 0000000000..dd209d0d99 --- /dev/null +++ b/docs/command/includes/atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api sharedTierRestoreJobs getGroupClusterBackupTenantRestore --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --restoreId [restoreId] diff --git a/docs/command/includes/atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob-2023-01-01-default.sh b/docs/command/includes/atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob-2023-01-01-default.sh deleted file mode 100644 index 7c037bfe47..0000000000 --- a/docs/command/includes/atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api sharedTierRestoreJobs getSharedClusterBackupRestoreJob --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --restoreId [restoreId] diff --git a/docs/command/includes/atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores-2023-01-01-default.sh b/docs/command/includes/atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores-2023-01-01-default.sh new file mode 100644 index 0000000000..fd7e3c66e4 --- /dev/null +++ b/docs/command/includes/atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api sharedTierRestoreJobs listGroupClusterBackupTenantRestores --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs-2023-01-01-default.sh b/docs/command/includes/atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs-2023-01-01-default.sh deleted file mode 100644 index 64d7674817..0000000000 --- a/docs/command/includes/atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api sharedTierRestoreJobs listSharedClusterBackupRestoreJobs --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot-2023-01-01-default.sh b/docs/command/includes/atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot-2023-01-01-default.sh new file mode 100644 index 0000000000..1a6f3e33c8 --- /dev/null +++ b/docs/command/includes/atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api sharedTierSnapshots getGroupClusterBackupTenantSnapshot --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-sharedTierSnapshots-getSharedClusterBackup-2023-01-01-default.sh b/docs/command/includes/atlas-api-sharedTierSnapshots-getSharedClusterBackup-2023-01-01-default.sh deleted file mode 100644 index 0ecff624e9..0000000000 --- a/docs/command/includes/atlas-api-sharedTierSnapshots-getSharedClusterBackup-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api sharedTierSnapshots getSharedClusterBackup --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 --snapshotId [snapshotId] diff --git a/docs/command/includes/atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots-2023-01-01-default.sh b/docs/command/includes/atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots-2023-01-01-default.sh new file mode 100644 index 0000000000..55c58d1934 --- /dev/null +++ b/docs/command/includes/atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api sharedTierSnapshots listGroupClusterBackupTenantSnapshots --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-sharedTierSnapshots-listSharedClusterBackups-2023-01-01-default.sh b/docs/command/includes/atlas-api-sharedTierSnapshots-listSharedClusterBackups-2023-01-01-default.sh deleted file mode 100644 index ca92fcde95..0000000000 --- a/docs/command/includes/atlas-api-sharedTierSnapshots-listSharedClusterBackups-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api sharedTierSnapshots listSharedClusterBackups --version 2023-01-01 --clusterName [clusterName] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-deleteGroupStreamConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-deleteGroupStreamConnection-2023-02-01-default.sh new file mode 100644 index 0000000000..eaf189691b --- /dev/null +++ b/docs/command/includes/atlas-api-streams-deleteGroupStreamConnection-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams deleteGroupStreamConnection --version 2023-02-01 --connectionName [connectionName] --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-deleteGroupStreamPrivateLinkConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-deleteGroupStreamPrivateLinkConnection-2023-02-01-default.sh new file mode 100644 index 0000000000..d657a54915 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-deleteGroupStreamPrivateLinkConnection-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams deleteGroupStreamPrivateLinkConnection --version 2023-02-01 --connectionId [connectionId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-deleteGroupStreamProcessor-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-deleteGroupStreamProcessor-2024-05-30-default.sh new file mode 100644 index 0000000000..55080e4429 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-deleteGroupStreamProcessor-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api streams deleteGroupStreamProcessor --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --processorName [processorName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-deleteGroupStreamVpcPeeringConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-deleteGroupStreamVpcPeeringConnection-2023-02-01-default.sh new file mode 100644 index 0000000000..6868c6a4f2 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-deleteGroupStreamVpcPeeringConnection-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams deleteGroupStreamVpcPeeringConnection --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --id [id] diff --git a/docs/command/includes/atlas-api-streams-deleteGroupStreamWorkspace-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-deleteGroupStreamWorkspace-2023-02-01-default.sh new file mode 100644 index 0000000000..c441d1cdb8 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-deleteGroupStreamWorkspace-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams deleteGroupStreamWorkspace --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-deletePrivateLinkConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-deletePrivateLinkConnection-2023-02-01-default.sh deleted file mode 100644 index 621f201799..0000000000 --- a/docs/command/includes/atlas-api-streams-deletePrivateLinkConnection-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams deletePrivateLinkConnection --version 2023-02-01 --connectionId [connectionId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-deleteStreamConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-deleteStreamConnection-2023-02-01-default.sh deleted file mode 100644 index 8a617af783..0000000000 --- a/docs/command/includes/atlas-api-streams-deleteStreamConnection-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams deleteStreamConnection --version 2023-02-01 --connectionName [connectionName] --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-deleteStreamInstance-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-deleteStreamInstance-2023-02-01-default.sh deleted file mode 100644 index 0b43cb763b..0000000000 --- a/docs/command/includes/atlas-api-streams-deleteStreamInstance-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams deleteStreamInstance --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-deleteStreamProcessor-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-deleteStreamProcessor-2024-05-30-default.sh deleted file mode 100644 index 08feba8be3..0000000000 --- a/docs/command/includes/atlas-api-streams-deleteStreamProcessor-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams deleteStreamProcessor --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --processorName [processorName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-deleteVpcPeeringConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-deleteVpcPeeringConnection-2023-02-01-default.sh deleted file mode 100644 index 4215d8e43d..0000000000 --- a/docs/command/includes/atlas-api-streams-deleteVpcPeeringConnection-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams deleteVpcPeeringConnection --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --id [id] diff --git a/docs/command/includes/atlas-api-streams-downloadGroupStreamAuditLogs-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-downloadGroupStreamAuditLogs-2023-02-01-default.sh new file mode 100644 index 0000000000..026bc1e8a4 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-downloadGroupStreamAuditLogs-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams downloadGroupStreamAuditLogs --version 2023-02-01 --endDate 1.636481348e+09 --groupId 32b6e34b3d91647abb20e7b8 --startDate 1.636466948e+09 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-downloadStreamTenantAuditLogs-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-downloadStreamTenantAuditLogs-2023-02-01-default.sh deleted file mode 100644 index 24578a729f..0000000000 --- a/docs/command/includes/atlas-api-streams-downloadStreamTenantAuditLogs-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams downloadStreamTenantAuditLogs --version 2023-02-01 --endDate 1.636481348e+09 --groupId 32b6e34b3d91647abb20e7b8 --startDate 1.636466948e+09 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-getAccountDetails-2024-11-13-default.sh b/docs/command/includes/atlas-api-streams-getAccountDetails-2024-11-13-default.sh deleted file mode 100644 index c446c43bef..0000000000 --- a/docs/command/includes/atlas-api-streams-getAccountDetails-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams getAccountDetails --version 2024-11-13 --cloudProvider [cloudProvider] --groupId 32b6e34b3d91647abb20e7b8 --regionName [regionName] diff --git a/docs/command/includes/atlas-api-streams-getActiveVpcPeeringConnections-2024-11-13-default.sh b/docs/command/includes/atlas-api-streams-getActiveVpcPeeringConnections-2024-11-13-default.sh deleted file mode 100644 index 74b47892e5..0000000000 --- a/docs/command/includes/atlas-api-streams-getActiveVpcPeeringConnections-2024-11-13-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams getActiveVpcPeeringConnections --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-getGroupStreamAccountDetails-2024-11-13-default.sh b/docs/command/includes/atlas-api-streams-getGroupStreamAccountDetails-2024-11-13-default.sh new file mode 100644 index 0000000000..1203b22fdb --- /dev/null +++ b/docs/command/includes/atlas-api-streams-getGroupStreamAccountDetails-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api streams getGroupStreamAccountDetails --version 2024-11-13 --cloudProvider [cloudProvider] --groupId 32b6e34b3d91647abb20e7b8 --regionName [regionName] diff --git a/docs/command/includes/atlas-api-streams-getGroupStreamConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-getGroupStreamConnection-2023-02-01-default.sh new file mode 100644 index 0000000000..e7d7d7e35f --- /dev/null +++ b/docs/command/includes/atlas-api-streams-getGroupStreamConnection-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams getGroupStreamConnection --version 2023-02-01 --connectionName [connectionName] --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-getGroupStreamPrivateLinkConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-getGroupStreamPrivateLinkConnection-2023-02-01-default.sh new file mode 100644 index 0000000000..316cc93ea3 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-getGroupStreamPrivateLinkConnection-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams getGroupStreamPrivateLinkConnection --version 2023-02-01 --connectionId [connectionId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-getGroupStreamProcessor-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-getGroupStreamProcessor-2024-05-30-default.sh new file mode 100644 index 0000000000..27f331a8b3 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-getGroupStreamProcessor-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api streams getGroupStreamProcessor --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --processorName [processorName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-getGroupStreamProcessors-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-getGroupStreamProcessors-2024-05-30-default.sh new file mode 100644 index 0000000000..25336027db --- /dev/null +++ b/docs/command/includes/atlas-api-streams-getGroupStreamProcessors-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api streams getGroupStreamProcessors --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-getGroupStreamWorkspace-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-getGroupStreamWorkspace-2023-02-01-default.sh new file mode 100644 index 0000000000..4af5819b00 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-getGroupStreamWorkspace-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams getGroupStreamWorkspace --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-getPrivateLinkConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-getPrivateLinkConnection-2023-02-01-default.sh deleted file mode 100644 index 98c2c93833..0000000000 --- a/docs/command/includes/atlas-api-streams-getPrivateLinkConnection-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams getPrivateLinkConnection --version 2023-02-01 --connectionId [connectionId] --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-getStreamConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-getStreamConnection-2023-02-01-default.sh deleted file mode 100644 index cc3ec4a666..0000000000 --- a/docs/command/includes/atlas-api-streams-getStreamConnection-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams getStreamConnection --version 2023-02-01 --connectionName [connectionName] --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-getStreamInstance-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-getStreamInstance-2023-02-01-default.sh deleted file mode 100644 index 0f9cf050be..0000000000 --- a/docs/command/includes/atlas-api-streams-getStreamInstance-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams getStreamInstance --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-getStreamProcessor-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-getStreamProcessor-2024-05-30-default.sh deleted file mode 100644 index bd9a4d2f4e..0000000000 --- a/docs/command/includes/atlas-api-streams-getStreamProcessor-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams getStreamProcessor --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --processorName [processorName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-getVpcPeeringConnections-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-getVpcPeeringConnections-2023-02-01-default.sh deleted file mode 100644 index e6e1c5984b..0000000000 --- a/docs/command/includes/atlas-api-streams-getVpcPeeringConnections-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams getVpcPeeringConnections --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --requesterAccountId [requesterAccountId] diff --git a/docs/command/includes/atlas-api-streams-listGroupStreamActiveVpcPeeringConnections-2024-11-13-default.sh b/docs/command/includes/atlas-api-streams-listGroupStreamActiveVpcPeeringConnections-2024-11-13-default.sh new file mode 100644 index 0000000000..3fe759f168 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-listGroupStreamActiveVpcPeeringConnections-2024-11-13-default.sh @@ -0,0 +1 @@ +atlas api streams listGroupStreamActiveVpcPeeringConnections --version 2024-11-13 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-listGroupStreamConnections-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-listGroupStreamConnections-2023-02-01-default.sh new file mode 100644 index 0000000000..e7dc48db16 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-listGroupStreamConnections-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams listGroupStreamConnections --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-listGroupStreamPrivateLinkConnections-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-listGroupStreamPrivateLinkConnections-2023-02-01-default.sh new file mode 100644 index 0000000000..6e49b6199d --- /dev/null +++ b/docs/command/includes/atlas-api-streams-listGroupStreamPrivateLinkConnections-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams listGroupStreamPrivateLinkConnections --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-listGroupStreamVpcPeeringConnections-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-listGroupStreamVpcPeeringConnections-2023-02-01-default.sh new file mode 100644 index 0000000000..bff46e5e9d --- /dev/null +++ b/docs/command/includes/atlas-api-streams-listGroupStreamVpcPeeringConnections-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams listGroupStreamVpcPeeringConnections --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --requesterAccountId [requesterAccountId] diff --git a/docs/command/includes/atlas-api-streams-listGroupStreamWorkspaces-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-listGroupStreamWorkspaces-2023-02-01-default.sh new file mode 100644 index 0000000000..3604a1c3f0 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-listGroupStreamWorkspaces-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams listGroupStreamWorkspaces --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-listPrivateLinkConnections-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-listPrivateLinkConnections-2023-02-01-default.sh deleted file mode 100644 index 60529815b0..0000000000 --- a/docs/command/includes/atlas-api-streams-listPrivateLinkConnections-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams listPrivateLinkConnections --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-listStreamConnections-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-listStreamConnections-2023-02-01-default.sh deleted file mode 100644 index b45e11eeb4..0000000000 --- a/docs/command/includes/atlas-api-streams-listStreamConnections-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams listStreamConnections --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-listStreamInstances-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-listStreamInstances-2023-02-01-default.sh deleted file mode 100644 index 69bea15932..0000000000 --- a/docs/command/includes/atlas-api-streams-listStreamInstances-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams listStreamInstances --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-streams-listStreamProcessors-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-listStreamProcessors-2024-05-30-default.sh deleted file mode 100644 index 0d4384c9a8..0000000000 --- a/docs/command/includes/atlas-api-streams-listStreamProcessors-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams listStreamProcessors --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-rejectGroupStreamVpcPeeringConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-rejectGroupStreamVpcPeeringConnection-2023-02-01-default.sh new file mode 100644 index 0000000000..82cefcd4b5 --- /dev/null +++ b/docs/command/includes/atlas-api-streams-rejectGroupStreamVpcPeeringConnection-2023-02-01-default.sh @@ -0,0 +1 @@ +atlas api streams rejectGroupStreamVpcPeeringConnection --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --id [id] diff --git a/docs/command/includes/atlas-api-streams-rejectVpcPeeringConnection-2023-02-01-default.sh b/docs/command/includes/atlas-api-streams-rejectVpcPeeringConnection-2023-02-01-default.sh deleted file mode 100644 index 433f68e30e..0000000000 --- a/docs/command/includes/atlas-api-streams-rejectVpcPeeringConnection-2023-02-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams rejectVpcPeeringConnection --version 2023-02-01 --groupId 32b6e34b3d91647abb20e7b8 --id [id] diff --git a/docs/command/includes/atlas-api-streams-startGroupStreamProcessor-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-startGroupStreamProcessor-2024-05-30-default.sh new file mode 100644 index 0000000000..5e00728dbc --- /dev/null +++ b/docs/command/includes/atlas-api-streams-startGroupStreamProcessor-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api streams startGroupStreamProcessor --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --processorName [processorName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-startStreamProcessor-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-startStreamProcessor-2024-05-30-default.sh deleted file mode 100644 index de52f684c0..0000000000 --- a/docs/command/includes/atlas-api-streams-startStreamProcessor-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams startStreamProcessor --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --processorName [processorName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-stopGroupStreamProcessor-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-stopGroupStreamProcessor-2024-05-30-default.sh new file mode 100644 index 0000000000..f7540ef60d --- /dev/null +++ b/docs/command/includes/atlas-api-streams-stopGroupStreamProcessor-2024-05-30-default.sh @@ -0,0 +1 @@ +atlas api streams stopGroupStreamProcessor --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --processorName [processorName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-streams-stopStreamProcessor-2024-05-30-default.sh b/docs/command/includes/atlas-api-streams-stopStreamProcessor-2024-05-30-default.sh deleted file mode 100644 index 8189ef9796..0000000000 --- a/docs/command/includes/atlas-api-streams-stopStreamProcessor-2024-05-30-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api streams stopStreamProcessor --version 2024-05-30 --groupId 32b6e34b3d91647abb20e7b8 --processorName [processorName] --tenantName [tenantName] diff --git a/docs/command/includes/atlas-api-teams-deleteOrgTeam-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-deleteOrgTeam-2023-01-01-default.sh new file mode 100644 index 0000000000..55827d4989 --- /dev/null +++ b/docs/command/includes/atlas-api-teams-deleteOrgTeam-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api teams deleteOrgTeam --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --teamId [teamId] diff --git a/docs/command/includes/atlas-api-teams-deleteTeam-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-deleteTeam-2023-01-01-default.sh deleted file mode 100644 index 1252510ea0..0000000000 --- a/docs/command/includes/atlas-api-teams-deleteTeam-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api teams deleteTeam --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --teamId [teamId] diff --git a/docs/command/includes/atlas-api-teams-getGroupTeam-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-getGroupTeam-2023-01-01-default.sh new file mode 100644 index 0000000000..3665e79778 --- /dev/null +++ b/docs/command/includes/atlas-api-teams-getGroupTeam-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api teams getGroupTeam --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --teamId [teamId] diff --git a/docs/command/includes/atlas-api-teams-getOrgTeam-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-getOrgTeam-2023-01-01-default.sh new file mode 100644 index 0000000000..5950181a41 --- /dev/null +++ b/docs/command/includes/atlas-api-teams-getOrgTeam-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api teams getOrgTeam --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --teamId [teamId] diff --git a/docs/command/includes/atlas-api-teams-getOrgTeamByName-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-getOrgTeamByName-2023-01-01-default.sh new file mode 100644 index 0000000000..b1ce8fffc2 --- /dev/null +++ b/docs/command/includes/atlas-api-teams-getOrgTeamByName-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api teams getOrgTeamByName --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --teamName [teamName] diff --git a/docs/command/includes/atlas-api-teams-getProjectTeam-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-getProjectTeam-2023-01-01-default.sh deleted file mode 100644 index 51a438290f..0000000000 --- a/docs/command/includes/atlas-api-teams-getProjectTeam-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api teams getProjectTeam --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --teamId [teamId] diff --git a/docs/command/includes/atlas-api-teams-getTeamById-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-getTeamById-2023-01-01-default.sh deleted file mode 100644 index bde5a6882f..0000000000 --- a/docs/command/includes/atlas-api-teams-getTeamById-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api teams getTeamById --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --teamId [teamId] diff --git a/docs/command/includes/atlas-api-teams-getTeamByName-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-getTeamByName-2023-01-01-default.sh deleted file mode 100644 index 90c1052205..0000000000 --- a/docs/command/includes/atlas-api-teams-getTeamByName-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api teams getTeamByName --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --teamName [teamName] diff --git a/docs/command/includes/atlas-api-teams-listGroupTeams-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-listGroupTeams-2023-01-01-default.sh new file mode 100644 index 0000000000..61ff51d483 --- /dev/null +++ b/docs/command/includes/atlas-api-teams-listGroupTeams-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api teams listGroupTeams --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-teams-listOrgTeams-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-listOrgTeams-2023-01-01-default.sh new file mode 100644 index 0000000000..399367f2ca --- /dev/null +++ b/docs/command/includes/atlas-api-teams-listOrgTeams-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api teams listOrgTeams --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-teams-listOrganizationTeams-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-listOrganizationTeams-2023-01-01-default.sh deleted file mode 100644 index a0a36ad95f..0000000000 --- a/docs/command/includes/atlas-api-teams-listOrganizationTeams-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api teams listOrganizationTeams --version 2023-01-01 --orgId 4888442a3354817a7320eb61 diff --git a/docs/command/includes/atlas-api-teams-listProjectTeams-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-listProjectTeams-2023-01-01-default.sh deleted file mode 100644 index e5aad39aa0..0000000000 --- a/docs/command/includes/atlas-api-teams-listProjectTeams-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api teams listProjectTeams --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-teams-removeGroupTeam-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-removeGroupTeam-2023-01-01-default.sh new file mode 100644 index 0000000000..92a1eab0e3 --- /dev/null +++ b/docs/command/includes/atlas-api-teams-removeGroupTeam-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api teams removeGroupTeam --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --teamId [teamId] diff --git a/docs/command/includes/atlas-api-teams-removeOrgTeamUserFromTeam-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-removeOrgTeamUserFromTeam-2023-01-01-default.sh new file mode 100644 index 0000000000..8c0802af3a --- /dev/null +++ b/docs/command/includes/atlas-api-teams-removeOrgTeamUserFromTeam-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api teams removeOrgTeamUserFromTeam --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --teamId [teamId] --userId [userId] diff --git a/docs/command/includes/atlas-api-teams-removeProjectTeam-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-removeProjectTeam-2023-01-01-default.sh deleted file mode 100644 index b80d378b9f..0000000000 --- a/docs/command/includes/atlas-api-teams-removeProjectTeam-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api teams removeProjectTeam --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --teamId [teamId] diff --git a/docs/command/includes/atlas-api-teams-removeTeamUser-2023-01-01-default.sh b/docs/command/includes/atlas-api-teams-removeTeamUser-2023-01-01-default.sh deleted file mode 100644 index b1911b5b9c..0000000000 --- a/docs/command/includes/atlas-api-teams-removeTeamUser-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api teams removeTeamUser --version 2023-01-01 --orgId 4888442a3354817a7320eb61 --teamId [teamId] --userId [userId] diff --git a/docs/command/includes/atlas-api-thirdPartyIntegrations-deleteGroupIntegration-2023-01-01-default.sh b/docs/command/includes/atlas-api-thirdPartyIntegrations-deleteGroupIntegration-2023-01-01-default.sh new file mode 100644 index 0000000000..0719b7b033 --- /dev/null +++ b/docs/command/includes/atlas-api-thirdPartyIntegrations-deleteGroupIntegration-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api thirdPartyIntegrations deleteGroupIntegration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --integrationType [integrationType] diff --git a/docs/command/includes/atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration-2023-01-01-default.sh b/docs/command/includes/atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration-2023-01-01-default.sh deleted file mode 100644 index 9ac8d12a14..0000000000 --- a/docs/command/includes/atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api thirdPartyIntegrations deleteThirdPartyIntegration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --integrationType [integrationType] diff --git a/docs/command/includes/atlas-api-thirdPartyIntegrations-getGroupIntegration-2023-01-01-default.sh b/docs/command/includes/atlas-api-thirdPartyIntegrations-getGroupIntegration-2023-01-01-default.sh new file mode 100644 index 0000000000..385fb7cb3c --- /dev/null +++ b/docs/command/includes/atlas-api-thirdPartyIntegrations-getGroupIntegration-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api thirdPartyIntegrations getGroupIntegration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --integrationType [integrationType] diff --git a/docs/command/includes/atlas-api-thirdPartyIntegrations-getThirdPartyIntegration-2023-01-01-default.sh b/docs/command/includes/atlas-api-thirdPartyIntegrations-getThirdPartyIntegration-2023-01-01-default.sh deleted file mode 100644 index 173918be2d..0000000000 --- a/docs/command/includes/atlas-api-thirdPartyIntegrations-getThirdPartyIntegration-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api thirdPartyIntegrations getThirdPartyIntegration --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --integrationType [integrationType] diff --git a/docs/command/includes/atlas-api-thirdPartyIntegrations-listGroupIntegrations-2023-01-01-default.sh b/docs/command/includes/atlas-api-thirdPartyIntegrations-listGroupIntegrations-2023-01-01-default.sh new file mode 100644 index 0000000000..299fd23f09 --- /dev/null +++ b/docs/command/includes/atlas-api-thirdPartyIntegrations-listGroupIntegrations-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api thirdPartyIntegrations listGroupIntegrations --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations-2023-01-01-default.sh b/docs/command/includes/atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations-2023-01-01-default.sh deleted file mode 100644 index 837ca0651c..0000000000 --- a/docs/command/includes/atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api thirdPartyIntegrations listThirdPartyIntegrations --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-x509Authentication-disableCustomerManagedX509-2023-01-01-default.sh b/docs/command/includes/atlas-api-x509Authentication-disableCustomerManagedX509-2023-01-01-default.sh deleted file mode 100644 index fc597810c6..0000000000 --- a/docs/command/includes/atlas-api-x509Authentication-disableCustomerManagedX509-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api x509Authentication disableCustomerManagedX509 --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509-2023-01-01-default.sh b/docs/command/includes/atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509-2023-01-01-default.sh new file mode 100644 index 0000000000..d0011d108c --- /dev/null +++ b/docs/command/includes/atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api x509Authentication disableGroupUserSecurityCustomerX509 --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 diff --git a/docs/command/includes/atlas-api-x509Authentication-listDatabaseUserCertificates-2023-01-01-default.sh b/docs/command/includes/atlas-api-x509Authentication-listDatabaseUserCertificates-2023-01-01-default.sh deleted file mode 100644 index 909594e7d4..0000000000 --- a/docs/command/includes/atlas-api-x509Authentication-listDatabaseUserCertificates-2023-01-01-default.sh +++ /dev/null @@ -1 +0,0 @@ -atlas api x509Authentication listDatabaseUserCertificates --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --username [username] diff --git a/docs/command/includes/atlas-api-x509Authentication-listGroupDatabaseUserCerts-2023-01-01-default.sh b/docs/command/includes/atlas-api-x509Authentication-listGroupDatabaseUserCerts-2023-01-01-default.sh new file mode 100644 index 0000000000..00f785e376 --- /dev/null +++ b/docs/command/includes/atlas-api-x509Authentication-listGroupDatabaseUserCerts-2023-01-01-default.sh @@ -0,0 +1 @@ +atlas api x509Authentication listGroupDatabaseUserCerts --version 2023-01-01 --groupId 32b6e34b3d91647abb20e7b8 --username [username] diff --git a/internal/api/commands.go b/internal/api/commands.go index e082c2d769..3454c78f6b 100644 --- a/internal/api/commands.go +++ b/internal/api/commands.go @@ -29,13 +29,13 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns and edits custom DNS configurations for MongoDB Cloud database deployments on AWS. The resource requires your Project ID. If you use the VPC peering on AWS and you use your own DNS servers instead of Amazon Route 53, enable custom DNS. Before 31 March 2020, applications deployed within AWS using custom DNS services and VPC-peered with MongoDB Cloud couldn't connect over private IP addresses. Custom DNS resolved to public IP addresses. AWS internal DNS resolved to private IP addresses. Applications deployed with custom DNS services in AWS should use Private IP for Peering connection strings.`, Commands: []shared_api.Command{ { - OperationID: `getAwsCustomDns`, + OperationID: `getGroupAwsCustomDns`, Aliases: nil, Description: `Returns the custom DNS configuration for AWS clusters in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getawscustomdns. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupawscustomdns. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-awsClustersDns-getAwsCustomDns/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-awsClustersDns-getGroupAwsCustomDns/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/awsCustomDNS`, QueryParameters: []shared_api.Parameter{ @@ -89,13 +89,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `toggleAwsCustomDns`, + OperationID: `toggleGroupAwsCustomDns`, Aliases: nil, Description: `Enables or disables the custom DNS configuration for AWS clusters in the specified project. Enable custom DNS if you use AWS VPC peering and use your own DNS servers. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-toggleawscustomdns. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglegroupawscustomdns. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-awsClustersDns-toggleAwsCustomDns/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-awsClustersDns-toggleGroupAwsCustomDns/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/awsCustomDNS`, QueryParameters: []shared_api.Parameter{ @@ -155,13 +155,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns access logs for authentication attempts made to Atlas database deployments. To view database access history, you must have either the Project Owner or Organization Owner role.`, Commands: []shared_api.Command{ { - OperationID: `listAccessLogsByClusterName`, + OperationID: `getGroupDbAccessHistoryCluster`, Aliases: nil, Description: `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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listaccesslogsbyclustername. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdbaccesshistorycluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-accessTracking-listAccessLogsByClusterName/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-accessTracking-getGroupDbAccessHistoryCluster/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/dbAccessHistory/clusters/{clusterName}`, QueryParameters: []shared_api.Parameter{ @@ -275,13 +275,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAccessLogsByHostname`, + OperationID: `getGroupDbAccessHistoryProcess`, Aliases: nil, Description: `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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listaccesslogsbyhostname. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdbaccesshistoryprocess. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-accessTracking-listAccessLogsByHostname/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-accessTracking-getGroupDbAccessHistoryProcess/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/dbAccessHistory/processes/{hostname}`, QueryParameters: []shared_api.Parameter{ @@ -401,16 +401,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and edits the conditions that trigger alerts and how MongoDB Cloud notifies users. This collection remains under revision and may change.`, Commands: []shared_api.Command{ { - OperationID: `createAlertConfiguration`, + OperationID: `createGroupAlertConfig`, Aliases: nil, Description: `Creates one alert configuration for the specified project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createalertconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupalertconfig. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-createAlertConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-createGroupAlertConfig/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/alertConfigs`, QueryParameters: []shared_api.Parameter{ @@ -464,16 +464,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAlertConfiguration`, + OperationID: `deleteGroupAlertConfig`, Aliases: nil, Description: `Removes one alert configuration from the specified project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletealertconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupalertconfig. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-deleteAlertConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-deleteGroupAlertConfig/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}`, QueryParameters: []shared_api.Parameter{ @@ -537,18 +537,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAlertConfiguration`, + OperationID: `getGroupAlertAlertConfigs`, Aliases: nil, - Description: `Returns the specified alert configuration from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. + Description: `Returns all alert configurations set for the specified alert. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getalertconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupalertalertconfigs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-getAlertConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-getGroupAlertAlertConfigs/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}`, + URL: `/api/atlas/v2/groups/{groupId}/alerts/{alertId}/alertConfigs`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -570,6 +570,36 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -587,8 +617,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `alertConfigId`, - Description: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, + Name: `alertId`, + Description: `Unique 24-hexadecimal digit string that identifies the alert.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -610,15 +640,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAlertConfigurationMatchersFieldNames`, + OperationID: `getGroupAlertConfig`, Aliases: nil, - Description: `Get all field names that the matchers.fieldName parameter accepts when you create or update an Alert Configuration. You can successfully call this endpoint with any assigned role. + Description: `Returns the specified alert configuration from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigurationmatchersfieldnames. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-listAlertConfigurationMatchersFieldNames/`, +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupalertconfig. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-getGroupAlertConfig/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/alertConfigs/matchers/fieldNames`, + URL: `/api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -641,8 +674,33 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - URLParameters: []shared_api.Parameter{}, - Verb: http.MethodGet, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `alertConfigId`, + Description: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -655,18 +713,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listAlertConfigurations`, + OperationID: `listAlertConfigMatcherFieldNames`, Aliases: nil, - Description: `Returns all alert configurations for one project. These alert configurations apply to any component in the project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This resource remains under revision and may change. + Description: `Get all field names that the matchers.fieldName parameter accepts when you create or update an Alert Configuration. You can successfully call this endpoint with any assigned role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigurations. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigmatcherfieldnames. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-listAlertConfigurations/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-listAlertConfigMatcherFieldNames/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/alertConfigs`, + URL: `/api/atlas/v2/alertConfigs/matchers/fieldNames`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -678,36 +733,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, { Name: `pretty`, Description: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -719,23 +744,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - }, - Verb: http.MethodGet, + URLParameters: []shared_api.Parameter{}, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -748,18 +758,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAlertConfigurationsByAlertId`, + OperationID: `listGroupAlertConfigs`, Aliases: nil, - Description: `Returns all alert configurations set for the specified alert. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. + Description: `Returns all alert configurations for one project. These alert configurations apply to any component in the project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigurationsbyalertid. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupalertconfigs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-listAlertConfigurationsByAlertId/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-listGroupAlertConfigs/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/alerts/{alertId}/alertConfigs`, + URL: `/api/atlas/v2/groups/{groupId}/alertConfigs`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -771,16 +781,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, { Name: `includeCount`, Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, @@ -811,6 +811,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `int`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -827,16 +837,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `alertId`, - Description: `Unique 24-hexadecimal digit string that identifies the alert.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -851,7 +851,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `toggleAlertConfiguration`, + OperationID: `toggleGroupAlertConfig`, Aliases: nil, Description: `Enables or disables the specified alert configuration in the specified project. The resource enables the specified alert configuration if currently enabled. The resource disables the specified alert configuration if currently disabled. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -861,9 +861,9 @@ NOTE: This endpoint updates only the enabled/disabled state for the alert config This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglealertconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglegroupalertconfig. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-toggleAlertConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-toggleGroupAlertConfig/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}`, QueryParameters: []shared_api.Parameter{ @@ -927,7 +927,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAlertConfiguration`, + OperationID: `updateGroupAlertConfig`, Aliases: nil, Description: `Updates one alert configuration in the specified project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -937,9 +937,9 @@ NOTE: To enable or disable the alert configuration, see Toggle One State of One This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatealertconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupalertconfig. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-updateAlertConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alertConfigurations-updateGroupAlertConfig/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}`, QueryParameters: []shared_api.Parameter{ @@ -1009,16 +1009,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and acknowledges alerts that MongoDB Cloud triggers based on the alert conditions that you define. This collection remains under revision and may change.`, Commands: []shared_api.Command{ { - OperationID: `acknowledgeAlert`, + OperationID: `acknowledgeGroupAlert`, Aliases: nil, Description: `Confirms receipt of one existing alert. This alert applies to any component in one project. Acknowledging an alert prevents successive notifications. You receive an alert when a monitored component meets or exceeds a value you set until you acknowledge the alert. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acknowledgealert. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acknowledgegroupalert. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alerts-acknowledgeAlert/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alerts-acknowledgeGroupAlert/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/alerts/{alertId}`, QueryParameters: []shared_api.Parameter{ @@ -1089,16 +1089,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAlert`, + OperationID: `getGroupAlert`, Aliases: nil, Description: `Returns one alert. This alert applies to any component in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getalert. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupalert. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alerts-getAlert/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alerts-getGroupAlert/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/alerts/{alertId}`, QueryParameters: []shared_api.Parameter{ @@ -1162,119 +1162,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAlerts`, - Aliases: nil, - Description: `Returns all alerts. These alerts apply to all components in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This resource remains under revision and may change. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalerts. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alerts-listAlerts/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/alerts`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `status`, - Description: `Status of the alerts to return. Omit this parameter to return all alerts in all statuses. TRACKING indicates the alert condition exists but has not persisted for the minimum notification delay. OPEN indicates the alert condition currently exists. CLOSED indicates the alert condition has been resolved.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `listAlertsByAlertConfigurationId`, + OperationID: `getGroupAlertConfigAlerts`, Aliases: nil, Description: `Returns all open alerts that the specified alert configuration triggers. These alert configurations apply to the specified project only. Alert configurations define the triggers and notification methods for alerts. Open alerts have been triggered but remain unacknowledged. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertsbyalertconfigurationid. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupalertconfigalerts. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alerts-listAlertsByAlertConfigurationId/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alerts-getGroupAlertConfigAlerts/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}/alerts`, QueryParameters: []shared_api.Parameter{ @@ -1367,22 +1264,19 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - }, - }, - { - Name: `Atlas Search`, - Description: `Returns, adds, edits, and removes Atlas Search indexes for the specified cluster. Also returns and updates user-defined analyzers for the specified cluster.`, - Commands: []shared_api.Command{ { - OperationID: `createAtlasSearchDeployment`, + OperationID: `listGroupAlerts`, Aliases: nil, - Description: `Creates Search Nodes for the specified cluster. + Description: `Returns all alerts. These alerts apply to all components in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchdeployment. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-createAtlasSearchDeployment/`, +This resource remains under revision and may change. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupalerts. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-alerts-listGroupAlerts/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment`, + URL: `/api/atlas/v2/groups/{groupId}/alerts`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -1395,8 +1289,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -1404,84 +1298,29 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, - Aliases: []string{`projectId`}, }, { - Name: `clusterName`, - Description: `Label that identifies the cluster to create Search Nodes for.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodPost, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - Watcher: &shared_api.WatcherProperties{ - Get: shared_api.WatcherGetProperties{ - OperationID: `getAtlasSearchDeployment`, - Version: shared_api.NewStableVersion(2024, 5, 30), - Params: map[string]string{ - `clusterName`: `input:clusterName`, - `groupId`: `input:groupId`, - }, - }, - Expect: &shared_api.WatcherExpectProperties{ - Match: &shared_api.WatcherMatchProperties{ - Path: `$.stateName`, - Values: []string{ - `IDLE`, + Type: `int`, }, }, - }, - }, - }, - { - OperationID: `createAtlasSearchIndex`, - Aliases: nil, - Description: `Creates one Atlas Search index on the specified collection. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchindex. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-createAtlasSearchIndex/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes`, - QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -1490,13 +1329,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `status`, + Description: `Status of the alerts to return. Omit this parameter to return all alerts in all statuses. TRACKING indicates the alert condition exists but has not persisted for the minimum notification delay. OPEN indicates the alert condition currently exists. CLOSED indicates the alert condition has been resolved.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, }, @@ -1515,37 +1354,33 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `clusterName`, - Description: `Name of the cluster that contains the collection on which to create an Atlas Search index.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodPost, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: `json`, + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, }, }, }, + }, + }, + { + Name: `Atlas Search`, + Description: `Returns, adds, edits, and removes Atlas Search indexes for the specified cluster. Also returns and updates user-defined analyzers for the specified cluster.`, + Commands: []shared_api.Command{ { - OperationID: `createAtlasSearchIndexDeprecated`, + OperationID: `createGroupClusterFtsIndex`, Aliases: nil, Description: `Creates one Atlas Search index on the specified collection. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchindexdeprecated. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterftsindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-createAtlasSearchIndexDeprecated/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-createGroupClusterFtsIndex/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes`, QueryParameters: []shared_api.Parameter{ @@ -1609,13 +1444,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAtlasSearchDeployment`, + OperationID: `createGroupClusterSearchDeployment`, Aliases: nil, - Description: `Deletes the Search Nodes for the specified cluster. + Description: `Creates Search Nodes for the specified cluster. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchdeployment. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclustersearchdeployment. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-deleteAtlasSearchDeployment/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-createGroupClusterSearchDeployment/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment`, QueryParameters: []shared_api.Parameter{ @@ -1657,7 +1492,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Label that identifies the cluster to delete.`, + Description: `Label that identifies the cluster to create Search Nodes for.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -1666,19 +1501,19 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, }, { Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, @@ -1686,7 +1521,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getAtlasSearchDeployment`, + OperationID: `updateGroupClusterSearchDeployment`, Version: shared_api.NewStableVersion(2024, 5, 30), Params: map[string]string{ `clusterName`: `input:clusterName`, @@ -1694,21 +1529,25 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, Expect: &shared_api.WatcherExpectProperties{ - HTTPCode: 404, //nolint - Match: nil, + Match: &shared_api.WatcherMatchProperties{ + Path: `$.stateName`, + Values: []string{ + `IDLE`, + }, + }, }, }, }, { - OperationID: `deleteAtlasSearchIndex`, + OperationID: `createGroupClusterSearchIndex`, Aliases: nil, - Description: `Removes one Atlas Search index that you identified with its unique ID. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. + Description: `Creates one Atlas Search index on the specified collection. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindex. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclustersearchindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-deleteAtlasSearchIndex/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-createGroupClusterSearchIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{indexId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -1748,17 +1587,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `indexId`, - Description: `Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the Get All Atlas Search Indexes for a Collection API endpoint to find the IDs of all Atlas Search indexes.`, + Description: `Name of the cluster that contains the collection on which to create an Atlas Search index.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -1767,12 +1596,12 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, @@ -1780,15 +1609,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAtlasSearchIndexByName`, + OperationID: `deleteGroupClusterFtsIndex`, Aliases: nil, - Description: `Removes one Atlas Search index that you identified with its database, collection, and name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. + Description: `Removes one Atlas Search index that you identified with its unique ID. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindexbyname. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterftsindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-deleteAtlasSearchIndexByName/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-deleteGroupClusterFtsIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}/{indexName}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -1837,28 +1666,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - Name: `collectionName`, - Description: `Name of the collection that contains one or more Atlas Search indexes.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `databaseName`, - Description: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `indexName`, - Description: `Name of the Atlas Search index to delete.`, + Name: `indexId`, + Description: `Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the Get All Atlas Search Indexes for a Collection API endpoint to find the IDs of all Atlas Search indexes.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -1871,7 +1680,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -1880,15 +1689,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAtlasSearchIndexDeprecated`, + OperationID: `deleteGroupClusterSearchDeployment`, Aliases: nil, - Description: `Removes one Atlas Search index that you identified with its unique ID. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + Description: `Deletes the Search Nodes for the specified cluster. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindexdeprecated. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclustersearchdeployment. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-deleteAtlasSearchIndexDeprecated/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-deleteGroupClusterSearchDeployment/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -1928,17 +1737,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `indexId`, - Description: `Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the Get All Atlas Search Indexes for a Collection API endpoint to find the IDs of all Atlas Search indexes.`, + Description: `Label that identifies the cluster to delete.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -1957,18 +1756,39 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, + { + Version: shared_api.NewStableVersion(2024, 5, 30), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + Watcher: &shared_api.WatcherProperties{ + Get: shared_api.WatcherGetProperties{ + OperationID: `deleteGroupClusterSearchDeployment`, + Version: shared_api.NewStableVersion(2024, 5, 30), + Params: map[string]string{ + `clusterName`: `input:clusterName`, + `groupId`: `input:groupId`, + }, + }, + Expect: &shared_api.WatcherExpectProperties{ + HTTPCode: 404, //nolint + Match: nil, + }, }, }, { - OperationID: `getAtlasSearchDeployment`, + OperationID: `deleteGroupClusterSearchIndex`, Aliases: nil, - Description: `Returns the Search Nodes for the specified cluster. + Description: `Removes one Atlas Search index that you identified with its unique ID. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchdeployment. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclustersearchindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-getAtlasSearchDeployment/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-deleteGroupClusterSearchIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{indexId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2008,7 +1828,17 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Label that identifies the cluster to return the Search Nodes for.`, + Description: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `indexId`, + Description: `Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the Get All Atlas Search Indexes for a Collection API endpoint to find the IDs of all Atlas Search indexes.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2017,16 +1847,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodGet, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, { Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: ``, @@ -2034,25 +1857,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, - { - Version: shared_api.NewStableVersion(2025, 3, 12), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, }, }, { - OperationID: `getAtlasSearchIndex`, + OperationID: `deleteGroupClusterSearchIndexByName`, Aliases: nil, - Description: `Returns one Atlas Search index that you identified with its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. + Description: `Removes one Atlas Search index that you identified with its database, collection, and name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindex. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclustersearchindexbyname. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-getAtlasSearchIndex/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-deleteGroupClusterSearchIndexByName/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{indexId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}/{indexName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2092,7 +1908,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, + Description: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2101,8 +1917,28 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - Name: `indexId`, - Description: `Unique 24-hexadecimal digit string that identifies the Application Search index. Use the Get All Application Search Indexes for a Collection API endpoint to find the IDs of all Application Search indexes.`, + Name: `collectionName`, + Description: `Name of the collection that contains one or more Atlas Search indexes.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `databaseName`, + Description: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `indexName`, + Description: `Name of the Atlas Search index to delete.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2111,7 +1947,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodGet, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { @@ -2124,15 +1960,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAtlasSearchIndexByName`, + OperationID: `getGroupClusterFtsIndex`, Aliases: nil, - Description: `Returns one Atlas Search index that you identified with its database, collection name, and index name. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. + Description: `Returns one Atlas Search index in the specified project. You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindexbyname. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterftsindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-getAtlasSearchIndexByName/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-getGroupClusterFtsIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}/{indexName}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2181,8 +2017,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - Name: `collectionName`, - Description: `Name of the collection that contains one or more Atlas Search indexes.`, + Name: `indexId`, + Description: `Unique 24-hexadecimal digit string that identifies the Application Search index. Use the Get All Application Search Indexes for a Collection API endpoint to find the IDs of all Application Search indexes.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2190,19 +2026,69 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Type: `string`, }, }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `getGroupClusterSearchDeployment`, + Aliases: nil, + Description: `Returns the Search Nodes for the specified cluster. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersearchdeployment. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-getGroupClusterSearchDeployment/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment`, + QueryParameters: []shared_api.Parameter{ { - Name: `databaseName`, - Description: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, - Required: true, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, { - Name: `indexName`, - Description: `Name of the Atlas Search index to return.`, + Name: `clusterName`, + Description: `Label that identifies the cluster to return the Search Nodes for.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2214,6 +2100,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, { Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: ``, @@ -2221,18 +2114,25 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, + { + Version: shared_api.NewStableVersion(2025, 3, 12), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, }, }, { - OperationID: `getAtlasSearchIndexDeprecated`, + OperationID: `getGroupClusterSearchIndex`, Aliases: nil, - Description: `Returns one Atlas Search index in the specified project. You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. + Description: `Returns one Atlas Search index that you identified with its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindexdeprecated. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersearchindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-getAtlasSearchIndexDeprecated/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-getGroupClusterSearchIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{indexId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2295,7 +2195,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), + Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -2304,15 +2204,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAtlasSearchIndexes`, + OperationID: `getGroupClusterSearchIndexByName`, Aliases: nil, - Description: `Returns all Atlas Search indexes on the specified collection. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. + Description: `Returns one Atlas Search index that you identified with its database, collection name, and index name. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexes. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersearchindexbyname. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-listAtlasSearchIndexes/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-getGroupClusterSearchIndexByName/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}/{indexName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2380,6 +2280,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Type: `string`, }, }, + { + Name: `indexName`, + Description: `Name of the Atlas Search index to return.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodGet, }, @@ -2394,15 +2304,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAtlasSearchIndexesCluster`, + OperationID: `listGroupClusterFtsIndex`, Aliases: nil, - Description: `Returns all Atlas Search indexes on the specified cluster. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. + Description: `Returns all Atlas Search indexes on the specified collection. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexescluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterftsindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-listAtlasSearchIndexesCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-listGroupClusterFtsIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{databaseName}/{collectionName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2450,12 +2360,32 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Type: `string`, }, }, + { + Name: `collectionName`, + Description: `Name of the collection that contains one or more Atlas Search indexes.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `databaseName`, + Description: `Human-readable label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -2464,15 +2394,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAtlasSearchIndexesDeprecated`, + OperationID: `listGroupClusterSearchIndex`, Aliases: nil, Description: `Returns all Atlas Search indexes on the specified collection. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexesdeprecated. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustersearchindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-listAtlasSearchIndexesDeprecated/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-listGroupClusterSearchIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{databaseName}/{collectionName}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2532,7 +2462,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `databaseName`, - Description: `Human-readable label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + Description: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2545,7 +2475,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), + Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -2554,15 +2484,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAtlasSearchDeployment`, + OperationID: `listGroupClusterSearchIndexes`, Aliases: nil, - Description: `Updates the Search Nodes for the specified cluster. + Description: `Returns all Atlas Search indexes on the specified cluster. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchdeployment. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustersearchindexes. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-updateAtlasSearchDeployment/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-listGroupClusterSearchIndexes/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2602,7 +2532,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Label that identifies the cluster to update the Search Nodes for.`, + Description: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2611,53 +2541,28 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodPatch, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, { Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, }, }, - Watcher: &shared_api.WatcherProperties{ - Get: shared_api.WatcherGetProperties{ - OperationID: `getAtlasSearchDeployment`, - Version: shared_api.NewStableVersion(2024, 5, 30), - Params: map[string]string{ - `clusterName`: `input:clusterName`, - `groupId`: `input:groupId`, - }, - }, - Expect: &shared_api.WatcherExpectProperties{ - Match: &shared_api.WatcherMatchProperties{ - Path: `$.stateName`, - Values: []string{ - `IDLE`, - }, - }, - }, - }, }, { - OperationID: `updateAtlasSearchIndex`, + OperationID: `updateGroupClusterFtsIndex`, Aliases: nil, Description: `Updates one Atlas Search index that you identified with its unique ID. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindex. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusterftsindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-updateAtlasSearchIndex/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-updateGroupClusterFtsIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{indexId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2697,7 +2602,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Name of the cluster that contains the collection whose Atlas Search index you want to update.`, + Description: `Name of the cluster that contains the collection whose Atlas Search index to update.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2720,7 +2625,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, @@ -2729,15 +2634,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAtlasSearchIndexByName`, + OperationID: `updateGroupClusterSearchDeployment`, Aliases: nil, - Description: `Updates one Atlas Search index that you identified with its database, collection name, and index name. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + Description: `Updates the Search Nodes for the specified cluster. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindexbyname. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchdeployment. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-updateAtlasSearchIndexByName/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-updateGroupClusterSearchDeployment/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}/{indexName}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2777,37 +2682,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Name of the cluster that contains the collection whose Atlas Search index you want to update.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `collectionName`, - Description: `Name of the collection that contains one or more Atlas Search indexes.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `databaseName`, - Description: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `indexName`, - Description: `Name of the Atlas Search index to update.`, + Description: `Label that identifies the cluster to update the Search Nodes for.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2819,6 +2694,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, { Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: `json`, @@ -2827,17 +2709,35 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, + Watcher: &shared_api.WatcherProperties{ + Get: shared_api.WatcherGetProperties{ + OperationID: `updateGroupClusterSearchDeployment`, + Version: shared_api.NewStableVersion(2024, 5, 30), + Params: map[string]string{ + `clusterName`: `input:clusterName`, + `groupId`: `input:groupId`, + }, + }, + Expect: &shared_api.WatcherExpectProperties{ + Match: &shared_api.WatcherMatchProperties{ + Path: `$.stateName`, + Values: []string{ + `IDLE`, + }, + }, + }, + }, }, { - OperationID: `updateAtlasSearchIndexDeprecated`, + OperationID: `updateGroupClusterSearchIndex`, Aliases: nil, Description: `Updates one Atlas Search index that you identified with its unique ID. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindexdeprecated. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-updateAtlasSearchIndexDeprecated/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-updateGroupClusterSearchIndex/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{indexId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -2877,7 +2777,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Name of the cluster that contains the collection whose Atlas Search index to update.`, + Description: `Name of the cluster that contains the collection whose Atlas Search index you want to update.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -2900,7 +2800,107 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), + Version: shared_api.NewStableVersion(2024, 5, 30), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `updateGroupClusterSearchIndexByName`, + Aliases: nil, + Description: `Updates one Atlas Search index that you identified with its database, collection name, and index name. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchindexbyname. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-atlasSearch-updateGroupClusterSearchIndexByName/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}/{indexName}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `clusterName`, + Description: `Name of the cluster that contains the collection whose Atlas Search index you want to update.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `collectionName`, + Description: `Name of the collection that contains one or more Atlas Search indexes.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `databaseName`, + Description: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `indexName`, + Description: `Name of the Atlas Search index to update.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodPatch, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, @@ -2915,13 +2915,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and edits database auditing settings for MongoDB Cloud projects.`, Commands: []shared_api.Command{ { - OperationID: `getAuditingConfiguration`, + OperationID: `getGroupAuditLog`, Aliases: nil, Description: `Returns the auditing configuration for the specified project. The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for M0, M2, M5, or serverless clusters. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getauditingconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupauditlog. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-auditing-getAuditingConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-auditing-getGroupAuditLog/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/auditLog`, QueryParameters: []shared_api.Parameter{ @@ -2975,13 +2975,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAuditingConfiguration`, + OperationID: `updateGroupAuditLog`, Aliases: nil, Description: `Updates the auditing configuration for the specified project. The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for M0, M2, M5, or serverless clusters. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateauditingconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupauditlog. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-auditing-updateAuditingConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-auditing-updateGroupAuditLog/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/auditLog`, QueryParameters: []shared_api.Parameter{ @@ -3041,13 +3041,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Manages Cloud Backup snapshots, snapshot export buckets, restore jobs, and schedules. This resource applies only to clusters that use Cloud Backups.`, Commands: []shared_api.Command{ { - OperationID: `cancelBackupRestoreJob`, + OperationID: `cancelGroupClusterBackupRestoreJob`, Aliases: nil, Description: `Cancels one cloud backup restore job of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cancelbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cancelgroupclusterbackuprestorejob. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-cancelBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-cancelGroupClusterBackupRestoreJob/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs/{restoreJobId}`, QueryParameters: []shared_api.Parameter{ @@ -3121,13 +3121,80 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createBackupExportJob`, + OperationID: `createGroupBackupExportBucket`, + Aliases: nil, + Description: `Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. Once created, an snapshots can be exported to the Export Bucket and its referenced AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupbackupexportbucket. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-createGroupBackupExportBucket/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/backup/exportBuckets`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + }, + Verb: http.MethodPost, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + { + Version: shared_api.NewStableVersion(2024, 5, 30), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `createGroupClusterBackupExport`, Aliases: nil, Description: `Exports one backup Snapshot for dedicated Atlas cluster using Cloud Backups to an Export Bucket. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createbackupexportjob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterbackupexport. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-createBackupExportJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-createGroupClusterBackupExport/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports`, QueryParameters: []shared_api.Parameter{ @@ -3181,11 +3248,10 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getBackupExportJob`, + OperationID: `createGroupClusterBackupExport`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `clusterName`: `input:clusterName`, - `exportId`: `body:$.id`, `groupId`: `input:groupId`, }, }, @@ -3202,16 +3268,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createBackupRestoreJob`, + OperationID: `createGroupClusterBackupRestoreJob`, Aliases: nil, Description: `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 Service Account or API Key must have the Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterbackuprestorejob. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-createBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-createGroupClusterBackupRestoreJob/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs`, QueryParameters: []shared_api.Parameter{ @@ -3275,15 +3341,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createExportBucket`, + OperationID: `createGroupServerlessBackupRestoreJob`, Aliases: nil, - Description: `Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. Once created, an snapshots can be exported to the Export Bucket and its referenced AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Restores one snapshot of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createexportbucket. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-createExportBucket/`, +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the createFlexBackupRestoreJob endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserverlessbackuprestorejob. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-createGroupServerlessBackupRestoreJob/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/backup/exportBuckets`, + URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/restoreJobs`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -3321,6 +3390,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `clusterName`, + Description: `Human-readable label that identifies the serverless instance whose snapshot you want to restore.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodPost, }, @@ -3332,28 +3411,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, - { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, }, }, { - OperationID: `createServerlessBackupRestoreJob`, + OperationID: `deleteGroupBackupExportBucket`, Aliases: nil, - Description: `Restores one snapshot of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the createFlexBackupRestoreJob endpoint instead. + Description: `Deletes an Export Bucket. Auto export must be disabled on all clusters in this Project exporting to this Export Bucket before revoking access. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserverlessbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupbackupexportbucket. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-createServerlessBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-deleteGroupBackupExportBucket/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/restoreJobs`, + URL: `/api/atlas/v2/groups/{groupId}/backup/exportBuckets/{exportBucketId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -3365,16 +3434,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -3392,8 +3451,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `clusterName`, - Description: `Human-readable label that identifies the serverless instance whose snapshot you want to restore.`, + Name: `exportBucketId`, + Description: `Unique 24-hexadecimal character string that identifies the Export Bucket.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -3402,12 +3461,12 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodPost, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -3415,13 +3474,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAllBackupSchedules`, + OperationID: `deleteGroupClusterBackupSchedule`, Aliases: nil, Description: `Removes all cloud backup schedules for the specified cluster. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteallbackupschedules. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterbackupschedule. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-deleteAllBackupSchedules/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-deleteGroupClusterBackupSchedule/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/schedule`, QueryParameters: []shared_api.Parameter{ @@ -3482,15 +3541,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteExportBucket`, + OperationID: `deleteGroupClusterBackupSnapshot`, Aliases: nil, - Description: `Deletes an Export Bucket. Auto export must be disabled on all clusters in this Project exporting to this Export Bucket before revoking access. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + Description: `Removes the specified snapshot. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteexportbucket. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterbackupsnapshot. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-deleteExportBucket/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshot/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/backup/exportBuckets/{exportBucketId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -3502,6 +3561,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -3519,8 +3588,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `exportBucketId`, - Description: `Unique 24-hexadecimal character string that identifies the Export Bucket.`, + Name: `clusterName`, + Description: `Human-readable label that identifies the cluster.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `snapshotId`, + Description: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -3540,17 +3619,32 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, + Watcher: &shared_api.WatcherProperties{ + Get: shared_api.WatcherGetProperties{ + OperationID: `deleteGroupClusterBackupSnapshot`, + Version: shared_api.NewStableVersion(2023, 1, 1), + Params: map[string]string{ + `clusterName`: `input:clusterName`, + `groupId`: `input:groupId`, + `snapshotId`: `input:snapshotId`, + }, + }, + Expect: &shared_api.WatcherExpectProperties{ + HTTPCode: 404, //nolint + Match: nil, + }, + }, }, { - OperationID: `deleteReplicaSetBackup`, + OperationID: `deleteGroupClusterBackupSnapshotShardedCluster`, Aliases: nil, - Description: `Removes the specified snapshot. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + Description: `Removes one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletereplicasetbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterbackupsnapshotshardedcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-deleteReplicaSetBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-deleteGroupClusterBackupSnapshotShardedCluster/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/{snapshotId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedCluster/{snapshotId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -3620,32 +3714,17 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Watcher: &shared_api.WatcherProperties{ - Get: shared_api.WatcherGetProperties{ - OperationID: `getReplicaSetBackup`, - Version: shared_api.NewStableVersion(2023, 1, 1), - Params: map[string]string{ - `clusterName`: `input:clusterName`, - `groupId`: `input:groupId`, - `snapshotId`: `input:snapshotId`, - }, - }, - Expect: &shared_api.WatcherExpectProperties{ - HTTPCode: 404, //nolint - Match: nil, - }, - }, }, { - OperationID: `deleteShardedClusterBackup`, + OperationID: `disableGroupBackupCompliancePolicy`, Aliases: nil, - Description: `Removes one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + Description: `Disables the Backup Compliance Policy settings with the specified project. As a prerequisite, a support ticket needs to be file first, instructions in https://www.mongodb.com/docs/atlas/backup/cloud-backup/backup-compliance-policy/. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteshardedclusterbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablegroupbackupcompliancepolicy. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-deleteShardedClusterBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-disableGroupBackupCompliancePolicy/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedCluster/{snapshotId}`, + URL: `/api/atlas/v2/groups/{groupId}/backupCompliancePolicy`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -3683,47 +3762,44 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `snapshotId`, - Description: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), + Version: shared_api.NewStableVersion(2024, 11, 13), RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, }, }, + Watcher: &shared_api.WatcherProperties{ + Get: shared_api.WatcherGetProperties{ + OperationID: `updateGroupBackupCompliancePolicy`, + Version: shared_api.NewStableVersion(2023, 10, 1), + Params: map[string]string{ + `groupId`: `input:groupId`, + }, + }, + Expect: &shared_api.WatcherExpectProperties{ + Match: &shared_api.WatcherMatchProperties{ + Path: `$.state`, + Values: []string{ + `ACTIVE`, + }, + }, + }, + }, }, { - OperationID: `disableDataProtectionSettings`, + OperationID: `getGroupBackupCompliancePolicy`, Aliases: nil, - Description: `Disables the Backup Compliance Policy settings with the specified project. As a prerequisite, a support ticket needs to be file first, instructions in https://www.mongodb.com/docs/atlas/backup/cloud-backup/backup-compliance-policy/. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Returns the Backup Compliance Policy settings with the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disabledataprotectionsettings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupbackupcompliancepolicy. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-disableDataProtectionSettings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupBackupCompliancePolicy/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/backupCompliancePolicy`, QueryParameters: []shared_api.Parameter{ @@ -3764,45 +3840,35 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 11, 13), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, }, - }, - Watcher: &shared_api.WatcherProperties{ - Get: shared_api.WatcherGetProperties{ - OperationID: `getDataProtectionSettings`, - Version: shared_api.NewStableVersion(2023, 10, 1), - Params: map[string]string{ - `groupId`: `input:groupId`, - }, - }, - Expect: &shared_api.WatcherExpectProperties{ - Match: &shared_api.WatcherMatchProperties{ - Path: `$.state`, - Values: []string{ - `ACTIVE`, - }, + { + Version: shared_api.NewStableVersion(2023, 10, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, }, }, }, }, { - OperationID: `getBackupExportJob`, + OperationID: `getGroupBackupExportBucket`, Aliases: nil, - Description: `Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. + Description: `Returns one Export Bucket associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackupexportjob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupbackupexportbucket. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getBackupExportJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupBackupExportBucket/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports/{exportId}`, + URL: `/api/atlas/v2/groups/{groupId}/backup/exportBuckets/{exportBucketId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -3831,18 +3897,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `exportId`, - Description: `Unique 24-hexadecimal character string that identifies the Export Job.`, + Name: `exportBucketId`, + Description: `Unique 24-hexadecimal character string that identifies the Export Bucket.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -3861,18 +3917,25 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, + { + Version: shared_api.NewStableVersion(2024, 5, 30), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, }, }, { - OperationID: `getBackupRestoreJob`, + OperationID: `getGroupClusterBackupExport`, Aliases: nil, - Description: `Returns one cloud backup restore job for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + Description: `Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupexport. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupClusterBackupExport/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs/{restoreJobId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports/{exportId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -3884,16 +3947,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -3912,7 +3965,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster with the restore jobs you want to return.`, + Description: `Human-readable label that identifies the cluster.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -3921,8 +3974,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - Name: `restoreJobId`, - Description: `Unique 24-hexadecimal digit string that identifies the restore job to return.`, + Name: `exportId`, + Description: `Unique 24-hexadecimal character string that identifies the Export Job.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -3944,15 +3997,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getBackupSchedule`, + OperationID: `getGroupClusterBackupRestoreJob`, Aliases: nil, - Description: `Returns the cloud backup schedule for the specified cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns one cloud backup restore job for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackupschedule. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackuprestorejob. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getBackupSchedule/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupClusterBackupRestoreJob/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/schedule`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs/{restoreJobId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -3992,7 +4045,17 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, + Description: `Human-readable label that identifies the cluster with the restore jobs you want to return.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `restoreJobId`, + Description: `Unique 24-hexadecimal digit string that identifies the restore job to return.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -4011,25 +4074,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, - { - Version: shared_api.NewStableVersion(2024, 8, 5), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, }, }, { - OperationID: `getDataProtectionSettings`, + OperationID: `getGroupClusterBackupSchedule`, Aliases: nil, - Description: `Returns the Backup Compliance Policy settings with the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Returns the cloud backup schedule for the specified cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdataprotectionsettings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupschedule. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getDataProtectionSettings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupClusterBackupSchedule/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/backupCompliancePolicy`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/schedule`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4058,63 +4114,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - { - Version: shared_api.NewStableVersion(2023, 10, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `getExportBucket`, - Aliases: nil, - Description: `Returns one Export Bucket associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getexportbucket. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getExportBucket/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/backup/exportBuckets/{exportBucketId}`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, Short: ``, Required: true, @@ -4125,8 +4124,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `exportBucketId`, - Description: `Unique 24-hexadecimal character string that identifies the Export Bucket.`, + Name: `clusterName`, + Description: `Human-readable label that identifies the cluster.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -4146,7 +4145,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - Version: shared_api.NewStableVersion(2024, 5, 30), + Version: shared_api.NewStableVersion(2024, 8, 5), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -4155,13 +4154,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getReplicaSetBackup`, + OperationID: `getGroupClusterBackupSnapshot`, Aliases: nil, Description: `Returns one snapshot from the specified cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getreplicasetbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupsnapshot. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getReplicaSetBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupClusterBackupSnapshot/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ @@ -4235,18 +4234,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessBackup`, + OperationID: `getGroupClusterBackupSnapshotShardedCluster`, Aliases: nil, - Description: `Returns one snapshot of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - - -This endpoint can also be used on Flex clusters that were created with the createServerlessInstance API or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the getFlexBackup endpoint instead. + Description: `Returns one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupsnapshotshardedcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getServerlessBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupClusterBackupSnapshotShardedCluster/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/snapshots/{snapshotId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedCluster/{snapshotId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4258,6 +4254,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -4276,7 +4282,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the serverless instance.`, + Description: `Human-readable label that identifies the cluster.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -4308,16 +4314,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessBackupRestoreJob`, + OperationID: `getGroupServerlessBackupRestoreJob`, Aliases: nil, Description: `Returns one restore job for one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the getFlexBackupRestoreJob endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserverlessbackuprestorejob. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getServerlessBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupServerlessBackupRestoreJob/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/restoreJobs/{restoreJobId}`, QueryParameters: []shared_api.Parameter{ @@ -4391,15 +4397,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getShardedClusterBackup`, + OperationID: `getGroupServerlessBackupSnapshot`, Aliases: nil, - Description: `Returns one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. + Description: `Returns one snapshot of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + + +This endpoint can also be used on Flex clusters that were created with the createServerlessInstance API or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the getFlexBackup endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getshardedclusterbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserverlessbackupsnapshot. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getShardedClusterBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-getGroupServerlessBackupSnapshot/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedCluster/{snapshotId}`, + URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4411,16 +4420,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -4439,7 +4438,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, + Description: `Human-readable label that identifies the serverless instance.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -4471,15 +4470,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listBackupExportJobs`, + OperationID: `listGroupBackupExportBuckets`, Aliases: nil, - Description: `Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. + Description: `Returns all Export Buckets associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listbackupexportjobs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupbackupexportbuckets. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listBackupExportJobs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listGroupBackupExportBuckets/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports`, + URL: `/api/atlas/v2/groups/{groupId}/backup/exportBuckets`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4491,16 +4490,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, { Name: `includeCount`, Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, @@ -4531,6 +4520,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `int`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -4547,16 +4546,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -4568,18 +4557,25 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, + { + Version: shared_api.NewStableVersion(2024, 5, 30), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, }, }, { - OperationID: `listBackupRestoreJobs`, + OperationID: `listGroupClusterBackupExports`, Aliases: nil, - Description: `Returns all cloud backup restore jobs for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. + Description: `Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listbackuprestorejobs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackupexports. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listBackupRestoreJobs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listGroupClusterBackupExports/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4592,8 +4588,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -4602,18 +4598,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -4622,13 +4618,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, }, }, }, @@ -4649,7 +4645,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster with the restore jobs you want to return.`, + Description: `Human-readable label that identifies the cluster.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -4671,15 +4667,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listExportBuckets`, + OperationID: `listGroupClusterBackupRestoreJobs`, Aliases: nil, - Description: `Returns all Export Buckets associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns all cloud backup restore jobs for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listexportbuckets. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackuprestorejobs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listExportBuckets/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listGroupClusterBackupRestoreJobs/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/backup/exportBuckets`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4747,6 +4743,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `clusterName`, + Description: `Human-readable label that identifies the cluster with the restore jobs you want to return.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodGet, }, @@ -4758,25 +4764,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, - { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, }, }, { - OperationID: `listReplicaSetBackups`, + OperationID: `listGroupClusterBackupSnapshotShardedClusters`, Aliases: nil, - Description: `Returns all snapshots of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. + Description: `Returns all snapshots of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listreplicasetbackups. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackupsnapshotshardedclusters. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listReplicaSetBackups/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listGroupClusterBackupSnapshotShardedClusters/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedClusters`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4788,36 +4787,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, { Name: `pretty`, Description: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -4868,18 +4837,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServerlessBackupRestoreJobs`, + OperationID: `listGroupClusterBackupSnapshots`, Aliases: nil, - Description: `Returns all restore jobs for one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the listFlexBackupRestoreJobs endpoint instead. + Description: `Returns all snapshots of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserverlessbackuprestorejobs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackupsnapshots. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listServerlessBackupRestoreJobs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listGroupClusterBackupSnapshots/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/restoreJobs`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4949,7 +4915,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the serverless instance.`, + Description: `Human-readable label that identifies the cluster.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -4971,18 +4937,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServerlessBackups`, + OperationID: `listGroupServerlessBackupRestoreJobs`, Aliases: nil, - Description: `Returns all snapshots of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns all restore jobs for one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the listFlexBackups endpoint instead. +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the listFlexBackupRestoreJobs endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserverlessbackups. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserverlessbackuprestorejobs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listServerlessBackups/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listGroupServerlessBackupRestoreJobs/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/snapshots`, + URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/restoreJobs`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -4994,16 +4960,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, { Name: `includeCount`, Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, @@ -5034,6 +4990,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `int`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -5074,15 +5040,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listShardedClusterBackups`, + OperationID: `listGroupServerlessBackupSnapshots`, Aliases: nil, - Description: `Returns all snapshots of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. + Description: `Returns all snapshots of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listshardedclusterbackups. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listShardedClusterBackups/`, +This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the listFlexBackups endpoint instead. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserverlessbackupsnapshots. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-listGroupServerlessBackupSnapshots/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedClusters`, + URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/snapshots`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -5104,6 +5073,36 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -5122,7 +5121,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, + Description: `Human-readable label that identifies the serverless instance.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -5144,16 +5143,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `takeSnapshot`, + OperationID: `takeGroupClusterBackupSnapshots`, Aliases: nil, Description: `Takes one on-demand snapshot for the specified cluster. 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 Service Account or API Key must have the Project Backup Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-takesnapshot. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-takegroupclusterbackupsnapshots. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-takeSnapshot/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-takeGroupClusterBackupSnapshots/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots`, QueryParameters: []shared_api.Parameter{ @@ -5217,12 +5216,11 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getReplicaSetBackup`, + OperationID: `takeGroupClusterBackupSnapshots`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `clusterName`: `input:clusterName`, `groupId`: `input:groupId`, - `snapshotId`: `body:$.id`, }, }, Expect: &shared_api.WatcherExpectProperties{ @@ -5237,90 +5235,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateBackupSchedule`, - Aliases: nil, - Description: `Updates the cloud backup schedule for one cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatebackupschedule. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-updateBackupSchedule/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/schedule`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - { - Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodPatch, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - { - Version: shared_api.NewStableVersion(2024, 8, 5), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `updateDataProtectionSettings`, + OperationID: `updateGroupBackupCompliancePolicy`, Aliases: nil, Description: `Updates the Backup Compliance Policy settings for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatedataprotectionsettings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupbackupcompliancepolicy. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-updateDataProtectionSettings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-updateGroupBackupCompliancePolicy/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/backupCompliancePolicy`, QueryParameters: []shared_api.Parameter{ @@ -5391,7 +5312,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getDataProtectionSettings`, + OperationID: `updateGroupBackupCompliancePolicy`, Version: shared_api.NewStableVersion(2023, 10, 1), Params: map[string]string{ `groupId`: `input:groupId`, @@ -5408,15 +5329,92 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateSnapshotRetention`, + OperationID: `updateGroupClusterBackupSchedule`, Aliases: nil, - Description: `Changes the expiration date for one cloud backup snapshot for one cluster in the specified project. The requesting API Key must have the Project Backup Manager role. + Description: `Updates the cloud backup schedule for one cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatesnapshotretention. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusterbackupschedule. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-updateSnapshotRetention/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-updateGroupClusterBackupSchedule/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/{snapshotId}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/schedule`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `clusterName`, + Description: `Human-readable label that identifies the cluster.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodPatch, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + { + Version: shared_api.NewStableVersion(2024, 8, 5), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `updateGroupClusterBackupSnapshot`, + Aliases: nil, + Description: `Changes the expiration date for one cloud backup snapshot for one cluster in the specified project. The requesting API Key must have the Project Backup Manager role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusterbackupsnapshot. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudBackups-updateGroupClusterBackupSnapshot/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -5488,7 +5486,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getReplicaSetBackup`, + OperationID: `updateGroupClusterBackupSnapshot`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `clusterName`: `input:clusterName`, @@ -5514,15 +5512,24 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Manages the Cloud Migration Service. Source organizations, projects, and MongoDB clusters reside on Cloud Manager or Ops Manager. Destination organizations, projects, and MongoDB clusters reside on MongoDB Cloud. Source databases can't use any authentication except SCRAM-SHA.`, Commands: []shared_api.Command{ { - OperationID: `createLinkToken`, + OperationID: `createGroupLiveMigration`, Aliases: nil, - Description: `Create one link-token that contains all the information required to complete the link. MongoDB Atlas uses the link-token for push live migrations only. Live migration (push) allows you to securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. + Description: `Migrate one cluster that Cloud or Ops Manager manages to MongoDB Atlas. + + +Please make sure to validate your migration before initiating it. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createlinktoken. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-createLinkToken/`, +You can use this API endpoint for push live migrations only. Your API Key must have the Organization Owner role to successfully call this resource. + + +NOTE: Migrating time-series collections is not yet supported on MongoDB 6.0 or higher. Migrations on MongoDB 6.0 or higher will skip any time-series collections on the source cluster. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategrouplivemigration. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-createGroupLiveMigration/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/liveMigrations/linkTokens`, + URL: `/api/atlas/v2/groups/{groupId}/liveMigrations`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -5547,14 +5554,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, }, Verb: http.MethodPost, @@ -5567,27 +5578,25 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c `json`, }, }, + { + Version: shared_api.NewStableVersion(2024, 5, 30), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, }, }, { - OperationID: `createPushMigration`, + OperationID: `createOrgLiveMigrationLinkToken`, Aliases: nil, - Description: `Migrate one cluster that Cloud or Ops Manager manages to MongoDB Atlas. - - -Please make sure to validate your migration before initiating it. - - -You can use this API endpoint for push live migrations only. Your API Key must have the Organization Owner role to successfully call this resource. - - -NOTE: Migrating time-series collections is not yet supported on MongoDB 6.0 or higher. Migrations on MongoDB 6.0 or higher will skip any time-series collections on the source cluster. + Description: `Create one link-token that contains all the information required to complete the link. MongoDB Atlas uses the link-token for push live migrations only. Live migration (push) allows you to securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpushmigration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorglivemigrationlinktoken. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-createPushMigration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-createOrgLiveMigrationLinkToken/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/liveMigrations`, + URL: `/api/atlas/v2/orgs/{orgId}/liveMigrations/linkTokens`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -5612,18 +5621,14 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, Verb: http.MethodPost, @@ -5636,23 +5641,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you `json`, }, }, - { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, }, }, { - OperationID: `cutoverMigration`, + OperationID: `cutoverGroupLiveMigration`, Aliases: nil, Description: `Cut over the migrated cluster to MongoDB Atlas. Confirm when the cut over completes. When the cut over completes, MongoDB Atlas completes the live migration process and stops synchronizing with the source cluster. Your API Key must have the Organization Owner role to successfully call this resource. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cutovermigration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cutovergrouplivemigration. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-cutoverMigration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-cutoverGroupLiveMigration/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/liveMigrations/{liveMigrationId}/cutover`, QueryParameters: []shared_api.Parameter{ @@ -5716,13 +5714,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteLinkToken`, + OperationID: `deleteOrgLiveMigrationLinkTokens`, Aliases: nil, Description: `Remove one organization link and its associated public API key. MongoDB Atlas uses the link-token for push live migrations only. Live migrations (push) let you securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletelinktoken. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorglivemigrationlinktokens. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-deleteLinkToken/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-deleteOrgLiveMigrationLinkTokens/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/liveMigrations/linkTokens`, QueryParameters: []shared_api.Parameter{ @@ -5762,13 +5760,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getPushMigration`, + OperationID: `getGroupLiveMigration`, Aliases: nil, Description: `Return details of one cluster migration job. Each push live migration job uses one migration host. Your API Key must have the Organization Member role to successfully call this resource. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpushmigration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouplivemigration. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-getPushMigration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-getGroupLiveMigration/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/liveMigrations/{liveMigrationId}`, QueryParameters: []shared_api.Parameter{ @@ -5832,13 +5830,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getValidationStatus`, + OperationID: `getGroupLiveMigrationValidateStatus`, Aliases: nil, Description: `Return the status of one migration validation job. Your API Key must have the Organization Owner role to successfully call this resource. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getvalidationstatus. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouplivemigrationvalidatestatus. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-getValidationStatus/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-getGroupLiveMigrationValidateStatus/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/liveMigrations/validate/{validationId}`, QueryParameters: []shared_api.Parameter{ @@ -5892,13 +5890,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSourceProjects`, + OperationID: `listOrgLiveMigrationAvailableProjects`, Aliases: nil, Description: `Return all projects that you can migrate to the specified organization. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsourceprojects. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorglivemigrationavailableprojects. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-listSourceProjects/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-listOrgLiveMigrationAvailableProjects/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/liveMigrations/availableProjects`, QueryParameters: []shared_api.Parameter{ @@ -5948,13 +5946,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `validateMigration`, + OperationID: `validateGroupLiveMigrations`, Aliases: nil, Description: `Verifies whether the provided credentials, available disk space, MongoDB versions, and so on meet the requirements of the migration request. If the check passes, the migration can proceed. Your API Key must have the Organization Owner role to successfully call this resource. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validatemigration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validategrouplivemigrations. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-validateMigration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudMigrationService-validateGroupLiveMigrations/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/liveMigrations/validate`, QueryParameters: []shared_api.Parameter{ @@ -6021,13 +6019,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, authorizes, and removes AWS IAM roles in Atlas.`, Commands: []shared_api.Command{ { - OperationID: `authorizeCloudProviderAccessRole`, + OperationID: `authorizeGroupCloudProviderAccessRole`, Aliases: nil, Description: `Grants access to the specified project for the specified access role. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API endpoint is one step in a procedure to create unified access for MongoDB Cloud services. This is not required for GCP service account access. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-authorizecloudprovideraccessrole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-authorizegroupcloudprovideraccessrole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-authorizeCloudProviderAccessRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-authorizeGroupCloudProviderAccessRole/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/cloudProviderAccess/{roleId}`, QueryParameters: []shared_api.Parameter{ @@ -6091,13 +6089,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createCloudProviderAccessRole`, + OperationID: `createGroupCloudProviderAccess`, Aliases: nil, Description: `Creates one access role for the specified cloud provider. Some MongoDB Cloud features use these cloud provider access roles for authentication. To use this resource, the requesting Service Account or API Key must have the Project Owner role. For the GCP provider, if the project folder is not yet provisioned, Atlas will now create the role asynchronously. An intermediate role with status IN_PROGRESS will be returned, and the final service account will be provisioned. Once the GCP project is set up, subsequent requests will create the service account synchronously. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcloudprovideraccessrole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupcloudprovideraccess. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-createCloudProviderAccessRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-createGroupCloudProviderAccess/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/cloudProviderAccess`, QueryParameters: []shared_api.Parameter{ @@ -6151,13 +6149,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deauthorizeCloudProviderAccessRole`, + OperationID: `deauthorizeGroupCloudProviderAccessRole`, Aliases: nil, Description: `Revokes access to the specified project for the specified access role. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deauthorizecloudprovideraccessrole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deauthorizegroupcloudprovideraccessrole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-deauthorizeCloudProviderAccessRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-deauthorizeGroupCloudProviderAccessRole/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/cloudProviderAccess/{cloudProvider}/{roleId}`, QueryParameters: []shared_api.Parameter{ @@ -6231,13 +6229,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCloudProviderAccessRole`, + OperationID: `getGroupCloudProviderAccess`, Aliases: nil, Description: `Returns the access role with the specified id and with access to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcloudprovideraccessrole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupcloudprovideraccess. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-getCloudProviderAccessRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-getGroupCloudProviderAccess/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/cloudProviderAccess/{roleId}`, QueryParameters: []shared_api.Parameter{ @@ -6301,13 +6299,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listCloudProviderAccessRoles`, + OperationID: `listGroupCloudProviderAccess`, Aliases: nil, Description: `Returns all cloud provider access roles with access to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcloudprovideraccessroles. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcloudprovideraccess. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-listCloudProviderAccessRoles/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-cloudProviderAccess-listGroupCloudProviderAccess/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/cloudProviderAccess`, QueryParameters: []shared_api.Parameter{ @@ -6367,13 +6365,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, starts, or ends a cluster outage simulation.`, Commands: []shared_api.Command{ { - OperationID: `endOutageSimulation`, + OperationID: `endGroupClusterOutageSimulation`, Aliases: nil, Description: `Ends a cluster outage simulation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-endoutagesimulation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-endgroupclusteroutagesimulation. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusterOutageSimulation-endOutageSimulation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusterOutageSimulation-endGroupClusterOutageSimulation/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/outageSimulation`, QueryParameters: []shared_api.Parameter{ @@ -6437,7 +6435,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getOutageSimulation`, + OperationID: `endGroupClusterOutageSimulation`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `clusterName`: `input:clusterName`, @@ -6451,13 +6449,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getOutageSimulation`, + OperationID: `getGroupClusterOutageSimulation`, Aliases: nil, Description: `Returns one outage simulation for one cluster. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getoutagesimulation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusteroutagesimulation. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusterOutageSimulation-getOutageSimulation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusterOutageSimulation-getGroupClusterOutageSimulation/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/outageSimulation`, QueryParameters: []shared_api.Parameter{ @@ -6521,13 +6519,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `startOutageSimulation`, + OperationID: `startGroupClusterOutageSimulation`, Aliases: nil, Description: `Starts a cluster outage simulation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startoutagesimulation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startgroupclusteroutagesimulation. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusterOutageSimulation-startOutageSimulation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusterOutageSimulation-startGroupClusterOutageSimulation/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/outageSimulation`, QueryParameters: []shared_api.Parameter{ @@ -6591,7 +6589,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getOutageSimulation`, + OperationID: `startGroupClusterOutageSimulation`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `clusterName`: `input:clusterName`, @@ -6615,13 +6613,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `autoScalingConfiguration`, + OperationID: `autoGroupClusterScalingConfiguration`, Aliases: nil, Description: `Returns the internal configuration of AutoScaling for sharded clusters. This endpoint can be used for diagnostic purposes to ensure that sharded clusters updated from older APIs have gained support for AutoScaling each shard independently. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-autoscalingconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-autogroupclusterscalingconfiguration. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-autoScalingConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-autoGroupClusterScalingConfiguration/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/autoScalingConfiguration`, QueryParameters: []shared_api.Parameter{ @@ -6685,16 +6683,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createCluster`, + OperationID: `createGroupCluster`, Aliases: nil, Description: `Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. Please note that using an instanceSize of M2 or M5 will create a Flex cluster instead. Support for the instanceSize of M2 or M5 will be discontinued in January 2026. We recommend using the createFlexCluster API for such configurations moving forward. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-createCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-createGroupCluster/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters`, QueryParameters: []shared_api.Parameter{ @@ -6769,11 +6767,10 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getCluster`, + OperationID: `createGroupCluster`, Version: shared_api.NewStableVersion(2024, 8, 5), Params: map[string]string{ - `clusterName`: `body:$.name`, - `groupId`: `body:$.groupId`, + `groupId`: `body:$.groupId`, }, }, Expect: &shared_api.WatcherExpectProperties{ @@ -6787,16 +6784,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteCluster`, + OperationID: `deleteGroupCluster`, Aliases: nil, Description: `Removes one cluster from the specified project. The cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the deleteFlexCluster endpoint for Flex clusters instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletecluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-deleteCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-deleteGroupCluster/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}`, QueryParameters: []shared_api.Parameter{ @@ -6877,8 +6874,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getCluster`, - Version: shared_api.NewStableVersion(2024, 8, 5), + OperationID: `deleteGroupCluster`, + Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `clusterName`: `input:clusterName`, `groupId`: `input:groupId`, @@ -6891,16 +6888,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCluster`, + OperationID: `getGroupCluster`, Aliases: nil, Description: `Returns the details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the getFlexCluster endpoint for Flex clusters instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-getCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-getGroupCluster/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}`, QueryParameters: []shared_api.Parameter{ @@ -6978,13 +6975,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getClusterAdvancedConfiguration`, + OperationID: `getGroupClusterProcessArgs`, Aliases: nil, Description: `Returns the advanced configuration details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. This feature isn't available for M0 free clusters, M2 and M5 shared-tier clusters, flex clusters, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getclusteradvancedconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterprocessargs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-getClusterAdvancedConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-getGroupClusterProcessArgs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/processArgs`, QueryParameters: []shared_api.Parameter{ @@ -7055,13 +7052,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getClusterStatus`, + OperationID: `getGroupClusterStatus`, Aliases: nil, Description: `Returns the status of all changes that you made to the specified cluster in the specified project. Use this resource to check the progress MongoDB Cloud has made in processing your changes. The response does not include the deployment of new dedicated clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getclusterstatus. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterstatus. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-getClusterStatus/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-getGroupClusterStatus/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/status`, QueryParameters: []shared_api.Parameter{ @@ -7125,13 +7122,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getSampleDatasetLoadStatus`, + OperationID: `getGroupSampleDatasetLoad`, Aliases: nil, Description: `Checks the progress of loading the sample dataset into one cluster. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getsampledatasetloadstatus. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupsampledatasetload. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-getSampleDatasetLoadStatus/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-getGroupSampleDatasetLoad/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/sampleDatasetLoad/{sampleDatasetId}`, QueryParameters: []shared_api.Parameter{ @@ -7185,13 +7182,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `grantMongoDbEmployeeAccess`, + OperationID: `grantGroupClusterMongoDbEmployeeAccess`, Aliases: nil, Description: `Grants MongoDB employee cluster access for the given duration and at the specified level for one cluster. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-grantmongodbemployeeaccess. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-grantgroupclustermongodbemployeeaccess. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-grantMongoDbEmployeeAccess/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-grantGroupClusterMongoDbEmployeeAccess/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}:grantMongoDBEmployeeAccess`, QueryParameters: []shared_api.Parameter{ @@ -7255,13 +7252,88 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listCloudProviderRegions`, + OperationID: `listClusterDetails`, + Aliases: nil, + Description: `Returns the details for all clusters in all projects to which you have access. Clusters contain a group of hosts that maintain the same data set. The response does not include multi-cloud clusters. To use this resource, the requesting Service Account or API Key can have any cluster-level role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusterdetails. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-listClusterDetails/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/clusters`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{}, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `listGroupClusterProviderRegions`, Aliases: nil, Description: `Returns the list of regions available for the specified cloud provider at the specified tier. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcloudproviderregions. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterproviderregions. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-listCloudProviderRegions/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-listGroupClusterProviderRegions/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/provider/regions`, QueryParameters: []shared_api.Parameter{ @@ -7365,16 +7437,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClusters`, + OperationID: `listGroupClusters`, Aliases: nil, Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026. Please use the listFlexClusters endpoint for Flex clusters instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusters. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-listClusters/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-listGroupClusters/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters`, QueryParameters: []shared_api.Parameter{ @@ -7482,15 +7554,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClustersForAllProjects`, + OperationID: `pinGroupClusterFeatureCompatibilityVersion`, Aliases: nil, - Description: `Returns the details for all clusters in all projects to which you have access. Clusters contain a group of hosts that maintain the same data set. The response does not include multi-cloud clusters. To use this resource, the requesting Service Account or API Key can have any cluster-level role. + Description: `Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. If an FCV pin already exists for the cluster, calling this method will only update the expiration date of the existing pin and will not repin the FCV. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclustersforallprojects. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pingroupclusterfeaturecompatibilityversion. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-listClustersForAllProjects/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-pinGroupClusterFeatureCompatibilityVersion/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/clusters`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}:pinFeatureCompatibilityVersion`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -7503,8 +7575,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -7512,44 +7584,39 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, + Aliases: []string{`projectId`}, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `clusterName`, + Description: `Human-readable label that identifies this cluster.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, }, - URLParameters: []shared_api.Parameter{}, - Verb: http.MethodGet, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + Version: shared_api.NewStableVersion(2024, 5, 30), + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, @@ -7557,13 +7624,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `loadSampleDataset`, + OperationID: `requestGroupSampleDatasetLoad`, Aliases: nil, Description: `Requests loading the MongoDB sample dataset into the specified cluster. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-loadsampledataset. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-requestgroupsampledatasetload. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-loadSampleDataset/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-requestGroupSampleDatasetLoad/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/sampleDatasetLoad/{name}`, QueryParameters: []shared_api.Parameter{ @@ -7617,11 +7684,11 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getSampleDatasetLoadStatus`, + OperationID: `requestGroupSampleDatasetLoad`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ - `groupId`: `input:groupId`, - `sampleDatasetId`: `body:$.id`, + `groupId`: `input:groupId`, + `name`: `input:name`, }, }, Expect: &shared_api.WatcherExpectProperties{ @@ -7636,15 +7703,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `pinFeatureCompatibilityVersion`, + OperationID: `restartGroupClusterPrimaries`, Aliases: nil, - Description: `Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. If an FCV pin already exists for the cluster, calling this method will only update the expiration date of the existing pin and will not repin the FCV. + Description: `Starts a failover test for the specified cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. A failover test checks how MongoDB Cloud handles the failure of the cluster's primary node. During the test, MongoDB Cloud shuts down the primary node and elects a new primary. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinfeaturecompatibilityversion. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-restartgroupclusterprimaries. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-pinFeatureCompatibilityVersion/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-restartGroupClusterPrimaries/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}:pinFeatureCompatibilityVersion`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restartPrimaries`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -7684,7 +7751,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies this cluster.`, + Description: `Human-readable label that identifies the cluster.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -7697,77 +7764,14 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: `json`, + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, }, - }, - }, - { - OperationID: `revokeMongoDbEmployeeAccess`, - Aliases: nil, - Description: `Revokes a previously granted MongoDB employee cluster access. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokemongodbemployeeaccess. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-revokeMongoDbEmployeeAccess/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}:revokeMongoDBEmployeeAccess`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - { - Name: `clusterName`, - Description: `Human-readable label that identifies this cluster.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodPost, - }, - Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 8, 5), + Version: shared_api.NewStableVersion(2023, 2, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -7776,15 +7780,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `testFailover`, + OperationID: `revokeGroupClusterMongoDbEmployeeAccess`, Aliases: nil, - Description: `Starts a failover test for the specified cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. A failover test checks how MongoDB Cloud handles the failure of the cluster's primary node. During the test, MongoDB Cloud shuts down the primary node and elects a new primary. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. + Description: `Revokes a previously granted MongoDB employee cluster access. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-testfailover. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokegroupclustermongodbemployeeaccess. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-testFailover/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-revokeGroupClusterMongoDbEmployeeAccess/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restartPrimaries`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}:revokeMongoDBEmployeeAccess`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -7824,7 +7828,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, + Description: `Human-readable label that identifies this cluster.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -7837,14 +7841,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - { - Version: shared_api.NewStableVersion(2023, 2, 1), + Version: shared_api.NewStableVersion(2024, 8, 5), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -7853,13 +7850,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `unpinFeatureCompatibilityVersion`, + OperationID: `unpinGroupClusterFeatureCompatibilityVersion`, Aliases: nil, Description: `Unpins the current fixed Feature Compatibility Version (FCV). This feature is not available for clusters on rapid release. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpinfeaturecompatibilityversion. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpingroupclusterfeaturecompatibilityversion. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-unpinFeatureCompatibilityVersion/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-unpinGroupClusterFeatureCompatibilityVersion/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}:unpinFeatureCompatibilityVersion`, QueryParameters: []shared_api.Parameter{ @@ -7923,13 +7920,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateCluster`, + OperationID: `updateGroupCluster`, Aliases: nil, Description: `Updates the details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can update clusters with asymmetrically-sized shards. To update a cluster's termination protection, the requesting Service Account or API Key must have the Project Owner role. For all other updates, the requesting Service Account or API Key must have the Project Cluster Manager role. You can't modify a paused cluster (paused : true). You must call this endpoint to set paused : false. After this endpoint responds with paused : false, you can call it again with the changes you want to make to the cluster. This feature is not available for serverless clusters. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatecluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-updateCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-updateGroupCluster/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}`, QueryParameters: []shared_api.Parameter{ @@ -8014,7 +8011,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getCluster`, + OperationID: `updateGroupCluster`, Version: shared_api.NewStableVersion(2024, 8, 5), Params: map[string]string{ `clusterName`: `input:clusterName`, @@ -8032,13 +8029,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateClusterAdvancedConfiguration`, + OperationID: `updateGroupClusterProcessArgs`, Aliases: nil, Description: `Updates the advanced configuration details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. This feature isn't available for M0 free clusters, M2 and M5 shared-tier clusters, flex clusters, or serverless clusters. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateclusteradvancedconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusterprocessargs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-updateClusterAdvancedConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-updateGroupClusterProcessArgs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/processArgs`, QueryParameters: []shared_api.Parameter{ @@ -8109,16 +8106,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `upgradeSharedCluster`, + OperationID: `upgradeGroupClusterTenantUpgrade`, Aliases: nil, Description: `Upgrades a shared-tier cluster to a Flex or Dedicated (M10+) cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. Each project supports up to 25 clusters. This endpoint can also be used to upgrade Flex clusters that were created using the createCluster API or former M2/M5 clusters that have been migrated to Flex clusters, using instanceSizeName to “M2” or “M5” until January 2026. This functionality will be available until January 2026, after which it will only be available for M0 clusters. Please use the upgradeFlexCluster endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-upgradesharedcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-upgradegroupclustertenantupgrade. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-upgradeSharedCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-upgradeGroupClusterTenantUpgrade/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/tenantUpgrade`, QueryParameters: []shared_api.Parameter{ @@ -8178,15 +8175,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, and edits pinned namespaces for the specified cluster or process. Also returns collection level latency metric data.`, Commands: []shared_api.Command{ { - OperationID: `getCollStatsLatencyNamespaceClusterMeasurements`, + OperationID: `getGroupClusterCollStatNamespaces`, Aliases: nil, - Description: `Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. + Description: `Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespaceclustermeasurements. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustercollstatnamespaces. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceClusterMeasurements/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-getGroupClusterCollStatNamespaces/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/{clusterView}/{databaseName}/{collectionName}/collStats/measurements`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/{clusterView}/collStats/namespaces`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -8198,16 +8195,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `metrics`, - Description: `List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: true, - Type: `string`, - }, - }, { Name: `start`, Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, @@ -8256,7 +8243,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster to retrieve metrics for.`, + Description: `Human-readable label that identifies the cluster to pin namespaces to.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -8274,19 +8261,89 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Type: `string`, }, }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 11, 15), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `getGroupProcessCollStatNamespaces`, + Aliases: nil, + Description: `Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocesscollstatnamespaces. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-getGroupProcessCollStatNamespaces/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/collStats/namespaces`, + QueryParameters: []shared_api.Parameter{ { - Name: `databaseName`, - Description: `Human-readable label that identifies the database.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, - Required: true, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `start`, + Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, + Short: ``, + Required: false, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, { - Name: `collectionName`, - Description: `Human-readable label that identifies the collection.`, + Name: `end`, + Description: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `period`, + Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `processId`, + Description: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -8308,15 +8365,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCollStatsLatencyNamespaceHostMeasurements`, + OperationID: `listGroupClusterCollStatMeasurements`, Aliases: nil, - Description: `Get a list of the Coll Stats Latency process-level measurements for the given namespace. + Description: `Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacehostmeasurements. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustercollstatmeasurements. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceHostMeasurements/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-listGroupClusterCollStatMeasurements/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/{databaseName}/{collectionName}/collStats/measurements`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/{clusterView}/{databaseName}/{collectionName}/collStats/measurements`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -8385,8 +8442,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `processId`, - Description: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Name: `clusterName`, + Description: `Human-readable label that identifies the cluster to retrieve metrics for.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `clusterView`, + Description: `Human-readable label that identifies the cluster topology to retrieve metrics for.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -8428,13 +8495,73 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCollStatsLatencyNamespaceMetrics`, + OperationID: `listGroupClusterCollStatPinnedNamespaces`, + Aliases: nil, + Description: `Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustercollstatpinnednamespaces. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-listGroupClusterCollStatPinnedNamespaces/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/pinned`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `clusterName`, + Description: `Human-readable label that identifies the cluster to retrieve pinned namespaces for.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 11, 15), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `listGroupCollStatMetrics`, Aliases: nil, Description: `Returns all available Coll Stats Latency metric names and their respective units for the specified project at the time of request. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacemetrics. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcollstatmetrics. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespaceMetrics/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-listGroupCollStatMetrics/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/collStats/metrics`, QueryParameters: []shared_api.Parameter{ @@ -8478,15 +8605,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCollStatsLatencyNamespacesForCluster`, + OperationID: `listGroupProcessCollStatMeasurements`, Aliases: nil, - Description: `Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. + Description: `Get a list of the Coll Stats Latency process-level measurements for the given namespace. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacesforcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocesscollstatmeasurements. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-listGroupProcessCollStatMeasurements/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/{clusterView}/collStats/namespaces`, + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/{databaseName}/{collectionName}/collStats/measurements`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -8499,105 +8626,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `start`, - Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `end`, - Description: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `period`, - Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, + Name: `metrics`, + Description: `List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics.`, Short: ``, Required: false, Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - { - Name: `clusterName`, - Description: `Human-readable label that identifies the cluster to pin namespaces to.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, + IsArray: true, Type: `string`, }, }, - { - Name: `clusterView`, - Description: `Human-readable label that identifies the cluster topology to retrieve metrics for.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 11, 15), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `getCollStatsLatencyNamespacesForHost`, - Aliases: nil, - Description: `Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacesforhost. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-getCollStatsLatencyNamespacesForHost/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/collStats/namespaces`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, { Name: `start`, Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, @@ -8654,59 +8691,19 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Type: `string`, }, }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 11, 15), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `getPinnedNamespaces`, - Aliases: nil, - Description: `Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpinnednamespaces. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-getPinnedNamespaces/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/pinned`, - QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `databaseName`, + Description: `Human-readable label that identifies the database.`, Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, { - Name: `clusterName`, - Description: `Human-readable label that identifies the cluster to retrieve pinned namespaces for.`, + Name: `collectionName`, + Description: `Human-readable label that identifies the collection.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -8728,13 +8725,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `pinNamespacesPatch`, + OperationID: `pinGroupClusterCollStatPinnedNamespaces`, Aliases: nil, - Description: `Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. + Description: `Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. This initializes a pinned namespaces list or replaces any existing pinned namespaces list for the Group and Cluster. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinnamespacespatch. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pingroupclustercollstatpinnednamespaces. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-pinNamespacesPatch/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-pinGroupClusterCollStatPinnedNamespaces/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/pinned`, QueryParameters: []shared_api.Parameter{ @@ -8775,7 +8772,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodPatch, + Verb: http.MethodPut, }, Versions: []shared_api.CommandVersion{ { @@ -8789,15 +8786,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `pinNamespacesPut`, + OperationID: `unpinGroupClusterCollStatUnpinNamespaces`, Aliases: nil, - Description: `Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. This initializes a pinned namespaces list or replaces any existing pinned namespaces list for the Group and Cluster. + Description: `Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinnamespacesput. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpingroupclustercollstatunpinnamespaces. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-pinNamespacesPut/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-unpinGroupClusterCollStatUnpinNamespaces/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/pinned`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/unpin`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -8827,7 +8824,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster to pin namespaces to.`, + Description: `Human-readable label that identifies the cluster to unpin namespaces from.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -8836,7 +8833,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodPut, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { @@ -8844,21 +8841,20 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you RequestContentType: `json`, ResponseContentTypes: []string{ `json`, - `json`, }, }, }, }, { - OperationID: `unpinNamespaces`, + OperationID: `updateGroupClusterCollStatPinnedNamespaces`, Aliases: nil, - Description: `Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. + Description: `Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpinnamespaces. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustercollstatpinnednamespaces. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-unpinNamespaces/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-collectionLevelMetrics-updateGroupClusterCollStatPinnedNamespaces/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/unpin`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/pinned`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -8888,7 +8884,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `clusterName`, - Description: `Human-readable label that identifies the cluster to unpin namespaces from.`, + Description: `Human-readable label that identifies the cluster to pin namespaces to.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -8905,6 +8901,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you RequestContentType: `json`, ResponseContentTypes: []string{ `json`, + `json`, }, }, }, @@ -8916,13 +8913,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes custom database user privilege roles. Use custom roles to specify custom sets of actions that the MongoDB Cloud built-in roles can't describe. You define custom roles at the project level, for all clusters in the project. This resource supports a subset of MongoDB privilege actions. You can create a subset of custom role actions. To create a wider list of custom role actions, use the MongoDB Cloud user interface. Custom roles must include actions that all project's clusters support, and that are compatible with each MongoDB version that your project's clusters use. For example, if your project has MongoDB 4.2 clusters, you can't create custom roles that use actions introduced in MongoDB 4.4.`, Commands: []shared_api.Command{ { - OperationID: `createCustomDatabaseRole`, + OperationID: `createGroupCustomDbRoleRole`, Aliases: nil, Description: `Creates one custom role in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcustomdatabaserole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupcustomdbrolerole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-createCustomDatabaseRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-createGroupCustomDbRoleRole/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/customDBRoles/roles`, QueryParameters: []shared_api.Parameter{ @@ -8976,13 +8973,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteCustomDatabaseRole`, + OperationID: `deleteGroupCustomDbRoleRole`, Aliases: nil, Description: `Removes one custom role from the specified project. You can't remove a custom role that would leave one or more child roles with no parent roles or actions. You also can't remove a custom role that would leave one or more database users without roles. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletecustomdatabaserole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupcustomdbrolerole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-deleteCustomDatabaseRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-deleteGroupCustomDbRoleRole/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/customDBRoles/roles/{roleName}`, QueryParameters: []shared_api.Parameter{ @@ -9046,13 +9043,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCustomDatabaseRole`, + OperationID: `getGroupCustomDbRoleRole`, Aliases: nil, Description: `Returns one custom role for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcustomdatabaserole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupcustomdbrolerole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-getCustomDatabaseRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-getGroupCustomDbRoleRole/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/customDBRoles/roles/{roleName}`, QueryParameters: []shared_api.Parameter{ @@ -9116,13 +9113,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listCustomDatabaseRoles`, + OperationID: `listGroupCustomDbRoleRoles`, Aliases: nil, Description: `Returns all custom roles for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcustomdatabaseroles. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcustomdbroleroles. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-listCustomDatabaseRoles/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-listGroupCustomDbRoleRoles/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/customDBRoles/roles`, QueryParameters: []shared_api.Parameter{ @@ -9176,13 +9173,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateCustomDatabaseRole`, + OperationID: `updateGroupCustomDbRoleRole`, Aliases: nil, Description: `Updates one custom role in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatecustomdatabaserole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupcustomdbrolerole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-updateCustomDatabaseRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-customDatabaseRoles-updateGroupCustomDbRoleRole/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/customDBRoles/roles/{roleName}`, QueryParameters: []shared_api.Parameter{ @@ -9252,7 +9249,77 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes Federated Database Instances. This resource requires your project ID. Changes to federated database instance configurations can affect costs.`, Commands: []shared_api.Command{ { - OperationID: `createDataFederationPrivateEndpoint`, + OperationID: `createGroupDataFederation`, + Aliases: nil, + Description: `Creates one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupdatafederation. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-createGroupDataFederation/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/dataFederation`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `skipRoleValidation`, + Description: `Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + }, + Verb: http.MethodPost, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `createGroupPrivateNetworkSettingEndpointId`, Aliases: nil, Description: `Adds one private endpoint for Federated Database Instances and Online Archives to the specified projects. If the endpoint ID already exists and the associated comment is unchanged, Atlas Data Federation makes no change to the endpoint ID list. If the endpoint ID already exists and the associated comment is changed, Atlas Data Federation updates the comment value only in the endpoint ID list. If the endpoint ID doesn't exist, Atlas Data Federation appends the new endpoint to the list of endpoints in the endpoint ID list. Each region has an associated service name for the various endpoints in each region. @@ -9283,9 +9350,9 @@ ap-south-1 is com.amazonaws.vpce.ap-south-1.vpce-svc-03eb8a541f96d356d. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createdatafederationprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupprivatenetworksettingendpointid. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-createDataFederationPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-createGroupPrivateNetworkSettingEndpointId/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds`, QueryParameters: []shared_api.Parameter{ @@ -9339,15 +9406,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createFederatedDatabase`, + OperationID: `deleteGroupDataFederation`, Aliases: nil, - Description: `Creates one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. + Description: `Removes one federated database instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createfederateddatabase. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupdatafederation. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-createFederatedDatabase/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-deleteGroupDataFederation/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/dataFederation`, + URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -9369,16 +9436,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `skipRoleValidation`, - Description: `Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -9395,13 +9452,23 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `tenantName`, + Description: `Human-readable label that identifies the federated database instance to remove.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodPost, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -9409,13 +9476,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createOneDataFederationQueryLimit`, + OperationID: `deleteGroupDataFederationLimit`, Aliases: nil, - Description: `Creates or updates one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Deletes one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createonedatafederationquerylimit. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupdatafederationlimit. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-createOneDataFederationQueryLimit/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-deleteGroupDataFederationLimit/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits/{limitName}`, QueryParameters: []shared_api.Parameter{ @@ -9474,12 +9541,12 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodPatch, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -9487,13 +9554,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteDataFederationPrivateEndpoint`, + OperationID: `deleteGroupPrivateNetworkSettingEndpointId`, Aliases: nil, Description: `Removes one private endpoint for Federated Database Instances and Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletedatafederationprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupprivatenetworksettingendpointid. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-deleteDataFederationPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-deleteGroupPrivateNetworkSettingEndpointId/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds/{endpointId}`, QueryParameters: []shared_api.Parameter{ @@ -9557,29 +9624,89 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteFederatedDatabase`, + OperationID: `downloadGroupDataFederationQueryLogs`, Aliases: nil, - Description: `Removes one federated database instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. + Description: `Downloads the query logs for the specified federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Data Access Read Write roles. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederateddatabase. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupdatafederationquerylogs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-deleteFederatedDatabase/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-downloadGroupDataFederationQueryLogs/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}`, + URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/queryLogs.gz`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `endDate`, + Description: `Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `startDate`, + Description: `Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `tenantName`, + Description: `Human-readable label that identifies the federated database instance for which you want to download query logs.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `gzip`, + }, + }, + }, + }, + { + OperationID: `getGroupDataFederation`, + Aliases: nil, + Description: `Returns the details of one federated database instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdatafederation. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-getGroupDataFederation/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -9605,7 +9732,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `tenantName`, - Description: `Human-readable label that identifies the federated database instance to remove.`, + Description: `Human-readable label that identifies the Federated Database to return.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -9614,7 +9741,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -9627,13 +9754,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteOneDataFederationInstanceQueryLimit`, + OperationID: `getGroupDataFederationLimit`, Aliases: nil, - Description: `Deletes one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Returns the details of one query limit for the specified federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteonedatafederationinstancequerylimit. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdatafederationlimit. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-deleteOneDataFederationInstanceQueryLimit/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-getGroupDataFederationLimit/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits/{limitName}`, QueryParameters: []shared_api.Parameter{ @@ -9647,6 +9774,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -9692,7 +9829,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -9705,34 +9842,34 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `downloadFederatedDatabaseQueryLogs`, + OperationID: `getGroupPrivateNetworkSettingEndpointId`, Aliases: nil, - Description: `Downloads the query logs for the specified federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Data Access Read Write roles. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". + Description: `Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadfederateddatabasequerylogs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivatenetworksettingendpointid. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-downloadFederatedDatabaseQueryLogs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-getGroupPrivateNetworkSettingEndpointId/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/queryLogs.gz`, + URL: `/api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds/{endpointId}`, QueryParameters: []shared_api.Parameter{ { - Name: `endDate`, - Description: `Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { - Name: `startDate`, - Description: `Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, }, @@ -9752,8 +9889,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `tenantName`, - Description: `Human-readable label that identifies the federated database instance for which you want to download query logs.`, + Name: `endpointId`, + Description: `Unique 22-character alphanumeric string that identifies the private endpoint to return. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -9769,21 +9906,21 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ - `gzip`, + `json`, }, }, }, }, { - OperationID: `getDataFederationPrivateEndpoint`, + OperationID: `listGroupDataFederation`, Aliases: nil, - Description: `Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. + Description: `Returns the details of all federated database instances in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or higher role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatafederationprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupdatafederation. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-getDataFederationPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-listGroupDataFederation/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds/{endpointId}`, + URL: `/api/atlas/v2/groups/{groupId}/dataFederation`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -9805,6 +9942,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `type`, + Description: `Type of Federated Database Instances to return.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -9821,16 +9968,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `endpointId`, - Description: `Unique 22-character alphanumeric string that identifies the private endpoint to return. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -9845,15 +9982,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getFederatedDatabase`, + OperationID: `listGroupDataFederationLimits`, Aliases: nil, - Description: `Returns the details of one federated database instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. + Description: `Returns query limits for a federated databases instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederateddatabase. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupdatafederationlimits. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-getFederatedDatabase/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-listGroupDataFederationLimits/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}`, + URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -9865,6 +10002,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -9883,7 +10030,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `tenantName`, - Description: `Human-readable label that identifies the Federated Database to return.`, + Description: `Human-readable label that identifies the federated database instance for which you want to retrieve query limits.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -9905,13 +10052,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDataFederationPrivateEndpoints`, + OperationID: `listGroupPrivateNetworkSettingEndpointIds`, Aliases: nil, Description: `Returns all private endpoints for Federated Database Instances and Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatafederationprivateendpoints. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprivatenetworksettingendpointids. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-listDataFederationPrivateEndpoints/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-listGroupPrivateNetworkSettingEndpointIds/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds`, QueryParameters: []shared_api.Parameter{ @@ -9995,15 +10142,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listFederatedDatabases`, + OperationID: `setGroupDataFederationLimit`, Aliases: nil, - Description: `Returns the details of all federated database instances in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or higher role. + Description: `Creates or updates one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederateddatabases. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setgroupdatafederationlimit. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-listFederatedDatabases/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-setGroupDataFederationLimit/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/dataFederation`, + URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits/{limitName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -10015,49 +10162,57 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, + Aliases: []string{`projectId`}, }, { - Name: `type`, - Description: `Type of Federated Database Instances to return.`, + Name: `tenantName`, + Description: `Human-readable label that identifies the federated database instance to which the query limit applies.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + Name: `limitName`, + Description: `Human-readable label that identifies this data federation instance limit. -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, +| Limit Name | Description | Default | +| --- | --- | --- | +| bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | +| bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | +| bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | +| bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A |`, Short: ``, Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, - Verb: http.MethodGet, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, @@ -10065,15 +10220,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `returnFederatedDatabaseQueryLimit`, + OperationID: `updateGroupDataFederation`, Aliases: nil, - Description: `Returns the details of one query limit for the specified federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Updates the details of one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or higher role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnfederateddatabasequerylimit. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupdatafederation. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-returnFederatedDatabaseQueryLimit/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-updateGroupDataFederation/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits/{limitName}`, + URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -10095,6 +10250,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `skipRoleValidation`, + Description: `Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -10113,7 +10278,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `tenantName`, - Description: `Human-readable label that identifies the federated database instance to which the query limit applies.`, + Description: `Human-readable label that identifies the federated database instance to update.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -10121,47 +10286,35 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Type: `string`, }, }, - { - Name: `limitName`, - Description: `Human-readable label that identifies this data federation instance limit. - - -| Limit Name | Description | Default | -| --- | --- | --- | -| bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | -| bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | -| bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | -| bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A |`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodGet, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, }, }, }, + }, + }, + { + Name: `Database Users`, + Description: `Returns, adds, edits, and removes database users.`, + Commands: []shared_api.Command{ { - OperationID: `returnFederatedDatabaseQueryLimits`, + OperationID: `createGroupDatabaseUser`, Aliases: nil, - Description: `Returns query limits for a federated databases instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Creates one database user in the specified project. This MongoDB Cloud supports a maximum of 100 database users per project. If you require more than 100 database users on a project, contact Support. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnfederateddatabasequerylimits. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupdatabaseuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-returnFederatedDatabaseQueryLimits/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-createGroupDatabaseUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits`, + URL: `/api/atlas/v2/groups/{groupId}/databaseUsers`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -10199,23 +10352,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `tenantName`, - Description: `Human-readable label that identifies the federated database instance for which you want to retrieve query limits.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodGet, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, @@ -10223,161 +10366,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateFederatedDatabase`, + OperationID: `deleteGroupDatabaseUser`, Aliases: nil, - Description: `Updates the details of one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or higher role. + Description: `Removes one database user from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederateddatabase. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupdatabaseuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-dataFederation-updateFederatedDatabase/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-deleteGroupDatabaseUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `skipRoleValidation`, - Description: `Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - { - Name: `tenantName`, - Description: `Human-readable label that identifies the federated database instance to update.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodPatch, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - }, - }, - { - Name: `Database Users`, - Description: `Returns, adds, edits, and removes database users.`, - Commands: []shared_api.Command{ - { - OperationID: `createDatabaseUser`, - Aliases: nil, - Description: `Creates one database user in the specified project. This MongoDB Cloud supports a maximum of 100 database users per project. If you require more than 100 database users on a project, contact Support. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createdatabaseuser. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-createDatabaseUser/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/databaseUsers`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - }, - Verb: http.MethodPost, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `deleteDatabaseUser`, - Aliases: nil, - Description: `Removes one database user from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletedatabaseuser. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-deleteDatabaseUser/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/databaseUsers/{databaseName}/{username}`, + URL: `/api/atlas/v2/groups/{groupId}/databaseUsers/{databaseName}/{username}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -10462,13 +10459,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getDatabaseUser`, + OperationID: `getGroupDatabaseUser`, Aliases: nil, Description: `Returns one database user that belong to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabaseuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupdatabaseuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-getDatabaseUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-getGroupDatabaseUser/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/databaseUsers/{databaseName}/{username}`, QueryParameters: []shared_api.Parameter{ @@ -10555,13 +10552,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDatabaseUsers`, + OperationID: `listGroupDatabaseUsers`, Aliases: nil, Description: `Returns all database users that belong to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabaseusers. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupdatabaseusers. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-listDatabaseUsers/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-listGroupDatabaseUsers/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/databaseUsers`, QueryParameters: []shared_api.Parameter{ @@ -10645,13 +10642,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateDatabaseUser`, + OperationID: `updateGroupDatabaseUser`, Aliases: nil, Description: `Updates one database user that belongs to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatedatabaseuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupdatabaseuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-updateDatabaseUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-databaseUsers-updateGroupDatabaseUser/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/databaseUsers/{databaseName}/{username}`, QueryParameters: []shared_api.Parameter{ @@ -10744,13 +10741,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and edits the Encryption at Rest using Customer Key Management configuration. MongoDB Cloud encrypts all storage whether or not you use your own key management.`, Commands: []shared_api.Command{ { - OperationID: `createEncryptionAtRestPrivateEndpoint`, + OperationID: `createGroupEncryptionAtRestPrivateEndpoint`, Aliases: nil, Description: `Creates a private endpoint in the specified region for encryption at rest using customer key management. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createencryptionatrestprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupencryptionatrestprivateendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-createEncryptionAtRestPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-createGroupEncryptionAtRestPrivateEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/encryptionAtRest/{cloudProvider}/privateEndpoints`, QueryParameters: []shared_api.Parameter{ @@ -10814,16 +10811,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getEncryptionAtRest`, + OperationID: `getGroupEncryptionAtRest`, Aliases: nil, Description: `Returns the configuration for encryption at rest using the keys you manage through your cloud provider. MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. LIMITED TO M10 OR GREATER: MongoDB Cloud limits this feature to dedicated cluster tiers of M10 and greater. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getencryptionatrest. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupencryptionatrest. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRest/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRest/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/encryptionAtRest`, QueryParameters: []shared_api.Parameter{ @@ -10877,13 +10874,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getEncryptionAtRestPrivateEndpoint`, + OperationID: `getGroupEncryptionAtRestPrivateEndpoint`, Aliases: nil, Description: `Returns one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getencryptionatrestprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupencryptionatrestprivateendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getGroupEncryptionAtRestPrivateEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/encryptionAtRest/{cloudProvider}/privateEndpoints/{endpointId}`, QueryParameters: []shared_api.Parameter{ @@ -10957,13 +10954,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getEncryptionAtRestPrivateEndpointsForCloudProvider`, + OperationID: `listGroupEncryptionAtRestPrivateEndpoints`, Aliases: nil, Description: `Returns the private endpoints of the specified cloud provider for encryption at rest using customer key management. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getencryptionatrestprivateendpointsforcloudprovider. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupencryptionatrestprivateendpoints. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-getEncryptionAtRestPrivateEndpointsForCloudProvider/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-listGroupEncryptionAtRestPrivateEndpoints/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/encryptionAtRest/{cloudProvider}/privateEndpoints`, QueryParameters: []shared_api.Parameter{ @@ -11057,13 +11054,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `requestEncryptionAtRestPrivateEndpointDeletion`, + OperationID: `requestGroupEncryptionAtRestPrivateEndpointDeletion`, Aliases: nil, Description: `Deletes one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-requestencryptionatrestprivateendpointdeletion. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-requestgroupencryptionatrestprivateendpointdeletion. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestEncryptionAtRestPrivateEndpointDeletion/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-requestGroupEncryptionAtRestPrivateEndpointDeletion/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/encryptionAtRest/{cloudProvider}/privateEndpoints/{endpointId}`, QueryParameters: []shared_api.Parameter{ @@ -11137,16 +11134,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateEncryptionAtRest`, + OperationID: `updateGroupEncryptionAtRest`, Aliases: nil, Description: `Updates the configuration for encryption at rest using the keys you manage through your cloud provider. MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. This feature isn't available for M0 free clusters, M2, M5, or serverless clusters. After you configure at least one Encryption at Rest using a Customer Key Management provider for the MongoDB Cloud project, Project Owners can enable Encryption at Rest using Customer Key Management for each MongoDB Cloud cluster for which they require encryption. The Encryption at Rest using Customer Key Management provider doesn't have to match the cluster cloud service provider. MongoDB Cloud doesn't automatically rotate user-managed encryption keys. Defer to your preferred Encryption at Rest using Customer Key Management provider's documentation and guidance for best practices on key rotation. MongoDB Cloud automatically creates a 90-day key rotation alert when you configure Encryption at Rest using Customer Key Management using your Key Management in an MongoDB Cloud project. MongoDB Cloud encrypts all storage whether or not you use your own key management. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateencryptionatrest. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupencryptionatrest. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateEncryptionAtRest/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-encryptionAtRestUsingCustomerKeyManagement-updateGroupEncryptionAtRest/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/encryptionAtRest`, QueryParameters: []shared_api.Parameter{ @@ -11206,18 +11203,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns events. This collection remains under revision and may change.`, Commands: []shared_api.Command{ { - OperationID: `getOrganizationEvent`, + OperationID: `getGroupEvent`, Aliases: nil, - Description: `Returns one event for the specified organization. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. Use the Return Events from One Organization endpoint to retrieve all events to which the authenticated user has access. + Description: `Returns one event for the specified project. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return Events from One Project endpoint to retrieve all events to which the authenticated user has access. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationevent. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupevent. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-events-getOrganizationEvent/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-events-getGroupEvent/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/events/{eventId}`, + URL: `/api/atlas/v2/groups/{groupId}/events/{eventId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -11252,14 +11249,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, { Name: `eventId`, @@ -11285,18 +11286,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectEvent`, + OperationID: `getOrgEvent`, Aliases: nil, - Description: `Returns one event for the specified project. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return Events from One Project endpoint to retrieve all events to which the authenticated user has access. + Description: `Returns one event for the specified organization. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. Use the Return Events from One Organization endpoint to retrieve all events to which the authenticated user has access. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectevent. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgevent. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-events-getProjectEvent/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-events-getOrgEvent/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/events/{eventId}`, + URL: `/api/atlas/v2/orgs/{orgId}/events/{eventId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -11331,18 +11332,14 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, { Name: `eventId`, @@ -11443,18 +11440,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationEvents`, + OperationID: `listGroupEvents`, Aliases: nil, - Description: `Returns events for the specified organization. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + Description: `Returns events for the specified project. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationevents. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupevents. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-events-listOrganizationEvents/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-events-listGroupEvents/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/events`, + URL: `/api/atlas/v2/groups/{groupId}/events`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -11506,6 +11503,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `clusterNames`, + Description: `Human-readable label that identifies the cluster.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: true, + Type: `string`, + }, + }, { Name: `eventType`, Description: `Category of incident recorded at this moment in time. @@ -11519,6 +11526,19 @@ IMPORTANT: The complete list of event type values changes frequently.`, Type: `string`, }, }, + { + Name: `excludedEventType`, + Description: `Category of event that you would like to exclude from query results, such as CLUSTER_CREATED + + +IMPORTANT: Event type names change frequently. Verify that you specify the event type correctly by checking the complete list of event types.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: true, + Type: `string`, + }, + }, { Name: `includeRaw`, Description: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, @@ -11552,14 +11572,18 @@ IMPORTANT: The complete list of event type values changes frequently.`, }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, }, Verb: http.MethodGet, @@ -11575,18 +11599,18 @@ IMPORTANT: The complete list of event type values changes frequently.`, }, }, { - OperationID: `listProjectEvents`, + OperationID: `listOrgEvents`, Aliases: nil, - Description: `Returns events for the specified project. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns events for the specified organization. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This resource remains under revision and may change. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectevents. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgevents. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-events-listProjectEvents/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-events-listOrgEvents/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/events`, + URL: `/api/atlas/v2/orgs/{orgId}/events`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -11638,16 +11662,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `clusterNames`, - Description: `Human-readable label that identifies the cluster.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: true, - Type: `string`, - }, - }, { Name: `eventType`, Description: `Category of incident recorded at this moment in time. @@ -11661,19 +11675,6 @@ IMPORTANT: The complete list of event type values changes frequently.`, Type: `string`, }, }, - { - Name: `excludedEventType`, - Description: `Category of event that you would like to exclude from query results, such as CLUSTER_CREATED - - -IMPORTANT: Event type names change frequently. Verify that you specify the event type correctly by checking the complete list of event types.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: true, - Type: `string`, - }, - }, { Name: `includeRaw`, Description: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, @@ -11707,18 +11708,14 @@ IMPORTANT: Event type names change frequently. Verify that you specify the event }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, Verb: http.MethodGet, @@ -11740,18 +11737,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes federation-related features such as role mappings and connected organization configurations.`, Commands: []shared_api.Command{ { - OperationID: `createIdentityProvider`, + OperationID: `createFederationSettingConnectedOrgConfigRoleMapping`, Aliases: nil, - Description: `Creates one identity provider within the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - - -Note: This resource only supports the creation of OIDC identity providers. + Description: `Adds one role mapping to the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createidentityprovider. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createfederationsettingconnectedorgconfigrolemapping. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-createIdentityProvider/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-createFederationSettingConnectedOrgConfigRoleMapping/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -11775,12 +11769,22 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, + { + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 11, 15), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, @@ -11789,15 +11793,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createRoleMapping`, + OperationID: `createFederationSettingIdentityProvider`, Aliases: nil, - Description: `Adds one role mapping to the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Creates one identity provider within the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + + +Note: This resource only supports the creation of OIDC identity providers. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createrolemapping. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createfederationsettingidentityprovider. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-createRoleMapping/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-createFederationSettingIdentityProvider/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -11821,22 +11828,12 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, - { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), + Version: shared_api.NewStableVersion(2023, 11, 15), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, @@ -11845,13 +11842,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteFederationApp`, + OperationID: `deleteFederationSetting`, Aliases: nil, Description: `Deletes the federation settings instance and all associated data, including identity providers and domains. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the last remaining connected organization. Note: requests to this resource will fail if there is more than one connected organization in the federation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationapp. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationsetting. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-deleteFederationApp/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-deleteFederationSetting/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/federationSettings/{federationSettingsId}`, QueryParameters: []shared_api.Parameter{}, @@ -11880,18 +11877,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteIdentityProvider`, + OperationID: `deleteFederationSettingConnectedOrgConfigRoleMapping`, Aliases: nil, - Description: `Deletes one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - - -Note: Requests to this resource will fail if the identity provider has any connected organizations. Before deleting an identity provider, disconnect all organizations and confirm that no organization in your account uses this identity provider. + Description: `Removes one role mapping in the specified organization from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteidentityprovider. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationsettingconnectedorgconfigrolemapping. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-deleteIdentityProvider/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-deleteFederationSettingConnectedOrgConfigRoleMapping/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings/{id}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -11916,8 +11910,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `identityProviderId`, - Description: `Unique 24-hexadecimal digit string that identifies the identity provider to connect.`, + Name: `id`, + Description: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to remove.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -11930,7 +11934,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 11, 15), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -11939,15 +11943,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteRoleMapping`, + OperationID: `deleteFederationSettingIdentityProvider`, Aliases: nil, - Description: `Removes one role mapping in the specified organization from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Deletes one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleterolemapping. +Note: Requests to this resource will fail if the identity provider has any connected organizations. Before deleting an identity provider, disconnect all organizations and confirm that no organization in your account uses this identity provider. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationsettingidentityprovider. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-deleteRoleMapping/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-deleteFederationSettingIdentityProvider/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings/{id}`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -11972,18 +11979,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `id`, - Description: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to remove.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Name: `identityProviderId`, + Description: `Unique 24-hexadecimal digit string that identifies the identity provider to connect.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -11996,7 +11993,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), + Version: shared_api.NewStableVersion(2023, 11, 15), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -12005,13 +12002,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getConnectedOrgConfig`, + OperationID: `getFederationSettingConnectedOrgConfig`, Aliases: nil, Description: `Returns the specified connected org config from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getconnectedorgconfig. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettingconnectedorgconfig. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getConnectedOrgConfig/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfig/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}`, QueryParameters: []shared_api.Parameter{ @@ -12061,15 +12058,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getFederationSettings`, + OperationID: `getFederationSettingConnectedOrgConfigRoleMapping`, Aliases: nil, - Description: `Returns information about the federation settings for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. + Description: `Returns one role mapping from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettingconnectedorgconfigrolemapping. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getFederationSettings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getFederationSettingConnectedOrgConfigRoleMapping/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/federationSettings`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings/{id}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -12081,18 +12078,28 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `federationSettingsId`, + Description: `Unique 24-hexadecimal digit string that identifies your federation.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, + }, + }, + { + Name: `id`, + Description: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to return.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { Name: `orgId`, Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, @@ -12117,13 +12124,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getIdentityProvider`, + OperationID: `getFederationSettingIdentityProvider`, Aliases: nil, Description: `Returns one identity provider in the specified federation by the identity provider's id. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getidentityprovider. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettingidentityprovider. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getIdentityProvider/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getFederationSettingIdentityProvider/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}`, QueryParameters: []shared_api.Parameter{ @@ -12173,13 +12180,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getIdentityProviderMetadata`, + OperationID: `getFederationSettingIdentityProviderMetadata`, Aliases: nil, Description: `Returns the metadata of one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getidentityprovidermetadata. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettingidentityprovidermetadata. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getIdentityProviderMetadata/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getFederationSettingIdentityProviderMetadata/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}/metadata.xml`, QueryParameters: []shared_api.Parameter{}, @@ -12218,15 +12225,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getRoleMapping`, + OperationID: `getOrgFederationSettings`, Aliases: nil, - Description: `Returns one role mapping from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Returns information about the federation settings for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getrolemapping. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgfederationsettings. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getRoleMapping/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-getOrgFederationSettings/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings/{id}`, + URL: `/api/atlas/v2/orgs/{orgId}/federationSettings`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -12238,28 +12245,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `federationSettingsId`, - Description: `Unique 24-hexadecimal digit string that identifies your federation.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, { - Name: `id`, - Description: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to return.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { Name: `orgId`, Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, @@ -12284,15 +12281,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listConnectedOrgConfigs`, + OperationID: `listFederationSettingConnectedOrgConfigRoleMappings`, Aliases: nil, - Description: `Returns all connected org configs in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected orgs. + Description: `Returns all role mappings from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listconnectedorgconfigs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederationsettingconnectedorgconfigrolemappings. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-listConnectedOrgConfigs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigRoleMappings/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -12304,31 +12301,21 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `federationSettingsId`, + Description: `Unique 24-hexadecimal digit string that identifies your federation.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `federationSettingsId`, - Description: `Unique 24-hexadecimal digit string that identifies your federation.`, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -12350,15 +12337,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listIdentityProviders`, + OperationID: `listFederationSettingConnectedOrgConfigs`, Aliases: nil, - Description: `Returns all identity providers with the provided protocol and type in the specified federation. If no protocol is specified, only SAML identity providers will be returned. If no idpType is specified, only WORKFORCE identity providers will be returned. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + Description: `Returns all connected org configs in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected orgs. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listidentityproviders. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederationsettingconnectedorgconfigs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-listIdentityProviders/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-listFederationSettingConnectedOrgConfigs/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -12390,26 +12377,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `int`, }, }, - { - Name: `protocol`, - Description: `The protocols of the target identity providers.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: true, - Type: `string`, - }, - }, - { - Name: `idpType`, - Description: `The types of the target identity providers.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: true, - Type: `string`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -12436,15 +12403,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listRoleMappings`, + OperationID: `listFederationSettingIdentityProviders`, Aliases: nil, - Description: `Returns all role mappings from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Returns all identity providers with the provided protocol and type in the specified federation. If no protocol is specified, only SAML identity providers will be returned. If no idpType is specified, only WORKFORCE identity providers will be returned. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listrolemappings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederationsettingidentityproviders. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-listRoleMappings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-listFederationSettingIdentityProviders/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -12456,77 +12423,51 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `federationSettingsId`, - Description: `Unique 24-hexadecimal digit string that identifies your federation.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, }, { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `removeConnectedOrgConfig`, - Aliases: nil, - Description: `Removes one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This request fails if only one connected organization exists in the federation. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeconnectedorgconfig. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-removeConnectedOrgConfig/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}`, - QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `protocol`, + Description: `The protocols of the target identity providers.`, Short: ``, Required: false, Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, + IsArray: true, + Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `federationSettingsId`, - Description: `Unique 24-hexadecimal digit string that identifies your federation.`, + Name: `idpType`, + Description: `The types of the target identity providers.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ - IsArray: false, + IsArray: true, Type: `string`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the connected organization configuration to remove.`, + Name: `federationSettingsId`, + Description: `Unique 24-hexadecimal digit string that identifies your federation.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -12535,7 +12476,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -12548,18 +12489,74 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `revokeJwksFromIdentityProvider`, + OperationID: `removeFederationSettingConnectedOrgConfig`, Aliases: nil, - Description: `Revokes the JWKS tokens from the requested OIDC identity provider. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - - -Note: Revoking your JWKS tokens immediately refreshes your IdP public keys from all your Atlas clusters, invalidating previously signed access tokens and logging out all users. You may need to restart your MongoDB clients. All organizations connected to the identity provider will be affected. + Description: `Removes one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This request fails if only one connected organization exists in the federation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokejwksfromidentityprovider. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removefederationsettingconnectedorgconfig. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-revokeJwksFromIdentityProvider/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-removeFederationSettingConnectedOrgConfig/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}/jwks`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `federationSettingsId`, + Description: `Unique 24-hexadecimal digit string that identifies your federation.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the connected organization configuration to remove.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodDelete, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `revokeFederationSettingIdentityProviderJwks`, + Aliases: nil, + Description: `Revokes the JWKS tokens from the requested OIDC identity provider. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + + +Note: Revoking your JWKS tokens immediately refreshes your IdP public keys from all your Atlas clusters, invalidating previously signed access tokens and logging out all users. You may need to restart your MongoDB clients. All organizations connected to the identity provider will be affected. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokefederationsettingidentityproviderjwks. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-revokeFederationSettingIdentityProviderJwks/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}/jwks`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -12607,7 +12604,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateConnectedOrgConfig`, + OperationID: `updateFederationSettingConnectedOrgConfig`, Aliases: nil, Description: `Updates one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -12623,9 +12620,9 @@ Note: If the identityProviderId field is not provided, you will disconnect the o Note: Currently connected data access identity providers missing from the dataAccessIdentityProviderIds field will be disconnected. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateconnectedorgconfig. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederationsettingconnectedorgconfig. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-updateConnectedOrgConfig/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfig/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}`, QueryParameters: []shared_api.Parameter{ @@ -12675,18 +12672,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateIdentityProvider`, + OperationID: `updateFederationSettingConnectedOrgConfigRoleMapping`, Aliases: nil, - Description: `Updates one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - - -Note: Changing authorization types and/or updating authorization claims can prevent current users and/or groups from accessing the database. + Description: `Updates one role mapping in the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateidentityprovider. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederationsettingconnectedorgconfigrolemapping. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-updateIdentityProvider/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-updateFederationSettingConnectedOrgConfigRoleMapping/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings/{id}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -12711,8 +12705,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `identityProviderId`, - Description: `Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id.`, + Name: `id`, + Description: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to update.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -12721,11 +12725,11 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - Verb: http.MethodPatch, + Verb: http.MethodPut, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 11, 15), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, @@ -12734,15 +12738,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateRoleMapping`, + OperationID: `updateFederationSettingIdentityProvider`, Aliases: nil, - Description: `Updates one role mapping in the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Updates one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. + + +Note: Changing authorization types and/or updating authorization claims can prevent current users and/or groups from accessing the database. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updaterolemapping. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederationsettingidentityprovider. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-updateRoleMapping/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-federatedAuthentication-updateFederationSettingIdentityProvider/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings/{id}`, + URL: `/api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -12767,18 +12774,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `id`, - Description: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to update.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Name: `identityProviderId`, + Description: `Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -12787,11 +12784,11 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - Verb: http.MethodPut, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), + Version: shared_api.NewStableVersion(2023, 11, 15), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, @@ -12806,13 +12803,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns, adds, edits, and removes flex clusters.`, Commands: []shared_api.Command{ { - OperationID: `createFlexCluster`, + OperationID: `createGroupFlexCluster`, Aliases: nil, Description: `Creates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createflexcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupflexcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-createFlexCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-createGroupFlexCluster/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters`, QueryParameters: []shared_api.Parameter{ @@ -12866,11 +12863,10 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getFlexCluster`, + OperationID: `createGroupFlexCluster`, Version: shared_api.NewStableVersion(2024, 11, 13), Params: map[string]string{ `groupId`: `input:groupId`, - `name`: `body:$.name`, }, }, Expect: &shared_api.WatcherExpectProperties{ @@ -12885,13 +12881,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteFlexCluster`, + OperationID: `deleteGroupFlexCluster`, Aliases: nil, Description: `Removes one flex cluster from the specified project. The flex cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteflexcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupflexcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-deleteFlexCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-deleteGroupFlexCluster/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}`, QueryParameters: []shared_api.Parameter{ @@ -12955,7 +12951,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getFlexCluster`, + OperationID: `deleteGroupFlexCluster`, Version: shared_api.NewStableVersion(2024, 11, 13), Params: map[string]string{ `groupId`: `input:groupId`, @@ -12969,13 +12965,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getFlexCluster`, + OperationID: `getGroupFlexCluster`, Aliases: nil, Description: `Returns details for one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupflexcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-getFlexCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-getGroupFlexCluster/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}`, QueryParameters: []shared_api.Parameter{ @@ -13039,13 +13035,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listFlexClusters`, + OperationID: `listGroupFlexClusters`, Aliases: nil, Description: `Returns details for all flex clusters in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexclusters. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupflexclusters. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-listFlexClusters/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-listGroupFlexClusters/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters`, QueryParameters: []shared_api.Parameter{ @@ -13129,15 +13125,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateFlexCluster`, + OperationID: `tenantGroupFlexClusterUpgrade`, Aliases: nil, - Description: `Updates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateflexcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-tenantgroupflexclusterupgrade. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-updateFlexCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-tenantGroupFlexClusterUpgrade/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}`, + URL: `/api/atlas/v2/groups/{groupId}/flexClusters:tenantUpgrade`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -13175,18 +13171,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `name`, - Description: `Human-readable label that identifies the flex cluster.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodPatch, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { @@ -13197,35 +13183,17 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Watcher: &shared_api.WatcherProperties{ - Get: shared_api.WatcherGetProperties{ - OperationID: `getFlexCluster`, - Version: shared_api.NewStableVersion(2024, 11, 13), - Params: map[string]string{ - `groupId`: `input:groupId`, - `name`: `input:name`, - }, - }, - Expect: &shared_api.WatcherExpectProperties{ - Match: &shared_api.WatcherMatchProperties{ - Path: `$.stateName`, - Values: []string{ - `IDLE`, - }, - }, - }, - }, }, { - OperationID: `upgradeFlexCluster`, + OperationID: `updateGroupFlexCluster`, Aliases: nil, - Description: `Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. + Description: `Updates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-upgradeflexcluster. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupflexcluster. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-upgradeFlexCluster/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexClusters-updateGroupFlexCluster/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/flexClusters:tenantUpgrade`, + URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -13263,8 +13231,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `name`, + Description: `Human-readable label that identifies the flex cluster.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodPost, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { @@ -13275,6 +13253,24 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, + Watcher: &shared_api.WatcherProperties{ + Get: shared_api.WatcherGetProperties{ + OperationID: `updateGroupFlexCluster`, + Version: shared_api.NewStableVersion(2024, 11, 13), + Params: map[string]string{ + `groupId`: `input:groupId`, + `name`: `input:name`, + }, + }, + Expect: &shared_api.WatcherExpectProperties{ + Match: &shared_api.WatcherMatchProperties{ + Path: `$.stateName`, + Values: []string{ + `IDLE`, + }, + }, + }, + }, }, }, }, @@ -13283,13 +13279,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and adds restore jobs for flex database deployments.`, Commands: []shared_api.Command{ { - OperationID: `createFlexBackupRestoreJob`, + OperationID: `createGroupFlexClusterBackupRestoreJob`, Aliases: nil, Description: `Restores one snapshot of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createflexbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupflexclusterbackuprestorejob. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexRestoreJobs-createFlexBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexRestoreJobs-createGroupFlexClusterBackupRestoreJob/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/restoreJobs`, QueryParameters: []shared_api.Parameter{ @@ -13353,12 +13349,11 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getFlexBackupRestoreJob`, + OperationID: `createGroupFlexClusterBackupRestoreJob`, Version: shared_api.NewStableVersion(2024, 11, 13), Params: map[string]string{ - `groupId`: `input:groupId`, - `name`: `input:name`, - `restoreJobId`: `body:$.id`, + `groupId`: `input:groupId`, + `name`: `input:name`, }, }, Expect: &shared_api.WatcherExpectProperties{ @@ -13373,13 +13368,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getFlexBackupRestoreJob`, + OperationID: `getGroupFlexClusterBackupRestoreJob`, Aliases: nil, Description: `Returns one restore job for one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupflexclusterbackuprestorejob. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexRestoreJobs-getFlexBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexRestoreJobs-getGroupFlexClusterBackupRestoreJob/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/restoreJobs/{restoreJobId}`, QueryParameters: []shared_api.Parameter{ @@ -13453,13 +13448,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listFlexBackupRestoreJobs`, + OperationID: `listGroupFlexClusterBackupRestoreJobs`, Aliases: nil, Description: `Returns all restore jobs for one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexbackuprestorejobs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupflexclusterbackuprestorejobs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexRestoreJobs-listFlexBackupRestoreJobs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexRestoreJobs-listGroupFlexClusterBackupRestoreJobs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/restoreJobs`, QueryParameters: []shared_api.Parameter{ @@ -13559,13 +13554,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and requests to download flex database deployment snapshots.`, Commands: []shared_api.Command{ { - OperationID: `downloadFlexBackup`, + OperationID: `downloadGroupFlexClusterBackup`, Aliases: nil, Description: `Requests one snapshot for the specified flex cluster. This resource returns a snapshotURL that you can use to download the snapshot. This snapshotURL remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadflexbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupflexclusterbackup. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexSnapshots-downloadFlexBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexSnapshots-downloadGroupFlexClusterBackup/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/download`, QueryParameters: []shared_api.Parameter{ @@ -13629,13 +13624,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getFlexBackup`, + OperationID: `getGroupFlexClusterBackupSnapshot`, Aliases: nil, Description: `Returns one snapshot of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupflexclusterbackupsnapshot. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexSnapshots-getFlexBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexSnapshots-getGroupFlexClusterBackupSnapshot/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ @@ -13699,13 +13694,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listFlexBackups`, + OperationID: `listGroupFlexClusterBackupSnapshots`, Aliases: nil, Description: `Returns all snapshots of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexbackups. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupflexclusterbackupsnapshots. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexSnapshots-listFlexBackups/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-flexSnapshots-listGroupFlexClusterBackupSnapshots/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/snapshots`, QueryParameters: []shared_api.Parameter{ @@ -13806,13 +13801,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you MongoDB Cloud shards the empty collection using the required location field and a custom shard key. For example, if your custom shard key is city, the compound shard key is location, city. Each Global Cluster is also associated with one or more Global Writes Zones. When a user creates a Global Cluster, MongoDB Cloud automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. For example, a use case might require mapping a location code to a geographically distant zone. Administrators can manage custom zone mappings with the APIs below and the Global Cluster Configuration pane when you create or modify your Global Cluster.`, Commands: []shared_api.Command{ { - OperationID: `createCustomZoneMapping`, + OperationID: `createGroupClusterGlobalWriteCustomZoneMapping`, Aliases: nil, Description: `Creates one custom zone mapping for the specified global cluster. A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcustomzonemapping. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterglobalwritecustomzonemapping. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-createCustomZoneMapping/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-createGroupClusterGlobalWriteCustomZoneMapping/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites/customZoneMapping`, QueryParameters: []shared_api.Parameter{ @@ -13890,13 +13885,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createManagedNamespace`, + OperationID: `createGroupClusterGlobalWriteManagedNamespace`, Aliases: nil, Description: `Creates one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createmanagednamespace. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterglobalwritemanagednamespace. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-createManagedNamespace/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-createGroupClusterGlobalWriteManagedNamespace/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites/managedNamespaces`, QueryParameters: []shared_api.Parameter{ @@ -13974,13 +13969,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAllCustomZoneMappings`, + OperationID: `deleteGroupClusterGlobalWriteCustomZoneMapping`, Aliases: nil, Description: `Removes all custom zone mappings for the specified global cluster. A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. Removing the custom zone mappings restores the default mapping. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteallcustomzonemappings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterglobalwritecustomzonemapping. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-deleteAllCustomZoneMappings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-deleteGroupClusterGlobalWriteCustomZoneMapping/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites/customZoneMapping`, QueryParameters: []shared_api.Parameter{ @@ -14058,13 +14053,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteManagedNamespace`, + OperationID: `deleteGroupClusterGlobalWriteManagedNamespaces`, Aliases: nil, Description: `Removes one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. Deleting a managed namespace does not remove the associated collection or data. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletemanagednamespace. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusterglobalwritemanagednamespaces. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-deleteManagedNamespace/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-deleteGroupClusterGlobalWriteManagedNamespaces/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites/managedNamespaces`, QueryParameters: []shared_api.Parameter{ @@ -14162,13 +14157,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getManagedNamespace`, + OperationID: `getGroupClusterGlobalWrites`, Aliases: nil, Description: `Returns one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmanagednamespace. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterglobalwrites. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-getManagedNamespace/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-globalClusters-getGroupClusterGlobalWrites/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites`, QueryParameters: []shared_api.Parameter{ @@ -14252,13 +14247,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns invoices.`, Commands: []shared_api.Command{ { - OperationID: `createCostExplorerQueryProcess`, + OperationID: `createOrgBillingCostExplorerUsageProcess`, Aliases: nil, Description: `Creates a query process within the Cost Explorer for the given parameters. A token is returned that can be used to poll the status of the query and eventually retrieve the results. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcostexplorerqueryprocess. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgbillingcostexplorerusageprocess. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-createCostExplorerQueryProcess/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-createOrgBillingCostExplorerUsageProcess/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/billing/costExplorer/usage`, QueryParameters: []shared_api.Parameter{ @@ -14298,16 +14293,73 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `downloadInvoiceCsv`, + OperationID: `getOrgBillingCostExplorerUsage`, Aliases: nil, - Description: `Returns one invoice that MongoDB issued to the specified organization in CSV format. A unique 24-hexadecimal digit string identifies the invoice. To use this resource, the requesting Service Account or API Key have at least the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner Role. + Description: `Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. If the data is not ready, a 'processing' response willindicate that another request should be sent later to view the data. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgbillingcostexplorerusage. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-getOrgBillingCostExplorerUsage/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/orgs/{orgId}/billing/costExplorer/usage/{token}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `token`, + Description: `Unique 64 digit string that identifies the Cost Explorer query.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `csv`, + `json`, + }, + }, + }, + }, + { + OperationID: `getOrgInvoice`, + Aliases: nil, + Description: `Returns one invoice that MongoDB issued to the specified organization. A unique 24-hexadecimal digit string identifies the invoice. You can choose to receive this invoice in JSON or CSV format. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner role. To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadinvoicecsv. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorginvoice. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-downloadInvoiceCsv/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-getOrgInvoice/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/csv`, + URL: `/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -14360,20 +14412,22 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c RequestContentType: ``, ResponseContentTypes: []string{ `csv`, + `json`, }, }, }, }, { - OperationID: `getCostExplorerQueryProcess`, + OperationID: `getOrgInvoiceCsv`, Aliases: nil, - Description: `Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. If the data is not ready, a 'processing' response willindicate that another request should be sent later to view the data. + Description: `Returns one invoice that MongoDB issued to the specified organization in CSV format. A unique 24-hexadecimal digit string identifies the invoice. To use this resource, the requesting Service Account or API Key have at least the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner Role. +To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcostexplorerqueryprocess. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorginvoicecsv. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-getCostExplorerQueryProcess/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-getOrgInvoiceCsv/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/billing/costExplorer/usage/{token}`, + URL: `/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/csv`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -14385,6 +14439,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -14398,8 +14462,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `token`, - Description: `Unique 64 digit string that identifies the Cost Explorer query.`, + Name: `invoiceId`, + Description: `Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -14416,22 +14480,20 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c RequestContentType: ``, ResponseContentTypes: []string{ `csv`, - `json`, }, }, }, }, { - OperationID: `getInvoice`, + OperationID: `listOrgInvoicePending`, Aliases: nil, - Description: `Returns one invoice that MongoDB issued to the specified organization. A unique 24-hexadecimal digit string identifies the invoice. You can choose to receive this invoice in JSON or CSV format. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner role. -To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. + Description: `Returns all invoices accruing charges for the current billing cycle for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner Role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getinvoice. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorginvoicepending. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-getInvoice/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-listOrgInvoicePending/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}`, + URL: `/api/atlas/v2/orgs/{orgId}/invoices/pending`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -14465,16 +14527,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, - { - Name: `invoiceId`, - Description: `Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -14483,21 +14535,20 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ - `csv`, `json`, }, }, }, }, { - OperationID: `listInvoices`, + OperationID: `listOrgInvoices`, Aliases: nil, Description: `Returns all invoices that MongoDB issued to the specified organization. This list includes all invoices regardless of invoice status. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner role. To compute the total owed amount of the invoices - sum up total owed of each invoice. It could be computed as a sum of owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listinvoices. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorginvoices. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-listInvoices/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-listOrgInvoices/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/invoices`, QueryParameters: []shared_api.Parameter{ @@ -14637,69 +14688,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listPendingInvoices`, - Aliases: nil, - Description: `Returns all invoices accruing charges for the current billing cycle for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner Role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpendinginvoices. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-listPendingInvoices/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/invoices/pending`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `queryLineItemsFromSingleInvoice`, + OperationID: `searchOrgInvoiceLineItems`, Aliases: nil, Description: `Query the lineItems of the specified invoice and return the result JSON. A unique 24-hexadecimal digit string identifies the invoice. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-querylineitemsfromsingleinvoice. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-searchorginvoicelineitems. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-queryLineItemsFromSingleInvoice/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-invoices-searchOrgInvoiceLineItems/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/lineItems:search`, QueryParameters: []shared_api.Parameter{ @@ -14775,13 +14770,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns, edits, verifies, and removes LDAP configurations. An LDAP configuration defines settings for MongoDB Cloud to connect to your LDAP server over TLS for user authentication and authorization. Your LDAP server must be visible to the internet or connected to your MongoDB Cloud cluster with VPC Peering. Also, your LDAP server must use TLS. You must have the MongoDB Cloud admin user privilege to use these endpoints. Also, to configure user authentication and authorization with LDAPS, your cluster must run MongoDB 3.6 or higher. Groups for which you have configured LDAPS can't create a cluster using a version of MongoDB 3.6 or lower.`, Commands: []shared_api.Command{ { - OperationID: `deleteLdapConfiguration`, + OperationID: `deleteGroupUserSecurityLdapUserToDnMapping`, Aliases: nil, Description: `Removes the current LDAP Distinguished Name mapping captured in the userToDNMapping document from the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteldapconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupusersecurityldapusertodnmapping. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-deleteLdapConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-deleteGroupUserSecurityLdapUserToDnMapping/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/userSecurity/ldap/userToDNMapping`, QueryParameters: []shared_api.Parameter{ @@ -14835,13 +14830,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLdapConfiguration`, + OperationID: `getGroupUserSecurity`, Aliases: nil, Description: `Returns the current LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getldapconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupusersecurity. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-getLdapConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-getGroupUserSecurity/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/userSecurity`, QueryParameters: []shared_api.Parameter{ @@ -14895,13 +14890,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLdapConfigurationStatus`, + OperationID: `getGroupUserSecurityLdapVerify`, Aliases: nil, Description: `Returns the status of one request to verify one LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getldapconfigurationstatus. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupusersecurityldapverify. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-getLdapConfigurationStatus/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-getGroupUserSecurityLdapVerify/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/userSecurity/ldap/verify/{requestId}`, QueryParameters: []shared_api.Parameter{ @@ -14965,16 +14960,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `saveLdapConfiguration`, + OperationID: `updateGroupUserSecurity`, Aliases: nil, Description: `Edits the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Updating this configuration triggers a rolling restart of the database. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-saveldapconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupusersecurity. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-saveLdapConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-updateGroupUserSecurity/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/userSecurity`, QueryParameters: []shared_api.Parameter{ @@ -15028,13 +15023,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `verifyLdapConfiguration`, + OperationID: `verifyGroupUserSecurityLdap`, Aliases: nil, Description: `Verifies the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifyldapconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifygroupusersecurityldap. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-verifyLdapConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-ldapConfiguration-verifyGroupUserSecurityLdap/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/userSecurity/ldap/verify`, QueryParameters: []shared_api.Parameter{ @@ -15088,11 +15083,10 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getLdapConfigurationStatus`, + OperationID: `verifyGroupUserSecurityLdap`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ - `groupId`: `input:groupId`, - `requestId`: `body:$.requestId`, + `groupId`: `input:groupId`, }, }, Expect: &shared_api.WatcherExpectProperties{ @@ -15113,13 +15107,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Manages Legacy Backup snapshots, restore jobs, schedules and checkpoints.`, Commands: []shared_api.Command{ { - OperationID: `createLegacyBackupRestoreJob`, + OperationID: `createGroupClusterRestoreJob`, Aliases: nil, Description: `Restores one legacy backup for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This endpoint doesn't support creating checkpoint restore jobs for sharded clusters, or creating restore jobs for queryable backup snapshots. If you create an automated restore job by specifying delivery.methodName of AUTOMATED_RESTORE in your request body, MongoDB Cloud removes all existing data on the target cluster prior to the restore. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createlegacybackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterrestorejob. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-createLegacyBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-createGroupClusterRestoreJob/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restoreJobs`, QueryParameters: []shared_api.Parameter{ @@ -15183,13 +15177,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteLegacySnapshot`, + OperationID: `deleteGroupClusterSnapshot`, Aliases: nil, Description: `Removes one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletelegacysnapshot. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclustersnapshot. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-deleteLegacySnapshot/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-deleteGroupClusterSnapshot/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ @@ -15263,13 +15257,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLegacyBackupCheckpoint`, + OperationID: `getGroupClusterBackupCheckpoint`, Aliases: nil, Description: `Returns one legacy backup checkpoint for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacybackupcheckpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackupcheckpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-getLegacyBackupCheckpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-getGroupClusterBackupCheckpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backupCheckpoints/{checkpointId}`, QueryParameters: []shared_api.Parameter{ @@ -15343,16 +15337,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLegacyBackupRestoreJob`, + OperationID: `getGroupClusterRestoreJob`, Aliases: nil, Description: `Returns one legacy backup restore job for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacybackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterrestorejob. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-getLegacyBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-getGroupClusterRestoreJob/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restoreJobs/{jobId}`, QueryParameters: []shared_api.Parameter{ @@ -15426,13 +15420,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLegacySnapshot`, + OperationID: `getGroupClusterSnapshot`, Aliases: nil, Description: `Returns one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacysnapshot. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersnapshot. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-getLegacySnapshot/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-getGroupClusterSnapshot/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ @@ -15506,16 +15500,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLegacySnapshotSchedule`, + OperationID: `getGroupClusterSnapshotSchedule`, Aliases: nil, Description: `Returns the snapshot schedule for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacysnapshotschedule. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclustersnapshotschedule. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-getLegacySnapshotSchedule/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-getGroupClusterSnapshotSchedule/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshotSchedule`, QueryParameters: []shared_api.Parameter{ @@ -15579,13 +15573,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listLegacyBackupCheckpoints`, + OperationID: `listGroupClusterBackupCheckpoints`, Aliases: nil, Description: `Returns all legacy backup checkpoints for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listlegacybackupcheckpoints. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackupcheckpoints. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-listLegacyBackupCheckpoints/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-listGroupClusterBackupCheckpoints/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backupCheckpoints`, QueryParameters: []shared_api.Parameter{ @@ -15679,16 +15673,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listLegacyBackupRestoreJobs`, + OperationID: `listGroupClusterRestoreJobs`, Aliases: nil, Description: `Returns all legacy backup restore jobs for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. If you use the BATCH-ID query parameter, you can retrieve all restore jobs in the specified batch. When creating a restore job for a sharded cluster, MongoDB Cloud creates a separate job for each shard, plus another for the config server. Each of those jobs are part of a batch. However, a batch can't include a restore job for a replica set. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listlegacybackuprestorejobs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterrestorejobs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-listLegacyBackupRestoreJobs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-listGroupClusterRestoreJobs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restoreJobs`, QueryParameters: []shared_api.Parameter{ @@ -15792,13 +15786,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listLegacySnapshots`, + OperationID: `listGroupClusterSnapshots`, Aliases: nil, Description: `Returns all legacy backup snapshots for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listlegacysnapshots. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclustersnapshots. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-listLegacySnapshots/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-listGroupClusterSnapshots/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshots`, QueryParameters: []shared_api.Parameter{ @@ -15902,13 +15896,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateLegacySnapshotRetention`, + OperationID: `updateGroupClusterSnapshot`, Aliases: nil, Description: `Changes the expiration date for one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatelegacysnapshotretention. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersnapshot. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-updateLegacySnapshotRetention/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-updateGroupClusterSnapshot/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ @@ -15982,16 +15976,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateLegacySnapshotSchedule`, + OperationID: `updateGroupClusterSnapshotSchedule`, Aliases: nil, Description: `Updates the snapshot schedule for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatelegacysnapshotschedule. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersnapshotschedule. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-updateLegacySnapshotSchedule/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-legacyBackup-updateGroupClusterSnapshotSchedule/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshotSchedule`, QueryParameters: []shared_api.Parameter{ @@ -16061,13 +16055,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, edits, and removes maintenance windows. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. You can defer a scheduled maintenance event for a project up to two times. Deferred maintenance events occur during your preferred maintenance window exactly one week after the previously scheduled date and time.`, Commands: []shared_api.Command{ { - OperationID: `deferMaintenanceWindow`, + OperationID: `deferGroupMaintenanceWindow`, Aliases: nil, Description: `Defers the maintenance window for the specified project. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-defermaintenancewindow. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-defergroupmaintenancewindow. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-deferMaintenanceWindow/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-deferGroupMaintenanceWindow/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/maintenanceWindow/defer`, QueryParameters: []shared_api.Parameter{ @@ -16111,13 +16105,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getMaintenanceWindow`, + OperationID: `getGroupMaintenanceWindow`, Aliases: nil, Description: `Returns the maintenance window for the specified project. MongoDB Cloud starts those maintenance activities when needed. You can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmaintenancewindow. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupmaintenancewindow. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-getMaintenanceWindow/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-getGroupMaintenanceWindow/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/maintenanceWindow`, QueryParameters: []shared_api.Parameter{ @@ -16171,13 +16165,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `resetMaintenanceWindow`, + OperationID: `resetGroupMaintenanceWindow`, Aliases: nil, Description: `Resets the maintenance window for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-resetmaintenancewindow. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-resetgroupmaintenancewindow. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-resetMaintenanceWindow/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-resetGroupMaintenanceWindow/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/maintenanceWindow`, QueryParameters: []shared_api.Parameter{ @@ -16221,13 +16215,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `toggleMaintenanceAutoDefer`, + OperationID: `toggleGroupMaintenanceWindowAutoDefer`, Aliases: nil, Description: `Toggles automatic deferral of the maintenance window for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglemaintenanceautodefer. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglegroupmaintenancewindowautodefer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-toggleMaintenanceAutoDefer/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-toggleGroupMaintenanceWindowAutoDefer/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/maintenanceWindow/autoDefer`, QueryParameters: []shared_api.Parameter{ @@ -16271,13 +16265,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateMaintenanceWindow`, + OperationID: `updateGroupMaintenanceWindow`, Aliases: nil, Description: `Updates the maintenance window for the specified project. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. Updating the maintenance window will reset any maintenance deferrals for this project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatemaintenancewindow. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupmaintenancewindow. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-updateMaintenanceWindow/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-maintenanceWindows-updateGroupMaintenanceWindow/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/maintenanceWindow`, QueryParameters: []shared_api.Parameter{ @@ -16327,21 +16321,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, and edits MongoDB Cloud users.`, Commands: []shared_api.Command{ { - OperationID: `addOrganizationRole`, + OperationID: `addGroupUserRole`, Aliases: nil, - Description: `Adds one organization-level role to the MongoDB Cloud user. You can add a role to an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This operation is atomic. + Description: `Adds one project-level role to the MongoDB Cloud user. You can add a role to an active user or a user that has been invited to join the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Note: This resource cannot be used to add a role to users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addorganizationrole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupuserrole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-addOrganizationRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-addGroupUserRole/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}:addRole`, + URL: `/api/atlas/v2/groups/{groupId}/users/{userId}:addRole`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -16366,18 +16357,22 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, { Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, + Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -16399,18 +16394,25 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `addProjectRole`, + OperationID: `addGroupUsers`, Aliases: nil, - Description: `Adds one project-level role to the MongoDB Cloud user. You can add a role to an active user or a user that has been invited to join the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Adds one MongoDB Cloud user to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -Note: This resource cannot be used to add a role to users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectrole. +If the user has a pending invitation to join the project's organization, MongoDB Cloud modifies it and grants project access. + -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-addProjectRole/`, +If the user doesn't have an invitation to join the organization, MongoDB Cloud sends a new invitation that grants the user organization and project access. + + +If the user is already active in the project's organization, MongoDB Cloud grants access to the project. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupusers. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-addGroupUsers/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/users/{userId}:addRole`, + URL: `/api/atlas/v2/groups/{groupId}/users`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -16448,16 +16450,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodPost, }, @@ -16472,25 +16464,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `addProjectUser`, + OperationID: `addOrgTeamUser`, Aliases: nil, - Description: `Adds one MongoDB Cloud user to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - - -If the user has a pending invitation to join the project's organization, MongoDB Cloud modifies it and grants project access. - - -If the user doesn't have an invitation to join the organization, MongoDB Cloud sends a new invitation that grants the user organization and project access. + Description: `Adds one MongoDB Cloud user to one team. You can add an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -If the user is already active in the project's organization, MongoDB Cloud grants access to the project. +Note: This resource cannot be used to add a user invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addorgteamuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-addProjectUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-addOrgTeamUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/users`, + URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}:addUser`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -16515,18 +16500,24 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `teamId`, + Description: `Unique 24-hexadecimal digit string that identifies the team to add the MongoDB Cloud user to.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, Verb: http.MethodPost, @@ -16542,18 +16533,21 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `addUserToTeam`, + OperationID: `addOrgUserRole`, Aliases: nil, - Description: `Adds one MongoDB Cloud user to one team. You can add an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Adds one organization-level role to the MongoDB Cloud user. You can add a role to an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -Note: This resource cannot be used to add a user invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. +Note: This operation is atomic. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addusertoteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-addUserToTeam/`, +Note: This resource cannot be used to add a role to users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addorguserrole. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-addOrgUserRole/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}:addUser`, + URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}:addRole`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -16588,8 +16582,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `teamId`, - Description: `Unique 24-hexadecimal digit string that identifies the team to add the MongoDB Cloud user to.`, + Name: `userId`, + Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -16611,16 +16605,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createOrganizationUser`, + OperationID: `createOrgUser`, Aliases: nil, Description: `Invites one new or existing MongoDB Cloud user to join the organization. The invitation to join the organization will be sent to the username provided and must be accepted within 30 days. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: If the user does not have an existing MongoDB Cloud account, they will be prompted to finish setting up an account upon accepting the invitation. If the user already has an account, they will still receive an invitation to access the organization. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorganizationuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorguser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-createOrganizationUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-createOrgUser/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/users`, QueryParameters: []shared_api.Parameter{ @@ -16721,21 +16715,21 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrganizationUser`, + OperationID: `getGroupUser`, Aliases: nil, - Description: `Returns information about the specified MongoDB Cloud user within the context of the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + Description: `Returns information about the specified MongoDB Cloud user within the context of the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -Note: This resource can only be used to fetch information about MongoDB Cloud human users. To return information about an API Key, use the Return One Organization API Key endpoint. +Note: You can only use this resource to fetch information about MongoDB Cloud human users. To return information about an API Key, use the Return One Organization API Key endpoint. Note: This resource does not return information about pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-getOrganizationUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-getGroupUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}`, + URL: `/api/atlas/v2/groups/{groupId}/users/{userId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -16760,18 +16754,22 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, { Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, + Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -16793,21 +16791,21 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectUser`, + OperationID: `getOrgUser`, Aliases: nil, - Description: `Returns information about the specified MongoDB Cloud user within the context of the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns information about the specified MongoDB Cloud user within the context of the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -Note: You can only use this resource to fetch information about MongoDB Cloud human users. To return information about an API Key, use the Return One Organization API Key endpoint. +Note: This resource can only be used to fetch information about MongoDB Cloud human users. To return information about an API Key, use the Return One Organization API Key endpoint. Note: This resource does not return information about pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorguser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-getProjectUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-getOrgUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/users/{userId}`, + URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -16832,22 +16830,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, { Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, + Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -16925,13 +16919,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getUserByUsername`, + OperationID: `getUserByName`, Aliases: nil, Description: `Returns the details for one MongoDB Cloud user account with the specified username. You can't use this endpoint to return information about an API Key. To return information about an API Key, use the Return One Organization API Key endpoint. To use this resource, the requesting Service Account or API Key can have any role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getuserbyusername. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getuserbyname. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-getUserByUsername/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-getUserByName/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/users/byName/{userName}`, QueryParameters: []shared_api.Parameter{ @@ -16981,9 +16975,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationUsers`, + OperationID: `listGroupUsers`, Aliases: nil, - Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. @@ -16991,11 +16985,11 @@ Note: This resource cannot be used to view details about users invited via the d Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationusers. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupusers. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-listOrganizationUsers/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-listGroupUsers/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/users`, + URL: `/api/atlas/v2/groups/{groupId}/users`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17007,16 +17001,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, { Name: `includeCount`, Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, @@ -17048,18 +17032,48 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `username`, - Description: `Email address to filter users by. Not supported in deprecated versions.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, + }, + }, + { + Name: `flattenTeams`, + Description: `Flag that indicates whether the returned list should include users who belong to a team with a role in this project. You might not have assigned the individual users a role in this project. If "flattenTeams" : false, this resource returns only users with a role in the project. If "flattenTeams" : true, this resource returns both users with roles in the project and users who belong to teams with roles in the project.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `includeOrgUsers`, + Description: `Flag that indicates whether the returned list should include users with implicit access to the project, the Organization Owner or Organization Read Only role. You might not have assigned the individual users a role in this project. If "includeOrgUsers": false, this resource returns only users with a role in the project. If "includeOrgUsers": true, this resource returns both users with roles in the project and users who have implicit access to the project through their organization role.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, }, }, { Name: `orgMembershipStatus`, - Description: `Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, + Description: `Flag that indicates whether to filter the returned list by users organization membership status. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `username`, + Description: `Email address to filter users by. Not supported in deprecated versions.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -17070,14 +17084,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, }, Verb: http.MethodGet, @@ -17100,9 +17118,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listProjectUsers`, + OperationID: `listOrgTeamUsers`, Aliases: nil, - Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified team in the organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. @@ -17110,11 +17128,11 @@ Note: This resource cannot be used to view details about users invited via the d Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectusers. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgteamusers. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-listProjectUsers/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-listOrgTeamUsers/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/users`, + URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}/users`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17126,16 +17144,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, { Name: `itemsPerPage`, Description: `Number of items that the response returns per page.`, @@ -17167,28 +17175,28 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `flattenTeams`, - Description: `Flag that indicates whether the returned list should include users who belong to a team with a role in this project. You might not have assigned the individual users a role in this project. If "flattenTeams" : false, this resource returns only users with a role in the project. If "flattenTeams" : true, this resource returns both users with roles in the project and users who belong to teams with roles in the project.`, + Name: `username`, + Description: `Email address to filter users by. Not supported in deprecated versions.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, { - Name: `includeOrgUsers`, - Description: `Flag that indicates whether the returned list should include users with implicit access to the project, the Organization Owner or Organization Read Only role. You might not have assigned the individual users a role in this project. If "includeOrgUsers": false, this resource returns only users with a role in the project. If "includeOrgUsers": true, this resource returns both users with roles in the project and users who have implicit access to the project through their organization role.`, + Name: `orgMembershipStatus`, + Description: `Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, { - Name: `orgMembershipStatus`, - Description: `Flag that indicates whether to filter the returned list by users organization membership status. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, + Name: `userId`, + Description: `Unique 24-hexadecimal digit string to filter users by. Not supported in deprecated versions.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -17196,31 +17204,27 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `username`, - Description: `Email address to filter users by. Not supported in deprecated versions.`, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `teamId`, + Description: `Unique 24-hexadecimal digit string that identifies the team whose application users you want to return.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, Verb: http.MethodGet, @@ -17243,9 +17247,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listTeamUsers`, + OperationID: `listOrgUsers`, Aliases: nil, - Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified team in the organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Member role. Note: This resource cannot be used to view details about users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. @@ -17253,11 +17257,11 @@ Note: This resource cannot be used to view details about users invited via the d Note: To return both pending and active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users will be returned. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listteamusers. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgusers. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-listTeamUsers/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-listOrgUsers/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}/users`, + URL: `/api/atlas/v2/orgs/{orgId}/users`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17270,48 +17274,48 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, }, }, { - Name: `username`, - Description: `Email address to filter users by. Not supported in deprecated versions.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, }, { - Name: `orgMembershipStatus`, - Description: `Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, + Name: `username`, + Description: `Email address to filter users by. Not supported in deprecated versions.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -17320,8 +17324,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `userId`, - Description: `Unique 24-hexadecimal digit string to filter users by. Not supported in deprecated versions.`, + Name: `orgMembershipStatus`, + Description: `Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -17341,16 +17345,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, - { - Name: `teamId`, - Description: `Unique 24-hexadecimal digit string that identifies the team whose application users you want to return.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -17372,81 +17366,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `removeOrganizationRole`, + OperationID: `removeGroupUser`, Aliases: nil, - Description: `Removes one organization-level role from the MongoDB Cloud user. You can remove a role from an active user or a user that has not yet accepted the invitation to join the organization. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: This operation is atomic. - - -Note: This resource cannot be used to remove a role from users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorganizationrole. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeOrganizationRole/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}:removeRole`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodPost, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2025, 2, 19), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `removeOrganizationUser`, - Aliases: nil, - Description: `Removes one MongoDB Cloud user in the specified organization. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Removes one MongoDB Cloud user from the specified project. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Note: This resource cannot be used to remove pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. @@ -17454,11 +17376,11 @@ Note: This resource cannot be used to remove pending users invited via the depre Note: To remove pending or active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users can be removed. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorganizationuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removegroupuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeOrganizationUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeGroupUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}`, + URL: `/api/atlas/v2/groups/{groupId}/users/{userId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17483,18 +17405,22 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, { Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, + Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -17523,16 +17449,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `removeProjectRole`, + OperationID: `removeGroupUserRole`, Aliases: nil, Description: `Removes one project-level role from the MongoDB Cloud user. You can remove a role from an active user or a user that has been invited to join the project. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Note: This resource cannot be used to remove a role from users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectrole. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removegroupuserrole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeProjectRole/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeGroupUserRole/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/users/{userId}:removeRole`, QueryParameters: []shared_api.Parameter{ @@ -17596,21 +17522,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeProjectUser`, + OperationID: `removeOrgTeamUser`, Aliases: nil, - Description: `Removes one MongoDB Cloud user from the specified project. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - - -Note: This resource cannot be used to remove pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + Description: `Removes one MongoDB Cloud user from one team. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -Note: To remove pending or active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users can be removed. +Note: This resource cannot be used to remove a user invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorgteamuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeProjectUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeOrgTeamUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/users/{userId}`, + URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}:removeUser`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17635,22 +17558,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, { - Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, + Name: `teamId`, + Description: `Unique 24-hexadecimal digit string that identifies the team to remove the MongoDB user from.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -17659,19 +17578,12 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, { Version: shared_api.NewStableVersion(2025, 2, 19), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, @@ -17679,18 +17591,21 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeUserFromTeam`, + OperationID: `removeOrgUser`, Aliases: nil, - Description: `Removes one MongoDB Cloud user from one team. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Removes one MongoDB Cloud user in the specified organization. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -Note: This resource cannot be used to remove a user invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. +Note: This resource cannot be used to remove pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeuserfromteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeUserFromTeam/`, +Note: To remove pending or active users, use v2-{2025-02-19} or later. If using a deprecated version, only active users can be removed. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorguser. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeOrgUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}:removeUser`, + URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17725,8 +17640,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `teamId`, - Description: `Unique 24-hexadecimal digit string that identifies the team to remove the MongoDB user from.`, + Name: `userId`, + Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -17735,12 +17650,19 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - Verb: http.MethodPost, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, { Version: shared_api.NewStableVersion(2025, 2, 19), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -17748,21 +17670,21 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationUser`, + OperationID: `removeOrgUserRole`, Aliases: nil, - Description: `Updates one MongoDB Cloud user in the specified organization. You can update an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Removes one organization-level role from the MongoDB Cloud user. You can remove a role from an active user or a user that has not yet accepted the invitation to join the organization. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -Note: Only include the fields you wish to update in the request body. Supplying a field with an empty value will reset that field on the user. +Note: This operation is atomic. -Note: This resource cannot be used to update pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. +Note: This resource cannot be used to remove a role from users invited using the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorguserrole. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-updateOrganizationUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-removeOrgUserRole/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}`, + URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}:removeRole`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17807,7 +17729,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - Verb: http.MethodPatch, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { @@ -17819,22 +17741,22 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - }, - }, - { - Name: `Monitoring and Logs`, - Description: `Returns database deployment monitoring and logging data.`, - Commands: []shared_api.Command{ { - OperationID: `getAtlasProcess`, + OperationID: `updateOrgUser`, Aliases: nil, - Description: `Returns the processes for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Updates one MongoDB Cloud user in the specified organization. You can update an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlasprocess. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getAtlasProcess/`, +Note: Only include the fields you wish to update in the request body. Supplying a field with an empty value will reset that field on the user. + + +Note: This resource cannot be used to update pending users invited via the deprecated Invite One MongoDB Cloud User to Join One Project endpoint. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorguser. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-mongoDbCloudUsers-updateOrgUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}`, + URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17859,22 +17781,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, { - Name: `processId`, - Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Name: `userId`, + Description: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -17883,28 +17801,34 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodGet, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + Version: shared_api.NewStableVersion(2025, 2, 19), + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, }, }, }, + }, + }, + { + Name: `Monitoring and Logs`, + Description: `Returns database deployment monitoring and logging data.`, + Commands: []shared_api.Command{ { - OperationID: `getDatabase`, + OperationID: `downloadGroupClusterLog`, Aliases: nil, - Description: `Returns one database running on the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. MongoDB updates process and audit logs from the cluster backend infrastructure every five minutes. Logs are stored in chunks approximately five minutes in length, but this duration may vary. If you poll the API for log files, we recommend polling every five minutes even though consecutive polls could contain some overlapping logs. This feature isn't available for M0 free clusters, M2, M5, flex, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabase. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupclusterlog. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getDatabase/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-downloadGroupClusterLog/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}`, + URL: `/api/atlas/v2/groups/{groupId}/clusters/{hostName}/logs/{logName}.gz`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -17917,13 +17841,23 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `endDate`, + Description: `Specifies the date and time for the ending point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours after the start date. If the start date is also unspecified, the value will default to the time of the request.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, + }, + }, + { + Name: `startDate`, + Description: `Specifies the date and time for the starting point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours prior to the end date. If the end date is also unspecified, the value will default to 24 hours prior to the time of the request.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, }, }, }, @@ -17943,8 +17877,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `databaseName`, - Description: `Human-readable label that identifies the database that the specified MongoDB process serves.`, + Name: `hostName`, + Description: `Human-readable label that identifies the host that stores the log files that you want to download.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -17953,8 +17887,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - Name: `processId`, - Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Name: `logName`, + Description: `Human-readable label that identifies the log file that you want to return. To return audit logs, enable Database Auditing for the specified project.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -17970,55 +17904,94 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ - `json`, + `gzip`, + }, + }, + { + Version: shared_api.NewStableVersion(2023, 2, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `gzip`, }, }, }, }, { - OperationID: `getDatabaseMeasurements`, + OperationID: `getGroupHostFtsMetricIndexMeasurements`, Aliases: nil, - Description: `Returns the measurements of one database for the specified host for the specified project. Returns the database's on-disk storage space based on the MongoDB dbStats command output. To calculate some metric series, Atlas takes the rate between every two adjacent points. For these metric series, the first data point has a null value because Atlas can't calculate a rate for the first data point given the query time range. Atlas retrieves database metrics every 20 minutes but reduces frequency when necessary to optimize database performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. You must have the Project Read Only or higher role to view the Atlas Search metric types. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabasemeasurements. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouphostftsmetricindexmeasurements. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getDatabaseMeasurements/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getGroupHostFtsMetricIndexMeasurements/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}/measurements`, + URL: `/api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/{indexName}/measurements`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `granularity`, + Description: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `period`, + Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `start`, + Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, { - Name: `m`, - Description: `One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the m parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements.`, + Name: `end`, + Description: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `metrics`, + Description: `List that contains the measurements that MongoDB Atlas reports for the associated data series.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: true, Type: `string`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `granularity`, - Description: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, + Name: `processId`, + Description: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -18027,36 +18000,164 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `period`, - Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, + Name: `indexName`, + Description: `Human-readable label that identifies the index.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, { - Name: `start`, - Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, + Name: `databaseName`, + Description: `Human-readable label that identifies the database.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, { - Name: `end`, - Description: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, + Name: `collectionName`, + Description: `Human-readable label that identifies the collection.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `getGroupProcess`, + Aliases: nil, + Description: `Returns the processes for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocess. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getGroupProcess/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `processId`, + Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `getGroupProcessDatabase`, + Aliases: nil, + Description: `Returns one database running on the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessdatabase. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getGroupProcessDatabase/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, URLParameters: []shared_api.Parameter{ { Name: `groupId`, @@ -18106,32 +18207,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getDiskMeasurements`, + OperationID: `getGroupProcessDatabaseMeasurements`, Aliases: nil, - Description: `Returns the measurements of one disk or partition for the specified host for the specified project. Returned value can be one of the following: - - - -Throughput of I/O operations for the disk partition used for the MongoDB process - - -Percentage of time during which requests the partition issued and serviced - - -Latency per operation type of the disk partition used for the MongoDB process - - -Amount of free and used disk space on the disk partition used for the MongoDB process - - - -To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns the measurements of one database for the specified host for the specified project. Returns the database's on-disk storage space based on the MongoDB dbStats command output. To calculate some metric series, Atlas takes the rate between every two adjacent points. For these metric series, the first data point has a null value because Atlas can't calculate a rate for the first data point given the query time range. Atlas retrieves database metrics every 20 minutes but reduces frequency when necessary to optimize database performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdiskmeasurements. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessdatabasemeasurements. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getDiskMeasurements/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getGroupProcessDatabaseMeasurements/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}/measurements`, + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}/measurements`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -18220,8 +18304,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `partitionName`, - Description: `Human-readable label of the disk or partition to which the measurements apply.`, + Name: `databaseName`, + Description: `Human-readable label that identifies the database that the specified MongoDB process serves.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -18253,15 +18337,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getHostLogs`, + OperationID: `getGroupProcessDisk`, Aliases: nil, - Description: `Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. MongoDB updates process and audit logs from the cluster backend infrastructure every five minutes. Logs are stored in chunks approximately five minutes in length, but this duration may vary. If you poll the API for log files, we recommend polling every five minutes even though consecutive polls could contain some overlapping logs. This feature isn't available for M0 free clusters, M2, M5, flex, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". + Description: `Returns measurement details for one disk or partition for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-gethostlogs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessdisk. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getHostLogs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getGroupProcessDisk/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{hostName}/logs/{logName}.gz`, + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -18273,28 +18357,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `endDate`, - Description: `Specifies the date and time for the ending point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours after the start date. If the start date is also unspecified, the value will default to the time of the request.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `startDate`, - Description: `Specifies the date and time for the starting point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours prior to the end date. If the end date is also unspecified, the value will default to 24 hours prior to the time of the request.`, + Name: `partitionName`, + Description: `Human-readable label of the disk or partition to which the measurements apply.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { Name: `groupId`, Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. @@ -18310,18 +18384,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `hostName`, - Description: `Human-readable label that identifies the host that stores the log files that you want to download.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `logName`, - Description: `Human-readable label that identifies the log file that you want to return. To return audit logs, enable Database Auditing for the specified project.`, + Name: `processId`, + Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -18337,22 +18401,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ - `gzip`, - }, - }, - { - Version: shared_api.NewStableVersion(2023, 2, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `gzip`, + `json`, }, }, }, }, { - OperationID: `getHostMeasurements`, + OperationID: `getGroupProcessDiskMeasurements`, Aliases: nil, - Description: `Returns disk, partition, or host measurements per process for the specified host for the specified project. Returned value can be one of the following: + Description: `Returns the measurements of one disk or partition for the specified host for the specified project. Returned value can be one of the following: @@ -18368,17 +18425,14 @@ Latency per operation type of the disk partition used for the MongoDB process Amount of free and used disk space on the disk partition used for the MongoDB process -Measurements for the host, such as CPU usage or number of I/O operations - - To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-gethostmeasurements. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessdiskmeasurements. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getHostMeasurements/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getGroupProcessDiskMeasurements/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/measurements`, + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}/measurements`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -18411,20 +18465,20 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `period`, - Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, + Name: `granularity`, + Description: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, { - Name: `granularity`, - Description: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, + Name: `period`, + Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, @@ -18466,6 +18520,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `partitionName`, + Description: `Human-readable label of the disk or partition to which the measurements apply.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, { Name: `processId`, Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, @@ -18490,59 +18554,49 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getIndexMetrics`, + OperationID: `getGroupProcessMeasurements`, Aliases: nil, - Description: `Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. You must have the Project Read Only or higher role to view the Atlas Search metric types. + Description: `Returns disk, partition, or host measurements per process for the specified host for the specified project. Returned value can be one of the following: + + + +Throughput of I/O operations for the disk partition used for the MongoDB process -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getindexmetrics. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getIndexMetrics/`, +Percentage of time during which requests the partition issued and serviced + + +Latency per operation type of the disk partition used for the MongoDB process + + +Amount of free and used disk space on the disk partition used for the MongoDB process + + +Measurements for the host, such as CPU usage or number of I/O operations + + + +To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprocessmeasurements. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getGroupProcessMeasurements/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/{indexName}/measurements`, + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/measurements`, QueryParameters: []shared_api.Parameter{ { - Name: `granularity`, - Description: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `period`, - Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `start`, - Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `end`, - Description: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, }, }, { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -18551,30 +18605,28 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `metrics`, - Description: `List that contains the measurements that MongoDB Atlas reports for the associated data series.`, + Name: `m`, + Description: `One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for m, repeat the m parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: true, Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `processId`, - Description: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Name: `period`, + Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, { - Name: `indexName`, - Description: `Human-readable label that identifies the index.`, + Name: `granularity`, + Description: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -18583,25 +18635,27 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `databaseName`, - Description: `Human-readable label that identifies the database.`, + Name: `start`, + Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, { - Name: `collectionName`, - Description: `Human-readable label that identifies the collection.`, + Name: `end`, + Description: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, + }, + URLParameters: []shared_api.Parameter{ { Name: `groupId`, Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. @@ -18616,6 +18670,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `processId`, + Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodGet, }, @@ -18630,15 +18694,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getMeasurements`, + OperationID: `listGroupHostFtsMetricIndexMeasurements`, Aliases: nil, - Description: `Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. + Description: `Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmeasurements. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouphostftsmetricindexmeasurements. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-getMeasurements/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetricIndexMeasurements/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/measurements`, + URL: `/api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/measurements`, QueryParameters: []shared_api.Parameter{ { Name: `granularity`, @@ -18692,7 +18756,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, { Name: `metrics`, - Description: `List that contains the metrics that you want MongoDB Atlas to report for the associated data series. If you don't set this parameter, this resource returns all hardware and status metrics for the associated data series.`, + Description: `List that contains the measurements that MongoDB Atlas reports for the associated data series.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -18713,95 +18777,25 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `listAtlasProcesses`, - Aliases: nil, - Description: `Returns details of all processes for the specified project. A MongoDB process can be either a mongod or mongos. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlasprocesses. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listAtlasProcesses/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `databaseName`, + Description: `Human-readable label that identifies the database.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `collectionName`, + Description: `Human-readable label that identifies the collection.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { Name: `groupId`, Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. @@ -18830,59 +18824,59 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDatabases`, + OperationID: `listGroupHostFtsMetricMeasurements`, Aliases: nil, - Description: `Returns the list of databases running on the specified host for the specified project. M0 free clusters, M2, M5, serverless, and Flex clusters have some operational limits. The MongoDB Cloud process must be a mongod. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabases. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouphostftsmetricmeasurements. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listDatabases/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetricMeasurements/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/databases`, + URL: `/api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/measurements`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `granularity`, + Description: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Name: `period`, + Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, + Name: `start`, + Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, }, { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `end`, + Description: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -18890,8 +18884,28 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `metrics`, + Description: `List that contains the metrics that you want MongoDB Atlas to report for the associated data series. If you don't set this parameter, this resource returns all hardware and status metrics for the associated data series.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: true, + Type: `string`, + }, + }, }, URLParameters: []shared_api.Parameter{ + { + Name: `processId`, + Description: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, { Name: `groupId`, Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. @@ -18906,16 +18920,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `processId`, - Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod). The port must be the IANA port on which the MongoDB process listens for requests.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -18930,15 +18934,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDiskMeasurements`, + OperationID: `listGroupHostFtsMetrics`, Aliases: nil, - Description: `Returns measurement details for one disk or partition for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns all Atlas Search metric types available for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdiskmeasurements. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouphostftsmetrics. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listDiskMeasurements/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listGroupHostFtsMetrics/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}`, + URL: `/api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -18953,8 +18957,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `partitionName`, - Description: `Human-readable label of the disk or partition to which the measurements apply.`, + Name: `processId`, + Description: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -18976,16 +18980,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `processId`, - Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -19000,15 +18994,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDiskPartitions`, + OperationID: `listGroupProcessDatabases`, Aliases: nil, - Description: `Returns the list of disks or partitions for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns the list of databases running on the specified host for the specified project. M0 free clusters, M2, M5, serverless, and Flex clusters have some operational limits. The MongoDB Cloud process must be a mongod. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdiskpartitions. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessdatabases. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listDiskPartitions/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listGroupProcessDatabases/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/disks`, + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/databases`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19078,7 +19072,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `processId`, - Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod). The port must be the IANA port on which the MongoDB process listens for requests.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -19100,59 +19094,59 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listIndexMetrics`, + OperationID: `listGroupProcessDisks`, Aliases: nil, - Description: `Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. + Description: `Returns the list of disks or partitions for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listindexmetrics. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessdisks. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listIndexMetrics/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listGroupProcessDisks/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/measurements`, + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/disks`, QueryParameters: []shared_api.Parameter{ { - Name: `granularity`, - Description: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, }, }, { - Name: `period`, - Description: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set start and end.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, }, }, { - Name: `start`, - Description: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, }, { - Name: `end`, - Description: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set period.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, }, { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -19160,48 +19154,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `metrics`, - Description: `List that contains the measurements that MongoDB Atlas reports for the associated data series.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: true, - Type: `string`, - }, - }, }, URLParameters: []shared_api.Parameter{ - { - Name: `processId`, - Description: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `databaseName`, - Description: `Human-readable label that identifies the database.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `collectionName`, - Description: `Human-readable label that identifies the collection.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, { Name: `groupId`, Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. @@ -19216,6 +19170,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `processId`, + Description: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodGet, }, @@ -19230,15 +19194,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listMetricTypes`, + OperationID: `listGroupProcesses`, Aliases: nil, - Description: `Returns all Atlas Search metric types available for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. + Description: `Returns details of all processes for the specified project. A MongoDB process can be either a mongod or mongos. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listmetrictypes. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocesses. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listMetricTypes/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-monitoringAndLogs-listGroupProcesses/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics`, + URL: `/api/atlas/v2/groups/{groupId}/processes`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19250,18 +19214,48 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `processId`, - Description: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, + }, + }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, }, }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ { Name: `groupId`, Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. @@ -19297,15 +19291,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you When you deploy an M10+ dedicated cluster, Atlas creates a VPC for the selected provider and region or regions if no existing VPC or VPC peering connection exists for that provider and region. Atlas assigns the VPC a Classless Inter-Domain Routing (CIDR) block.`, Commands: []shared_api.Command{ { - OperationID: `createPeeringConnection`, + OperationID: `createGroupContainer`, Aliases: nil, - Description: `Creates one new network peering connection in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations and prerequisites, see the Network Peering Documentation. + Description: `Creates one new network peering container in the specified project. MongoDB Cloud can deploy Network Peering connections in a network peering container. GCP can have one container per project. AWS and Azure can have one container per cloud provider region. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpeeringconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupcontainer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-createPeeringConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-createGroupContainer/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/peers`, + URL: `/api/atlas/v2/groups/{groupId}/containers`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19357,15 +19351,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createPeeringContainer`, + OperationID: `createGroupPeer`, Aliases: nil, - Description: `Creates one new network peering container in the specified project. MongoDB Cloud can deploy Network Peering connections in a network peering container. GCP can have one container per project. AWS and Azure can have one container per cloud provider region. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Creates one new network peering connection in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations and prerequisites, see the Network Peering Documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpeeringcontainer. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategrouppeer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-createPeeringContainer/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-createGroupPeer/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/containers`, + URL: `/api/atlas/v2/groups/{groupId}/peers`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19417,15 +19411,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePeeringConnection`, + OperationID: `deleteGroupContainer`, Aliases: nil, - Description: `Removes one network peering connection in the specified project. If you Removes the last network peering connection associated with a project, MongoDB Cloud also removes any AWS security groups from the project IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Removes one network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepeeringconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupcontainer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-deletePeeringConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-deleteGroupContainer/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/peers/{peerId}`, + URL: `/api/atlas/v2/groups/{groupId}/containers/{containerId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19464,8 +19458,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `peerId`, - Description: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to delete.`, + Name: `containerId`, + Description: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -19487,15 +19481,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePeeringContainer`, + OperationID: `deleteGroupPeer`, Aliases: nil, - Description: `Removes one network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Removes one network peering connection in the specified project. If you Removes the last network peering connection associated with a project, MongoDB Cloud also removes any AWS security groups from the project IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepeeringcontainer. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegrouppeer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-deletePeeringContainer/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-deleteGroupPeer/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/containers/{containerId}`, + URL: `/api/atlas/v2/groups/{groupId}/peers/{peerId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19534,8 +19528,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `containerId`, - Description: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove.`, + Name: `peerId`, + Description: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to delete.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -19557,13 +19551,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `disablePeering`, + OperationID: `disableGroupPrivateIpModePeering`, Aliases: nil, Description: `Disables Connect via Peering Only mode for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablepeering. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablegroupprivateipmodepeering. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-disablePeering/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-disableGroupPrivateIpModePeering/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateIpMode`, QueryParameters: []shared_api.Parameter{ @@ -19617,15 +19611,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPeeringConnection`, + OperationID: `getGroupContainer`, Aliases: nil, - Description: `Returns details about one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns details about one network peering container in one specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpeeringconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupcontainer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-getPeeringConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-getGroupContainer/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/peers/{peerId}`, + URL: `/api/atlas/v2/groups/{groupId}/containers/{containerId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19664,8 +19658,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `peerId`, - Description: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to retrieve.`, + Name: `containerId`, + Description: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -19687,15 +19681,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPeeringContainer`, + OperationID: `getGroupPeer`, Aliases: nil, - Description: `Returns details about one network peering container in one specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns details about one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpeeringcontainer. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouppeer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-getPeeringContainer/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-getGroupPeer/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/containers/{containerId}`, + URL: `/api/atlas/v2/groups/{groupId}/peers/{peerId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19734,8 +19728,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `containerId`, - Description: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container.`, + Name: `peerId`, + Description: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to retrieve.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -19757,15 +19751,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPeeringConnections`, + OperationID: `listGroupContainerAll`, Aliases: nil, - Description: `Returns details about all network peering connections in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns details about all network peering containers in the specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringconnections. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcontainerall. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-listPeeringConnections/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-listGroupContainerAll/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/peers`, + URL: `/api/atlas/v2/groups/{groupId}/containers/all`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -19817,16 +19811,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `providerName`, - Description: `Cloud service provider to use for this VPC peering connection.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -19857,13 +19841,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPeeringContainerByCloudProvider`, + OperationID: `listGroupContainers`, Aliases: nil, Description: `Returns details about all network peering containers in the specified project for the specified cloud provider. If you do not specify the cloud provider, MongoDB Cloud returns details about all network peering containers in the project for Amazon Web Services (AWS). To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringcontainerbycloudprovider. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupcontainers. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-listPeeringContainerByCloudProvider/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-listGroupContainers/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/containers`, QueryParameters: []shared_api.Parameter{ @@ -19957,15 +19941,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPeeringContainers`, + OperationID: `listGroupPeers`, Aliases: nil, - Description: `Returns details about all network peering containers in the specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns details about all network peering connections in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringcontainers. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouppeers. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-listPeeringContainers/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-listGroupPeers/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/containers/all`, + URL: `/api/atlas/v2/groups/{groupId}/peers`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -20017,6 +20001,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `providerName`, + Description: `Cloud service provider to use for this VPC peering connection.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -20047,15 +20041,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updatePeeringConnection`, + OperationID: `updateGroupContainer`, Aliases: nil, - Description: `Updates one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Updates the network details and labels of one specified network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepeeringconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupcontainer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-updatePeeringConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-updateGroupContainer/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/peers/{peerId}`, + URL: `/api/atlas/v2/groups/{groupId}/containers/{containerId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -20094,8 +20088,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `peerId`, - Description: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to update.`, + Name: `containerId`, + Description: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -20117,15 +20111,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updatePeeringContainer`, + OperationID: `updateGroupPeer`, Aliases: nil, - Description: `Updates the network details and labels of one specified network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Updates one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepeeringcontainer. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategrouppeer. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-updatePeeringContainer/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-updateGroupPeer/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/containers/{containerId}`, + URL: `/api/atlas/v2/groups/{groupId}/peers/{peerId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -20164,8 +20158,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `containerId`, - Description: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove.`, + Name: `peerId`, + Description: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to update.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -20187,13 +20181,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `verifyConnectViaPeeringOnlyModeForOneProject`, + OperationID: `verifyGroupPrivateIpMode`, Aliases: nil, Description: `Verifies if someone set the specified project to Connect via Peering Only mode. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifyconnectviapeeringonlymodeforoneproject. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifygroupprivateipmode. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-verifyConnectViaPeeringOnlyModeForOneProject/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-networkPeering-verifyGroupPrivateIpMode/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateIpMode`, QueryParameters: []shared_api.Parameter{ @@ -20253,13 +20247,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, or removes an online archive.`, Commands: []shared_api.Command{ { - OperationID: `createOnlineArchive`, + OperationID: `createGroupClusterOnlineArchive`, Aliases: nil, Description: `Creates one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createonlinearchive. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusteronlinearchive. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-createOnlineArchive/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-createGroupClusterOnlineArchive/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives`, QueryParameters: []shared_api.Parameter{ @@ -20323,10 +20317,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getOnlineArchive`, + OperationID: `createGroupClusterOnlineArchive`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ - `archiveId`: `body:$.id`, `clusterName`: `input:clusterName`, `groupId`: `input:groupId`, }, @@ -20346,13 +20339,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteOnlineArchive`, + OperationID: `deleteGroupClusterOnlineArchive`, Aliases: nil, Description: `Removes one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteonlinearchive. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupclusteronlinearchive. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-deleteOnlineArchive/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-deleteGroupClusterOnlineArchive/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}`, QueryParameters: []shared_api.Parameter{ @@ -20426,7 +20419,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getOnlineArchive`, + OperationID: `deleteGroupClusterOnlineArchive`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `archiveId`: `input:archiveId`, @@ -20441,13 +20434,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `downloadOnlineArchiveQueryLogs`, + OperationID: `downloadGroupClusterOnlineArchiveQueryLogs`, Aliases: nil, Description: `Downloads query logs for the specified online archive. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadonlinearchivequerylogs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupclusteronlinearchivequerylogs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-downloadOnlineArchiveQueryLogs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-downloadGroupClusterOnlineArchiveQueryLogs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/queryLogs.gz`, QueryParameters: []shared_api.Parameter{ @@ -20531,13 +20524,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getOnlineArchive`, + OperationID: `getGroupClusterOnlineArchive`, Aliases: nil, Description: `Returns one online archive for one cluster. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getonlinearchive. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusteronlinearchive. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-getOnlineArchive/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-getGroupClusterOnlineArchive/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}`, QueryParameters: []shared_api.Parameter{ @@ -20611,13 +20604,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listOnlineArchives`, + OperationID: `listGroupClusterOnlineArchives`, Aliases: nil, Description: `Returns details of all online archives. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listonlinearchives. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusteronlinearchives. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-listOnlineArchives/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-listGroupClusterOnlineArchives/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives`, QueryParameters: []shared_api.Parameter{ @@ -20711,13 +20704,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateOnlineArchive`, + OperationID: `updateGroupClusterOnlineArchive`, Aliases: nil, Description: `Updates, pauses, or resumes one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateonlinearchive. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclusteronlinearchive. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-updateOnlineArchive/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-onlineArchive-updateGroupClusterOnlineArchive/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}`, QueryParameters: []shared_api.Parameter{ @@ -20791,7 +20784,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getOnlineArchive`, + OperationID: `updateGroupClusterOnlineArchive`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `archiveId`: `input:archiveId`, @@ -20820,13 +20813,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, and edits organizational units in MongoDB Cloud.`, Commands: []shared_api.Command{ { - OperationID: `createOrganization`, + OperationID: `createOrg`, Aliases: nil, Description: `Creates one organization in MongoDB Cloud and links it to the requesting Service Account's or API Key's organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. The requesting Service Account's or API Key's organization must be a paying organization. To learn more, see Configure a Paying Organization in the MongoDB Atlas documentation. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorganization. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorg. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-createOrganization/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-createOrg/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs`, QueryParameters: []shared_api.Parameter{ @@ -20865,16 +20858,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createOrganizationInvitation`, + OperationID: `createOrgInvite`, Aliases: nil, Description: `Invites one MongoDB Cloud user to join the specified organization. The user must accept the invitation to access information within the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: Invitation management APIs are deprecated. Use Add One MongoDB Cloud User to One Organization to invite a user. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorganizationinvitation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorginvite. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-createOrganizationInvitation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-createOrgInvite/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/invites`, QueryParameters: []shared_api.Parameter{ @@ -20924,7 +20917,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteOrganization`, + OperationID: `deleteOrg`, Aliases: nil, Description: `Removes one specified organization. MongoDB Cloud imposes the following limits on this resource: @@ -20936,9 +20929,9 @@ Organizations with active projects cannot be removed. All projects in the organization must be removed before you can remove the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorganization. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorg. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-deleteOrganization/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-deleteOrg/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}`, QueryParameters: []shared_api.Parameter{ @@ -20978,16 +20971,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteOrganizationInvitation`, + OperationID: `deleteOrgInvite`, Aliases: nil, Description: `Cancels one pending invitation sent to the specified MongoDB Cloud user to join an organization. You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: Invitation management APIs are deprecated. Use Remove One MongoDB Cloud User From One Organization to remove a pending user. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorganizationinvitation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorginvite. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-deleteOrganizationInvitation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-deleteOrgInvite/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/invites/{invitationId}`, QueryParameters: []shared_api.Parameter{ @@ -21047,13 +21040,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrganization`, + OperationID: `getOrg`, Aliases: nil, Description: `Returns one organization to which the requesting Service Account or API Key has access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganization. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorg. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-getOrganization/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-getOrg/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}`, QueryParameters: []shared_api.Parameter{ @@ -21103,18 +21096,32 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrganizationInvitation`, + OperationID: `getOrgGroups`, Aliases: nil, - Description: `Returns the details of one pending invitation to the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Returns multiple projects in the specified organization. Each organization can have multiple projects. Use projects to: -Note: Invitation management APIs are deprecated. Use Return One MongoDB Cloud User in One Organization to return a pending user. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationinvitation. +Isolate different environments, such as development, test, or production environments, from each other. + + +Associate different MongoDB Cloud users or teams with different environments, or give different permission to MongoDB Cloud users in different environments. + + +Maintain separate cluster security configurations. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-getOrganizationInvitation/`, + +Create different alert settings. + + + +To use this resource, the requesting Service Account or API Key must have the Organization Member role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorggroups. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-getOrgGroups/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/invites/{invitationId}`, + URL: `/api/atlas/v2/orgs/{orgId}/groups`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -21126,21 +21133,61 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, - Required: true, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `name`, + Description: `Human-readable label of the project to use to filter the returned list. Performs a case-insensitive search for a project within the organization which is prefixed by the specified name.`, + Short: ``, + Required: false, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `invitationId`, - Description: `Unique 24-hexadecimal digit string that identifies the invitation.`, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -21162,15 +21209,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrganizationSettings`, + OperationID: `getOrgInvite`, Aliases: nil, - Description: `Returns details about the specified organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + Description: `Returns the details of one pending invitation to the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + + +Note: Invitation management APIs are deprecated. Use Return One MongoDB Cloud User in One Organization to return a pending user. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationsettings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorginvite. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-getOrganizationSettings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-getOrgInvite/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/settings`, + URL: `/api/atlas/v2/orgs/{orgId}/invites/{invitationId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -21182,21 +21232,21 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Name: `invitationId`, + Description: `Unique 24-hexadecimal digit string that identifies the invitation.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -21218,18 +21268,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationInvitations`, + OperationID: `getOrgSettings`, Aliases: nil, - Description: `Returns all pending invitations to the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - - -Note: Invitation management APIs are deprecated. Use Return All MongoDB Cloud Users in One Organization and filter by orgMembershipStatus to return all pending users. + Description: `Returns details about the specified organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationinvitations. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgsettings. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-listOrganizationInvitations/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-getOrgSettings/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/invites`, + URL: `/api/atlas/v2/orgs/{orgId}/settings`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -21251,16 +21298,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `username`, - Description: `Email address of the user account invited to this organization. If you exclude this parameter, this resource returns all pending invitations.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -21287,32 +21324,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationProjects`, + OperationID: `listOrgInvites`, Aliases: nil, - Description: `Returns multiple projects in the specified organization. Each organization can have multiple projects. Use projects to: - - - -Isolate different environments, such as development, test, or production environments, from each other. - - -Associate different MongoDB Cloud users or teams with different environments, or give different permission to MongoDB Cloud users in different environments. - - -Maintain separate cluster security configurations. - - -Create different alert settings. - + Description: `Returns all pending invitations to the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -To use this resource, the requesting Service Account or API Key must have the Organization Member role. +Note: Invitation management APIs are deprecated. Use Return All MongoDB Cloud Users in One Organization and filter by orgMembershipStatus to return all pending users. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationprojects. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorginvites. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-listOrganizationProjects/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-listOrgInvites/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/groups`, + URL: `/api/atlas/v2/orgs/{orgId}/invites`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -21324,36 +21347,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, { Name: `pretty`, Description: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -21365,8 +21358,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `name`, - Description: `Human-readable label of the project to use to filter the returned list. Performs a case-insensitive search for a project within the organization which is prefixed by the specified name.`, + Name: `username`, + Description: `Email address of the user account invited to this organization. If you exclude this parameter, this resource returns all pending invitations.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -21400,13 +21393,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizations`, + OperationID: `listOrgs`, Aliases: nil, Description: `Returns all organizations to which the requesting Service Account or API Key has access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizations. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-listOrganizations/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-listOrgs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs`, QueryParameters: []shared_api.Parameter{ @@ -21485,13 +21478,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganization`, + OperationID: `updateOrg`, Aliases: nil, Description: `Updates one organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganization. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorg. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrganization/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrg/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}`, QueryParameters: []shared_api.Parameter{ @@ -21541,69 +21534,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationInvitation`, - Aliases: nil, - Description: `Updates the details of one pending invitation, identified by the username of the invited user, to the specified organization. To use this resource, the requesting API Key must have the Organization Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationinvitation. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrganizationInvitation/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/invites`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodPatch, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `updateOrganizationInvitationById`, + OperationID: `updateOrgInviteById`, Aliases: nil, Description: `Updates the details of one pending invitation, identified by its unique ID, to the specified organization. Use the Return All Organization Invitations endpoint to retrieve IDs for all pending organization invitations. To use this resource, the requesting API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationinvitationbyid. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorginvitebyid. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrganizationInvitationById/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrgInviteById/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/invites/{invitationId}`, QueryParameters: []shared_api.Parameter{ @@ -21663,19 +21600,19 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationRoles`, + OperationID: `updateOrgInvites`, Aliases: nil, - Description: `Updates the roles of the specified user in the specified organization. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization User Admin role. + Description: `Updates the details of one pending invitation, identified by the username of the invited user, to the specified organization. To use this resource, the requesting API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationroles. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorginvites. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrganizationRoles/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrgInvites/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}/roles`, + URL: `/api/atlas/v2/orgs/{orgId}/invites`, QueryParameters: []shared_api.Parameter{ { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -21684,8 +21621,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -21705,9 +21642,55 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, + }, + Verb: http.MethodPatch, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `updateOrgSettings`, + Aliases: nil, + Description: `Updates the organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorgsettings. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrgSettings/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/orgs/{orgId}/settings`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, { - Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the user to modify.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -21716,7 +21699,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - Verb: http.MethodPut, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { @@ -21729,19 +21712,19 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationSettings`, + OperationID: `updateOrgUserRoles`, Aliases: nil, - Description: `Updates the organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Updates the roles of the specified user in the specified organization. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization User Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationsettings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorguserroles. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrganizationSettings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-organizations-updateOrgUserRoles/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/settings`, + URL: `/api/atlas/v2/orgs/{orgId}/users/{userId}/roles`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -21750,8 +21733,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -21771,8 +21754,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, + { + Name: `userId`, + Description: `Unique 24-hexadecimal digit string that identifies the user to modify.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodPatch, + Verb: http.MethodPut, }, Versions: []shared_api.CommandVersion{ { @@ -21791,13 +21784,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns suggested indexes and slow query data for a database deployment. Also enables or disables MongoDB Cloud-managed slow operation thresholds. To view field values in a sample query, you must have the Project Data Access Read Only role or higher. Otherwise, MongoDB Cloud returns redacted data rather than the field values.`, Commands: []shared_api.Command{ { - OperationID: `disableSlowOperationThresholding`, + OperationID: `disableGroupManagedSlowMs`, Aliases: nil, Description: `Disables the slow operation threshold that MongoDB Cloud calculated for the specified project. The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disableslowoperationthresholding. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablegroupmanagedslowms. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-disableSlowOperationThresholding/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-disableGroupManagedSlowMs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/managedSlowMs/disable`, QueryParameters: []shared_api.Parameter{ @@ -21851,13 +21844,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `enableSlowOperationThresholding`, + OperationID: `enableGroupManagedSlowMs`, Aliases: nil, Description: `Enables MongoDB Cloud to use its slow operation threshold for the specified project. The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-enableslowoperationthresholding. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-enablegroupmanagedslowms. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-enableSlowOperationThresholding/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-enableGroupManagedSlowMs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/managedSlowMs/enable`, QueryParameters: []shared_api.Parameter{ @@ -21911,13 +21904,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getManagedSlowMs`, + OperationID: `getGroupManagedSlowMs`, Aliases: nil, Description: `Get whether the Managed Slow MS feature is enabled. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmanagedslowms. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupmanagedslowms. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-getManagedSlowMs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-getGroupManagedSlowMs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/managedSlowMs`, QueryParameters: []shared_api.Parameter{ @@ -21971,13 +21964,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessAutoIndexing`, + OperationID: `getGroupServerlessPerformanceAdvisorAutoIndexing`, Aliases: nil, Description: `Get whether the Serverless Auto Indexing feature is enabled. This endpoint returns a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessautoindexing. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserverlessperformanceadvisorautoindexing. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-getServerlessAutoIndexing/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-getGroupServerlessPerformanceAdvisorAutoIndexing/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/performanceAdvisor/autoIndexing`, QueryParameters: []shared_api.Parameter{ @@ -22041,13 +22034,111 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClusterSuggestedIndexes`, + OperationID: `listGroupClusterPerformanceAdvisorDropIndexSuggestions`, + Aliases: nil, + Description: `Returns the indexes that the Performance Advisor suggests to drop. The Performance Advisor suggests dropping unused, redundant, and hidden indexes to improve write performance and increase storage space. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterperformanceadvisordropindexsuggestions. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorDropIndexSuggestions/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/dropIndexSuggestions`, + QueryParameters: []shared_api.Parameter{}, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `clusterName`, + Description: `Human-readable label that identifies the cluster.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2024, 8, 5), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `listGroupClusterPerformanceAdvisorSchemaAdvice`, + Aliases: nil, + Description: `Returns the schema suggestions that the Performance Advisor detects. The Performance Advisor provides holistic schema recommendations for your cluster by sampling documents in your most active collections and collections with slow-running queries. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterperformanceadvisorschemaadvice. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSchemaAdvice/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/schemaAdvice`, + QueryParameters: []shared_api.Parameter{}, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `clusterName`, + Description: `Human-readable label that identifies the cluster.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2024, 8, 5), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `listGroupClusterPerformanceAdvisorSuggestedIndexes`, Aliases: nil, Description: `Returns the indexes that the Performance Advisor suggests. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclustersuggestedindexes. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterperformanceadvisorsuggestedindexes. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listClusterSuggestedIndexes/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listGroupClusterPerformanceAdvisorSuggestedIndexes/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/suggestedIndexes`, QueryParameters: []shared_api.Parameter{ @@ -22145,65 +22236,71 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDropIndexes`, + OperationID: `listGroupProcessPerformanceAdvisorNamespaces`, Aliases: nil, - Description: `Returns the indexes that the Performance Advisor suggests to drop. The Performance Advisor suggests dropping unused, redundant, and hidden indexes to improve write performance and increase storage space. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns up to 20 namespaces for collections experiencing slow queries on the specified host. If you specify a secondary member of a replica set that hasn't received any database read operations, the endpoint doesn't return any namespaces. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdropindexes. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessperformanceadvisornamespaces. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listDropIndexes/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorNamespaces/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/dropIndexSuggestions`, - QueryParameters: []shared_api.Parameter{}, - URLParameters: []shared_api.Parameter{ + URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/namespaces`, + QueryParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, }, - Aliases: []string{`projectId`}, }, { - Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, }, }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2024, 8, 5), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, + { + Name: `duration`, + Description: `Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. + + + +If you don't specify the since parameter, the endpoint returns data covering the duration before the current time. + + +If you specify neither the duration nor since parameters, the endpoint returns data from the previous 24 hours.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, }, - }, - }, - }, - { - OperationID: `listSchemaAdvice`, - Aliases: nil, - Description: `Returns the schema suggestions that the Performance Advisor detects. The Performance Advisor provides holistic schema recommendations for your cluster by sampling documents in your most active collections and collections with slow-running queries. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + { + Name: `since`, + Description: `Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the UNIX epoch. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listschemaadvice. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listSchemaAdvice/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/schemaAdvice`, - QueryParameters: []shared_api.Parameter{}, + +If you don't specify the duration parameter, the endpoint returns data covering from the since value and the current time. + + +If you specify neither the duration nor the since parameters, the endpoint returns data from the previous 24 hours.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + }, URLParameters: []shared_api.Parameter{ { Name: `groupId`, @@ -22220,8 +22317,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `clusterName`, - Description: `Human-readable label that identifies the cluster.`, + Name: `processId`, + Description: `Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -22234,7 +22331,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 8, 5), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -22243,13 +22340,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSlowQueries`, + OperationID: `listGroupProcessPerformanceAdvisorSlowQueryLogs`, Aliases: nil, Description: `Returns log lines for slow queries that the Performance Advisor and Query Profiler identified. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. MongoDB Cloud bases the threshold for slow queries on the average time of operations on your cluster. This enables workload-relevant recommendations. To use this resource, the requesting Service Account or API Key must have any Project Data Access role or the Project Observability Viewer role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listslowqueries. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessperformanceadvisorslowquerylogs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listSlowQueries/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSlowQueryLogs/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/slowQueryLogs`, QueryParameters: []shared_api.Parameter{ @@ -22397,117 +22494,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSlowQueryNamespaces`, - Aliases: nil, - Description: `Returns up to 20 namespaces for collections experiencing slow queries on the specified host. If you specify a secondary member of a replica set that hasn't received any database read operations, the endpoint doesn't return any namespaces. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listslowquerynamespaces. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listSlowQueryNamespaces/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/namespaces`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `duration`, - Description: `Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. - - - -If you don't specify the since parameter, the endpoint returns data covering the duration before the current time. - - -If you specify neither the duration nor since parameters, the endpoint returns data from the previous 24 hours.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `since`, - Description: `Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the UNIX epoch. - - - -If you don't specify the duration parameter, the endpoint returns data covering from the since value and the current time. - - -If you specify neither the duration nor the since parameters, the endpoint returns data from the previous 24 hours.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - { - Name: `processId`, - Description: `Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `listSuggestedIndexes`, + OperationID: `listGroupProcessPerformanceAdvisorSuggestedIndexes`, Aliases: nil, Description: `Returns the indexes that the Performance Advisor suggests. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsuggestedindexes. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprocessperformanceadvisorsuggestedindexes. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listSuggestedIndexes/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-listGroupProcessPerformanceAdvisorSuggestedIndexes/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/suggestedIndexes`, QueryParameters: []shared_api.Parameter{ @@ -22665,13 +22658,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `setServerlessAutoIndexing`, + OperationID: `setGroupServerlessPerformanceAdvisorAutoIndexing`, Aliases: nil, Description: `Set whether the Serverless Auto Indexing feature is enabled. This endpoint sets a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setserverlessautoindexing. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setgroupserverlessperformanceadvisorautoindexing. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-setServerlessAutoIndexing/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-performanceAdvisor-setGroupServerlessPerformanceAdvisorAutoIndexing/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serverless/{clusterName}/performanceAdvisor/autoIndexing`, QueryParameters: []shared_api.Parameter{ @@ -22741,13 +22734,91 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes private endpoint services.`, Commands: []shared_api.Command{ { - OperationID: `createPrivateEndpoint`, + OperationID: `createGroupPrivateEndpointEndpointService`, + Aliases: nil, + Description: `Creates one private endpoint service for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. When you create a private endpoint service, MongoDB Cloud creates a network container in the project for the cloud provider for which you create the private endpoint service if one doesn't already exist. To learn more about private endpoint terminology in MongoDB Cloud, see Private Endpoint Concepts. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupprivateendpointendpointservice. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointService/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/endpointService`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + }, + Verb: http.MethodPost, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + Watcher: &shared_api.WatcherProperties{ + Get: shared_api.WatcherGetProperties{ + OperationID: `createGroupPrivateEndpointEndpointService`, + Version: shared_api.NewStableVersion(2023, 1, 1), + Params: map[string]string{ + `groupId`: `input:groupId`, + }, + }, + Expect: &shared_api.WatcherExpectProperties{ + Match: &shared_api.WatcherMatchProperties{ + Path: `$.status`, + Values: []string{ + `WAITING_FOR_USER`, + `FAILED`, + }, + }, + }, + }, + }, + { + OperationID: `createGroupPrivateEndpointEndpointServiceEndpoint`, Aliases: nil, Description: `Creates one private endpoint for the specified cloud service provider. This cloud service provider manages the private endpoint service, which in turn manages the private endpoints for the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations, limitations, and prerequisites, see the MongoDB documentation for setting up a private endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupprivateendpointendpointserviceendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-createPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-createGroupPrivateEndpointEndpointServiceEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}/endpoint`, QueryParameters: []shared_api.Parameter{ @@ -22821,15 +22892,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createPrivateEndpointService`, + OperationID: `deleteGroupPrivateEndpointEndpointService`, Aliases: nil, - Description: `Creates one private endpoint service for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. When you create a private endpoint service, MongoDB Cloud creates a network container in the project for the cloud provider for which you create the private endpoint service if one doesn't already exist. To learn more about private endpoint terminology in MongoDB Cloud, see Private Endpoint Concepts. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Removes one private endpoint service from the specified project. This cloud service provider manages the private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivateendpointservice. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupprivateendpointendpointservice. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-createPrivateEndpointService/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointService/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/endpointService`, + URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -22867,13 +22938,33 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `cloudProvider`, + Description: `Cloud service provider that manages this private endpoint service.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `endpointServiceId`, + Description: `Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to delete.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodPost, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -22881,7 +22972,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getPrivateEndpointService`, + OperationID: `deleteGroupPrivateEndpointEndpointService`, Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `cloudProvider`: `body:$.cloudProvider`, @@ -22890,24 +22981,19 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, Expect: &shared_api.WatcherExpectProperties{ - Match: &shared_api.WatcherMatchProperties{ - Path: `$.status`, - Values: []string{ - `WAITING_FOR_USER`, - `FAILED`, - }, - }, + HTTPCode: 404, //nolint + Match: nil, }, }, }, { - OperationID: `deletePrivateEndpoint`, + OperationID: `deleteGroupPrivateEndpointEndpointServiceEndpoint`, Aliases: nil, Description: `Removes one private endpoint from the specified project and private endpoint service, as managed by the specified cloud service provider. When the last private endpoint is removed from a given private endpoint service, that private endpoint service is also removed. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupprivateendpointendpointserviceendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-deletePrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-deleteGroupPrivateEndpointEndpointServiceEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}/endpoint/{endpointId}`, QueryParameters: []shared_api.Parameter{ @@ -22991,13 +23077,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePrivateEndpointService`, + OperationID: `getGroupPrivateEndpointEndpointService`, Aliases: nil, - Description: `Removes one private endpoint service from the specified project. This cloud service provider manages the private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Returns the name, interfaces, and state of the specified private endpoint service from one project. The cloud service provider hosted this private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivateendpointservice. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivateendpointendpointservice. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-deletePrivateEndpointService/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointService/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}`, QueryParameters: []shared_api.Parameter{ @@ -23039,7 +23125,97 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `cloudProvider`, - Description: `Cloud service provider that manages this private endpoint service.`, + Description: `Cloud service provider that manages this private endpoint service.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `endpointServiceId`, + Description: `Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to return.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `getGroupPrivateEndpointEndpointServiceEndpoint`, + Aliases: nil, + Description: `Returns the connection state of the specified private endpoint. The private endpoint service manages this private endpoint which belongs to one project hosted from one cloud service provider. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivateendpointendpointserviceendpoint. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointEndpointServiceEndpoint/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}/endpoint/{endpointId}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `cloudProvider`, + Description: `Cloud service provider that manages this private endpoint.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `endpointId`, + Description: `Unique string that identifies the private endpoint you want to return. The format of the endpointId parameter differs for AWS and Azure. You must URL encode the endpointId for Azure private endpoints.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -23049,7 +23225,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `endpointServiceId`, - Description: `Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to delete.`, + Description: `Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to return a private endpoint.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -23058,7 +23234,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -23069,32 +23245,17 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Watcher: &shared_api.WatcherProperties{ - Get: shared_api.WatcherGetProperties{ - OperationID: `getPrivateEndpointService`, - Version: shared_api.NewStableVersion(2023, 1, 1), - Params: map[string]string{ - `cloudProvider`: `body:$.cloudProvider`, - `endpointServiceId`: `body:$.id`, - `groupId`: `input:groupId`, - }, - }, - Expect: &shared_api.WatcherExpectProperties{ - HTTPCode: 404, //nolint - Match: nil, - }, - }, }, { - OperationID: `getPrivateEndpoint`, + OperationID: `getGroupPrivateEndpointRegionalMode`, Aliases: nil, - Description: `Returns the connection state of the specified private endpoint. The private endpoint service manages this private endpoint which belongs to one project hosted from one cloud service provider. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. The cloud service provider manages the private endpoint for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivateendpointregionalmode. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-getPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-getGroupPrivateEndpointRegionalMode/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}/endpoint/{endpointId}`, + URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/regionalMode`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23132,36 +23293,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `cloudProvider`, - Description: `Cloud service provider that manages this private endpoint.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `endpointId`, - Description: `Unique string that identifies the private endpoint you want to return. The format of the endpointId parameter differs for AWS and Azure. You must URL encode the endpointId for Azure private endpoints.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `endpointServiceId`, - Description: `Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to return a private endpoint.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -23176,15 +23307,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPrivateEndpointService`, + OperationID: `listGroupPrivateEndpointEndpointService`, Aliases: nil, - Description: `Returns the name, interfaces, and state of the specified private endpoint service from one project. The cloud service provider hosted this private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivateendpointservice. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprivateendpointendpointservice. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-getPrivateEndpointService/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-listGroupPrivateEndpointEndpointService/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}`, + URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23232,16 +23363,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Type: `string`, }, }, - { - Name: `endpointServiceId`, - Description: `Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to return.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -23256,13 +23377,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getRegionalizedPrivateEndpointSetting`, + OperationID: `toggleGroupPrivateEndpointRegionalMode`, Aliases: nil, - Description: `Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. The cloud service provider manages the private endpoint for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. The cloud service provider manages the private endpoints for the project. Connection strings to existing multi-region and global sharded clusters change when you enable this setting. You must update your applications to use the new connection strings. This might cause downtime. To use this resource, the requesting Service Account or API Key must have the Project Owner role and all clusters in the deployment must be sharded clusters. Once enabled, you cannot create replica sets. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getregionalizedprivateendpointsetting. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglegroupprivateendpointregionalmode. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-getRegionalizedPrivateEndpointSetting/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-toggleGroupPrivateEndpointRegionalMode/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/regionalMode`, QueryParameters: []shared_api.Parameter{ @@ -23303,28 +23424,34 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, }, - Verb: http.MethodGet, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, }, }, }, + }, + }, + { + Name: `Programmatic API Keys`, + Description: `Returns, adds, edits, and removes access tokens to use the MongoDB Cloud API. MongoDB Cloud applies these keys to organizations. These resources can return, assign, or revoke use of these keys within a specified project.`, + Commands: []shared_api.Command{ { - OperationID: `listPrivateEndpointServices`, + OperationID: `addGroupApiKey`, Aliases: nil, - Description: `Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can then use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprivateendpointservices. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupapikey. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-listPrivateEndpointServices/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-addGroupApiKey/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService`, + URL: `/api/atlas/v2/groups/{groupId}/apiKeys/{apiUserId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23363,8 +23490,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `cloudProvider`, - Description: `Cloud service provider that manages this private endpoint service.`, + Name: `apiUserId`, + Description: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to assign to one project.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -23373,67 +23500,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `toggleRegionalizedPrivateEndpointSetting`, - Aliases: nil, - Description: `Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. The cloud service provider manages the private endpoints for the project. Connection strings to existing multi-region and global sharded clusters change when you enable this setting. You must update your applications to use the new connection strings. This might cause downtime. To use this resource, the requesting Service Account or API Key must have the Project Owner role and all clusters in the deployment must be sharded clusters. Once enabled, you cannot create replica sets. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-toggleregionalizedprivateendpointsetting. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-privateEndpointServices-toggleRegionalizedPrivateEndpointSetting/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/regionalMode`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - }, - Verb: http.MethodPatch, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { @@ -23445,22 +23512,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - }, - }, - { - Name: `Programmatic API Keys`, - Description: `Returns, adds, edits, and removes access tokens to use the MongoDB Cloud API. MongoDB Cloud applies these keys to organizations. These resources can return, assign, or revoke use of these keys within a specified project.`, - Commands: []shared_api.Command{ { - OperationID: `addProjectApiKey`, + OperationID: `createGroupApiKey`, Aliases: nil, - Description: `Assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can then use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Creates and assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectapikey. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupapikey. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-addProjectApiKey/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-createGroupApiKey/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/apiKeys/{apiUserId}`, + URL: `/api/atlas/v2/groups/{groupId}/apiKeys`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23498,16 +23559,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `apiUserId`, - Description: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to assign to one project.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodPost, }, @@ -23522,13 +23573,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createApiKey`, + OperationID: `createOrgApiKey`, Aliases: nil, Description: `Creates one API key for the specified organization. An organization API key grants programmatic access to an organization. You can't use the API key to log into the console. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikey. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgapikey. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-createApiKey/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-createOrgApiKey/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/apiKeys`, QueryParameters: []shared_api.Parameter{ @@ -23578,13 +23629,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createApiKeyAccessList`, + OperationID: `createOrgApiKeyAccessListEntry`, Aliases: nil, Description: `Creates the access list entries for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikeyaccesslist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgapikeyaccesslistentry. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-createApiKeyAccessList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-createOrgApiKeyAccessListEntry/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList`, QueryParameters: []shared_api.Parameter{ @@ -23674,15 +23725,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createProjectApiKey`, + OperationID: `deleteOrgApiKey`, Aliases: nil, - Description: `Creates and assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Removes one organization API key from the specified organization. When you remove an API key from an organization, MongoDB Cloud also removes that key from any projects that use that key. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectapikey. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgapikey. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-createProjectApiKey/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-deleteOrgApiKey/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/apiKeys`, + URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23707,26 +23758,32 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `apiUserId`, + Description: `Unique 24-hexadecimal digit string that identifies this organization API key.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, - Verb: http.MethodPost, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -23734,15 +23791,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteApiKey`, + OperationID: `deleteOrgApiKeyAccessListEntry`, Aliases: nil, - Description: `Removes one organization API key from the specified organization. When you remove an API key from an organization, MongoDB Cloud also removes that key from any projects that use that key. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. + Description: `Removes the specified access list entry from the specified organization API key. Resources require all API requests originate from the IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. In addition, you cannot remove the requesting IP address from the requesting organization API key. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteapikey. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgapikeyaccesslistentry. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-deleteApiKey/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-deleteOrgApiKeyAccessListEntry/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}`, + URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList/{ipAddress}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23778,7 +23835,17 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, { Name: `apiUserId`, - Description: `Unique 24-hexadecimal digit string that identifies this organization API key.`, + Description: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to remove access list entries.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `ipAddress`, + Description: `One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -23800,15 +23867,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteApiKeyAccessListEntry`, + OperationID: `getOrgApiKey`, Aliases: nil, - Description: `Removes the specified access list entry from the specified organization API key. Resources require all API requests originate from the IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. In addition, you cannot remove the requesting IP address from the requesting organization API key. + Description: `Returns one organization API key. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the user interface. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteapikeyaccesslistentry. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgapikey. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-deleteApiKeyAccessListEntry/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-getOrgApiKey/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList/{ipAddress}`, + URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23844,17 +23911,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, { Name: `apiUserId`, - Description: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to remove access list entries.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `ipAddress`, - Description: `One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, + Description: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to update.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -23863,7 +23920,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -23876,15 +23933,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getApiKey`, + OperationID: `getOrgApiKeyAccessListEntry`, Aliases: nil, - Description: `Returns one organization API key. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the user interface. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + Description: `Returns one access list entry for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getapikey. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgapikeyaccesslistentry. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-getApiKey/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-getOrgApiKeyAccessListEntry/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}`, + URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList/{ipAddress}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23918,9 +23975,19 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, + { + Name: `ipAddress`, + Description: `One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, { Name: `apiUserId`, - Description: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to update.`, + Description: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -23942,15 +24009,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getApiKeyAccessList`, + OperationID: `listGroupApiKeys`, Aliases: nil, - Description: `Returns one access list entry for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + Description: `Returns all organization API keys that you assigned to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getapikeyaccesslist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupapikeys. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-getApiKeyAccessList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-listGroupApiKeys/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList/{ipAddress}`, + URL: `/api/atlas/v2/groups/{groupId}/apiKeys`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -23963,8 +24030,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -23972,37 +24039,51 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, }, { - Name: `ipAddress`, - Description: `One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, }, { - Name: `apiUserId`, - Description: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, - Required: true, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, }, Verb: http.MethodGet, @@ -24018,13 +24099,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listApiKeyAccessListsEntries`, + OperationID: `listOrgApiKeyAccessListEntries`, Aliases: nil, Description: `Returns all access list entries that you configured for the specified organization API key. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listapikeyaccesslistsentries. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgapikeyaccesslistentries. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-listApiKeyAccessListsEntries/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-listOrgApiKeyAccessListEntries/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList`, QueryParameters: []shared_api.Parameter{ @@ -24114,13 +24195,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listApiKeys`, + OperationID: `listOrgApiKeys`, Aliases: nil, Description: `Returns all organization API keys for the specified organization. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the console. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listapikeys. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgapikeys. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-listApiKeys/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-listOrgApiKeys/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/apiKeys`, QueryParameters: []shared_api.Parameter{ @@ -24200,15 +24281,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listProjectApiKeys`, + OperationID: `removeGroupApiKey`, Aliases: nil, - Description: `Returns all organization API keys that you assigned to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Removes one organization API key from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectapikeys. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removegroupapikey. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-listProjectApiKeys/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-removeGroupApiKey/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/apiKeys`, + URL: `/api/atlas/v2/groups/{groupId}/apiKeys/{apiUserId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -24220,36 +24301,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, { Name: `pretty`, Description: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -24276,8 +24327,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `apiUserId`, + Description: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodGet, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { @@ -24290,19 +24351,39 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeProjectApiKey`, + OperationID: `updateGroupApiKeyRoles`, Aliases: nil, - Description: `Removes one organization API key from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Updates the roles of the organization API key that you specify for the project that you specify. You must specify at least one valid role for the project. The application removes any roles that you do not include in this request if they were previously set in the organization API key that you specify for the project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectapikey. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupapikeyroles. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-removeProjectApiKey/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-updateGroupApiKeyRoles/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/apiKeys/{apiUserId}`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -24320,6 +24401,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -24347,12 +24438,12 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, @@ -24360,13 +24451,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateApiKey`, + OperationID: `updateOrgApiKey`, Aliases: nil, Description: `Updates one organization API key in the specified organization. The organization API keys grant programmatic access to an organization. To use this resource, the requesting API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateapikey. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorgapikey. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-updateApiKey/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-updateOrgApiKey/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}`, QueryParameters: []shared_api.Parameter{ @@ -24425,60 +24516,66 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, + }, + }, + { + Name: `Project IP Access List`, + Description: `Returns, adds, edits, and removes network access limits to database deployments in Atlas. This resource replaces the whitelist resource. Atlas removed whitelists in July 2021. Update your applications to use this new resource. This resource manages a project's IP Access List and supports creating temporary Access List entries that automatically expire within a user-configurable 7-day period.`, + Commands: []shared_api.Command{ { - OperationID: `updateApiKeyRoles`, + OperationID: `createGroupAccessListEntry`, Aliases: nil, - Description: `Updates the roles of the organization API key that you specify for the project that you specify. You must specify at least one valid role for the project. The application removes any roles that you do not include in this request if they were previously set in the organization API key that you specify for the project. + Description: `Adds one or more access list entries to the specified project. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. Write each entry as either one IP address or one CIDR-notated block of IP addresses. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. This endpoint doesn't support concurrent POST requests. You must submit multiple POST requests synchronously. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateapikeyroles. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupaccesslistentry. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-programmaticApiKeys-updateApiKeyRoles/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-createGroupAccessListEntry/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/apiKeys/{apiUserId}`, + URL: `/api/atlas/v2/groups/{groupId}/accessList`, QueryParameters: []shared_api.Parameter{ { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, }, }, { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -24502,18 +24599,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `apiUserId`, - Description: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodPatch, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { @@ -24525,22 +24612,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - }, - }, - { - Name: `Project IP Access List`, - Description: `Returns, adds, edits, and removes network access limits to database deployments in Atlas. This resource replaces the whitelist resource. Atlas removed whitelists in July 2021. Update your applications to use this new resource. This resource manages a project's IP Access List and supports creating temporary Access List entries that automatically expire within a user-configurable 7-day period.`, - Commands: []shared_api.Command{ { - OperationID: `createProjectIpAccessList`, + OperationID: `deleteGroupAccessListEntry`, Aliases: nil, - Description: `Adds one or more access list entries to the specified project. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. Write each entry as either one IP address or one CIDR-notated block of IP addresses. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. This endpoint doesn't support concurrent POST requests. You must submit multiple POST requests synchronously. + Description: `Removes one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains one IP address, one CIDR-notated block of IP addresses, or one AWS Security Group ID. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectipaccesslist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupaccesslistentry. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-createProjectIpAccessList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-deleteGroupAccessListEntry/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/accessList`, + URL: `/api/atlas/v2/groups/{groupId}/accessList/{entryValue}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -24553,8 +24634,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -24562,24 +24643,74 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, + Aliases: []string{`projectId`}, }, { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `entryValue`, + Description: `Access list entry that you want to remove from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (/) with its URL-encoded value (%2F). When you remove an entry from the IP access list, existing connections from the removed address or addresses may remain open for a variable amount of time. The amount of time it takes MongoDB Cloud to close the connection depends upon several factors, including: + + + +how your application established the connection, + + +how MongoDB Cloud or the driver using the address behaves, and + + +which protocol (like TCP or UDP) the connection uses.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodDelete, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `getGroupAccessListEntry`, + Aliases: nil, + Description: `Returns one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. This endpoint (/groups/{GROUP-ID}/accessList) manages the Project IP Access List. It doesn't manage the access list for MongoDB Cloud organizations. TheProgrammatic API Keys endpoint (/orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist) manages those access lists. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupaccesslistentry. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-getGroupAccessListEntry/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/accessList/{entryValue}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { @@ -24608,13 +24739,23 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `entryValue`, + Description: `Access list entry that you want to return from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (/) with its URL-encoded value (%2F).`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodPost, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -24622,15 +24763,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectIpAccessList`, + OperationID: `getGroupAccessListStatus`, Aliases: nil, - Description: `Removes one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains one IP address, one CIDR-notated block of IP addresses, or one AWS Security Group ID. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. + Description: `Returns the status of one project IP access list entry. This resource checks if the provided project IP access list entry applies to all cloud providers serving clusters from the specified project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectipaccesslist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupaccessliststatus. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-deleteProjectIpAccessList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-getGroupAccessListStatus/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/accessList/{entryValue}`, + URL: `/api/atlas/v2/groups/{groupId}/accessList/{entryValue}/status`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -24669,27 +24810,17 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `entryValue`, - Description: `Access list entry that you want to remove from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (/) with its URL-encoded value (%2F). When you remove an entry from the IP access list, existing connections from the removed address or addresses may remain open for a variable amount of time. The amount of time it takes MongoDB Cloud to close the connection depends upon several factors, including: - - - -how your application established the connection, - - -how MongoDB Cloud or the driver using the address behaves, and - - -which protocol (like TCP or UDP) the connection uses.`, - Short: ``, - Required: true, + Name: `entryValue`, + Description: `Network address or cloud provider security construct that identifies which project access list entry to be verified.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -24702,15 +24833,15 @@ which protocol (like TCP or UDP) the connection uses.`, }, }, { - OperationID: `getProjectIpAccessListStatus`, + OperationID: `listGroupAccessListEntries`, Aliases: nil, - Description: `Returns the status of one project IP access list entry. This resource checks if the provided project IP access list entry applies to all cloud providers serving clusters from the specified project. + Description: `Returns all access list entries from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectipaccessliststatus. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupaccesslistentries. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-getProjectIpAccessListStatus/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-listGroupAccessListEntries/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/accessList/{entryValue}/status`, + URL: `/api/atlas/v2/groups/{groupId}/accessList`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -24722,6 +24853,36 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, { Name: `pretty`, Description: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -24748,16 +24909,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `entryValue`, - Description: `Network address or cloud provider security construct that identifies which project access list entry to be verified.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -24771,20 +24922,26 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, + }, + }, + { + Name: `Projects`, + Description: `Returns, adds, and edits collections of clusters and users in MongoDB Cloud.`, + Commands: []shared_api.Command{ { - OperationID: `getProjectIpList`, + OperationID: `addGroupAccessUser`, Aliases: nil, - Description: `Returns one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. This endpoint (/groups/{GROUP-ID}/accessList) manages the Project IP Access List. It doesn't manage the access list for MongoDB Cloud organizations. TheProgrammatic API Keys endpoint (/orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist) manages those access lists. + Description: `Adds one MongoDB Cloud user to the specified project. If the MongoDB Cloud user is not a member of the project's organization, then the user must accept their invitation to the organization to access information within the specified project. If the MongoDB Cloud User is already a member of the project's organization, then they will be added to the project immediately and an invitation will not be returned by this resource. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectiplist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupaccessuser. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-getProjectIpList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-addGroupAccessUser/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/accessList/{entryValue}`, + URL: `/api/atlas/v2/groups/{groupId}/access`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -24793,8 +24950,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -24818,39 +24975,30 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `entryValue`, - Description: `Access list entry that you want to return from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (/) with its URL-encoded value (%2F).`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodGet, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + Version: shared_api.NewStableVersion(2023, 2, 1), + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, + `json`, }, }, }, }, { - OperationID: `listProjectIpAccessLists`, + OperationID: `createGroup`, Aliases: nil, - Description: `Returns all access list entries from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. + Description: `Creates one project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Read Write role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectipaccesslists. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroup. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projectIpAccessList-listProjectIpAccessLists/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-createGroup/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/accessList`, + URL: `/api/atlas/v2/groups`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -24862,36 +25010,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, { Name: `pretty`, Description: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -24902,51 +25020,40 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `projectOwnerId`, + Description: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user to whom to grant the Project Owner role on the specified project. If you set this parameter, it overrides the default value of the oldest Organization Owner.`, + Short: ``, + Required: false, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, - Verb: http.MethodGet, + URLParameters: []shared_api.Parameter{}, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, }, }, }, - }, - }, - { - Name: `Projects`, - Description: `Returns, adds, and edits collections of clusters and users in MongoDB Cloud.`, - Commands: []shared_api.Command{ { - OperationID: `addUserToProject`, + OperationID: `createGroupInvite`, Aliases: nil, - Description: `Adds one MongoDB Cloud user to the specified project. If the MongoDB Cloud user is not a member of the project's organization, then the user must accept their invitation to the organization to access information within the specified project. If the MongoDB Cloud User is already a member of the project's organization, then they will be added to the project immediately and an invitation will not be returned by this resource. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. + Description: `Invites one MongoDB Cloud user to join the specified project. The MongoDB Cloud user must accept the invitation to access information within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addusertoproject. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupinvite. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-addUserToProject/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-createGroupInvite/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/access`, + URL: `/api/atlas/v2/groups/{groupId}/invites`, QueryParameters: []shared_api.Parameter{ { Name: `pretty`, @@ -24989,25 +25096,24 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 2, 1), + Version: shared_api.NewStableVersion(2023, 1, 1), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, - `json`, }, }, }, }, { - OperationID: `createProject`, + OperationID: `deleteGroup`, Aliases: nil, - Description: `Creates one project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Read Write role. + Description: `Removes the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. You can delete a project only if there are no Online Archives for the clusters in the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createproject. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroup. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-createProject/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-deleteGroup/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups`, + URL: `/api/atlas/v2/groups/{groupId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -25029,24 +25135,29 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `projectOwnerId`, - Description: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user to whom to grant the Project Owner role on the specified project. If you set this parameter, it overrides the default value of the oldest Organization Owner.`, - Short: ``, - Required: false, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, }, - URLParameters: []shared_api.Parameter{}, - Verb: http.MethodPost, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -25054,26 +25165,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createProjectInvitation`, + OperationID: `deleteGroupInvite`, Aliases: nil, - Description: `Invites one MongoDB Cloud user to join the specified project. The MongoDB Cloud user must accept the invitation to access information within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectinvitation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupinvite. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-createProjectInvitation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-deleteGroupInvite/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/invites`, + URL: `/api/atlas/v2/groups/{groupId}/invites/{invitationId}`, QueryParameters: []shared_api.Parameter{ - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, { Name: `envelope`, Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -25100,13 +25201,23 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `invitationId`, + Description: `Unique 24-hexadecimal digit string that identifies the invitation.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodPost, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: `json`, + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -25114,15 +25225,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProject`, + OperationID: `deleteGroupLimit`, Aliases: nil, - Description: `Removes the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. You can delete a project only if there are no Online Archives for the clusters in the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Removes the specified project limit. Depending on the limit, Atlas either resets the limit to its default value or removes the limit entirely. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteproject. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegrouplimit. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-deleteProject/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-deleteGroupLimit/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}`, + URL: `/api/atlas/v2/groups/{groupId}/limits/{limitName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -25146,6 +25257,32 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, URLParameters: []shared_api.Parameter{ + { + Name: `limitName`, + Description: `Human-readable label that identifies this project limit. + + +| Limit Name | Description | Default | API Override Limit | +| --- | --- | --- | --- | +| atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | +| atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | +| atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | +| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | +| atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | +| atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | +| dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | +| dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | +| dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | +| dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | +| atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| +| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27|`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, { Name: `groupId`, Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. @@ -25174,15 +25311,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectInvitation`, + OperationID: `getGroup`, Aliases: nil, - Description: `Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Returns details about the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectinvitation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroup. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-deleteProjectInvitation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getGroup/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/invites/{invitationId}`, + URL: `/api/atlas/v2/groups/{groupId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -25194,6 +25331,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -25210,18 +25357,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `invitationId`, - Description: `Unique 24-hexadecimal digit string that identifies the invitation.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -25234,15 +25371,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectLimit`, + OperationID: `getGroupByName`, Aliases: nil, - Description: `Removes the specified project limit. Depending on the limit, Atlas either resets the limit to its default value or removes the limit entirely. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Returns details about the project identified by its name. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectlimit. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupbyname. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-deleteProjectLimit/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getGroupByName/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/limits/{limitName}`, + URL: `/api/atlas/v2/groups/byName/{groupName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -25267,48 +25404,17 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `limitName`, - Description: `Human-readable label that identifies this project limit. - - -| Limit Name | Description | Default | API Override Limit | -| --- | --- | --- | --- | -| atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | -| atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | -| atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | -| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | -| atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | -| atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | -| dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | -| dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | -| dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | -| dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | -| atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| -| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| -| atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 |`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `groupName`, + Description: `Human-readable label that identifies this project.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -25321,15 +25427,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProject`, + OperationID: `getGroupInvite`, Aliases: nil, - Description: `Returns details about the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns the details of one pending invitation to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getproject. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupinvite. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getProject/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getGroupInvite/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}`, + URL: `/api/atlas/v2/groups/{groupId}/invites/{invitationId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -25367,55 +25473,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `getProjectByName`, - Aliases: nil, - Description: `Returns details about the project identified by its name. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectbyname. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getProjectByName/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/byName/{groupName}`, - QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupName`, - Description: `Human-readable label that identifies this project.`, + Name: `invitationId`, + Description: `Unique 24-hexadecimal digit string that identifies the invitation.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -25437,15 +25497,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectInvitation`, + OperationID: `getGroupIpAddresses`, Aliases: nil, - Description: `Returns the details of one pending invitation to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Returns all IP addresses for this project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectinvitation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupipaddresses. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getProjectInvitation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getGroupIpAddresses/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/invites/{invitationId}`, + URL: `/api/atlas/v2/groups/{groupId}/ipAddresses`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -25483,16 +25543,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `invitationId`, - Description: `Unique 24-hexadecimal digit string that identifies the invitation.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -25507,13 +25557,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProjectLimit`, + OperationID: `getGroupLimit`, Aliases: nil, Description: `Returns the specified limit for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectlimit. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouplimit. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getProjectLimit/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getGroupLimit/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/limits/{limitName}`, QueryParameters: []shared_api.Parameter{ @@ -25546,10 +25596,10 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c | Limit Name | Description | Default | API Override Limit | | --- | --- | --- | --- | -| atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | +| atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | -| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | +| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | @@ -25557,8 +25607,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c | dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| -| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| -| atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 |`, +| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27|`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -25594,13 +25643,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProjectLtsVersions`, + OperationID: `getGroupMongoDbVersions`, Aliases: nil, Description: `Returns the MongoDB Long Term Support Major Versions available to new clusters in this project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectltsversions. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupmongodbversions. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getProjectLtsVersions/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getGroupMongoDbVersions/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/mongoDBVersions`, QueryParameters: []shared_api.Parameter{ @@ -25704,13 +25753,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProjectSettings`, + OperationID: `getGroupSettings`, Aliases: nil, Description: `Returns details about the specified project's settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectsettings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupsettings. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getProjectSettings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-getGroupSettings/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/settings`, QueryParameters: []shared_api.Parameter{ @@ -25764,13 +25813,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjectInvitations`, + OperationID: `listGroupInvites`, Aliases: nil, Description: `Returns all pending invitations to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectinvitations. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupinvites. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-listProjectInvitations/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-listGroupInvites/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/invites`, QueryParameters: []shared_api.Parameter{ @@ -25834,13 +25883,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjectLimits`, + OperationID: `listGroupLimits`, Aliases: nil, Description: `Returns all the limits for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectlimits. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgrouplimits. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-listProjectLimits/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-listGroupLimits/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/limits`, QueryParameters: []shared_api.Parameter{ @@ -25894,13 +25943,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjects`, + OperationID: `listGroups`, Aliases: nil, Description: `Returns details about all projects. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Organization Read Only role or higher. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojects. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroups. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-listProjects/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-listGroups/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups`, QueryParameters: []shared_api.Parameter{ @@ -25969,13 +26018,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `migrateProjectToAnotherOrg`, + OperationID: `migrateGroup`, Aliases: nil, Description: `Migrates a project from its current organization to another organization. All project users and their roles will be copied to the same project in the destination organization. You must include an organization API key with the Organization Owner role for the destination organization to verify access to the destination organization when you authenticate with Programmatic API Keys. Otherwise, the requesting user must have the Organization Owner role in both organizations. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-migrateprojecttoanotherorg. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-migrategroup. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-migrateProjectToAnotherOrg/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-migrateGroup/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}:migrate`, QueryParameters: []shared_api.Parameter{ @@ -26019,76 +26068,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `returnAllIpAddresses`, - Aliases: nil, - Description: `Returns all IP addresses for this project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnallipaddresses. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-returnAllIpAddresses/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/ipAddresses`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 1, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `setProjectLimit`, + OperationID: `setGroupLimit`, Aliases: nil, Description: `Sets the specified project limit. To use this resource, the requesting Service Account or API Key must have the Project Owner role. NOTE: Increasing the following configuration limits might lead to slower response times in the MongoDB Cloud UI or increased user management overhead leading to authentication or authorization re-architecture. If possible, we recommend that you create additional projects to gain access to more of these resources for a more sustainable growth pattern. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setprojectlimit. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setgrouplimit. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-setProjectLimit/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-setGroupLimit/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/limits/{limitName}`, QueryParameters: []shared_api.Parameter{ @@ -26121,10 +26110,10 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c | Limit Name | Description | Default | API Override Limit | | --- | --- | --- | --- | -| atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | +| atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | -| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | +| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | @@ -26132,8 +26121,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c | dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| -| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| -| atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 |`, +| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27|`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -26169,13 +26157,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProject`, + OperationID: `updateGroup`, Aliases: nil, Description: `Updates the human-readable label that identifies the specified project, or the tags associated with the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateproject. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroup. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateProject/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateGroup/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}`, QueryParameters: []shared_api.Parameter{ @@ -26229,15 +26217,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProjectInvitation`, + OperationID: `updateGroupInviteById`, Aliases: nil, - Description: `Updates the details of one pending invitation, identified by the username of the invited user, to the specified project. To use this resource, the requesting API Key must have the Project Owner role. + Description: `Updates the details of one pending invitation, identified by its unique ID, to the specified project. Use the Return All Project Invitations endpoint to retrieve IDs for all pending project invitations. To use this resource, the requesting API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectinvitation. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupinvitebyid. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateProjectInvitation/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateGroupInviteById/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/invites`, + URL: `/api/atlas/v2/groups/{groupId}/invites/{invitationId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -26249,16 +26237,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -26275,6 +26253,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `invitationId`, + Description: `Unique 24-hexadecimal digit string that identifies the invitation.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodPatch, }, @@ -26289,15 +26277,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProjectInvitationById`, + OperationID: `updateGroupInvites`, Aliases: nil, - Description: `Updates the details of one pending invitation, identified by its unique ID, to the specified project. Use the Return All Project Invitations endpoint to retrieve IDs for all pending project invitations. To use this resource, the requesting API Key must have the Project Owner role. + Description: `Updates the details of one pending invitation, identified by the username of the invited user, to the specified project. To use this resource, the requesting API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectinvitationbyid. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupinvites. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateProjectInvitationById/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateGroupInvites/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/invites/{invitationId}`, + URL: `/api/atlas/v2/groups/{groupId}/invites`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -26309,6 +26297,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -26325,16 +26323,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `invitationId`, - Description: `Unique 24-hexadecimal digit string that identifies the invitation.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodPatch, }, @@ -26349,19 +26337,19 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProjectRoles`, + OperationID: `updateGroupSettings`, Aliases: nil, - Description: `Updates the roles of the specified user in the specified project. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified project. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. + Description: `Updates the settings of the specified project. You can update any of the options available. MongoDB cloud only updates the options provided in the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectroles. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupsettings. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateProjectRoles/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateGroupSettings/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/users/{userId}/roles`, + URL: `/api/atlas/v2/groups/{groupId}/settings`, QueryParameters: []shared_api.Parameter{ { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -26370,8 +26358,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -26395,18 +26383,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `userId`, - Description: `Unique 24-hexadecimal digit string that identifies the user to modify.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodPut, + Verb: http.MethodPatch, }, Versions: []shared_api.CommandVersion{ { @@ -26419,19 +26397,19 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProjectSettings`, + OperationID: `updateGroupUserRoles`, Aliases: nil, - Description: `Updates the settings of the specified project. You can update any of the options available. MongoDB cloud only updates the options provided in the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. + Description: `Updates the roles of the specified user in the specified project. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified project. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectsettings. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupuserroles. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateProjectSettings/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-projects-updateGroupUserRoles/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/settings`, + URL: `/api/atlas/v2/groups/{groupId}/users/{userId}/roles`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -26440,8 +26418,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -26465,8 +26443,18 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `userId`, + Description: `Unique 24-hexadecimal digit string that identifies the user to modify.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodPatch, + Verb: http.MethodPut, }, Versions: []shared_api.CommandVersion{ { @@ -26485,13 +26473,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `You can continually push logs from mongod, mongos, and audit logs to an AWS S3 bucket. Atlas exports logs every 5 minutes.`, Commands: []shared_api.Command{ { - OperationID: `createPushBasedLogConfiguration`, + OperationID: `createGroupPushBasedLogExport`, Aliases: nil, Description: `Configures the project level settings for the push-based log export feature. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpushbasedlogconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategrouppushbasedlogexport. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-pushBasedLogExport-createPushBasedLogConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-pushBasedLogExport-createGroupPushBasedLogExport/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/pushBasedLogExport`, QueryParameters: []shared_api.Parameter{ @@ -26545,13 +26533,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePushBasedLogConfiguration`, + OperationID: `deleteGroupPushBasedLogExport`, Aliases: nil, Description: `Disables the push-based log export feature by resetting the project level settings to its default configuration. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepushbasedlogconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegrouppushbasedlogexport. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-pushBasedLogExport-deletePushBasedLogConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-pushBasedLogExport-deleteGroupPushBasedLogExport/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/pushBasedLogExport`, QueryParameters: []shared_api.Parameter{ @@ -26605,13 +26593,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPushBasedLogConfiguration`, + OperationID: `getGroupPushBasedLogExport`, Aliases: nil, Description: `Fetches the current project level settings for the push-based log export feature. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpushbasedlogconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgrouppushbasedlogexport. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-pushBasedLogExport-getPushBasedLogConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-pushBasedLogExport-getGroupPushBasedLogExport/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/pushBasedLogExport`, QueryParameters: []shared_api.Parameter{ @@ -26665,13 +26653,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updatePushBasedLogConfiguration`, + OperationID: `updateGroupPushBasedLogExport`, Aliases: nil, Description: `Updates the project level settings for the push-based log export feature. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepushbasedlogconfiguration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategrouppushbasedlogexport. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-pushBasedLogExport-updatePushBasedLogConfiguration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-pushBasedLogExport-updateGroupPushBasedLogExport/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/pushBasedLogExport`, QueryParameters: []shared_api.Parameter{ @@ -26855,13 +26843,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getGroupClusterQueryShapeInsightSummaries`, + OperationID: `listGroupClusterQueryShapeInsightSummaries`, Aliases: nil, Description: `Returns a list of query shape statistics summaries for a given cluster. Query shape statistics provide performance insights about MongoDB queries, helping users identify problematic query patterns and potential optimizations. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterqueryshapeinsightsummaries. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterqueryshapeinsightsummaries. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-queryShapeInsights-getGroupClusterQueryShapeInsightSummaries/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-queryShapeInsights-listGroupClusterQueryShapeInsightSummaries/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/queryShapeInsights/summaries`, QueryParameters: []shared_api.Parameter{ @@ -27147,15 +27135,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrgResourcePolicy`, + OperationID: `getOrgNonCompliantResources`, Aliases: nil, - Description: `Return one Atlas Resource Policy for an org. + Description: `Return all non-compliant resources for an org. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgresourcepolicy. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgnoncompliantresources. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-resourcePolicies-getOrgResourcePolicy/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-resourcePolicies-getOrgNonCompliantResources/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/resourcePolicies/{resourcePolicyId}`, + URL: `/api/atlas/v2/orgs/{orgId}/nonCompliantResources`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -27189,16 +27177,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, - { - Name: `resourcePolicyId`, - Description: `Unique 24-hexadecimal digit string that identifies an atlas resource policy.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, @@ -27213,15 +27191,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getResourcesNonCompliant`, + OperationID: `getOrgResourcePolicy`, Aliases: nil, - Description: `Return all non-compliant resources for an org. + Description: `Return one Atlas Resource Policy for an org. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getresourcesnoncompliant. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgresourcepolicy. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-resourcePolicies-getResourcesNonCompliant/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-resourcePolicies-getOrgResourcePolicy/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/nonCompliantResources`, + URL: `/api/atlas/v2/orgs/{orgId}/resourcePolicies/{resourcePolicyId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -27255,6 +27233,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, + { + Name: `resourcePolicyId`, + Description: `Unique 24-hexadecimal digit string that identifies an atlas resource policy.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodGet, }, @@ -27391,13 +27379,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `validateAtlasResourcePolicy`, + OperationID: `validateOrgResourcePolicies`, Aliases: nil, Description: `Validate one Atlas Resource Policy for an org. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validateatlasresourcepolicy. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validateorgresourcepolicies. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-resourcePolicies-validateAtlasResourcePolicy/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-resourcePolicies-validateOrgResourcePolicies/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/resourcePolicies:validate`, QueryParameters: []shared_api.Parameter{ @@ -27453,13 +27441,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Creates one index to a database deployment in a rolling manner. Rolling indexes build indexes on the applicable nodes sequentially and may reduce the performance impact of an index build if your deployment's average CPU utilization exceeds (N-1)/N-10% where N is the number of CPU threads available to mongod of if the WiredTiger cache fill ratio regularly exceeds 90%. If your deployment does not meet this criteria, use the default index build. You can't create a rolling index on an M0 free cluster or M2/M5 shared cluster.`, Commands: []shared_api.Command{ { - OperationID: `createRollingIndex`, + OperationID: `createGroupClusterIndexRollingIndex`, Aliases: nil, Description: `Creates an index on the cluster identified by its name in a rolling manner. Creating the index in this way allows index builds on one replica set member as a standalone at a time, starting with the secondary members. Creating indexes in this way requires at least one replica set election. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createrollingindex. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterindexrollingindex. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-rollingIndex-createRollingIndex/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-rollingIndex-createGroupClusterIndexRollingIndex/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/index`, QueryParameters: []shared_api.Parameter{ @@ -27574,13 +27562,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `returnAllControlPlaneIpAddresses`, + OperationID: `listControlPlaneIpAddresses`, Aliases: nil, Description: `Returns all control plane IP addresses. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnallcontrolplaneipaddresses. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcontrolplaneipaddresses. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-root-returnAllControlPlaneIpAddresses/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-root-listControlPlaneIpAddresses/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/unauth/controlPlaneIPAddresses`, QueryParameters: []shared_api.Parameter{ @@ -27615,16 +27603,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns, adds, edits, and removes serverless instances.`, Commands: []shared_api.Command{ { - OperationID: `createServerlessInstance`, + OperationID: `createGroupServerlessInstance`, Aliases: nil, Description: `Update as of Feb 2025: This endpoint now creates a Flex cluster instead. This endpoint will no longer be supported starting January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect. Please use the createFlexCluster endpoint instead. Creates one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserverlessinstance. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserverlessinstance. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-createServerlessInstance/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-createGroupServerlessInstance/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serverless`, QueryParameters: []shared_api.Parameter{ @@ -27678,11 +27666,10 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getFlexCluster`, - Version: shared_api.NewStableVersion(2024, 11, 13), + OperationID: `createGroupServerlessInstance`, + Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `groupId`: `input:groupId`, - `name`: `body:$.name`, }, }, Expect: &shared_api.WatcherExpectProperties{ @@ -27696,16 +27683,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteServerlessInstance`, + OperationID: `deleteGroupServerlessInstance`, Aliases: nil, Description: `Removes one serverless instance from the specified project. The serverless instance must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Please use the deleteFlexCluster endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserverlessinstance. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupserverlessinstance. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-deleteServerlessInstance/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-deleteGroupServerlessInstance/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serverless/{name}`, QueryParameters: []shared_api.Parameter{ @@ -27769,8 +27756,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getFlexCluster`, - Version: shared_api.NewStableVersion(2024, 11, 13), + OperationID: `deleteGroupServerlessInstance`, + Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `groupId`: `input:groupId`, `name`: `input:name`, @@ -27783,16 +27770,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessInstance`, + OperationID: `getGroupServerlessInstance`, Aliases: nil, Description: `Returns details for one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. This endpoint will be sunset in January 2026. Please use the getFlexCluster endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessinstance. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserverlessinstance. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-getServerlessInstance/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-getGroupServerlessInstance/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serverless/{name}`, QueryParameters: []shared_api.Parameter{ @@ -27856,16 +27843,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServerlessInstances`, + OperationID: `listGroupServerlessInstances`, Aliases: nil, Description: `Returns details for all serverless instances in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This endpoint also lists Flex clusters that were created using the createServerlessInstance endpoint or former Serverless instances that have been migrated to Flex clusters, until January 2026 after which this endpoint will be sunset. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. Please use the listFlexClusters endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserverlessinstances. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserverlessinstances. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-listServerlessInstances/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-listGroupServerlessInstances/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serverless`, QueryParameters: []shared_api.Parameter{ @@ -27949,16 +27936,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateServerlessInstance`, + OperationID: `updateGroupServerlessInstance`, Aliases: nil, Description: `Updates one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API can also be used on Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. This endpoint will be sunset in January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect on these clusters. Please use the updateFlexCluster endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateserverlessinstance. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupserverlessinstance. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-updateServerlessInstance/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessInstances-updateGroupServerlessInstance/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serverless/{name}`, QueryParameters: []shared_api.Parameter{ @@ -28022,8 +28009,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Watcher: &shared_api.WatcherProperties{ Get: shared_api.WatcherGetProperties{ - OperationID: `getFlexCluster`, - Version: shared_api.NewStableVersion(2024, 11, 13), + OperationID: `updateGroupServerlessInstance`, + Version: shared_api.NewStableVersion(2023, 1, 1), Params: map[string]string{ `groupId`: `input:groupId`, `name`: `input:name`, @@ -28046,7 +28033,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes private endpoints for serverless instances. To learn more, see the Atlas Administration API tab on the following tutorial.`, Commands: []shared_api.Command{ { - OperationID: `createServerlessPrivateEndpoint`, + OperationID: `createGroupPrivateEndpointServerlessInstanceEndpoint`, Aliases: nil, Description: `Creates one private endpoint for one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -28056,9 +28043,9 @@ A new endpoint won't be immediately available after creation. Read the steps in This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserverlessprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupprivateendpointserverlessinstanceendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-createServerlessPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-createGroupPrivateEndpointServerlessInstanceEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint`, QueryParameters: []shared_api.Parameter{ @@ -28112,16 +28099,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteServerlessPrivateEndpoint`, + OperationID: `deleteGroupPrivateEndpointServerlessInstanceEndpoint`, Aliases: nil, Description: `Remove one private endpoint from one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserverlessprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupprivateendpointserverlessinstanceendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-deleteServerlessPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-deleteGroupPrivateEndpointServerlessInstanceEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint/{endpointId}`, QueryParameters: []shared_api.Parameter{ @@ -28185,16 +28172,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessPrivateEndpoint`, + OperationID: `getGroupPrivateEndpointServerlessInstanceEndpoint`, Aliases: nil, Description: `Return one private endpoint for one serverless instance. Identify this endpoint using its unique ID. You must have at least the Project Read Only role for the project to successfully call this resource. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupprivateendpointserverlessinstanceendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-getServerlessPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-getGroupPrivateEndpointServerlessInstanceEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint/{endpointId}`, QueryParameters: []shared_api.Parameter{ @@ -28258,16 +28245,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServerlessPrivateEndpoints`, + OperationID: `listGroupPrivateEndpointServerlessInstanceEndpoint`, Aliases: nil, Description: `Returns all private endpoints for one serverless instance. You must have at least the Project Read Only role for the project to successfully call this resource. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserverlessprivateendpoints. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupprivateendpointserverlessinstanceendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-listServerlessPrivateEndpoints/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-listGroupPrivateEndpointServerlessInstanceEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint`, QueryParameters: []shared_api.Parameter{ @@ -28321,16 +28308,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateServerlessPrivateEndpoint`, + OperationID: `updateGroupPrivateEndpointServerlessInstanceEndpoint`, Aliases: nil, Description: `Updates one private endpoint for one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateserverlessprivateendpoint. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupprivateendpointserverlessinstanceendpoint. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-updateServerlessPrivateEndpoint/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serverlessPrivateEndpoints-updateGroupPrivateEndpointServerlessInstanceEndpoint/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint/{endpointId}`, QueryParameters: []shared_api.Parameter{ @@ -28400,83 +28387,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Endpoints for managing Service Accounts and secrets. Service Accounts are used for programmatic access to the Atlas Admin API through the OAuth 2.0 Client Credentials flow.`, Commands: []shared_api.Command{ { - OperationID: `addProjectServiceAccount`, - Aliases: nil, - Description: `Assigns the specified Service Account to the specified Project. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectserviceaccount. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-addProjectServiceAccount/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}:invite`, - QueryParameters: []shared_api.Parameter{ - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `clientId`, - Description: `The Client ID of the Service Account.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - }, - Verb: http.MethodPost, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2024, 8, 5), - RequestContentType: `json`, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `createProjectServiceAccount`, + OperationID: `createGroupServiceAccount`, Aliases: nil, Description: `Creates one Service Account for the specified Project. The Service Account will automatically be added as an Organization Member to the Organization that the specified Project is a part of. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccount. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserviceaccount. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createProjectServiceAccount/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createGroupServiceAccount/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts`, QueryParameters: []shared_api.Parameter{ @@ -28530,13 +28447,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createProjectServiceAccountAccessList`, + OperationID: `createGroupServiceAccountAccessList`, Aliases: nil, Description: `Add Access List Entries for the specified Service Account for the project. Resources require all API requests to originate from IP addresses on the API access list. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccountaccesslist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserviceaccountaccesslist. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createProjectServiceAccountAccessList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createGroupServiceAccountAccessList/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/accessList`, QueryParameters: []shared_api.Parameter{ @@ -28630,13 +28547,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createProjectServiceAccountSecret`, + OperationID: `createGroupServiceAccountSecret`, Aliases: nil, Description: `Create a secret for the specified Service Account in the specified Project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccountsecret. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupserviceaccountsecret. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createProjectServiceAccountSecret/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createGroupServiceAccountSecret/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/secrets`, QueryParameters: []shared_api.Parameter{ @@ -28700,13 +28617,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createServiceAccount`, + OperationID: `createOrgServiceAccount`, Aliases: nil, Description: `Creates one Service Account for the specified Organization. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccount. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgserviceaccount. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createServiceAccount/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createOrgServiceAccount/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts`, QueryParameters: []shared_api.Parameter{ @@ -28756,13 +28673,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createServiceAccountAccessList`, + OperationID: `createOrgServiceAccountAccessList`, Aliases: nil, Description: `Add Access List Entries for the specified Service Account for the organization. Resources require all API requests to originate from IP addresses on the API access list. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccountaccesslist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgserviceaccountaccesslist. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createServiceAccountAccessList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createOrgServiceAccountAccessList/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/accessList`, QueryParameters: []shared_api.Parameter{ @@ -28852,13 +28769,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createServiceAccountSecret`, + OperationID: `createOrgServiceAccountSecret`, Aliases: nil, Description: `Create a secret for the specified Service Account. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccountsecret. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgserviceaccountsecret. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createServiceAccountSecret/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-createOrgServiceAccountSecret/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/secrets`, QueryParameters: []shared_api.Parameter{ @@ -28918,13 +28835,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteProjectServiceAccount`, + OperationID: `deleteGroupServiceAccount`, Aliases: nil, Description: `Removes the specified Service Account from the specified project. The Service Account will still be a part of the Organization it was created in, and the credentials will remain active until expired or manually revoked. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccount. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupserviceaccount. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteProjectServiceAccount/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteGroupServiceAccount/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}`, QueryParameters: []shared_api.Parameter{ @@ -28988,13 +28905,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectServiceAccountAccessListEntry`, + OperationID: `deleteGroupServiceAccountAccessListEntry`, Aliases: nil, Description: `Removes the specified access list entry from the specified Service Account for the project. You can't remove the requesting IP address from the access list. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccountaccesslistentry. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupserviceaccountaccesslistentry. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteProjectServiceAccountAccessListEntry/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteGroupServiceAccountAccessListEntry/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/accessList/{ipAddress}`, QueryParameters: []shared_api.Parameter{ @@ -29068,15 +28985,161 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectServiceAccountSecret`, + OperationID: `deleteGroupServiceAccountSecret`, + Aliases: nil, + Description: `Deletes the specified Service Account secret. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupserviceaccountsecret. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteGroupServiceAccountSecret/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/secrets/{secretId}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `clientId`, + Description: `The Client ID of the Service Account.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `secretId`, + Description: `Unique 24-hexadecimal digit string that identifies the secret.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + }, + Verb: http.MethodDelete, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2024, 8, 5), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `deleteOrgServiceAccount`, + Aliases: nil, + Description: `Deletes the specified Service Account. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgserviceaccount. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteOrgServiceAccount/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `clientId`, + Description: `The Client ID of the Service Account.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodDelete, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2024, 8, 5), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `deleteOrgServiceAccountAccessListEntry`, Aliases: nil, - Description: `Deletes the specified Service Account secret. + Description: `Removes the specified access list entry from the specified Service Account for the organization. You can't remove the requesting IP address from the access list. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccountsecret. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgserviceaccountaccesslistentry. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteProjectServiceAccountSecret/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteOrgServiceAccountAccessListEntry/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/secrets/{secretId}`, + URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/accessList/{ipAddress}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -29101,8 +29164,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `clientId`, - Description: `The Client ID of the Service Account.`, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -29111,8 +29174,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `secretId`, - Description: `Unique 24-hexadecimal digit string that identifies the secret.`, + Name: `clientId`, + Description: `The Client ID of the Service Account.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -29121,18 +29184,14 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `ipAddress`, + Description: `One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, Verb: http.MethodDelete, @@ -29148,15 +29207,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteServiceAccount`, + OperationID: `deleteOrgServiceAccountSecret`, Aliases: nil, - Description: `Deletes the specified Service Account. + Description: `Deletes the specified Service Account secret. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccount. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgserviceaccountsecret. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteServiceAccount/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteOrgServiceAccountSecret/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}`, + URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/secrets/{secretId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -29190,6 +29249,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, + { + Name: `secretId`, + Description: `Unique 24-hexadecimal digit string that identifies the secret.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, { Name: `orgId`, Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, @@ -29214,15 +29283,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteServiceAccountAccessListEntry`, + OperationID: `getGroupServiceAccount`, Aliases: nil, - Description: `Removes the specified access list entry from the specified Service Account for the organization. You can't remove the requesting IP address from the access list. + Description: `Returns one Service Account in the specified Project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccountaccesslistentry. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupserviceaccount. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteServiceAccountAccessListEntry/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-getGroupServiceAccount/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/accessList/{ipAddress}`, + URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -29247,14 +29316,18 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, { Name: `clientId`, @@ -29266,18 +29339,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, - { - Name: `ipAddress`, - Description: `One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -29290,15 +29353,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteServiceAccountSecret`, + OperationID: `getOrgServiceAccount`, Aliases: nil, - Description: `Deletes the specified Service Account secret. + Description: `Returns the specified Service Account. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccountsecret. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgserviceaccount. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-deleteServiceAccountSecret/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-getOrgServiceAccount/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/secrets/{secretId}`, + URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -29323,18 +29386,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `clientId`, - Description: `The Client ID of the Service Account.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `secretId`, - Description: `Unique 24-hexadecimal digit string that identifies the secret.`, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -29343,8 +29396,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Name: `clientId`, + Description: `The Client ID of the Service Account.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -29353,7 +29406,7 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { @@ -29366,24 +29419,34 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectServiceAccount`, + OperationID: `getOrgServiceAccountGroups`, Aliases: nil, - Description: `Returns one Service Account in the specified Project. + Description: `Returns a list of all projects the specified Service Account is a part of. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectserviceaccount. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgserviceaccountgroups. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-getProjectServiceAccount/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-getOrgServiceAccountGroups/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}`, + URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/groups`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, + }, + }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, }, }, { @@ -29396,21 +29459,27 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, { Name: `clientId`, @@ -29436,15 +29505,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServiceAccount`, + OperationID: `inviteGroupServiceAccount`, Aliases: nil, - Description: `Returns the specified Service Account. + Description: `Assigns the specified Service Account to the specified Project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserviceaccount. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-invitegroupserviceaccount. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-getServiceAccount/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-inviteGroupServiceAccount/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}`, + URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}:invite`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -29469,8 +29538,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Name: `clientId`, + Description: `The Client ID of the Service Account.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -29479,22 +29548,26 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `clientId`, - Description: `The Client ID of the Service Account.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, }, - Verb: http.MethodGet, + Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2024, 8, 5), - RequestContentType: ``, + RequestContentType: `json`, ResponseContentTypes: []string{ `json`, }, @@ -29502,13 +29575,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listProjectServiceAccountAccessList`, + OperationID: `listGroupServiceAccountAccessList`, Aliases: nil, Description: `Returns all access list entries that you configured for the specified Service Account for the project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectserviceaccountaccesslist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserviceaccountaccesslist. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listProjectServiceAccountAccessList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listGroupServiceAccountAccessList/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/accessList`, QueryParameters: []shared_api.Parameter{ @@ -29602,13 +29675,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjectServiceAccounts`, + OperationID: `listGroupServiceAccounts`, Aliases: nil, Description: `Returns all Service Accounts for the specified Project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectserviceaccounts. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupserviceaccounts. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listProjectServiceAccounts/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listGroupServiceAccounts/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts`, QueryParameters: []shared_api.Parameter{ @@ -29682,13 +29755,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServiceAccountAccessList`, + OperationID: `listOrgServiceAccountAccessList`, Aliases: nil, Description: `Returns all access list entries that you configured for the specified Service Account for the organization. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccountaccesslist. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgserviceaccountaccesslist. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listServiceAccountAccessList/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listOrgServiceAccountAccessList/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/accessList`, QueryParameters: []shared_api.Parameter{ @@ -29778,99 +29851,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listServiceAccountProjects`, - Aliases: nil, - Description: `Returns a list of all projects the specified Service Account is a part of. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccountprojects. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listServiceAccountProjects/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/groups`, - QueryParameters: []shared_api.Parameter{ - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `clientId`, - Description: `The Client ID of the Service Account.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2024, 8, 5), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `listServiceAccounts`, + OperationID: `listOrgServiceAccounts`, Aliases: nil, Description: `Returns all Service Accounts for the specified Organization. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccounts. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgserviceaccounts. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listServiceAccounts/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-listOrgServiceAccounts/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts`, QueryParameters: []shared_api.Parameter{ @@ -29940,13 +29927,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateProjectServiceAccount`, + OperationID: `updateGroupServiceAccount`, Aliases: nil, Description: `Updates one Service Account in the specified Project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectserviceaccount. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupserviceaccount. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-updateProjectServiceAccount/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-updateGroupServiceAccount/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}`, QueryParameters: []shared_api.Parameter{ @@ -30010,13 +29997,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateServiceAccount`, + OperationID: `updateOrgServiceAccount`, Aliases: nil, Description: `Updates the specified Service Account in the specified Organization. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateserviceaccount. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorgserviceaccount. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-updateServiceAccount/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-serviceAccounts-updateOrgServiceAccount/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}`, QueryParameters: []shared_api.Parameter{ @@ -30082,16 +30069,16 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns and adds restore jobs for shared-tier database deployments.`, Commands: []shared_api.Command{ { - OperationID: `createSharedClusterBackupRestoreJob`, + OperationID: `createGroupClusterBackupTenantRestore`, Aliases: nil, Description: `Restores the specified M2 or M5 cluster. MongoDB Cloud limits which clusters can be the target clusters of a restore. The target cluster can't use encryption at rest, run a major release MongoDB version different than the snapshot, or receive client requests during restores. MongoDB Cloud deletes all existing data on the target cluster prior to the restore operation. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the createFlexBackupRestoreJob endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createsharedclusterbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclusterbackuptenantrestore. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierRestoreJobs-createSharedClusterBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierRestoreJobs-createGroupClusterBackupTenantRestore/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restore`, QueryParameters: []shared_api.Parameter{ @@ -30155,16 +30142,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getSharedClusterBackupRestoreJob`, + OperationID: `getGroupClusterBackupTenantRestore`, Aliases: nil, Description: `Returns the specified restore job for the specified M2 or M5 cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the getFlexBackupRestoreJob endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getsharedclusterbackuprestorejob. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackuptenantrestore. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierRestoreJobs-getSharedClusterBackupRestoreJob/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierRestoreJobs-getGroupClusterBackupTenantRestore/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restores/{restoreId}`, QueryParameters: []shared_api.Parameter{ @@ -30238,16 +30225,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSharedClusterBackupRestoreJobs`, + OperationID: `listGroupClusterBackupTenantRestores`, Aliases: nil, Description: `Returns all restore jobs for the specified M2 or M5 cluster. Restore jobs restore a cluster using a snapshot. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the listFlexBackupRestoreJobs endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsharedclusterbackuprestorejobs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackuptenantrestores. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierRestoreJobs-listSharedClusterBackupRestoreJobs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierRestoreJobs-listGroupClusterBackupTenantRestores/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restores`, QueryParameters: []shared_api.Parameter{ @@ -30317,16 +30304,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and requests to download shared-tier database deployment snapshots.`, Commands: []shared_api.Command{ { - OperationID: `downloadSharedClusterBackup`, + OperationID: `downloadGroupClusterBackupTenant`, Aliases: nil, Description: `Requests one snapshot for the specified shared cluster. This resource returns a snapshotURL that you can use to download the snapshot. This snapshotURL remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the downloadFlexBackup endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadsharedclusterbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupclusterbackuptenant. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierSnapshots-downloadSharedClusterBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierSnapshots-downloadGroupClusterBackupTenant/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/download`, QueryParameters: []shared_api.Parameter{ @@ -30390,16 +30377,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getSharedClusterBackup`, + OperationID: `getGroupClusterBackupTenantSnapshot`, Aliases: nil, Description: `Returns details for one snapshot for the specified shared cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This endpoint can also be used on Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters until January 2026, after which this endpoint will be sunset. Please use the getFlexBackup endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getsharedclusterbackup. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterbackuptenantsnapshot. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierSnapshots-getSharedClusterBackup/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierSnapshots-getGroupClusterBackupTenantSnapshot/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/snapshots/{snapshotId}`, QueryParameters: []shared_api.Parameter{ @@ -30473,16 +30460,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSharedClusterBackups`, + OperationID: `listGroupClusterBackupTenantSnapshots`, Aliases: nil, Description: `Returns details for all snapshots for the specified shared cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This API also works for Flex clusters that were created using the createCluster endpoint or former M2/M5 clusters that have been migrated to Flex clusters, until January 2026, after which this endpoint will be sunset. Please use the listFlexBackups endpoint instead. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsharedclusterbackups. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupclusterbackuptenantsnapshots. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierSnapshots-listSharedClusterBackups/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-sharedTierSnapshots-listGroupClusterBackupTenantSnapshots/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/snapshots`, QueryParameters: []shared_api.Parameter{ @@ -30552,13 +30539,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes Streams Instances. This resource requires your project ID.`, Commands: []shared_api.Command{ { - OperationID: `acceptVpcPeeringConnection`, + OperationID: `acceptGroupStreamVpcPeeringConnection`, Aliases: nil, Description: `Requests the acceptance of an incoming VPC Peering connection. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acceptvpcpeeringconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acceptgroupstreamvpcpeeringconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-acceptVpcPeeringConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-acceptGroupStreamVpcPeeringConnection/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}:accept`, QueryParameters: []shared_api.Parameter{ @@ -30612,15 +30599,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createPrivateLinkConnection`, + OperationID: `createGroupStreamConnection`, Aliases: nil, - Description: `Creates one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. + Description: `Creates one connection for a stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivatelinkconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupstreamconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createPrivateLinkConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createGroupStreamConnection/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/privateLinkConnections`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -30658,6 +30645,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `tenantName`, + Description: `Human-readable label that identifies the stream instance.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodPost, }, @@ -30672,15 +30669,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createStreamConnection`, + OperationID: `createGroupStreamPrivateLinkConnection`, Aliases: nil, - Description: `Creates one connection for a stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. + Description: `Creates one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreamconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupstreamprivatelinkconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createStreamConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createGroupStreamPrivateLinkConnection/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections`, + URL: `/api/atlas/v2/groups/{groupId}/streams/privateLinkConnections`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -30718,16 +30715,6 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodPost, }, @@ -30742,15 +30729,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createStreamInstance`, + OperationID: `createGroupStreamProcessor`, Aliases: nil, - Description: `Creates one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. + Description: `Create one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreaminstance. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupstreamprocessor. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createStreamInstance/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createGroupStreamProcessor/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -30788,12 +30775,22 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, + { + Name: `tenantName`, + Description: `Human-readable label that identifies the stream instance.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, Verb: http.MethodPost, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 2, 1), + Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, @@ -30802,15 +30799,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createStreamInstanceWithSampleConnections`, + OperationID: `createGroupStreamWorkspace`, Aliases: nil, - Description: `Creates one stream instance in the specified project with sample connections. To use this resource the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. + Description: `Creates one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreaminstancewithsampleconnections. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupstreamworkspace. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createStreamInstanceWithSampleConnections/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createGroupStreamWorkspace/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams:withSampleConnections`, + URL: `/api/atlas/v2/groups/{groupId}/streams`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -30853,7 +30850,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 8, 5), + Version: shared_api.NewStableVersion(2023, 2, 1), RequestContentType: `json`, ResponseContentTypes: []string{ `json`, @@ -30862,15 +30859,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createStreamProcessor`, + OperationID: `deleteGroupStreamConnection`, Aliases: nil, - Description: `Create one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + Description: `Delete one connection of the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreamprocessor. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-createStreamProcessor/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteGroupStreamConnection/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections/{connectionName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -30918,13 +30915,23 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Type: `string`, }, }, + { + Name: `connectionName`, + Description: `Human-readable label that identifies the stream connection.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, }, - Verb: http.MethodPost, + Verb: http.MethodDelete, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: `json`, + Version: shared_api.NewStableVersion(2023, 2, 1), + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -30932,13 +30939,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePrivateLinkConnection`, + OperationID: `deleteGroupStreamPrivateLinkConnection`, Aliases: nil, Description: `Deletes one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivatelinkconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamprivatelinkconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deletePrivateLinkConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteGroupStreamPrivateLinkConnection/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/privateLinkConnections/{connectionId}`, QueryParameters: []shared_api.Parameter{ @@ -31002,15 +31009,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteStreamConnection`, + OperationID: `deleteGroupStreamProcessor`, Aliases: nil, - Description: `Delete one connection of the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + Description: `Delete a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreamconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamprocessor. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteStreamConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteGroupStreamProcessor/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections/{connectionName}`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31059,8 +31066,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - Name: `connectionName`, - Description: `Human-readable label that identifies the stream connection.`, + Name: `processorName`, + Description: `Human-readable label that identifies the stream processor.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -31073,7 +31080,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 2, 1), + Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -31082,15 +31089,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteStreamInstance`, + OperationID: `deleteGroupStreamVpcPeeringConnection`, Aliases: nil, - Description: `Delete one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. + Description: `Deletes an incoming VPC Peering connection. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreaminstance. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamvpcpeeringconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteStreamInstance/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteGroupStreamVpcPeeringConnection/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}`, + URL: `/api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31102,16 +31109,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, }, URLParameters: []shared_api.Parameter{ { @@ -31129,8 +31126,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance to delete.`, + Name: `id`, + Description: `The VPC Peering Connection id.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -31152,15 +31149,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteStreamProcessor`, + OperationID: `deleteGroupStreamWorkspace`, Aliases: nil, - Description: `Delete a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + Description: `Delete one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreamprocessor. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupstreamworkspace. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteStreamProcessor/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteGroupStreamWorkspace/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31200,17 +31197,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `processorName`, - Description: `Human-readable label that identifies the stream processor.`, + Description: `Human-readable label that identifies the stream instance to delete.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -31223,7 +31210,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), + Version: shared_api.NewStableVersion(2023, 2, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -31232,15 +31219,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteVpcPeeringConnection`, + OperationID: `downloadGroupStreamAuditLogs`, Aliases: nil, - Description: `Deletes an incoming VPC Peering connection. + Description: `Downloads the audit logs for the specified Atlas Streams Processing instance. By default, logs cover periods of 30 days. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletevpcpeeringconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadgroupstreamauditlogs. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-deleteVpcPeeringConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-downloadGroupStreamAuditLogs/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/auditLogs`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31252,6 +31239,26 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `endDate`, + Description: `Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `startDate`, + Description: `Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, }, URLParameters: []shared_api.Parameter{ { @@ -31269,8 +31276,8 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Aliases: []string{`projectId`}, }, { - Name: `id`, - Description: `The VPC Peering Connection id.`, + Name: `tenantName`, + Description: `Human-readable label that identifies the stream instance.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -31279,28 +31286,28 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, - Verb: http.MethodDelete, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { Version: shared_api.NewStableVersion(2023, 2, 1), RequestContentType: ``, ResponseContentTypes: []string{ - `json`, + `gzip`, }, }, }, }, { - OperationID: `downloadStreamTenantAuditLogs`, + OperationID: `getGroupStreamAccountDetails`, Aliases: nil, - Description: `Downloads the audit logs for the specified Atlas Streams Processing instance. By default, logs cover periods of 30 days. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". + Description: `Returns the Account ID, and the VPC ID for the group and region specified. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadstreamtenantauditlogs. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamaccountdetails. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-downloadStreamTenantAuditLogs/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getGroupStreamAccountDetails/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/auditLogs`, + URL: `/api/atlas/v2/groups/{groupId}/streams/accountDetails`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31313,23 +31320,23 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `endDate`, - Description: `Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, + Name: `cloudProvider`, + Description: `One of "aws", "azure" or "gcp".`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, }, { - Name: `startDate`, - Description: `Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, + Name: `regionName`, + Description: `The cloud provider specific region name, i.e. "US_EAST_1" for cloud provider "aws".`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, }, }, @@ -31348,39 +31355,29 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 2, 1), + Version: shared_api.NewStableVersion(2024, 11, 13), RequestContentType: ``, ResponseContentTypes: []string{ - `gzip`, + `json`, }, }, }, }, { - OperationID: `getAccountDetails`, + OperationID: `getGroupStreamConnection`, Aliases: nil, - Description: `Returns the Account ID, and the VPC ID for the group and region specified. + Description: `Returns the details of one stream connection within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getaccountdetails. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getAccountDetails/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getGroupStreamConnection/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/accountDetails`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections/{connectionName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31392,19 +31389,25 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `cloudProvider`, - Description: `One of "aws", "azure" or "gcp".`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, { - Name: `regionName`, - Description: `The cloud provider specific region name, i.e. "US_EAST_1" for cloud provider "aws".`, + Name: `tenantName`, + Description: `Human-readable label that identifies the stream instance to return.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -31412,28 +31415,22 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `connectionName`, + Description: `Human-readable label that identifies the stream connection to return.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 11, 13), + Version: shared_api.NewStableVersion(2023, 2, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -31442,15 +31439,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getActiveVpcPeeringConnections`, + OperationID: `getGroupStreamPrivateLinkConnection`, Aliases: nil, - Description: `Returns a list of active incoming VPC Peering Connections. + Description: `Returns the details of one Private Link connection within the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getactivevpcpeeringconnections. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamprivatelinkconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getActiveVpcPeeringConnections/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getGroupStreamPrivateLinkConnection/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/activeVpcPeeringConnections`, + URL: `/api/atlas/v2/groups/{groupId}/streams/privateLinkConnections/{connectionId}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31462,24 +31459,64 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + }, + URLParameters: []shared_api.Parameter{ { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `connectionId`, + Description: `Unique ID that identifies the Private Link connection.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `string`, }, }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 2, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `getGroupStreamProcessor`, + Aliases: nil, + Description: `Get one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamprocessor. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getGroupStreamProcessor/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}`, + QueryParameters: []shared_api.Parameter{ { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { @@ -31508,59 +31545,19 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2024, 11, 13), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `getPrivateLinkConnection`, - Aliases: nil, - Description: `Returns the details of one Private Link connection within the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivatelinkconnection. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getPrivateLinkConnection/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/privateLinkConnections/{connectionId}`, - QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `tenantName`, + Description: `Human-readable label that identifies the stream instance.`, Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, { - Name: `connectionId`, - Description: `Unique ID that identifies the Private Link connection.`, + Name: `processorName`, + Description: `Human-readable label that identifies the stream processor.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -31573,7 +31570,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 2, 1), + Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -31582,15 +31579,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getStreamConnection`, + OperationID: `getGroupStreamProcessors`, Aliases: nil, - Description: `Returns the details of one stream connection within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns all Stream Processors within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreamconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamprocessors. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getStreamConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getGroupStreamProcessors/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections/{connectionName}`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processors`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31602,79 +31599,39 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, - }, - URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, - { - Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance to return.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `bool`, }, }, { - Name: `connectionName`, - Description: `Human-readable label that identifies the stream connection to return.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, - Required: true, + Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `string`, + Type: `int`, }, }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2023, 2, 1), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `getStreamInstance`, - Aliases: nil, - Description: `Returns the details of one stream instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreaminstance. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getStreamInstance/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}`, - QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, }, }, { - Name: `includeConnections`, - Description: `Flag to indicate whether connections information should be included in the stream instance.`, + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -31700,7 +31657,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance to return.`, + Description: `Human-readable label that identifies the stream instance.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -31713,7 +31670,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 2, 1), + Version: shared_api.NewStableVersion(2024, 5, 30), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -31722,15 +31679,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getStreamProcessor`, + OperationID: `getGroupStreamWorkspace`, Aliases: nil, - Description: `Get one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + Description: `Returns the details of one stream instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreamprocessor. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupstreamworkspace. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getStreamProcessor/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getGroupStreamWorkspace/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}`, + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31743,8 +31700,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `includeConnections`, + Description: `Flag to indicate whether connections information should be included in the stream instance.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -31770,51 +31727,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, { Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `processorName`, - Description: `Human-readable label that identifies the stream processor.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - }, - Verb: http.MethodGet, - }, - Versions: []shared_api.CommandVersion{ - { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: ``, - ResponseContentTypes: []string{ - `json`, - }, - }, - }, - }, - { - OperationID: `getVpcPeeringConnections`, - Aliases: nil, - Description: `Returns a list of incoming VPC Peering Connections. - -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getvpcpeeringconnections. - -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-getVpcPeeringConnections/`, - RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections`, - QueryParameters: []shared_api.Parameter{ - { - Name: `requesterAccountId`, - Description: `The Account ID of the VPC Peering connection/s.`, + Description: `Human-readable label that identifies the stream instance to return.`, Short: ``, Required: true, Type: shared_api.ParameterType{ @@ -31822,62 +31735,6 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `string`, }, }, - { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `int`, - }, - }, - { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, - Short: ``, - Required: false, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `bool`, - }, - }, - }, - URLParameters: []shared_api.Parameter{ - { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - Aliases: []string{`projectId`}, - }, }, Verb: http.MethodGet, }, @@ -31892,15 +31749,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPrivateLinkConnections`, + OperationID: `listGroupStreamActiveVpcPeeringConnections`, Aliases: nil, - Description: `Returns all Private Link connections for the specified project. To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. + Description: `Returns a list of active incoming VPC Peering Connections. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprivatelinkconnections. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamactivevpcpeeringconnections. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listPrivateLinkConnections/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listGroupStreamActiveVpcPeeringConnections/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/privateLinkConnections`, + URL: `/api/atlas/v2/groups/{groupId}/streams/activeVpcPeeringConnections`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -31963,7 +31820,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2023, 2, 1), + Version: shared_api.NewStableVersion(2024, 11, 13), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -31972,13 +31829,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listStreamConnections`, + OperationID: `listGroupStreamConnections`, Aliases: nil, Description: `Returns all connections of the stream instance for the specified project. To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreamconnections. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamconnections. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listStreamConnections/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listGroupStreamConnections/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections`, QueryParameters: []shared_api.Parameter{ @@ -32062,15 +31919,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listStreamInstances`, + OperationID: `listGroupStreamPrivateLinkConnections`, Aliases: nil, - Description: `Returns all stream instances for the specified project. + Description: `Returns all Private Link connections for the specified project. To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreaminstances. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamprivatelinkconnections. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listStreamInstances/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listGroupStreamPrivateLinkConnections/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams`, + URL: `/api/atlas/v2/groups/{groupId}/streams/privateLinkConnections`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -32142,29 +31999,29 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listStreamProcessors`, + OperationID: `listGroupStreamVpcPeeringConnections`, Aliases: nil, - Description: `Returns all Stream Processors within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + Description: `Returns a list of incoming VPC Peering Connections. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreamprocessors. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamvpcpeeringconnections. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listStreamProcessors/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listGroupStreamVpcPeeringConnections/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processors`, + URL: `/api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections`, QueryParameters: []shared_api.Parameter{ { - Name: `envelope`, - Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Name: `requesterAccountId`, + Description: `The Account ID of the VPC Peering connection/s.`, Short: ``, - Required: false, + Required: true, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `string`, }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -32193,8 +32050,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `includeCount`, - Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -32218,22 +32075,12 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), + Version: shared_api.NewStableVersion(2023, 2, 1), RequestContentType: ``, ResponseContentTypes: []string{ `json`, @@ -32242,15 +32089,15 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `modifyStreamProcessor`, + OperationID: `listGroupStreamWorkspaces`, Aliases: nil, - Description: `Modify one existing Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + Description: `Returns all stream instances for the specified project. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-modifystreamprocessor. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupstreamworkspaces. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-modifyStreamProcessor/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-listGroupStreamWorkspaces/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}`, + URL: `/api/atlas/v2/groups/{groupId}/streams`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -32262,6 +32109,26 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Type: `bool`, }, }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, { Name: `pretty`, Description: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -32288,33 +32155,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, Aliases: []string{`projectId`}, }, - { - Name: `tenantName`, - Description: `Human-readable label that identifies the stream instance.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, - { - Name: `processorName`, - Description: `Human-readable label that identifies the stream processor.`, - Short: ``, - Required: true, - Type: shared_api.ParameterType{ - IsArray: false, - Type: `string`, - }, - }, }, - Verb: http.MethodPatch, + Verb: http.MethodGet, }, Versions: []shared_api.CommandVersion{ { - Version: shared_api.NewStableVersion(2024, 5, 30), - RequestContentType: `json`, + Version: shared_api.NewStableVersion(2023, 2, 1), + RequestContentType: ``, ResponseContentTypes: []string{ `json`, }, @@ -32322,13 +32169,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `rejectVpcPeeringConnection`, + OperationID: `rejectGroupStreamVpcPeeringConnection`, Aliases: nil, Description: `Requests the rejection of an incoming VPC Peering connection. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-rejectvpcpeeringconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-rejectgroupstreamvpcpeeringconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-rejectVpcPeeringConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-rejectGroupStreamVpcPeeringConnection/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}:reject`, QueryParameters: []shared_api.Parameter{ @@ -32382,13 +32229,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `startStreamProcessor`, + OperationID: `startGroupStreamProcessor`, Aliases: nil, Description: `Start a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startstreamprocessor. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startgroupstreamprocessor. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-startStreamProcessor/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-startGroupStreamProcessor/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:start`, QueryParameters: []shared_api.Parameter{ @@ -32462,13 +32309,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `startStreamProcessorWith`, + OperationID: `startGroupStreamProcessorWith`, Aliases: nil, Description: `Start a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startstreamprocessorwith. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startgroupstreamprocessorwith. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-startStreamProcessorWith/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-startGroupStreamProcessorWith/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:startWith`, QueryParameters: []shared_api.Parameter{ @@ -32542,13 +32389,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `stopStreamProcessor`, + OperationID: `stopGroupStreamProcessor`, Aliases: nil, Description: `Stop a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-stopstreamprocessor. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-stopgroupstreamprocessor. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-stopStreamProcessor/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-stopGroupStreamProcessor/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:stop`, QueryParameters: []shared_api.Parameter{ @@ -32622,13 +32469,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateStreamConnection`, + OperationID: `updateGroupStreamConnection`, Aliases: nil, Description: `Update one connection for the specified stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatestreamconnection. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupstreamconnection. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-updateStreamConnection/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-updateGroupStreamConnection/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections/{connectionName}`, QueryParameters: []shared_api.Parameter{ @@ -32702,13 +32549,93 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateStreamInstance`, + OperationID: `updateGroupStreamProcessor`, + Aliases: nil, + Description: `Modify one existing Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupstreamprocessor. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-updateGroupStreamProcessor/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + { + Name: `tenantName`, + Description: `Human-readable label that identifies the stream instance.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + { + Name: `processorName`, + Description: `Human-readable label that identifies the stream processor.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodPatch, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2024, 5, 30), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `updateGroupStreamWorkspace`, Aliases: nil, Description: `Update one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatestreaminstance. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupstreamworkspace. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-updateStreamInstance/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-updateGroupStreamWorkspace/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/streams/{tenantName}`, QueryParameters: []shared_api.Parameter{ @@ -32771,6 +32698,66 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, }, + { + OperationID: `withGroupStreamSampleConnections`, + Aliases: nil, + Description: `Creates one stream instance in the specified project with sample connections. To use this resource the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-withgroupstreamsampleconnections. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-streams-withGroupStreamSampleConnections/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/streams:withSampleConnections`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + Aliases: []string{`projectId`}, + }, + }, + Verb: http.MethodPost, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2024, 8, 5), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, }, }, { @@ -32778,13 +32765,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, or removes teams.`, Commands: []shared_api.Command{ { - OperationID: `addAllTeamsToProject`, + OperationID: `addGroupTeams`, Aliases: nil, Description: `Adds one or more teams to the specified project. All members of the team share the same project access. MongoDB Cloud limits the number of users to a maximum of 100 teams per project and a maximum of 250 teams per organization. To use this resource, the requesting API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addallteamstoproject. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addgroupteams. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-addAllTeamsToProject/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-addGroupTeams/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/teams`, QueryParameters: []shared_api.Parameter{ @@ -32838,16 +32825,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `addTeamUser`, + OperationID: `addOrgTeamUsers`, Aliases: nil, Description: `Adds one or more MongoDB Cloud users from the specified organization to the specified team. Teams enable you to grant project access roles to MongoDB Cloud users. You can assign up to 250 MongoDB Cloud users from one organization to one team. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This endpoint is deprecated. Use Add One MongoDB Cloud User to One Team to add an active or pending user to a team. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addteamuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addorgteamusers. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-addTeamUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-addOrgTeamUsers/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}/users`, QueryParameters: []shared_api.Parameter{ @@ -32907,13 +32894,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createTeam`, + OperationID: `createOrgTeam`, Aliases: nil, Description: `Creates one team in the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud limits the number of teams to a maximum of 250 teams per organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createteam. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-createTeam/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-createOrgTeam/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/teams`, QueryParameters: []shared_api.Parameter{ @@ -32963,13 +32950,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteTeam`, + OperationID: `deleteOrgTeam`, Aliases: nil, Description: `Removes one team specified using its unique 24-hexadecimal digit identifier from the organization specified using its unique 24-hexadecimal digit identifier. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteteam. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-deleteTeam/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-deleteOrgTeam/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}`, QueryParameters: []shared_api.Parameter{ @@ -33029,13 +33016,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectTeam`, + OperationID: `getGroupTeam`, Aliases: nil, Description: `Returns one team to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectteam. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-getProjectTeam/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-getGroupTeam/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/teams/{teamId}`, QueryParameters: []shared_api.Parameter{ @@ -33099,13 +33086,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getTeamById`, + OperationID: `getOrgTeam`, Aliases: nil, Description: `Returns one team that you identified using its unique 24-hexadecimal digit ID. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getteambyid. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-getTeamById/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-getOrgTeam/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}`, QueryParameters: []shared_api.Parameter{ @@ -33165,13 +33152,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getTeamByName`, + OperationID: `getOrgTeamByName`, Aliases: nil, Description: `Returns one team that you identified using its human-readable name. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getteambyname. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgteambyname. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-getTeamByName/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-getOrgTeamByName/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/teams/byName/{teamName}`, QueryParameters: []shared_api.Parameter{ @@ -33231,15 +33218,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationTeams`, + OperationID: `listGroupTeams`, Aliases: nil, - Description: `Returns all teams that belong to the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud only returns teams for which you have access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. + Description: `Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationteams. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupteams. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-listOrganizationTeams/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-listGroupTeams/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/orgs/{orgId}/teams`, + URL: `/api/atlas/v2/groups/{groupId}/teams`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -33252,13 +33239,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, { @@ -33272,8 +33259,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -33282,26 +33269,30 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, }, }, }, URLParameters: []shared_api.Parameter{ { - Name: `orgId`, - Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, - Short: ``, - Required: true, + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, + Aliases: []string{`projectId`}, }, }, Verb: http.MethodGet, @@ -33317,15 +33308,15 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listProjectTeams`, + OperationID: `listOrgTeams`, Aliases: nil, - Description: `Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. + Description: `Returns all teams that belong to the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud only returns teams for which you have access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectteams. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgteams. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-listProjectTeams/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-listOrgTeams/`, RequestParameters: shared_api.RequestParameters{ - URL: `/api/atlas/v2/groups/{groupId}/teams`, + URL: `/api/atlas/v2/orgs/{orgId}/teams`, QueryParameters: []shared_api.Parameter{ { Name: `envelope`, @@ -33338,13 +33329,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pretty`, - Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `bool`, + Type: `int`, }, }, { @@ -33358,8 +33349,8 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `itemsPerPage`, - Description: `Number of items that the response returns per page.`, + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, Short: ``, Required: false, Type: shared_api.ParameterType{ @@ -33368,30 +33359,26 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - Name: `pageNum`, - Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, Short: ``, Required: false, Type: shared_api.ParameterType{ IsArray: false, - Type: `int`, + Type: `bool`, }, }, }, URLParameters: []shared_api.Parameter{ { - Name: `groupId`, - Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. - - -NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - Short: ``, - Required: true, + Name: `orgId`, + Description: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the /orgs endpoint to retrieve all organizations to which the authenticated user has access.`, + Short: ``, + Required: true, Type: shared_api.ParameterType{ IsArray: false, Type: `string`, }, - Aliases: []string{`projectId`}, }, }, Verb: http.MethodGet, @@ -33407,13 +33394,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeProjectTeam`, + OperationID: `removeGroupTeam`, Aliases: nil, Description: `Removes one team specified using its unique 24-hexadecimal digit identifier from the project specified using its unique 24-hexadecimal digit identifier. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectteam. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removegroupteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-removeProjectTeam/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-removeGroupTeam/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/teams/{teamId}`, QueryParameters: []shared_api.Parameter{ @@ -33467,16 +33454,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeTeamUser`, + OperationID: `removeOrgTeamUserFromTeam`, Aliases: nil, Description: `Removes one MongoDB Cloud user from the specified team. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This endpoint is deprecated. Use Remove One MongoDB Cloud User from One Team to remove an active or pending user from a team. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeteamuser. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeorgteamuserfromteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-removeTeamUser/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-removeOrgTeamUserFromTeam/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}/users/{userId}`, QueryParameters: []shared_api.Parameter{ @@ -33546,13 +33533,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `renameTeam`, + OperationID: `renameOrgTeam`, Aliases: nil, Description: `Renames one team in the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-renameteam. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-renameorgteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-renameTeam/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-renameOrgTeam/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/orgs/{orgId}/teams/{teamId}`, QueryParameters: []shared_api.Parameter{ @@ -33612,13 +33599,13 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateTeamRoles`, + OperationID: `updateGroupTeam`, Aliases: nil, Description: `Updates the project roles assigned to the specified team. You can grant team roles for specific projects and grant project access roles to users in the team. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateteamroles. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupteam. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-updateTeamRoles/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-teams-updateGroupTeam/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/teams/{teamId}`, QueryParameters: []shared_api.Parameter{ @@ -33691,13 +33678,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you IMPORTANT: Each project can only have one configuration per integrationType.`, Commands: []shared_api.Command{ { - OperationID: `createThirdPartyIntegration`, + OperationID: `createGroupIntegration`, Aliases: nil, Description: `Adds the settings for configuring one third-party service integration. These settings apply to all databases managed in the specified MongoDB Cloud project. Each project can have only one configuration per {INTEGRATION-TYPE}. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createthirdpartyintegration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupintegration. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-createThirdPartyIntegration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-createGroupIntegration/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/integrations/{integrationType}`, QueryParameters: []shared_api.Parameter{ @@ -33791,13 +33778,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteThirdPartyIntegration`, + OperationID: `deleteGroupIntegration`, Aliases: nil, Description: `Removes the settings that permit configuring one third-party service integration. These settings apply to all databases managed in one MongoDB Cloud project. If you delete an integration from a project, you remove that integration configuration only for that project. This action doesn't affect any other project or organization's configured {INTEGRATION-TYPE} integrations. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletethirdpartyintegration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletegroupintegration. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-deleteThirdPartyIntegration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-deleteGroupIntegration/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/integrations/{integrationType}`, QueryParameters: []shared_api.Parameter{ @@ -33861,13 +33848,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getThirdPartyIntegration`, + OperationID: `getGroupIntegration`, Aliases: nil, Description: `Returns the settings for configuring integration with one third-party service. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getthirdpartyintegration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupintegration. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-getThirdPartyIntegration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-getGroupIntegration/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/integrations/{integrationType}`, QueryParameters: []shared_api.Parameter{ @@ -33931,13 +33918,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listThirdPartyIntegrations`, + OperationID: `listGroupIntegrations`, Aliases: nil, Description: `Returns the settings that permit integrations with all configured third-party services. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listthirdpartyintegrations. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupintegrations. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-listThirdPartyIntegrations/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-listGroupIntegrations/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/integrations`, QueryParameters: []shared_api.Parameter{ @@ -34021,13 +34008,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateThirdPartyIntegration`, + OperationID: `updateGroupIntegration`, Aliases: nil, Description: `Updates the settings for configuring integration with one third-party service. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatethirdpartyintegration. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupintegration. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-updateThirdPartyIntegration/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-thirdPartyIntegrations-updateGroupIntegration/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/integrations/{integrationType}`, QueryParameters: []shared_api.Parameter{ @@ -34127,7 +34114,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, edits, and removes user-managed X.509 configurations. Also returns and generates MongoDB Cloud-managed X.509 certificates for database users. The following resources help manage database users who authenticate using X.509 certificates. You can manage these X.509 certificates or let MongoDB Cloud do it for you. If MongoDB Cloud manages your certificates, it also manages your Certificate Authority and can generate certificates for your database users. No additional X.509 configuration is required. If you manage your certificates, you must provide a Certificate Authority and generate certificates for your database users.`, Commands: []shared_api.Command{ { - OperationID: `createDatabaseUserCertificate`, + OperationID: `createGroupDatabaseUserCert`, Aliases: nil, Description: `Generates one X.509 certificate for the specified MongoDB user. Atlas manages the certificate and MongoDB user that belong to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -34137,9 +34124,9 @@ To get MongoDB Cloud to generate a managed certificate for a database user, set If you are managing your own Certificate Authority (CA) in Self-Managed X.509 mode, you must generate certificates for database users using your own CA. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createdatabaseusercertificate. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupdatabaseusercert. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-x509Authentication-createDatabaseUserCertificate/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-x509Authentication-createGroupDatabaseUserCert/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/databaseUsers/{username}/certs`, QueryParameters: []shared_api.Parameter{ @@ -34203,16 +34190,16 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `disableCustomerManagedX509`, + OperationID: `disableGroupUserSecurityCustomerX509`, Aliases: nil, Description: `Clears the customer-managed X.509 settings on a project, including the uploaded Certificate Authority, which disables self-managed X.509. Updating this configuration triggers a rolling restart of the database. You must have the Project Owner role to use this endpoint. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablecustomermanagedx509. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablegroupusersecuritycustomerx509. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-x509Authentication-disableCustomerManagedX509/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-x509Authentication-disableGroupUserSecurityCustomerX509/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/userSecurity/customerX509`, QueryParameters: []shared_api.Parameter{ @@ -34256,13 +34243,13 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDatabaseUserCertificates`, + OperationID: `listGroupDatabaseUserCerts`, Aliases: nil, Description: `Returns all unexpired X.509 certificates for the specified MongoDB user. This MongoDB user belongs to one project. Atlas manages these certificates and the MongoDB user. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. -This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabaseusercertificates. +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listgroupdatabaseusercerts. -For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-x509Authentication-listDatabaseUserCertificates/`, +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-x509Authentication-listGroupDatabaseUserCerts/`, RequestParameters: shared_api.RequestParameters{ URL: `/api/atlas/v2/groups/{groupId}/databaseUsers/{username}/certs`, QueryParameters: []shared_api.Parameter{ diff --git a/test/e2e/atlas/autogeneration/autogeneratedcommands/autogenerated_commands_test.go b/test/e2e/atlas/autogeneration/autogeneratedcommands/autogenerated_commands_test.go index 9465545068..41a87302f6 100644 --- a/test/e2e/atlas/autogeneration/autogeneratedcommands/autogenerated_commands_test.go +++ b/test/e2e/atlas/autogeneration/autogeneratedcommands/autogenerated_commands_test.go @@ -37,8 +37,8 @@ func TestAutogeneratedCommands(t *testing.T) { req := require.New(t) req.NoError(err) - t.Run("getCluster_RequiredFieldNotSet", func(_ *testing.T) { - cmd := exec.Command(cliPath, "api", "clusters", "getCluster", "-P", internal.ProfileName()) + t.Run("getGroupCluster_RequiredFieldNotSet", func(_ *testing.T) { + cmd := exec.Command(cliPath, "api", "clusters", "getGroupCluster", "-P", internal.ProfileName()) cmd.Env = os.Environ() _, err := internal.RunAndGetStdOutAndErr(cmd) @@ -52,8 +52,8 @@ func TestAutogeneratedCommands(t *testing.T) { Name string `json:"name"` } - t.Run("getCluster_OK", func(_ *testing.T) { - cmd := exec.Command(cliPath, "api", "clusters", "getCluster", "--groupId", g.ProjectID, "--clusterName", g.ClusterName, "-P", internal.ProfileName()) + t.Run("getGroupCluster_OK", func(_ *testing.T) { + cmd := exec.Command(cliPath, "api", "clusters", "getGroupCluster", "--groupId", g.ProjectID, "--clusterName", g.ClusterName, "-P", internal.ProfileName()) cmd.Env = os.Environ() stdOut, stdErr, err := internal.RunAndGetSeparateStdOutAndErr(cmd) @@ -70,8 +70,8 @@ func TestAutogeneratedCommands(t *testing.T) { req.Contains(errorStr, "'; consider pinning a version to ensure consisentcy when updating the CLI\n") }) - t.Run("getCluster_valid_version_OK", func(_ *testing.T) { - cmd := exec.Command(cliPath, "api", "clusters", "getCluster", "--groupId", g.ProjectID, "--clusterName", g.ClusterName, "--version", "2024-08-05", "-P", internal.ProfileName()) + t.Run("getGroupCluster_valid_version_OK", func(_ *testing.T) { + cmd := exec.Command(cliPath, "api", "clusters", "getGroupCluster", "--groupId", g.ProjectID, "--clusterName", g.ClusterName, "--version", "2024-08-05", "-P", internal.ProfileName()) cmd.Env = os.Environ() stdOut, stdErr, err := internal.RunAndGetSeparateStdOutAndErr(cmd) @@ -88,8 +88,8 @@ func TestAutogeneratedCommands(t *testing.T) { req.NotContains(errorStr, "'; consider pinning a version to ensure consisentcy when updating the CLI\n") }) - t.Run("getCluster_valid_version_OK_using_projectID_alias", func(_ *testing.T) { - cmd := exec.Command(cliPath, "api", "clusters", "getCluster", "--projectId", g.ProjectID, "--clusterName", g.ClusterName, "--version", "2024-08-05", "-P", internal.ProfileName()) + t.Run("getGroupCluster_valid_version_OK_using_projectID_alias", func(_ *testing.T) { + cmd := exec.Command(cliPath, "api", "clusters", "getGroupCluster", "--projectId", g.ProjectID, "--clusterName", g.ClusterName, "--version", "2024-08-05", "-P", internal.ProfileName()) cmd.Env = os.Environ() stdOut, stdErr, err := internal.RunAndGetSeparateStdOutAndErr(cmd) @@ -106,8 +106,8 @@ func TestAutogeneratedCommands(t *testing.T) { req.NotContains(errorStr, "'; consider pinning a version to ensure consisentcy when updating the CLI\n") }) - t.Run("getCluster_invalid_version_warn", func(_ *testing.T) { - cmd := exec.Command(cliPath, "api", "clusters", "getCluster", "--groupId", g.ProjectID, "--clusterName", g.ClusterName, "--version", "2020-01-01", "-P", internal.ProfileName()) + t.Run("getGroupCluster_invalid_version_warn", func(_ *testing.T) { + cmd := exec.Command(cliPath, "api", "clusters", "getGroupCluster", "--groupId", g.ProjectID, "--clusterName", g.ClusterName, "--version", "2020-01-01", "-P", internal.ProfileName()) cmd.Env = os.Environ() stdOut, stdErr, err := internal.RunAndGetSeparateStdOutAndErr(cmd) diff --git a/test/internal/helper.go b/test/internal/helper.go index 892a2185e7..e8f7bbbacc 100644 --- a/test/internal/helper.go +++ b/test/internal/helper.go @@ -1512,7 +1512,7 @@ func createOrgServiceAccount(cliPath, name string) (string, string, error) { args := []string{ apiEntity, serviceAccountsEntity, - "createServiceAccount", + "createOrgServiceAccount", "--version", serviceAccountAPIVersion, "-P", @@ -1564,7 +1564,7 @@ func deleteOrgServiceAccount(t *testing.T, cliPath, clientID string) { args := []string{ apiEntity, serviceAccountsEntity, - "deleteServiceAccount", + "deleteOrgServiceAccount", "--clientId", clientID, "--version", diff --git a/tools/cmd/docs/metadata.go b/tools/cmd/docs/metadata.go index 79f5b87696..f3ef1c6249 100644 --- a/tools/cmd/docs/metadata.go +++ b/tools/cmd/docs/metadata.go @@ -20,7 +20,7 @@ package main import "github.com/mongodb/mongodb-atlas-cli/atlascli/tools/internal/metadatatypes" var metadata = metadatatypes.Metadata{ - `acceptVpcPeeringConnection`: { + `acceptGroupStreamVpcPeeringConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -36,7 +36,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `acknowledgeAlert`: { + `acknowledgeGroupAlert`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `alertId`: { Usage: `Unique 24-hexadecimal digit string that identifies the alert.`, @@ -55,7 +55,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `addAllTeamsToProject`: { + `addGroupAccessUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -71,24 +71,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `addOrganizationRole`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, - }, - }, - Examples: nil, - }, - `addProjectApiKey`: { + `addGroupApiKey`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `apiUserId`: { Usage: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to assign to one project.`, @@ -107,7 +90,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `addProjectRole`: { + `addGroupTeams`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -120,17 +103,11 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, - }, }, Examples: nil, }, - `addProjectServiceAccount`: { + `addGroupUserRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -142,10 +119,13 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, + }, }, Examples: nil, }, - `addProjectUser`: { + `addGroupUsers`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -161,7 +141,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `addTeamUser`: { + `addOrgTeamUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -173,28 +153,29 @@ var metadata = metadatatypes.Metadata{ Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, `teamId`: { - Usage: `Unique 24-hexadecimal character string that identifies the team to which you want to add MongoDB Cloud users.`, + Usage: `Unique 24-hexadecimal digit string that identifies the team to add the MongoDB Cloud user to.`, }, }, Examples: nil, }, - `addUserToProject`: { + `addOrgTeamUsers`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `teamId`: { + Usage: `Unique 24-hexadecimal character string that identifies the team to which you want to add MongoDB Cloud users.`, + }, }, Examples: nil, }, - `addUserToTeam`: { + `addOrgUserRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -205,13 +186,13 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `teamId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the team to add the MongoDB Cloud user to.`, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, }, }, Examples: nil, }, - `authorizeCloudProviderAccessRole`: { + `authorizeGroupCloudProviderAccessRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -230,7 +211,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `autoScalingConfiguration`: { + `autoGroupClusterScalingConfiguration`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies this cluster.`, @@ -259,7 +240,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `cancelBackupRestoreJob`: { + `cancelGroupClusterBackupRestoreJob`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster.`, @@ -292,67 +273,64 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `createAlertConfiguration`: { + `createFederationSettingConnectedOrgConfigRoleMapping`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, }, Examples: nil, }, - `createApiKey`: { + `createFederationSettingIdentityProvider`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, }, }, Examples: nil, }, - `createApiKeyAccessList`: { + `createGroup`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to create a new access list entry.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `projectOwnerId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user to whom to grant the Project Owner role on the specified project. If you set this parameter, it overrides the default value of the oldest Organization Owner.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `create_project`, + Name: `Create a basic project with environment tag`, + Description: `Creates a new project named "MongoTube" with an environment tag set to "e2e"`, + Value: `{ + "name": "MongoTube", + "orgId": "67b715468c10250b968dcb84", + "tags": [ + { + "key": "environment", + "value": "e2e" + } + ] +}`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: nil, }, - `createAtlasSearchDeployment`: { + `createGroupAccessListEntry`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Label that identifies the cluster to create Search Nodes for.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -361,17 +339,43 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: nil, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `project_ip_access_list_add`, + Name: `Add Entries to Project IP Access List`, + Description: `Adds multiple access list entries to the specified project`, + Value: `[ + { + "cidrBlock": "192.168.1.0/24", + "comment": "Internal network range" + }, + { + "cidrBlock": "10.0.0.0/16", + "comment": "VPC network range" + } +]`, + Flags: map[string]string{ + `groupId`: `[your-project-id]`, + }, + }, + }, + }, }, - `createAtlasSearchIndex`: { + `createGroupAlertConfig`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Name of the cluster that contains the collection on which to create an Atlas Search index.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -386,11 +390,8 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createAtlasSearchIndexDeprecated`: { + `createGroupApiKey`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Name of the cluster that contains the collection on which to create an Atlas Search index.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -405,11 +406,8 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createBackupExportJob`: { + `createGroupBackupExportBucket`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -418,29 +416,69 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, }, - Examples: nil, - }, - `createBackupRestoreJob`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `AWS`, + + Description: `AWS`, + Value: `{ + "bucketName": "export-bucket", + "cloudProvider": "AWS", + "iamRoleId": "668c5f0ed436263134491592", + "requirePrivateNetworking": false +}`, + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, }, - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + `2024-05-30`: {{ + Source: `AWS`, -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Description: `AWS`, + Value: `{ + "bucketName": "export-bucket", + "cloudProvider": "AWS", + "iamRoleId": "668c5f0ed436263134491592", + "requirePrivateNetworking": false +}`, + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, { + Source: `Azure`, + + Description: `Azure`, + Value: `{ + "bucketName": "examplecontainer", + "cloudProvider": "AZURE", + "roleId": "668c5f0ed436263134491592", + "serviceUrl": "https://examplestorageaccount.blob.core.windows.net/examplecontainer" +}`, + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, { + Source: `GCP`, + + Description: `GCP`, + Value: `{ + "bucketName": "export-bucket", + "cloudProvider": "GCP", + "roleId": "668c5f0ed436263134491592" +}`, + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: nil, }, - `createCloudProviderAccessRole`: { + `createGroupCloudProviderAccess`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -456,7 +494,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createCluster`: { + `createGroupCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -730,19 +768,65 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `createCostExplorerQueryProcess`: { + `createGroupClusterBackupExport`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + }, + Examples: nil, + }, + `createGroupClusterBackupRestoreJob`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `createGroupClusterBackupTenantRestore`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `createCustomDatabaseRole`: { + `createGroupClusterFtsIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Name of the cluster that contains the collection on which to create an Atlas Search index.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -757,7 +841,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createCustomZoneMapping`: { + `createGroupClusterGlobalWriteCustomZoneMapping`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies this cluster.`, @@ -776,8 +860,11 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createDataFederationPrivateEndpoint`: { + `createGroupClusterGlobalWriteManagedNamespace`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies this cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -792,8 +879,11 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createDatabaseUser`: { + `createGroupClusterIndexRollingIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster on which MongoDB Cloud creates an index.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -808,9 +898,259 @@ var metadata = metadatatypes.Metadata{ }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `AWS IAM Authentication`, + Source: `2dspere Index`, - Description: `AWS IAM Authentication`, + Description: `2dspere Index`, + Value: `{ + "collation": { + "alternate": "non-ignorable", + "backwards": false, + "caseFirst": "lower", + "caseLevel": false, + "locale": "af", + "maxVariable": "punct", + "normalization": false, + "numericOrdering": false, + "strength": 3 + }, + "collection": "accounts", + "db": "sample_airbnb", + "keys": [ + { + "property_type": "1" + } + ], + "options": { + "name": "PartialIndexTest", + "partialFilterExpression": { + "limit": { + "$gt": 900 + } + } + } +}`, + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, { + Source: `Partial Index`, + + Description: `Partial Index`, + Value: `{ + "collation": { + "alternate": "non-ignorable", + "backwards": false, + "caseFirst": "lower", + "caseLevel": false, + "locale": "af", + "maxVariable": "punct", + "normalization": false, + "numericOrdering": false, + "strength": 3 + }, + "collection": "accounts", + "db": "sample_airbnb", + "keys": [ + { + "property_type": "1" + } + ], + "options": { + "name": "PartialIndexTest", + "partialFilterExpression": { + "limit": { + "$gt": 900 + } + } + } +}`, + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, { + Source: `Sparse Index`, + + Description: `Sparse Index`, + Value: `{ + "collation": { + "alternate": "non-ignorable", + "backwards": false, + "caseFirst": "lower", + "caseLevel": false, + "locale": "af", + "maxVariable": "punct", + "normalization": false, + "numericOrdering": false, + "strength": 3 + }, + "collection": "accounts", + "db": "sample_airbnb", + "keys": [ + { + "test_field": "1" + } + ], + "options": { + "name": "SparseIndexTest", + "sparse": true + } +}`, + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, + }, + }, + }, + `createGroupClusterOnlineArchive`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that contains the collection for which you want to create one online archive.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `createGroupClusterRestoreJob`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `createGroupClusterSearchDeployment`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Label that identifies the cluster to create Search Nodes for.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `createGroupClusterSearchIndex`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Name of the cluster that contains the collection on which to create an Atlas Search index.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `createGroupContainer`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `createGroupCustomDbRoleRole`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `createGroupDataFederation`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `skipRoleValidation`: { + Usage: `Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check.`, + }, + }, + Examples: nil, + }, + `createGroupDatabaseUser`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `AWS IAM Authentication`, + + Description: `AWS IAM Authentication`, Value: `{ "awsIAMType": "USER", "databaseName": "$external", @@ -936,155 +1276,47 @@ var metadata = metadatatypes.Metadata{ "databaseName": "sales", "roleName": "readWrite" }, - { - "databaseName": "marketing", - "roleName": "read" - } - ], - "scopes": [ - { - "name": "myCluster", - "type": "CLUSTER" - } - ], - "username": "david" -}`, - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, { - Source: `X509 Authentication`, - - Description: `X509 Authentication`, - Value: `{ - "databaseName": "$external", - "groupId": "32b6e34b3d91647abb20e7b8", - "roles": [ - { - "databaseName": "sales", - "roleName": "readWrite" - }, - { - "databaseName": "marketing", - "roleName": "read" - } - ], - "scopes": [ - { - "name": "myCluster", - "type": "CLUSTER" - } - ], - "username": "CN=david@example.com,OU=users,DC=example,DC=com", - "x509Type": "CUSTOMER" -}`, - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, - }, - }, - }, - `createDatabaseUserCertificate`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `username`: { - Usage: `Human-readable label that represents the MongoDB database user account for whom to create a certificate.`, - }, - }, - Examples: nil, - }, - `createEncryptionAtRestPrivateEndpoint`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Human-readable label that identifies the cloud provider for the private endpoint to create.`, - }, - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `createExportBucket`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `AWS`, - - Description: `AWS`, - Value: `{ - "bucketName": "export-bucket", - "cloudProvider": "AWS", - "iamRoleId": "668c5f0ed436263134491592" -}`, - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, - }, - `2024-05-30`: {{ - Source: `AWS`, - - Description: `AWS`, - Value: `{ - "bucketName": "export-bucket", - "cloudProvider": "AWS", - "iamRoleId": "668c5f0ed436263134491592" -}`, - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, { - Source: `Azure`, - - Description: `Azure`, - Value: `{ - "bucketName": "examplecontainer", - "cloudProvider": "AZURE", - "roleId": "668c5f0ed436263134491592", - "serviceUrl": "https://examplestorageaccount.blob.core.windows.net/examplecontainer" + { + "databaseName": "marketing", + "roleName": "read" + } + ], + "scopes": [ + { + "name": "myCluster", + "type": "CLUSTER" + } + ], + "username": "david" }`, Flags: map[string]string{ `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, { - Source: `GCP`, + Source: `X509 Authentication`, - Description: `GCP`, + Description: `X509 Authentication`, Value: `{ - "bucketName": "export-bucket", - "cloudProvider": "GCP", - "roleId": "668c5f0ed436263134491592" + "databaseName": "$external", + "groupId": "32b6e34b3d91647abb20e7b8", + "roles": [ + { + "databaseName": "sales", + "roleName": "readWrite" + }, + { + "databaseName": "marketing", + "roleName": "read" + } + ], + "scopes": [ + { + "name": "myCluster", + "type": "CLUSTER" + } + ], + "username": "CN=david@example.com,OU=users,DC=example,DC=com", + "x509Type": "CUSTOMER" }`, Flags: map[string]string{ `groupId`: `32b6e34b3d91647abb20e7b8`, @@ -1093,7 +1325,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `createFederatedDatabase`: { + `createGroupDatabaseUserCert`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1106,14 +1338,17 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `skipRoleValidation`: { - Usage: `Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check.`, + `username`: { + Usage: `Human-readable label that represents the MongoDB database user account for whom to create a certificate.`, }, }, Examples: nil, }, - `createFlexBackupRestoreJob`: { + `createGroupEncryptionAtRestPrivateEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `cloudProvider`: { + Usage: `Human-readable label that identifies the cloud provider for the private endpoint to create.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1122,16 +1357,13 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `name`: { - Usage: `Human-readable label that identifies the flex cluster whose snapshot you want to restore.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `createFlexCluster`: { + `createGroupFlexCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1147,22 +1379,8 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createIdentityProvider`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, - }, - }, - Examples: nil, - }, - `createLegacyBackupRestoreJob`: { + `createGroupFlexClusterBackupRestoreJob`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1171,19 +1389,8 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `createLinkToken`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `name`: { + Usage: `Human-readable label that identifies the flex cluster whose snapshot you want to restore.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -1191,11 +1398,8 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createManagedNamespace`: { + `createGroupIntegration`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1204,44 +1408,26 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, - }, - Examples: nil, - }, - `createOneDataFederationQueryLimit`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + `integrationType`: { + Usage: `Human-readable label that identifies the service which you want to integrate with MongoDB Cloud.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - `limitName`: { - Usage: `Human-readable label that identifies this data federation instance limit. - -| Limit Name | Description | Default | -| --- | --- | --- | -| bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | -| bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | -| bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | -| bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | -`, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the federated database instance to which the query limit applies.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `createOnlineArchive`: { + `createGroupInvite`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that contains the collection for which you want to create one online archive.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1256,60 +1442,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createOrgResourcePolicy`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `createOrganization`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `createOrganizationInvitation`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `createOrganizationUser`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `createPeeringConnection`: { + `createGroupLiveMigration`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1325,7 +1458,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createPeeringContainer`: { + `createGroupPeer`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1341,7 +1474,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createPipeline`: { + `createGroupPipeline`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1354,14 +1487,8 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createPrivateEndpoint`: { + `createGroupPrivateEndpointEndpointService`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Cloud service provider that manages this private endpoint.`, - }, - `endpointServiceId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to create a private endpoint.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1376,24 +1503,14 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createPrivateEndpointService`: { + `createGroupPrivateEndpointEndpointServiceEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `cloudProvider`: { + Usage: `Cloud service provider that manages this private endpoint.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `endpointServiceId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to create a private endpoint.`, }, - }, - Examples: nil, - }, - `createPrivateLinkConnection`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1408,38 +1525,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createProject`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `projectOwnerId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user to whom to grant the Project Owner role on the specified project. If you set this parameter, it overrides the default value of the oldest Organization Owner.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `create_project`, - Name: `Create a basic project with environment tag`, - Description: `Creates a new project named "MongoTube" with an environment tag set to "e2e"`, - Value: `{ - "name": "MongoTube", - "orgId": "67b715468c10250b968dcb84", - "tags": [ - { - "key": "environment", - "value": "e2e" - } - ] -}`, - }, - }, - }, - }, - `createProjectApiKey`: { + `createGroupPrivateEndpointServerlessInstanceEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1449,13 +1535,13 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `instanceName`: { + Usage: `Human-readable label that identifies the serverless instance for which the tenant endpoint will be created.`, }, }, Examples: nil, }, - `createProjectInvitation`: { + `createGroupPrivateNetworkSettingEndpointId`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1471,7 +1557,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createProjectIpAccessList`: { + `createGroupPushBasedLogExport`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1481,43 +1567,17 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `project_ip_access_list_add`, - Name: `Add Entries to Project IP Access List`, - Description: `Adds multiple access list entries to the specified project`, - Value: `[ - { - "cidrBlock": "192.168.1.0/24", - "comment": "Internal network range" - }, - { - "cidrBlock": "10.0.0.0/16", - "comment": "VPC network range" - } -]`, - Flags: map[string]string{ - `groupId`: `[your-project-id]`, - }, - }, - }, - }, + Examples: nil, }, - `createProjectServiceAccount`: { + `createGroupServerlessBackupRestoreJob`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the serverless instance whose snapshot you want to restore.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1532,11 +1592,8 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createProjectServiceAccountAccessList`: { + `createGroupServerlessInstance`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1545,26 +1602,14 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `createProjectServiceAccountSecret`: { + `createGroupServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1579,8 +1624,11 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createPushBasedLogConfiguration`: { + `createGroupServiceAccountAccessList`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1589,14 +1637,26 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `createPushMigration`: { + `createGroupServiceAccountSecret`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1611,25 +1671,27 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createRoleMapping`: { + `createGroupStreamConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, }, }, Examples: nil, }, - `createRollingIndex`: { + `createGroupStreamPrivateLinkConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster on which MongoDB Cloud creates an index.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1642,120 +1704,10 @@ var metadata = metadatatypes.Metadata{ Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `2dspere Index`, - - Description: `2dspere Index`, - Value: `{ - "collation": { - "alternate": "non-ignorable", - "backwards": false, - "caseFirst": "lower", - "caseLevel": false, - "locale": "af", - "maxVariable": "punct", - "normalization": false, - "numericOrdering": false, - "strength": 3 - }, - "collection": "accounts", - "db": "sample_airbnb", - "keys": [ - { - "property_type": "1" - } - ], - "options": { - "name": "PartialIndexTest", - "partialFilterExpression": { - "limit": { - "$gt": 900 - } - } - } -}`, - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, { - Source: `Partial Index`, - - Description: `Partial Index`, - Value: `{ - "collation": { - "alternate": "non-ignorable", - "backwards": false, - "caseFirst": "lower", - "caseLevel": false, - "locale": "af", - "maxVariable": "punct", - "normalization": false, - "numericOrdering": false, - "strength": 3 - }, - "collection": "accounts", - "db": "sample_airbnb", - "keys": [ - { - "property_type": "1" - } - ], - "options": { - "name": "PartialIndexTest", - "partialFilterExpression": { - "limit": { - "$gt": 900 - } - } - } -}`, - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, { - Source: `Sparse Index`, - - Description: `Sparse Index`, - Value: `{ - "collation": { - "alternate": "non-ignorable", - "backwards": false, - "caseFirst": "lower", - "caseLevel": false, - "locale": "af", - "maxVariable": "punct", - "normalization": false, - "numericOrdering": false, - "strength": 3 - }, - "collection": "accounts", - "db": "sample_airbnb", - "keys": [ - { - "test_field": "1" - } - ], - "options": { - "name": "SparseIndexTest", - "sparse": true - } -}`, - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, - }, - }, + Examples: nil, }, - `createServerlessBackupRestoreJob`: { + `createGroupStreamProcessor`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the serverless instance whose snapshot you want to restore.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1767,10 +1719,13 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, + }, }, Examples: nil, }, - `createServerlessInstance`: { + `createGroupStreamWorkspace`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1786,23 +1741,18 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createServerlessPrivateEndpoint`: { + `createOrg`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `instanceName`: { - Usage: `Human-readable label that identifies the serverless instance for which the tenant endpoint will be created.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `createServiceAccount`: { + `createOrgApiKey`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1816,10 +1766,10 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createServiceAccountAccessList`: { + `createOrgApiKeyAccessListEntry`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to create a new access list entry.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -1842,35 +1792,24 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createServiceAccountSecret`: { + `createOrgBillingCostExplorerUsageProcess`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, `orgId`: { Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, }, Examples: nil, }, - `createSharedClusterBackupRestoreJob`: { + `createOrgInvite`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -1878,34 +1817,27 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createStreamConnection`: { + `createOrgLiveMigrationLinkToken`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: nil, }, - `createStreamInstance`: { + `createOrgResourcePolicy`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -1913,15 +1845,13 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createStreamInstanceWithSampleConnections`: { + `createOrgServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -1929,27 +1859,37 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createStreamProcessor`: { + `createOrgServiceAccountAccessList`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: nil, }, - `createTeam`: { + `createOrgServiceAccountSecret`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -1962,27 +1902,27 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `createThirdPartyIntegration`: { + `createOrgTeam`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, - `integrationType`: { - Usage: `Human-readable label that identifies the service which you want to integrate with MongoDB Cloud.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, + }, + Examples: nil, + }, + `createOrgUser`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -2001,7 +1941,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `cutoverMigration`: { + `cutoverGroupLiveMigration`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2030,7 +1970,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `deauthorizeCloudProviderAccessRole`: { + `deauthorizeGroupCloudProviderAccessRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `cloudProvider`: { Usage: `Human-readable label that identifies the cloud provider of the role to deauthorize.`, @@ -2063,7 +2003,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `deferMaintenanceWindow`: { + `deferGroupMaintenanceWindow`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2085,11 +2025,77 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `deleteAlertConfiguration`: { + `deleteFederationSetting`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `alertConfigId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `federationSettingsId`: `55fa922fb343282757d9554e`, + }, + }, + }, + }, + }, + `deleteFederationSettingConnectedOrgConfigRoleMapping`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `id`: { + Usage: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to remove.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `federationSettingsId`: `55fa922fb343282757d9554e`, + `id`: `32b6e34b3d91647abb20e7b8`, + `orgId`: `4888442a3354817a7320eb61`, + }, + }, + }, + }, + }, + `deleteFederationSettingIdentityProvider`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `identityProviderId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the identity provider to connect.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-11-15`: {{ + Source: `-`, + + Flags: map[string]string{ + `federationSettingsId`: `55fa922fb343282757d9554e`, + `identityProviderId`: `32b6e34b3d91647abb20e7b8`, + }, }, + }, + }, + }, + `deleteGroup`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -2104,20 +2110,25 @@ var metadata = metadatatypes.Metadata{ }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `-`, + Source: `delete_project`, + Name: `Delete a project`, + Description: `Deletes an existing project`, Flags: map[string]string{ - `alertConfigId`: `32b6e34b3d91647abb20e7b8`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteAllBackupSchedules`: { + `deleteGroupAccessListEntry`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `entryValue`: { + Usage: `Access list entry that you want to remove from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (` + "`" + `/` + "`" + `) with its URL-encoded value (` + "`" + `%2F` + "`" + `). When you remove an entry from the IP access list, existing connections from the removed address or addresses may remain open for a variable amount of time. The amount of time it takes MongoDB Cloud to close the connection depends upon several factors, including: + +- how your application established the connection, +- how MongoDB Cloud or the driver using the address behaves, and +- which protocol (like TCP or UDP) the connection uses.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2127,23 +2138,28 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ - Source: `-`, + `2023-01-01`: {{ + Source: `project_ip_access_list_delete`, + Name: `Remove One Entry from One Project IP Access List`, + Description: `Removes one access list entry from the specified project's IP access list`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `entryValue`: `10.0.0.0/16`, + `groupId`: `[your-project-id]`, }, }, }, }, }, - `deleteAllCustomZoneMappings`: { + `deleteGroupAlertConfig`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, + `alertConfigId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2158,30 +2174,29 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `alertConfigId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteApiKey`: { + `deleteGroupBackupExportBucket`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `exportBucketId`: { + Usage: `Unique 24-hexadecimal character string that identifies the Export Bucket.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -2189,48 +2204,51 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `apiUserId`: `[apiUserId]`, - `orgId`: `4888442a3354817a7320eb61`, + `exportBucketId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteApiKeyAccessListEntry`: { + `deleteGroupCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to remove access list entries.`, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `ipAddress`: { - Usage: `One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `retainBackups`: { + Usage: `Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, + `2023-02-01`: {{ + Source: `delete_cluster`, + Name: `Delete a cluster`, + Description: `Deletes the specified cluster from the project`, Flags: map[string]string{ - `apiUserId`: `[apiUserId]`, - `ipAddress`: `192.0.2.0%2F24`, - `orgId`: `4888442a3354817a7320eb61`, + `clusterName`: `[your-cluster-name]`, + `groupId`: `[your-project-id]`, }, }, }, }, }, - `deleteAtlasSearchDeployment`: { + `deleteGroupClusterBackupSchedule`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Label that identifies the cluster to delete.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2240,12 +2258,9 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ @@ -2256,10 +2271,10 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `deleteAtlasSearchIndex`: { + `deleteGroupClusterBackupSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2269,36 +2284,30 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `indexId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ `clusterName`: `[clusterName]`, `groupId`: `32b6e34b3d91647abb20e7b8`, - `indexId`: `[indexId]`, + `snapshotId`: `[snapshotId]`, }, }, }, }, }, - `deleteAtlasSearchIndexByName`: { + `deleteGroupClusterBackupSnapshotShardedCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, - }, - `collectionName`: { - Usage: `Name of the collection that contains one or more Atlas Search indexes.`, - }, - `databaseName`: { - Usage: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2308,29 +2317,27 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `indexName`: { - Usage: `Name of the Atlas Search index to delete.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `collectionName`: `[collectionName]`, - `databaseName`: `[databaseName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `indexName`: `[indexName]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `snapshotId`: `[snapshotId]`, }, }, }, }, }, - `deleteAtlasSearchIndexDeprecated`: { + `deleteGroupClusterFtsIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, @@ -2363,10 +2370,10 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `deleteCluster`: { + `deleteGroupClusterGlobalWriteCustomZoneMapping`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + Usage: `Human-readable label that identifies this cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2379,26 +2386,30 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `retainBackups`: { - Usage: `Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ - Source: `delete_cluster`, - Name: `Delete a cluster`, - Description: `Deletes the specified cluster from the project`, + `2024-08-05`: {{ + Source: `-`, Flags: map[string]string{ - `clusterName`: `[your-cluster-name]`, - `groupId`: `[your-project-id]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteCustomDatabaseRole`: { + `deleteGroupClusterGlobalWriteManagedNamespaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies this cluster.`, + }, + `collection`: { + Usage: `Human-readable label that identifies the collection associated with the managed namespace.`, + }, + `db`: { + Usage: `Human-readable label that identifies the database that contains the collection.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -2410,26 +2421,56 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `roleName`: { - Usage: `Human-readable label that identifies the role for the request. This name must be unique for this custom role in this project.`, + }, + Examples: map[string][]metadatatypes.Example{ + `2024-08-05`: {{ + Source: `-`, + + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, + }, + }, + }, + `deleteGroupClusterOnlineArchive`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `archiveId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the online archive to delete.`, + }, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that contains the collection from which you want to remove an online archive.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `roleName`: `[roleName]`, + Flags: map[string]string{ + `archiveId`: `[archiveId]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteDataFederationPrivateEndpoint`: { + `deleteGroupClusterSearchDeployment`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `endpointId`: { - Usage: `Unique 22-character alphanumeric string that identifies the private endpoint to remove. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature.`, + `clusterName`: { + Usage: `Label that identifies the cluster to delete.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2448,17 +2489,17 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `endpointId`: `[endpointId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteDatabaseUser`: { + `deleteGroupClusterSearchIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `databaseName`: { - Usage: `The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be ` + "`" + `$external` + "`" + `. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be ` + "`" + `admin` + "`" + `.`, + `clusterName`: { + Usage: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2468,67 +2509,72 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `indexId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the Atlas Search index. Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `username`: { - Usage: `Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: - -| Authentication Method | Parameter Needed | Parameter Value | username Format | -|---|---|---|---| -| AWS IAM | awsIAMType | ROLE | ARN | -| AWS IAM | awsIAMType | USER | ARN | -| x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | -| x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | -| LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | -| LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | -| OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | -| OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | -| SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | -`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `databaseName`: `[databaseName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `username`: `SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `indexId`: `[indexId]`, }, }, }, }, }, - `deleteExportBucket`: { + `deleteGroupClusterSearchIndexByName`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Name of the cluster that contains the database and collection with one or more Application Search indexes.`, + }, + `collectionName`: { + Usage: `Name of the collection that contains one or more Atlas Search indexes.`, + }, + `databaseName`: { + Usage: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `exportBucketId`: { - Usage: `Unique 24-hexadecimal character string that identifies the Export Bucket.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `indexName`: { + Usage: `Name of the Atlas Search index to delete.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `exportBucketId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `collectionName`: `[collectionName]`, + `databaseName`: `[databaseName]`, `groupId`: `32b6e34b3d91647abb20e7b8`, + `indexName`: `[indexName]`, }, }, }, }, }, - `deleteFederatedDatabase`: { + `deleteGroupClusterSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -2540,8 +2586,8 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the federated database instance to remove.`, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -2549,17 +2595,29 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `tenantName`: `[tenantName]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `snapshotId`: `[snapshotId]`, }, }, }, }, }, - `deleteFederationApp`: { + `deleteGroupContainer`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + `containerId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -2567,13 +2625,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, + `containerId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteFlexCluster`: { + `deleteGroupCustomDbRoleRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2583,50 +2642,55 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `name`: { - Usage: `Human-readable label that identifies the flex cluster.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `roleName`: { + Usage: `Human-readable label that identifies the role for the request. This name must be unique for this custom role in this project.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `roleName`: `[roleName]`, }, }, }, }, }, - `deleteIdentityProvider`: { + `deleteGroupDataFederation`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `identityProviderId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the identity provider to connect.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `tenantName`: { + Usage: `Human-readable label that identifies the federated database instance to remove.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-11-15`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, - `identityProviderId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `deleteLdapConfiguration`: { + `deleteGroupDataFederationLimit`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2636,8 +2700,19 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `limitName`: { + Usage: `Human-readable label that identifies this data federation instance limit. + +| Limit Name | Description | Default | +| --- | --- | --- | +| bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | +| bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | +| bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | +| bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | +`, + }, + `tenantName`: { + Usage: `Human-readable label that identifies the federated database instance to which the query limit applies.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -2645,16 +2720,18 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `limitName`: `[limitName]`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `deleteLegacySnapshot`: { + `deleteGroupDatabaseUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `databaseName`: { + Usage: `The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be ` + "`" + `$external` + "`" + `. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be ` + "`" + `admin` + "`" + `.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2667,8 +2744,21 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + `username`: { + Usage: `Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: + +| Authentication Method | Parameter Needed | Parameter Value | username Format | +|---|---|---|---| +| AWS IAM | awsIAMType | ROLE | ARN | +| AWS IAM | awsIAMType | USER | ARN | +| x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | +| x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | +| LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | +| LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | +| OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | +| OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | +| SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | +`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -2676,45 +2766,45 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `snapshotId`: `[snapshotId]`, + `databaseName`: `[databaseName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `username`: `SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName`, }, }, }, }, }, - `deleteLinkToken`: { + `deleteGroupFlexCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `name`: { + Usage: `Human-readable label that identifies the flex cluster.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, }, }, }, }, }, - `deleteManagedNamespace`: { + `deleteGroupIntegration`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, - }, - `collection`: { - Usage: `Human-readable label that identifies the collection associated with the managed namespace.`, - }, - `db`: { - Usage: `Human-readable label that identifies the database that contains the collection.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -2723,23 +2813,26 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `integrationType`: { + Usage: `Human-readable label that identifies the service which you want to integrate with MongoDB Cloud.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `integrationType`: `[integrationType]`, }, }, }, }, }, - `deleteOneDataFederationInstanceQueryLimit`: { + `deleteGroupInvite`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2749,19 +2842,8 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `limitName`: { - Usage: `Human-readable label that identifies this data federation instance limit. - -| Limit Name | Description | Default | -| --- | --- | --- | -| bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | -| bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | -| bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | -| bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | -`, - }, - `tenantName`: { - Usage: `Human-readable label that identifies the federated database instance to which the query limit applies.`, + `invitationId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -2769,22 +2851,15 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `limitName`: `[limitName]`, - `tenantName`: `[tenantName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `invitationId`: `[invitationId]`, }, }, }, }, }, - `deleteOnlineArchive`: { + `deleteGroupLimit`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `archiveId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the online archive to delete.`, - }, - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that contains the collection from which you want to remove an online archive.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -2792,6 +2867,25 @@ var metadata = metadatatypes.Metadata{ Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `limitName`: { + Usage: `Human-readable label that identifies this project limit. + +| Limit Name | Description | Default | API Override Limit | +| --- | --- | --- | --- | +| atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | +| atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | +| atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | +| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | +| atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | +| atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | +| dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | +| dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | +| dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | +| dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | +| atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| +| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| +`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -2802,48 +2896,54 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `archiveId`: `[archiveId]`, - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `limitName`: `[limitName]`, }, }, }, }, }, - `deleteOrgResourcePolicy`: { + `deleteGroupPeer`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `peerId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to delete.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `resourcePolicyId`: { - Usage: `Unique 24-hexadecimal digit string that identifies an atlas resource policy.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, - `resourcePolicyId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `peerId`: `[peerId]`, }, }, }, }, }, - `deleteOrganization`: { + `deleteGroupPipeline`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -2851,22 +2951,28 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `pipelineName`: `[pipelineName]`, }, }, }, }, }, - `deleteOrganizationInvitation`: { + `deleteGroupPipelineRun`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `invitationId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + }, + `pipelineRunId`: { + Usage: `Unique 24-hexadecimal character string that identifies a Data Lake Pipeline run.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -2877,15 +2983,22 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `invitationId`: `[invitationId]`, - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `pipelineName`: `[pipelineName]`, + `pipelineRunId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deletePeeringConnection`: { + `deleteGroupPrivateEndpointEndpointService`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `cloudProvider`: { + Usage: `Cloud service provider that manages this private endpoint service.`, + }, + `endpointServiceId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to delete.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -2894,9 +3007,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `peerId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to delete.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -2906,17 +3016,24 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `peerId`: `[peerId]`, + `cloudProvider`: `[cloudProvider]`, + `endpointServiceId`: `[endpointServiceId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deletePeeringContainer`: { + `deleteGroupPrivateEndpointEndpointServiceEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `containerId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove.`, + `cloudProvider`: { + Usage: `Cloud service provider that manages this private endpoint.`, + }, + `endpointId`: { + Usage: `Unique string that identifies the private endpoint you want to delete. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints.`, + }, + `endpointServiceId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service from which you want to delete a private endpoint.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -2935,15 +3052,20 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `containerId`: `32b6e34b3d91647abb20e7b8`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `cloudProvider`: `[cloudProvider]`, + `endpointId`: `[endpointId]`, + `endpointServiceId`: `[endpointServiceId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deletePipeline`: { + `deleteGroupPrivateEndpointServerlessInstanceEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `endpointId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the tenant endpoint which will be removed.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -2952,8 +3074,8 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + `instanceName`: { + Usage: `Human-readable label that identifies the serverless instance from which the tenant endpoint will be removed.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -2961,15 +3083,19 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ + `endpointId`: `[endpointId]`, `groupId`: `32b6e34b3d91647abb20e7b8`, - `pipelineName`: `[pipelineName]`, + `instanceName`: `[instanceName]`, }, }, }, }, }, - `deletePipelineRunDataset`: { + `deleteGroupPrivateNetworkSettingEndpointId`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `endpointId`: { + Usage: `Unique 22-character alphanumeric string that identifies the private endpoint to remove. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -2978,12 +3104,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, - }, - `pipelineRunId`: { - Usage: `Unique 24-hexadecimal character string that identifies a Data Lake Pipeline run.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -2993,25 +3113,15 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `pipelineName`: `[pipelineName]`, - `pipelineRunId`: `32b6e34b3d91647abb20e7b8`, + `endpointId`: `[endpointId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deletePrivateEndpoint`: { + `deleteGroupPushBasedLogExport`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Cloud service provider that manages this private endpoint.`, - }, - `endpointId`: { - Usage: `Unique string that identifies the private endpoint you want to delete. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints.`, - }, - `endpointServiceId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service from which you want to delete a private endpoint.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3029,23 +3139,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `cloudProvider`: `[cloudProvider]`, - `endpointId`: `[endpointId]`, - `endpointServiceId`: `[endpointServiceId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deletePrivateEndpointService`: { + `deleteGroupServerlessInstance`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Cloud service provider that manages this private endpoint service.`, - }, - `endpointServiceId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to delete.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3054,6 +3155,9 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `name`: { + Usage: `Human-readable label that identifies the serverless instance.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -3063,18 +3167,17 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `cloudProvider`: `[cloudProvider]`, - `endpointServiceId`: `[endpointServiceId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, }, }, }, }, }, - `deletePrivateLinkConnection`: { + `deleteGroupServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `connectionId`: { - Usage: `Unique ID that identifies the Private Link connection.`, + `clientId`: { + Usage: `The Client ID of the Service Account.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -3089,19 +3192,22 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `connectionId`: `[connectionId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteProject`: { + `deleteGroupServiceAccountAccessListEntry`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3110,25 +3216,31 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `ipAddress`: { + Usage: `One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `delete_project`, - Name: `Delete a project`, - Description: `Deletes an existing project`, + `2024-08-05`: {{ + Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `ipAddress`: `192.0.2.0%2F24`, }, }, }, }, }, - `deleteProjectInvitation`: { + `deleteGroupServiceAccountSecret`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3137,30 +3249,30 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `invitationId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `secretId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the secret.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `invitationId`: `[invitationId]`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `secretId`: `[secretId]`, }, }, }, }, }, - `deleteProjectIpAccessList`: { + `deleteGroupStreamConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `entryValue`: { - Usage: `Access list entry that you want to remove from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (` + "`" + `/` + "`" + `) with its URL-encoded value (` + "`" + `%2F` + "`" + `). When you remove an entry from the IP access list, existing connections from the removed address or addresses may remain open for a variable amount of time. The amount of time it takes MongoDB Cloud to close the connection depends upon several factors, including: - -- how your application established the connection, -- how MongoDB Cloud or the driver using the address behaves, and -- which protocol (like TCP or UDP) the connection uses.`, + `connectionName`: { + Usage: `Human-readable label that identifies the stream connection.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -3173,23 +3285,28 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `project_ip_access_list_delete`, - Name: `Remove One Entry from One Project IP Access List`, - Description: `Removes one access list entry from the specified project's IP access list`, + `2023-02-01`: {{ + Source: `-`, Flags: map[string]string{ - `entryValue`: `10.0.0.0/16`, - `groupId`: `[your-project-id]`, + `connectionName`: `[connectionName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `deleteProjectLimit`: { + `deleteGroupStreamPrivateLinkConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `connectionId`: { + Usage: `Unique ID that identifies the Private Link connection.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3197,48 +3314,25 @@ var metadata = metadatatypes.Metadata{ Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `limitName`: { - Usage: `Human-readable label that identifies this project limit. - -| Limit Name | Description | Default | API Override Limit | -| --- | --- | --- | --- | -| atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | -| atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | -| atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | -| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | -| atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | -| atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | -| dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | -| dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | -| dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | -| dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | -| atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| -| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| -| atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | -`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `limitName`: `[limitName]`, + `connectionId`: `[connectionId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteProjectServiceAccount`: { + `deleteGroupStreamProcessor`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3250,24 +3344,28 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processorName`: { + Usage: `Human-readable label that identifies the stream processor.`, + }, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processorName`: `[processorName]`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `deleteProjectServiceAccountAccessListEntry`: { + `deleteGroupStreamVpcPeeringConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3276,31 +3374,24 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `ipAddress`: { - Usage: `One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `id`: { + Usage: `The VPC Peering Connection id.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-02-01`: {{ Source: `-`, - Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `ipAddress`: `192.0.2.0%2F24`, + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + `id`: `[id]`, }, }, }, }, }, - `deleteProjectServiceAccountSecret`: { + `deleteGroupStreamWorkspace`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3312,24 +3403,23 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `secretId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the secret.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance to delete.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `secretId`: `[secretId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `deletePushBasedLogConfiguration`: { + `deleteGroupUserSecurityLdapUserToDnMapping`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -3354,24 +3444,13 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `deleteReplicaSetBackup`: { + `deleteOrg`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -3379,54 +3458,52 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `snapshotId`: `[snapshotId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `deleteRoleMapping`: { + `deleteOrgApiKey`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, - }, - `id`: { - Usage: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to remove.`, - }, `orgId`: { Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, - `id`: `32b6e34b3d91647abb20e7b8`, - `orgId`: `4888442a3354817a7320eb61`, + `apiUserId`: `[apiUserId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `deleteServerlessInstance`: { + `deleteOrgApiKeyAccessListEntry`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to remove access list entries.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `ipAddress`: { + Usage: `One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, }, - `name`: { - Usage: `Human-readable label that identifies the serverless instance.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -3437,28 +3514,27 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, + `apiUserId`: `[apiUserId]`, + `ipAddress`: `192.0.2.0%2F24`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `deleteServerlessPrivateEndpoint`: { + `deleteOrgInvite`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `endpointId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the tenant endpoint which will be removed.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `invitationId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, }, - `instanceName`: { - Usage: `Human-readable label that identifies the serverless instance from which the tenant endpoint will be removed.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -3466,73 +3542,61 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `endpointId`: `[endpointId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `instanceName`: `[instanceName]`, + `invitationId`: `[invitationId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `deleteServiceAccount`: { + `deleteOrgLiveMigrationLinkTokens`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, `orgId`: { Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `orgId`: `4888442a3354817a7320eb61`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `deleteServiceAccountAccessListEntry`: { + `deleteOrgResourcePolicy`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `ipAddress`: { - Usage: `One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, - }, `orgId`: { Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `resourcePolicyId`: { + Usage: `Unique 24-hexadecimal digit string that identifies an atlas resource policy.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `ipAddress`: `192.0.2.0%2F24`, - `orgId`: `4888442a3354817a7320eb61`, + `orgId`: `4888442a3354817a7320eb61`, + `resourcePolicyId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteServiceAccountSecret`: { + `deleteOrgServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clientId`: { Usage: `The Client ID of the Service Account.`, @@ -3546,9 +3610,6 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `secretId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the secret.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2024-08-05`: {{ @@ -3557,108 +3618,101 @@ var metadata = metadatatypes.Metadata{ Flags: map[string]string{ `clientId`: `mdb_sa_id_1234567890abcdef12345678`, `orgId`: `4888442a3354817a7320eb61`, - `secretId`: `[secretId]`, }, }, }, }, }, - `deleteShardedClusterBackup`: { + `deleteOrgServiceAccountAccessListEntry`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `clientId`: { + Usage: `The Client ID of the Service Account.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `ipAddress`: { + Usage: `One IP address or multiple IP addresses represented as one CIDR block. When specifying a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `snapshotId`: `[snapshotId]`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `ipAddress`: `192.0.2.0%2F24`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `deleteStreamConnection`: { + `deleteOrgServiceAccountSecret`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `connectionName`: { - Usage: `Human-readable label that identifies the stream connection.`, + `clientId`: { + Usage: `The Client ID of the Service Account.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, + `secretId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the secret.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `connectionName`: `[connectionName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `tenantName`: `[tenantName]`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `orgId`: `4888442a3354817a7320eb61`, + `secretId`: `[secretId]`, }, }, }, }, }, - `deleteStreamInstance`: { + `deleteOrgTeam`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance to delete.`, + `teamId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the team that you want to delete.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `tenantName`: `[tenantName]`, + `orgId`: `4888442a3354817a7320eb61`, + `teamId`: `[teamId]`, }, }, }, }, }, - `deleteStreamProcessor`: { + `disableGroupBackupCompliancePolicy`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -3671,54 +3725,44 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processorName`: { - Usage: `Human-readable label that identifies the stream processor.`, - }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processorName`: `[processorName]`, - `tenantName`: `[tenantName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteTeam`: { + `disableGroupManagedSlowMs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `teamId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the team that you want to delete.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, - `teamId`: `[teamId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `deleteThirdPartyIntegration`: { + `disableGroupPrivateIpModePeering`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -3728,26 +3772,13 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `integrationType`: { - Usage: `Human-readable label that identifies the service which you want to integrate with MongoDB Cloud.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `integrationType`: `[integrationType]`, - }, - }, - }, - }, + Examples: nil, }, - `deleteVpcPeeringConnection`: { + `disableGroupUserSecurityCustomerX509`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -3757,24 +3788,23 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `id`: { - Usage: `The VPC Peering Connection id.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ `groupId`: `32b6e34b3d91647abb20e7b8`, - `id`: `[id]`, }, }, }, }, }, - `disableCustomerManagedX509`: { + `downloadGroupClusterBackupTenant`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3783,20 +3813,17 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, + Examples: nil, }, - `disableDataProtectionSettings`: { + `downloadGroupClusterLog`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `endDate`: { + Usage: `Specifies the date and time for the ending point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours after the start date. If the start date is also unspecified, the value will default to the time of the request.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3805,39 +3832,44 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `hostName`: { + Usage: `Human-readable label that identifies the host that stores the log files that you want to download.`, + }, + `logName`: { + Usage: `Human-readable label that identifies the log file that you want to return. To return audit logs, enable *Database Auditing* for the specified project.`, + }, + `startDate`: { + Usage: `Specifies the date and time for the starting point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours prior to the end date. If the end date is also unspecified, the value will default to 24 hours prior to the time of the request.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ - Source: `-`, + `2023-02-01`: {{ + Source: `get_host_logs`, + Name: `Download MongoDB logs for a specific cluster host`, + Description: `Returns a compressed (.gz) MongoDB log file containing log messages for the specified host`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `endDate`: `1609545600`, + `groupId`: `[your-project-id]`, + `hostName`: `[your-host-name]`, + `logName`: `mongodb`, + `startDate`: `1609459200`, }, }, }, }, }, - `disablePeering`: { + `downloadGroupClusterOnlineArchiveQueryLogs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + `archiveOnly`: { + Usage: `Flag that indicates whether to download logs for queries against your online archive only or both your online archive and cluster.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that contains the collection for which you want to return the query logs from one online archive.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `endDate`: { + Usage: `Date and time that specifies the end point for the range of log messages to return. This resource expresses this value in the number of seconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time).`, }, - }, - Examples: nil, - }, - `disableSlowOperationThresholding`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3846,8 +3878,8 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `startDate`: { + Usage: `Date and time that specifies the starting point for the range of log messages to return. This resource expresses this value in the number of seconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time).`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -3855,13 +3887,16 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `endDate`: `1.636481348e+09`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `startDate`: `1.636481348e+09`, }, }, }, }, }, - `downloadFederatedDatabaseQueryLogs`: { + `downloadGroupDataFederationQueryLogs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `endDate`: { Usage: `Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, @@ -3892,7 +3927,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `downloadFlexBackup`: { + `downloadGroupFlexClusterBackup`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -3911,44 +3946,42 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `downloadInvoiceCsv`: { + `downloadGroupStreamAuditLogs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `endDate`: { + Usage: `Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `invoiceId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `startDate`: { + Usage: `Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `invoiceId`: `[invoiceId]`, - `orgId`: `4888442a3354817a7320eb61`, + `endDate`: `1.636481348e+09`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `startDate`: `1.636466948e+09`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `downloadOnlineArchiveQueryLogs`: { + `enableGroupManagedSlowMs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `archiveOnly`: { - Usage: `Flag that indicates whether to download logs for queries against your online archive only or both your online archive and cluster.`, - }, - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that contains the collection for which you want to return the query logs from one online archive.`, - }, - `endDate`: { - Usage: `Date and time that specifies the end point for the range of log messages to return. This resource expresses this value in the number of seconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time).`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -3957,8 +3990,8 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `startDate`: { - Usage: `Date and time that specifies the starting point for the range of log messages to return. This resource expresses this value in the number of seconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time).`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -3966,19 +3999,16 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `endDate`: `1.636481348e+09`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `startDate`: `1.636481348e+09`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `downloadSharedClusterBackup`: { + `endGroupClusterOutageSimulation`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + Usage: `Human-readable label that identifies the cluster that is undergoing outage simulation.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -3992,54 +4022,101 @@ var metadata = metadatatypes.Metadata{ Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: nil, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, + }, + }, }, - `downloadStreamTenantAuditLogs`: { + `getFederationSettingConnectedOrgConfig`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `endDate`: { - Usage: `Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the connected organization configuration to return.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Flags: map[string]string{ + `federationSettingsId`: `55fa922fb343282757d9554e`, + `orgId`: `32b6e34b3d91647abb20e7b8`, + }, }, - `startDate`: { - Usage: `Timestamp that specifies the starting point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, + }, + }, + `getFederationSettingConnectedOrgConfigRoleMapping`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `id`: { + Usage: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to return.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `endDate`: `1.636481348e+09`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `startDate`: `1.636466948e+09`, - `tenantName`: `[tenantName]`, + `federationSettingsId`: `55fa922fb343282757d9554e`, + `id`: `32b6e34b3d91647abb20e7b8`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `enableSlowOperationThresholding`: { + `getFederationSettingIdentityProvider`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `identityProviderId`: { + Usage: `Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-11-15`: {{ + Source: `-`, -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Flags: map[string]string{ + `federationSettingsId`: `55fa922fb343282757d9554e`, + `identityProviderId`: `32b6e34b3d91647abb20e7b8`, + }, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + }, + `getFederationSettingIdentityProviderMetadata`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `identityProviderId`: { + Usage: `Legacy 20-hexadecimal digit string that identifies the identity provider. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -4047,17 +4124,15 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `federationSettingsId`: `55fa922fb343282757d9554e`, + `identityProviderId`: `c2777a9eca931f29fc2f`, }, }, }, }, }, - `endOutageSimulation`: { + `getGroup`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that is undergoing outage simulation.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4072,20 +4147,21 @@ var metadata = metadatatypes.Metadata{ }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `-`, + Source: `get_project`, + Name: `Get a project`, + Description: `Get a project using a project id`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getAccountDetails`: { + `getGroupAccessListEntry`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `One of "aws", "azure" or "gcp".`, + `entryValue`: { + Usage: `Access list entry that you want to return from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (` + "`" + `/` + "`" + `) with its URL-encoded value (` + "`" + `%2F` + "`" + `).`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -4095,25 +4171,29 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `regionName`: { - Usage: `The cloud provider specific region name, i.e. "US_EAST_1" for cloud provider "aws".`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ - Source: `-`, + `2023-01-01`: {{ + Source: `project_ip_access_list_get`, + Name: `Return One Project IP Access List Entry`, + Description: `Returns one access list entry from the specified project's IP access list: 10.0.0.0/16`, Flags: map[string]string{ - `cloudProvider`: `[cloudProvider]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `regionName`: `[regionName]`, + `entryValue`: `10.0.0.0/16`, + `groupId`: `[your-project-id]`, }, }, }, }, }, - `getActiveVpcPeeringConnections`: { + `getGroupAccessListStatus`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `entryValue`: { + Usage: `Network address or cloud provider security construct that identifies which project access list entry to be verified.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4122,28 +4202,25 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ - Source: `-`, + `2023-01-01`: {{ + Source: `project_ip_access_list_get_status`, + Name: `Return Status of One Project IP Access List Entry`, + Description: `Returns the status of 10.0.0.0/16`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `entryValue`: `10.0.0.0/16`, + `groupId`: `[your-project-id]`, }, }, }, }, }, - `getAlert`: { + `getGroupAlert`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `alertId`: { Usage: `Unique 24-hexadecimal digit string that identifies the alert.`, @@ -4172,10 +4249,10 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getAlertConfiguration`: { + `getGroupAlertAlertConfigs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `alertConfigId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, + `alertId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the alert.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -4185,6 +4262,15 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -4194,23 +4280,25 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `alertConfigId`: `32b6e34b3d91647abb20e7b8`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `alertId`: `[alertId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getApiKey`: { + `getGroupAlertConfig`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to update.`, + `alertConfigId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -4221,26 +4309,34 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `apiUserId`: `[apiUserId]`, - `orgId`: `4888442a3354817a7320eb61`, + `alertConfigId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getApiKeyAccessList`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries.`, + `getGroupAlertConfigAlerts`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `alertConfigId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `ipAddress`: { - Usage: `One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -4251,15 +4347,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `apiUserId`: `[apiUserId]`, - `ipAddress`: `192.0.2.0%2F24`, - `orgId`: `4888442a3354817a7320eb61`, + `alertConfigId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getAtlasProcess`: { + `getGroupAuditLog`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -4272,27 +4367,20 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processId`: `mongodb.example.com:27017`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getAtlasSearchDeployment`: { + `getGroupAwsCustomDns`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Label that identifies the cluster to return the Search Nodes for.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4306,22 +4394,18 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2025-03-12`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getAtlasSearchIndex`: { + `getGroupBackupCompliancePolicy`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4330,72 +4414,63 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `indexId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the Application Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Application Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Application Search indexes.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2023-10-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `indexId`: `[indexId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getAtlasSearchIndexByName`: { + `getGroupBackupExportBucket`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, - }, - `collectionName`: { - Usage: `Name of the collection that contains one or more Atlas Search indexes.`, - }, - `databaseName`: { - Usage: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `exportBucketId`: { + Usage: `Unique 24-hexadecimal character string that identifies the Export Bucket.`, + }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `indexName`: { - Usage: `Name of the Atlas Search index to return.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `collectionName`: `[collectionName]`, - `databaseName`: `[databaseName]`, + `exportBucketId`: `32b6e34b3d91647abb20e7b8`, `groupId`: `32b6e34b3d91647abb20e7b8`, - `indexName`: `[indexName]`, }, }, }, }, }, - `getAtlasSearchIndexDeprecated`: { + `getGroupByName`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupName`: { + Usage: `Human-readable label that identifies this project.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `getGroupCloudProviderAccess`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4404,28 +4479,30 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `indexId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the Application Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Application Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Application Search indexes.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `roleId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the role.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `indexId`: `[indexId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `roleId`: `[roleId]`, }, }, }, }, }, - `getAuditingConfiguration`: { + `getGroupCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies this cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4439,18 +4516,27 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, + `2024-08-05`: {{ + Source: `get_cluster`, + Name: `Get details of a specific cluster`, + Description: `Returns the details for the specified cluster in the project`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[your-cluster-name]`, + `groupId`: `[your-project-id]`, }, }, }, }, }, - `getAwsCustomDns`: { + `getGroupClusterBackupCheckpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `checkpointId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the checkpoint.`, + }, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that contains the checkpoints that you want to return.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4468,13 +4554,15 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `checkpointId`: `[checkpointId]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getBackupExportJob`: { + `getGroupClusterBackupExport`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster.`, @@ -4504,7 +4592,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getBackupRestoreJob`: { + `getGroupClusterBackupRestoreJob`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster with the restore jobs you want to return.`, @@ -4537,7 +4625,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getBackupSchedule`: { + `getGroupClusterBackupSchedule`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster.`, @@ -4566,8 +4654,11 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getCloudProviderAccessRole`: { + `getGroupClusterBackupSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4579,8 +4670,8 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `roleId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the role.`, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -4588,17 +4679,18 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `roleId`: `[roleId]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `snapshotId`: `[snapshotId]`, }, }, }, }, }, - `getCluster`: { + `getGroupClusterBackupSnapshotShardedCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -4611,22 +4703,24 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ - Source: `get_cluster`, - Name: `Get details of a specific cluster`, - Description: `Returns the details for the specified cluster in the project`, + `2023-01-01`: {{ + Source: `-`, Flags: map[string]string{ - `clusterName`: `[your-cluster-name]`, - `groupId`: `[your-project-id]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `snapshotId`: `[snapshotId]`, }, }, }, }, }, - `getClusterAdvancedConfiguration`: { + `getGroupClusterBackupTenantRestore`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster.`, @@ -4642,20 +4736,24 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `restoreId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the restore job to return.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ `clusterName`: `[clusterName]`, `groupId`: `32b6e34b3d91647abb20e7b8`, + `restoreId`: `[restoreId]`, }, }, }, }, }, - `getClusterStatus`: { + `getGroupClusterBackupTenantSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster.`, @@ -4671,6 +4769,9 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ @@ -4679,70 +4780,20 @@ var metadata = metadatatypes.Metadata{ Flags: map[string]string{ `clusterName`: `[clusterName]`, `groupId`: `32b6e34b3d91647abb20e7b8`, + `snapshotId`: `[snapshotId]`, }, }, }, }, }, - `getCollStatsLatencyNamespaceClusterMeasurements`: { + `getGroupClusterCollStatNamespaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster to retrieve metrics for.`, + Usage: `Human-readable label that identifies the cluster to pin namespaces to.`, }, `clusterView`: { Usage: `Human-readable label that identifies the cluster topology to retrieve metrics for.`, }, - `collectionName`: { - Usage: `Human-readable label that identifies the collection.`, - }, - `databaseName`: { - Usage: `Human-readable label that identifies the database.`, - }, - `end`: { - Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, - }, - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `metrics`: { - Usage: `List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics.`, - }, - `period`: { - Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, - }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-11-15`: {{ - Source: `-`, - - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `clusterView`: `[clusterView]`, - `collectionName`: `mycoll`, - `databaseName`: `mydb`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `period`: `PT10H`, - }, - }, - }, - }, - }, - `getCollStatsLatencyNamespaceHostMeasurements`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `collectionName`: { - Usage: `Human-readable label that identifies the collection.`, - }, - `databaseName`: { - Usage: `Human-readable label that identifies the database.`, - }, `end`: { Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, @@ -4754,15 +4805,9 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `metrics`: { - Usage: `List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics.`, - }, `period`: { Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, }, - `processId`: { - Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, `start`: { Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, @@ -4772,48 +4817,19 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `collectionName`: `mycoll`, - `databaseName`: `mydb`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `period`: `PT10H`, - `processId`: `my.host.name.com:27017`, - }, - }, - }, - }, - }, - `getCollStatsLatencyNamespaceMetrics`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-11-15`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `clusterView`: `[clusterView]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `period`: `PT10H`, }, }, }, }, }, - `getCollStatsLatencyNamespacesForCluster`: { + `getGroupClusterFtsIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster to pin namespaces to.`, - }, - `clusterView`: { - Usage: `Human-readable label that identifies the cluster topology to retrieve metrics for.`, - }, - `end`: { - Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -4823,31 +4839,30 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `period`: { - Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + `indexId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the Application Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Application Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Application Search indexes.`, }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-11-15`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ `clusterName`: `[clusterName]`, - `clusterView`: `[clusterView]`, `groupId`: `32b6e34b3d91647abb20e7b8`, - `period`: `PT10H`, + `indexId`: `[indexId]`, }, }, }, }, }, - `getCollStatsLatencyNamespacesForHost`: { + `getGroupClusterGlobalWrites`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `end`: { - Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `clusterName`: { + Usage: `Human-readable label that identifies this cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -4857,39 +4872,40 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `period`: { - Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, - }, - `processId`: { - Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-11-15`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `period`: `PT10H`, - `processId`: `my.host.name.com:27017`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getConnectedOrgConfig`: { + `getGroupClusterOnlineArchive`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `archiveId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the online archive to return.`, + }, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that contains the specified collection from which Application created the online archive.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the connected organization configuration to return.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -4897,23 +4913,29 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, - `orgId`: `32b6e34b3d91647abb20e7b8`, + `archiveId`: `[archiveId]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getCostExplorerQueryProcess`: { + `getGroupClusterOutageSimulation`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that is undergoing outage simulation.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `token`: { - Usage: `Unique 64 digit string that identifies the Cost Explorer query.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -4921,15 +4943,18 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, - `token`: `4ABBE973862346D40F3AE859D4BE96E0F895764EB14EAB039E7B82F9D638C05C`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getCustomDatabaseRole`: { + `getGroupClusterProcessArgs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4941,26 +4966,23 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `roleName`: { - Usage: `Human-readable label that identifies the role for the request. This name must be unique for this custom role in this project.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `roleName`: `[roleName]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getDataFederationPrivateEndpoint`: { + `getGroupClusterQueryShapeInsightDetails`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `endpointId`: { - Usage: `Unique 22-character alphanumeric string that identifies the private endpoint to return. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature.`, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -4973,21 +4995,43 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processIds`: { + Usage: `ProcessIds from which to retrieve query shape statistics. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each processId.`, + }, + `queryShapeHash`: { + Usage: `A SHA256 hash of a query shape, output by MongoDB commands like $queryStats and $explain or slow query logs.`, + }, + `since`: { + Usage: `Date and time from which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. +- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, + }, + `until`: { + Usage: `Date and time up until which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you specify the **until** parameter, you must specify the **since** parameter. +- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-03-12`: {{ Source: `-`, Flags: map[string]string{ - `endpointId`: `[endpointId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `queryShapeHash`: `[queryShapeHash]`, }, }, }, }, }, - `getDataProtectionSettings`: { + `getGroupClusterRestoreJob`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -4996,25 +5040,30 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `jobId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the restore job.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-10-01`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `jobId`: `[jobId]`, }, }, }, }, }, - `getDatabase`: { + `getGroupClusterSearchDeployment`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `databaseName`: { - Usage: `Human-readable label that identifies the database that the specified MongoDB process serves.`, + `clusterName`: { + Usage: `Label that identifies the cluster to return the Search Nodes for.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5027,77 +5076,62 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-03-12`: {{ Source: `-`, Flags: map[string]string{ - `databaseName`: `[databaseName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processId`: `mongodb.example.com:27017`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getDatabaseMeasurements`: { + `getGroupClusterSearchIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `databaseName`: { - Usage: `Human-readable label that identifies the database that the specified MongoDB process serves.`, - }, - `end`: { - Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `clusterName`: { + Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `granularity`: { - Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `m`: { - Usage: `One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for ` + "`" + `m` + "`" + `, repeat the ` + "`" + `m` + "`" + ` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements.`, - }, - `period`: { - Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + `indexId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the Application Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Application Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Application Search indexes.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `databaseName`: `[databaseName]`, - `granularity`: `PT1M`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `period`: `PT10H`, - `processId`: `mongodb.example.com:27017`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `indexId`: `[indexId]`, }, }, }, }, }, - `getDatabaseUser`: { + `getGroupClusterSearchIndexByName`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, + }, + `collectionName`: { + Usage: `Name of the collection that contains one or more Atlas Search indexes.`, + }, `databaseName`: { - Usage: `The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be ` + "`" + `$external` + "`" + `. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be ` + "`" + `admin` + "`" + `.`, + Usage: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5107,72 +5141,46 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `indexName`: { + Usage: `Name of the Atlas Search index to return.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `username`: { - Usage: `Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: - -| Authentication Method | Parameter Needed | Parameter Value | username Format | -|---|---|---|---| -| AWS IAM | awsIAMType | ROLE | ARN | -| AWS IAM | awsIAMType | USER | ARN | -| x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | -| x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | -| LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | -| LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | -| OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | -| OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | -| SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | -`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `databaseName`: `[databaseName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `username`: `SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName`, + `clusterName`: `[clusterName]`, + `collectionName`: `[collectionName]`, + `databaseName`: `[databaseName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `indexName`: `[indexName]`, }, }, }, }, }, - `getDiskMeasurements`: { + `getGroupClusterSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `end`: { - Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `granularity`: { - Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `m`: { - Usage: `One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for ` + "`" + `m` + "`" + `, repeat the ` + "`" + `m` + "`" + ` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements.`, - }, - `partitionName`: { - Usage: `Human-readable label of the disk or partition to which the measurements apply.`, - }, - `period`: { - Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -5180,18 +5188,19 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `granularity`: `PT1M`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `partitionName`: `[partitionName]`, - `period`: `PT10H`, - `processId`: `mongodb.example.com:27017`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `snapshotId`: `[snapshotId]`, }, }, }, }, }, - `getEncryptionAtRest`: { + `getGroupClusterSnapshotSchedule`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5209,19 +5218,17 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getEncryptionAtRestPrivateEndpoint`: { + `getGroupClusterStatus`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Human-readable label that identifies the cloud provider of the private endpoint.`, - }, - `endpointId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint.`, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5239,19 +5246,18 @@ var metadata = metadatatypes.Metadata{ `2023-01-01`: {{ Source: `-`, - Flags: map[string]string{ - `cloudProvider`: `[cloudProvider]`, - `endpointId`: `[endpointId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getEncryptionAtRestPrivateEndpointsForCloudProvider`: { + `getGroupContainer`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Human-readable label that identifies the cloud provider for the private endpoints to return.`, + `containerId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5261,15 +5267,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -5279,40 +5276,43 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `cloudProvider`: `[cloudProvider]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `containerId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getExportBucket`: { + `getGroupCustomDbRoleRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `exportBucketId`: { - Usage: `Unique 24-hexadecimal character string that identifies the Export Bucket.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `roleName`: { + Usage: `Human-readable label that identifies the role for the request. This name must be unique for this custom role in this project.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `exportBucketId`: `32b6e34b3d91647abb20e7b8`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `roleName`: `[roleName]`, }, }, }, }, }, - `getFederatedDatabase`: { + `getGroupDataFederation`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5338,31 +5338,52 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getFederationSettings`: { + `getGroupDataFederationLimit`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `limitName`: { + Usage: `Human-readable label that identifies this data federation instance limit. + +| Limit Name | Description | Default | +| --- | --- | --- | +| bytesProcessed.query | Limit on the number of bytes processed during a single data federation query | N/A | +| bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | +| bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | +| bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | +`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `tenantName`: { + Usage: `Human-readable label that identifies the federated database instance to which the query limit applies.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `limitName`: `[limitName]`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `getFlexBackup`: { + `getGroupDatabaseUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `databaseName`: { + Usage: `The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be ` + "`" + `$external` + "`" + `. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be ` + "`" + `admin` + "`" + `.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5371,28 +5392,50 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `name`: { - Usage: `Human-readable label that identifies the flex cluster.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + `username`: { + Usage: `Human-readable label that represents the user that authenticates to MongoDB. The format of this label depends on the method of authentication: + +| Authentication Method | Parameter Needed | Parameter Value | username Format | +|---|---|---|---| +| AWS IAM | awsIAMType | ROLE | ARN | +| AWS IAM | awsIAMType | USER | ARN | +| x.509 | x509Type | CUSTOMER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | +| x.509 | x509Type | MANAGED | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | +| LDAP | ldapAuthType | USER | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | +| LDAP | ldapAuthType | GROUP | [RFC 2253](https://tools.ietf.org/html/2253) Distinguished Name | +| OIDC Workforce | oidcAuthType | IDP_GROUP | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP group name | +| OIDC Workload | oidcAuthType | USER | Atlas OIDC IdP ID (found in federation settings), followed by a '/', followed by the IdP user name | +| SCRAM-SHA | awsIAMType, x509Type, ldapAuthType, oidcAuthType | NONE | Alphanumeric string | +`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, - `snapshotId`: `32b6e34b3d91647abb20e7b8`, + `databaseName`: `[databaseName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `username`: `SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName`, }, }, }, }, }, - `getFlexBackupRestoreJob`: { + `getGroupDbAccessHistoryCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `authResult`: { + Usage: `Flag that indicates whether the response returns the successful authentication attempts only.`, + }, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, + `end`: { + Usage: `Date and time when to stop retrieving database history. If you specify **end**, you must also specify **start**. This parameter uses UNIX epoch time in milliseconds.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5401,31 +5444,39 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `name`: { - Usage: `Human-readable label that identifies the flex cluster.`, + `ipAddress`: { + Usage: `One Internet Protocol address that attempted to authenticate with the database.`, + }, + `nLogs`: { + Usage: `Maximum number of lines from the log to return.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `restoreJobId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the restore job to return.`, + `start`: { + Usage: `Date and time when MongoDB Cloud begins retrieving database history. If you specify **start**, you must also specify **end**. This parameter uses UNIX epoch time in milliseconds.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, - `restoreJobId`: `[restoreJobId]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getFlexCluster`: { + `getGroupDbAccessHistoryProcess`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `authResult`: { + Usage: `Flag that indicates whether the response returns the successful authentication attempts only.`, + }, + `end`: { + Usage: `Date and time when to stop retrieving database history. If you specify **end**, you must also specify **start**. This parameter uses UNIX epoch time in milliseconds.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5434,30 +5485,36 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `name`: { - Usage: `Human-readable label that identifies the flex cluster.`, + `hostname`: { + Usage: `Fully qualified domain name or IP address of the MongoDB host that stores the log files that you want to download.`, + }, + `ipAddress`: { + Usage: `One Internet Protocol address that attempted to authenticate with the database.`, + }, + `nLogs`: { + Usage: `Maximum number of lines from the log to return.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `start`: { + Usage: `Date and time when MongoDB Cloud begins retrieving database history. If you specify **start**, you must also specify **end**. This parameter uses UNIX epoch time in milliseconds.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `hostname`: `[hostname]`, }, }, }, }, }, - `getGroupClusterQueryShapeInsightDetails`: { + `getGroupEncryptionAtRest`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5469,45 +5526,25 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processIds`: { - Usage: `ProcessIds from which to retrieve query shape statistics. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each processId.`, - }, - `queryShapeHash`: { - Usage: `A SHA256 hash of a query shape, output by MongoDB commands like $queryStats and $explain or slow query logs.`, - }, - `since`: { - Usage: `Date and time from which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. -- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, - }, - `until`: { - Usage: `Date and time up until which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you specify the **until** parameter, you must specify the **since** parameter. -- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2025-03-12`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `queryShapeHash`: `[queryShapeHash]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getGroupClusterQueryShapeInsightSummaries`: { + `getGroupEncryptionAtRestPrivateEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `cloudProvider`: { + Usage: `Human-readable label that identifies the cloud provider of the private endpoint.`, }, - `commands`: { - Usage: `Retrieve query shape statistics matching specified MongoDB commands. To include multiple commands, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each command. The currently supported parameters are find, distinct, and aggregate. Omit this parameter to return results for all supported commands.`, + `endpointId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5517,181 +5554,148 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `nSummaries`: { - Usage: `Maximum number of query statistic summaries to return.`, - }, - `namespaces`: { - Usage: `Namespaces from which to retrieve query shape statistics. A namespace consists of one database and one collection resource written as ` + "`" + `.` + "`" + `: ` + "`" + `.` + "`" + `. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each namespace. Omit this parameter to return results for all namespaces.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processIds`: { - Usage: `ProcessIds from which to retrieve query shape statistics. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each processId.`, - }, - `queryShapeHashes`: { - Usage: `A list of SHA256 hashes of desired query shapes, output by MongoDB commands like $queryStats and $explain or slow query logs. To include multiple series, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each series. Omit this parameter to return results for all available series.`, - }, - `series`: { - Usage: `Query shape statistics data series to retrieve. A series represents a specific metric about query execution. To include multiple series, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each series. Omit this parameter to return results for all available series.`, - }, - `since`: { - Usage: `Date and time from which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. -- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, - }, - `until`: { - Usage: `Date and time up until which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you specify the **until** parameter, you must specify the **since** parameter. -- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2025-03-12`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `cloudProvider`: `[cloudProvider]`, + `endpointId`: `[endpointId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getHostLogs`: { + `getGroupEvent`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `endDate`: { - Usage: `Specifies the date and time for the ending point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours after the start date. If the start date is also unspecified, the value will default to the time of the request.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `eventId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the event that you want to return.`, + }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `hostName`: { - Usage: `Human-readable label that identifies the host that stores the log files that you want to download.`, - }, - `logName`: { - Usage: `Human-readable label that identifies the log file that you want to return. To return audit logs, enable *Database Auditing* for the specified project.`, + `includeRaw`: { + Usage: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, }, - `startDate`: { - Usage: `Specifies the date and time for the starting point of the range of log messages to retrieve, in the number of seconds that have elapsed since the UNIX epoch. This value will default to 24 hours prior to the end date. If the end date is also unspecified, the value will default to 24 hours prior to the time of the request.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ - Source: `get_host_logs`, - Name: `Download MongoDB logs for a specific cluster host`, - Description: `Returns a compressed (.gz) MongoDB log file containing log messages for the specified host`, + `2023-01-01`: {{ + Source: `-`, Flags: map[string]string{ - `endDate`: `1609545600`, - `groupId`: `[your-project-id]`, - `hostName`: `[your-host-name]`, - `logName`: `mongodb`, - `startDate`: `1609459200`, + `eventId`: `[eventId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getHostMeasurements`: { + `getGroupFlexCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `end`: { - Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `granularity`: { - Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `m`: { - Usage: `One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for ` + "`" + `m` + "`" + `, repeat the ` + "`" + `m` + "`" + ` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements.`, - }, - `period`: { - Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + `name`: { + Usage: `Human-readable label that identifies the flex cluster.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `granularity`: `PT1M`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `period`: `PT10H`, - `processId`: `mongodb.example.com:27017`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, }, }, }, }, }, - `getIdentityProvider`: { + `getGroupFlexClusterBackupRestoreJob`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `identityProviderId`: { - Usage: `Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id.`, + `name`: { + Usage: `Human-readable label that identifies the flex cluster.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `restoreJobId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the restore job to return.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-11-15`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, - `identityProviderId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, + `restoreJobId`: `[restoreJobId]`, }, }, }, }, }, - `getIdentityProviderMetadata`: { + `getGroupFlexClusterBackupSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `identityProviderId`: { - Usage: `Legacy 20-hexadecimal digit string that identifies the identity provider. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `name`: { + Usage: `Human-readable label that identifies the flex cluster.`, + }, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, - `identityProviderId`: `c2777a9eca931f29fc2f`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, + `snapshotId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getIndexMetrics`: { + `getGroupHostFtsMetricIndexMeasurements`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `collectionName`: { Usage: `Human-readable label that identifies the collection.`, @@ -5747,16 +5751,18 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getInvoice`: { + `getGroupIntegration`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `invoiceId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `integrationType`: { + Usage: `Human-readable label that identifies the service which you want to integrate with MongoDB Cloud.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -5767,14 +5773,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `invoiceId`: `[invoiceId]`, - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `integrationType`: `[integrationType]`, }, }, }, }, }, - `getLdapConfiguration`: { + `getGroupInvite`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5784,6 +5790,9 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `invitationId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -5793,13 +5802,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `invitationId`: `[invitationId]`, }, }, }, }, }, - `getLdapConfigurationStatus`: { + `getGroupIpAddresses`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5812,30 +5822,20 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `requestId`: { - Usage: `Unique string that identifies the request to verify an Lightweight Directory Access Protocol (LDAP) configuration.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `requestId`: `[requestId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getLegacyBackupCheckpoint`: { + `getGroupLimit`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `checkpointId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the checkpoint.`, - }, - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that contains the checkpoints that you want to return.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5843,6 +5843,25 @@ var metadata = metadatatypes.Metadata{ Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `limitName`: { + Usage: `Human-readable label that identifies this project limit. + +| Limit Name | Description | Default | API Override Limit | +| --- | --- | --- | --- | +| atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | +| atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | +| atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | +| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | +| atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | +| atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | +| dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | +| dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | +| dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | +| dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | +| atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| +| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| +`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -5853,19 +5872,15 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `checkpointId`: `[checkpointId]`, - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `limitName`: `[limitName]`, }, }, }, }, }, - `getLegacyBackupRestoreJob`: { + `getGroupLiveMigration`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5874,8 +5889,8 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `jobId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the restore job.`, + `liveMigrationId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the migration.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -5886,19 +5901,41 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `jobId`: `[jobId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `liveMigrationId`: `6296fb4c7c7aa997cf94e9a8`, }, }, }, }, }, - `getLegacySnapshot`: { + `getGroupLiveMigrationValidateStatus`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `validationId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the validation job.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + `validationId`: `507f1f77bcf86cd799439011`, + }, }, + }, + }, + }, + `getGroupMaintenanceWindow`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5910,8 +5947,30 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, + }, + }, + }, + `getGroupManagedSlowMs`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -5919,18 +5978,19 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `snapshotId`: `[snapshotId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getLegacySnapshotSchedule`: { + `getGroupMongoDbVersions`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, + `cloudProvider`: { + Usage: `Filter results to only one cloud provider.`, + }, + `defaultStatus`: { + Usage: `Filter results to only the default values per tier. This value must be DEFAULT.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5940,6 +6000,15 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `instanceSize`: { + Usage: `Filter results to only one instance size.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -5949,14 +6018,15 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `instanceSize`: `M10`, + `itemsPerPage`: `100`, }, }, }, }, }, - `getMaintenanceWindow`: { + `getGroupPeer`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -5966,6 +6036,9 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `peerId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to retrieve.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -5976,16 +6049,14 @@ var metadata = metadatatypes.Metadata{ Flags: map[string]string{ `groupId`: `32b6e34b3d91647abb20e7b8`, + `peerId`: `[peerId]`, }, }, }, }, }, - `getManagedNamespace`: { + `getGroupPipeline`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -5994,23 +6065,26 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `pipelineName`: `[pipelineName]`, }, }, }, }, }, - `getManagedSlowMs`: { + `getGroupPipelineAvailableSchedules`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6020,6 +6094,9 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -6029,39 +6106,40 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `pipelineName`: `[pipelineName]`, }, }, }, }, }, - `getMeasurements`: { + `getGroupPipelineAvailableSnapshots`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `end`: { - Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `completedAfter`: { + Usage: `Date and time after which MongoDB Cloud created the snapshot. If specified, MongoDB Cloud returns available backup snapshots created after this time and date only. This parameter expresses its value in the ISO 8601 timestamp format in UTC.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `granularity`: { - Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `metrics`: { - Usage: `List that contains the metrics that you want MongoDB Atlas to report for the associated data series. If you don't set this parameter, this resource returns all hardware and status metrics for the associated data series.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, - `period`: { - Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - `processId`: { - Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -6069,24 +6147,15 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `granularity`: `PT1M`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `metrics`: `[metrics]`, - `period`: `PT10H`, - `processId`: `my.host.name.com:27017`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `pipelineName`: `[pipelineName]`, }, }, }, }, }, - `getOnlineArchive`: { + `getGroupPipelineRun`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `archiveId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the online archive to return.`, - }, - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that contains the specified collection from which Application created the online archive.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6095,6 +6164,12 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + }, + `pipelineRunId`: { + Usage: `Unique 24-hexadecimal character string that identifies a Data Lake Pipeline run.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -6104,48 +6179,65 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `archiveId`: `[archiveId]`, - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `pipelineName`: `[pipelineName]`, + `pipelineRunId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getOrgResourcePolicy`: { + `getGroupPrivateEndpointEndpointService`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `cloudProvider`: { + Usage: `Cloud service provider that manages this private endpoint service.`, + }, + `endpointServiceId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to return.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `resourcePolicyId`: { - Usage: `Unique 24-hexadecimal digit string that identifies an atlas resource policy.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, - `resourcePolicyId`: `32b6e34b3d91647abb20e7b8`, + `cloudProvider`: `[cloudProvider]`, + `endpointServiceId`: `[endpointServiceId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getOrganization`: { + `getGroupPrivateEndpointEndpointServiceEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `cloudProvider`: { + Usage: `Cloud service provider that manages this private endpoint.`, + }, + `endpointId`: { + Usage: `Unique string that identifies the private endpoint you want to return. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints.`, + }, + `endpointServiceId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to return a private endpoint.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -6156,25 +6248,24 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `cloudProvider`: `[cloudProvider]`, + `endpointId`: `[endpointId]`, + `endpointServiceId`: `[endpointServiceId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getOrganizationEvent`: { + `getGroupPrivateEndpointRegionalMode`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `eventId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the event that you want to return.`, - }, - `includeRaw`: { - Usage: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -6185,23 +6276,27 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `eventId`: `[eventId]`, - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getOrganizationInvitation`: { + `getGroupPrivateEndpointServerlessInstanceEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `endpointId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the tenant endpoint.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `invitationId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `instanceName`: { + Usage: `Human-readable label that identifies the serverless instance associated with the tenant endpoint.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -6209,20 +6304,26 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `invitationId`: `[invitationId]`, - `orgId`: `4888442a3354817a7320eb61`, + `endpointId`: `[endpointId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `instanceName`: `[instanceName]`, }, }, }, }, }, - `getOrganizationSettings`: { + `getGroupPrivateNetworkSettingEndpointId`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `endpointId`: { + Usage: `Unique 22-character alphanumeric string that identifies the private endpoint to return. Atlas Data Federation supports AWS private endpoints using the AWS PrivateLink feature.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -6233,43 +6334,46 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `endpointId`: `[endpointId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getOrganizationUser`: { + `getGroupProcess`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, + `processId`: { + Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2025-02-19`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, - `userId`: `[userId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processId`: `mongodb.example.com:27017`, }, }, }, }, }, - `getOutageSimulation`: { + `getGroupProcessCollStatNamespaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that is undergoing outage simulation.`, + `end`: { + Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6279,24 +6383,34 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `period`: { + Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + }, + `processId`: { + Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `start`: { + Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-11-15`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `period`: `PT10H`, + `processId`: `my.host.name.com:27017`, }, }, }, }, }, - `getPeeringConnection`: { + `getGroupProcessDatabase`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `databaseName`: { + Usage: `Human-readable label that identifies the database that the specified MongoDB process serves.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6305,59 +6419,78 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `peerId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to retrieve.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processId`: { + Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `peerId`: `[peerId]`, + `databaseName`: `[databaseName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processId`: `mongodb.example.com:27017`, }, }, }, }, }, - `getPeeringContainer`: { + `getGroupProcessDatabaseMeasurements`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `containerId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container.`, + `databaseName`: { + Usage: `Human-readable label that identifies the database that the specified MongoDB process serves.`, + }, + `end`: { + Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `granularity`: { + Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, + }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `m`: { + Usage: `One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for ` + "`" + `m` + "`" + `, repeat the ` + "`" + `m` + "`" + ` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements.`, + }, + `period`: { + Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processId`: { + Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `start`: { + Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `containerId`: `32b6e34b3d91647abb20e7b8`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `databaseName`: `[databaseName]`, + `granularity`: `PT1M`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `period`: `PT10H`, + `processId`: `mongodb.example.com:27017`, }, }, }, }, }, - `getPinnedNamespaces`: { + `getGroupProcessDisk`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster to retrieve pinned namespaces for.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6366,92 +6499,124 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `partitionName`: { + Usage: `Human-readable label of the disk or partition to which the measurements apply.`, + }, + `processId`: { + Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-11-15`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `partitionName`: `[partitionName]`, + `processId`: `mongodb.example.com:27017`, }, }, }, }, }, - `getPipeline`: { + `getGroupProcessDiskMeasurements`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `end`: { + Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `granularity`: { + Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, + }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + `m`: { + Usage: `One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for ` + "`" + `m` + "`" + `, repeat the ` + "`" + `m` + "`" + ` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements.`, + }, + `partitionName`: { + Usage: `Human-readable label of the disk or partition to which the measurements apply.`, + }, + `period`: { + Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processId`: { + Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `start`: { + Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `pipelineName`: `[pipelineName]`, + `granularity`: `PT1M`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `partitionName`: `[partitionName]`, + `period`: `PT10H`, + `processId`: `mongodb.example.com:27017`, }, }, }, }, }, - `getPipelineRun`: { + `getGroupProcessMeasurements`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `end`: { + Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `granularity`: { + Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, + }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + `m`: { + Usage: `One or more types of measurement to request for this MongoDB process. If omitted, the resource returns all measurements. To specify multiple values for ` + "`" + `m` + "`" + `, repeat the ` + "`" + `m` + "`" + ` parameter for each value. Specify measurements that apply to the specified host. MongoDB Cloud returns an error if you specified any invalid measurements.`, }, - `pipelineRunId`: { - Usage: `Unique 24-hexadecimal character string that identifies a Data Lake Pipeline run.`, + `period`: { + Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processId`: { + Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `start`: { + Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `pipelineName`: `[pipelineName]`, - `pipelineRunId`: `32b6e34b3d91647abb20e7b8`, + `granularity`: `PT1M`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `period`: `PT10H`, + `processId`: `mongodb.example.com:27017`, }, }, }, }, }, - `getPrivateEndpoint`: { + `getGroupPushBasedLogExport`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Cloud service provider that manages this private endpoint.`, - }, - `endpointId`: { - Usage: `Unique string that identifies the private endpoint you want to return. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints.`, - }, - `endpointServiceId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to return a private endpoint.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6469,23 +6634,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `cloudProvider`: `[cloudProvider]`, - `endpointId`: `[endpointId]`, - `endpointServiceId`: `[endpointServiceId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getPrivateEndpointService`: { + `getGroupSampleDatasetLoad`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Cloud service provider that manages this private endpoint service.`, - }, - `endpointServiceId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to return.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6494,8 +6650,8 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `sampleDatasetId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the loaded sample dataset.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -6503,18 +6659,17 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `cloudProvider`: `[cloudProvider]`, - `endpointServiceId`: `[endpointServiceId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `sampleDatasetId`: `[sampleDatasetId]`, }, }, }, }, }, - `getPrivateLinkConnection`: { + `getGroupServerlessBackupRestoreJob`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `connectionId`: { - Usage: `Unique ID that identifies the Private Link connection.`, + `clusterName`: { + Usage: `Human-readable label that identifies the serverless instance.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6524,21 +6679,31 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `restoreJobId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the restore job to return.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `connectionId`: `[connectionId]`, + `clusterName`: `[clusterName]`, `groupId`: `32b6e34b3d91647abb20e7b8`, + `restoreJobId`: `[restoreJobId]`, }, }, }, }, }, - `getProject`: { + `getGroupServerlessBackupSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the serverless instance.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6547,52 +6712,35 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `get_project`, - Name: `Get a project`, - Description: `Get a project using a project id`, + Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `snapshotId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getProjectByName`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupName`: { - Usage: `Human-readable label that identifies this project.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `getProjectEvent`: { + `getGroupServerlessInstance`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `eventId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the event that you want to return.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeRaw`: { - Usage: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, + `name`: { + Usage: `Human-readable label that identifies the serverless instance.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -6603,15 +6751,18 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `eventId`: `[eventId]`, `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, }, }, }, }, }, - `getProjectInvitation`: { + `getGroupServerlessPerformanceAdvisorAutoIndexing`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6620,9 +6771,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `invitationId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -6632,17 +6780,17 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `invitationId`: `[invitationId]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getProjectIpAccessListStatus`: { + `getGroupServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `entryValue`: { - Usage: `Network address or cloud provider security construct that identifies which project access list entry to be verified.`, + `clientId`: { + Usage: `The Client ID of the Service Account.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6657,24 +6805,19 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `project_ip_access_list_get_status`, - Name: `Return Status of One Project IP Access List Entry`, - Description: `Returns the status of 10.0.0.0/16`, + `2024-08-05`: {{ + Source: `-`, Flags: map[string]string{ - `entryValue`: `10.0.0.0/16`, - `groupId`: `[your-project-id]`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getProjectIpList`: { + `getGroupSettings`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `entryValue`: { - Usage: `Access list entry that you want to return from the project's IP access list. This value can use one of the following: one AWS security group ID, one IP address, or one CIDR block of addresses. For CIDR blocks that use a subnet mask, replace the forward slash (` + "`" + `/` + "`" + `) with its URL-encoded value (` + "`" + `%2F` + "`" + `).`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6689,20 +6832,20 @@ var metadata = metadatatypes.Metadata{ }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `project_ip_access_list_get`, - Name: `Return One Project IP Access List Entry`, - Description: `Returns one access list entry from the specified project's IP access list: 10.0.0.0/16`, + Source: `-`, Flags: map[string]string{ - `entryValue`: `10.0.0.0/16`, - `groupId`: `[your-project-id]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getProjectLimit`: { + `getGroupStreamAccountDetails`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `cloudProvider`: { + Usage: `One of "aws", "azure" or "gcp".`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6711,49 +6854,27 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `limitName`: { - Usage: `Human-readable label that identifies this project limit. - -| Limit Name | Description | Default | API Override Limit | -| --- | --- | --- | --- | -| atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | -| atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | -| atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | -| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | -| atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | -| atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | -| dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | -| dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | -| dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | -| dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | -| atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| -| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| -| atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | -`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `regionName`: { + Usage: `The cloud provider specific region name, i.e. "US_EAST_1" for cloud provider "aws".`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `limitName`: `[limitName]`, + `cloudProvider`: `[cloudProvider]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `regionName`: `[regionName]`, }, }, }, }, }, - `getProjectLtsVersions`: { + `getGroupStreamConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Filter results to only one cloud provider.`, - }, - `defaultStatus`: { - Usage: `Filter results to only the default values per tier. This value must be DEFAULT.`, + `connectionName`: { + Usage: `Human-readable label that identifies the stream connection to return.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6763,36 +6884,27 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `instanceSize`: { - Usage: `Filter results to only one instance size.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance to return.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `instanceSize`: `M10`, - `itemsPerPage`: `100`, + `connectionName`: `[connectionName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `getProjectServiceAccount`: { + `getGroupStreamPrivateLinkConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, + `connectionId`: { + Usage: `Unique ID that identifies the Private Link connection.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6802,23 +6914,20 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `connectionId`: `[connectionId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getProjectSettings`: { + `getGroupStreamProcessor`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6831,19 +6940,27 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processorName`: { + Usage: `Human-readable label that identifies the stream processor.`, + }, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processorName`: `[processorName]`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `getProjectTeam`: { + `getGroupStreamProcessors`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6853,26 +6970,35 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `teamId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the team for which you want to get.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `teamId`: `[teamId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `getProjectUser`: { + `getGroupStreamWorkspace`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6882,26 +7008,26 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `includeConnections`: { + Usage: `Flag to indicate whether connections information should be included in the stream instance.`, }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance to return.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2025-02-19`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `userId`: `[userId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `getPushBasedLogConfiguration`: { + `getGroupTeam`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6914,6 +7040,9 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `teamId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the team for which you want to get.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ @@ -6921,12 +7050,13 @@ var metadata = metadatatypes.Metadata{ Flags: map[string]string{ `groupId`: `32b6e34b3d91647abb20e7b8`, + `teamId`: `[teamId]`, }, }, }, }, }, - `getPushMigration`: { + `getGroupUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6936,26 +7066,26 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `liveMigrationId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the migration.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Project resource and filter by username.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-02-19`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `liveMigrationId`: `6296fb4c7c7aa997cf94e9a8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `userId`: `[userId]`, }, }, }, }, }, - `getRegionalizedPrivateEndpointSetting`: { + `getGroupUserSecurity`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -6980,11 +7110,8 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getReplicaSetBackup`: { + `getGroupUserSecurityLdapVerify`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -6996,8 +7123,8 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + `requestId`: { + Usage: `Unique string that identifies the request to verify an Lightweight Directory Access Protocol (LDAP) configuration.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -7005,15 +7132,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `snapshotId`: `[snapshotId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `requestId`: `[requestId]`, }, }, }, }, }, - `getResourcesNonCompliant`: { + `getOrg`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -7026,7 +7152,7 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ @@ -7036,46 +7162,49 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getRoleMapping`: { + `getOrgApiKey`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to update.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, - }, - `id`: { - Usage: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to return.`, - }, `orgId`: { Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, - `id`: `32b6e34b3d91647abb20e7b8`, - `orgId`: `4888442a3354817a7320eb61`, + `apiUserId`: `[apiUserId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getSampleDatasetLoadStatus`: { + `getOrgApiKeyAccessListEntry`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `ipAddress`: { + Usage: `One IP address or multiple IP addresses represented as one CIDR block to limit requests to API resources in the specified organization. When adding a CIDR block with a subnet mask, such as 192.0.2.0/24, use the URL-encoded value %2F for the forward slash /.`, }, - `sampleDatasetId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the loaded sample dataset.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -7083,28 +7212,24 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `sampleDatasetId`: `[sampleDatasetId]`, + `apiUserId`: `[apiUserId]`, + `ipAddress`: `192.0.2.0%2F24`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getServerlessAutoIndexing`: { + `getOrgBillingCostExplorerUsage`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `token`: { + Usage: `Unique 64 digit string that identifies the Cost Explorer query.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -7112,28 +7237,29 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `orgId`: `4888442a3354817a7320eb61`, + `token`: `4ABBE973862346D40F3AE859D4BE96E0F895764EB14EAB039E7B82F9D638C05C`, }, }, }, }, }, - `getServerlessBackup`: { + `getOrgEvent`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the serverless instance.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `eventId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the event that you want to return.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + `includeRaw`: { + Usage: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -7141,59 +7267,55 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `snapshotId`: `32b6e34b3d91647abb20e7b8`, + `eventId`: `[eventId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getServerlessBackupRestoreJob`: { + `getOrgFederationSettings`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the serverless instance.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `restoreJobId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the restore job to return.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `restoreJobId`: `[restoreJobId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getServerlessInstance`: { + `getOrgGroups`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, `name`: { - Usage: `Human-readable label that identifies the serverless instance.`, + Usage: `Human-readable label of the project to use to filter the returned list. Performs a case-insensitive search for a project within the organization which is prefixed by the specified name.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -7204,28 +7326,22 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getServerlessPrivateEndpoint`: { + `getOrgInvite`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `endpointId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the tenant endpoint.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `invitationId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, }, - `instanceName`: { - Usage: `Human-readable label that identifies the serverless instance associated with the tenant endpoint.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -7233,22 +7349,21 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `endpointId`: `[endpointId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `instanceName`: `[instanceName]`, + `invitationId`: `[invitationId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getServiceAccount`: { + `getOrgInvoice`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `invoiceId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day.`, + }, `orgId`: { Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, @@ -7257,220 +7372,178 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `orgId`: `4888442a3354817a7320eb61`, + `invoiceId`: `[invoiceId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getShardedClusterBackup`: { + `getOrgInvoiceCsv`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `invoiceId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `snapshotId`: `[snapshotId]`, + `invoiceId`: `[invoiceId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getSharedClusterBackup`: { + `getOrgNonCompliantResources`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `snapshotId`: `[snapshotId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getSharedClusterBackupRestoreJob`: { + `getOrgResourcePolicy`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `restoreId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the restore job to return.`, + `resourcePolicyId`: { + Usage: `Unique 24-hexadecimal digit string that identifies an atlas resource policy.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `restoreId`: `[restoreId]`, + `orgId`: `4888442a3354817a7320eb61`, + `resourcePolicyId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `getStreamConnection`: { + `getOrgServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `connectionName`: { - Usage: `Human-readable label that identifies the stream connection to return.`, - }, - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance to return.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `connectionName`: `[connectionName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `tenantName`: `[tenantName]`, - }, - }, + `clientId`: { + Usage: `The Client ID of the Service Account.`, }, - }, - }, - `getStreamInstance`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `includeConnections`: { - Usage: `Flag to indicate whether connections information should be included in the stream instance.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance to return.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `tenantName`: `[tenantName]`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getStreamProcessor`: { + `getOrgServiceAccountGroups`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, - `processorName`: { - Usage: `Human-readable label that identifies the stream processor.`, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processorName`: `[processorName]`, - `tenantName`: `[tenantName]`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `getSystemStatus`: { + `getOrgSettings`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: nil, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `orgId`: `4888442a3354817a7320eb61`, + }, + }, + }, + }, }, - `getTeamById`: { + `getOrgTeam`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -7497,7 +7570,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getTeamByName`: { + `getOrgTeamByName`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -7524,35 +7597,44 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `getThirdPartyIntegration`: { + `getOrgUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `integrationType`: { - Usage: `Human-readable label that identifies the service which you want to integrate with MongoDB Cloud.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-02-19`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `integrationType`: `[integrationType]`, + `orgId`: `4888442a3354817a7320eb61`, + `userId`: `[userId]`, }, }, }, }, }, + `getSystemStatus`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, `getUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { @@ -7567,7 +7649,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `getUserByUsername`: { + `getUserByName`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -7581,8 +7663,11 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `getValidationStatus`: { + `grantGroupClusterMongoDbEmployeeAccess`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies this cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -7591,24 +7676,17 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `validationId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the validation job.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `validationId`: `507f1f77bcf86cd799439011`, - }, - }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, + Examples: nil, }, - `getVpcPeeringConnections`: { + `inviteGroupServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -7617,43 +7695,36 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `requesterAccountId`: { - Usage: `The Account ID of the VPC Peering connection/s.`, - }, }, - Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `requesterAccountId`: `[requesterAccountId]`, - }, + Examples: nil, + }, + `listAlertConfigMatcherFieldNames`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, + Examples: nil, }, - `grantMongoDbEmployeeAccess`: { + `listClusterDetails`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -7661,36 +7732,44 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `listAccessLogsByClusterName`: { + `listControlPlaneIpAddresses`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `authResult`: { - Usage: `Flag that indicates whether the response returns the successful authentication attempts only.`, - }, - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, - `end`: { - Usage: `Date and time when to stop retrieving database history. If you specify **end**, you must also specify **start**. This parameter uses UNIX epoch time in milliseconds.`, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + }, + Examples: nil, + }, + `listEventTypes`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, - `ipAddress`: { - Usage: `One Internet Protocol address that attempted to authenticate with the database.`, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - `nLogs`: { - Usage: `Maximum number of lines from the log to return.`, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins retrieving database history. If you specify **start**, you must also specify **end**. This parameter uses UNIX epoch time in milliseconds.`, + }, + Examples: nil, + }, + `listFederationSettingConnectedOrgConfigRoleMappings`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -7698,43 +7777,26 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `federationSettingsId`: `55fa922fb343282757d9554e`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listAccessLogsByHostname`: { + `listFederationSettingConnectedOrgConfigs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `authResult`: { - Usage: `Flag that indicates whether the response returns the successful authentication attempts only.`, - }, - `end`: { - Usage: `Date and time when to stop retrieving database history. If you specify **end**, you must also specify **start**. This parameter uses UNIX epoch time in milliseconds.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `hostname`: { - Usage: `Fully qualified domain name or IP address of the MongoDB host that stores the log files that you want to download.`, - }, - `ipAddress`: { - Usage: `One Internet Protocol address that attempted to authenticate with the database.`, - }, - `nLogs`: { - Usage: `Maximum number of lines from the log to return.`, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins retrieving database history. If you specify **start**, you must also specify **end**. This parameter uses UNIX epoch time in milliseconds.`, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -7742,25 +7804,45 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `hostname`: `[hostname]`, + `federationSettingsId`: `55fa922fb343282757d9554e`, }, }, }, }, }, - `listAlertConfigurationMatchersFieldNames`: { + `listFederationSettingIdentityProviders`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `idpType`: { + Usage: `The types of the target identity providers.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + `protocol`: { + Usage: `The protocols of the target identity providers.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `federationSettingsId`: `55fa922fb343282757d9554e`, + }, + }, }, }, - Examples: nil, }, - `listAlertConfigurations`: { + `listGroupAccessListEntries`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -7785,20 +7867,19 @@ var metadata = metadatatypes.Metadata{ }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `-`, + Source: `project_ip_access_list_list`, + Name: `Return project IP access list`, + Description: `Returns all access list entries from the specified project's IP access list.`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `[your-project-id]`, }, }, }, }, }, - `listAlertConfigurationsByAlertId`: { + `listGroupAlertConfigs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `alertId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the alert.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -7825,14 +7906,13 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `alertId`: `[alertId]`, `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listAlerts`: { + `listGroupAlerts`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -7869,11 +7949,8 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listAlertsByAlertConfigurationId`: { + `listGroupApiKeys`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `alertConfigId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -7900,30 +7977,28 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `alertConfigId`: `32b6e34b3d91647abb20e7b8`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listApiKeyAccessListsEntries`: { + `listGroupBackupExportBuckets`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, @@ -7932,33 +8007,25 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `apiUserId`: `[apiUserId]`, - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listApiKeys`: { + `listGroupCloudProviderAccess`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -7969,14 +8036,17 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listAtlasProcesses`: { + `listGroupClusterBackupCheckpoints`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that contains the checkpoints that you want to return.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -8000,27 +8070,20 @@ var metadata = metadatatypes.Metadata{ }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `list_atlas_processes`, - Name: `List all processes for a project`, - Description: `Returns details of all processes for the specified project`, + Source: `-`, Flags: map[string]string{ - `groupId`: `[your-project-id]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listAtlasSearchIndexes`: { + `listGroupClusterBackupExports`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, - }, - `collectionName`: { - Usage: `Name of the collection that contains one or more Atlas Search indexes.`, - }, - `databaseName`: { - Usage: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8030,28 +8093,35 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `collectionName`: `[collectionName]`, - `databaseName`: `[databaseName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listAtlasSearchIndexesCluster`: { + `listGroupClusterBackupRestoreJobs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, + Usage: `Human-readable label that identifies the cluster with the restore jobs you want to return.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8061,12 +8131,21 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ @@ -8077,16 +8156,10 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listAtlasSearchIndexesDeprecated`: { + `listGroupClusterBackupSnapshotShardedClusters`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, - }, - `collectionName`: { - Usage: `Name of the collection that contains one or more Atlas Search indexes.`, - }, - `databaseName`: { - Usage: `Human-readable label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8105,16 +8178,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `collectionName`: `[collectionName]`, - `databaseName`: `[databaseName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listBackupExportJobs`: { + `listGroupClusterBackupSnapshots`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster.`, @@ -8152,10 +8223,10 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listBackupRestoreJobs`: { + `listGroupClusterBackupTenantRestores`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster with the restore jobs you want to return.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8165,15 +8236,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -8190,8 +8252,11 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listCloudProviderAccessRoles`: { + `listGroupClusterBackupTenantSnapshots`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -8209,14 +8274,30 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listCloudProviderRegions`: { + `listGroupClusterCollStatMeasurements`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster to retrieve metrics for.`, + }, + `clusterView`: { + Usage: `Human-readable label that identifies the cluster topology to retrieve metrics for.`, + }, + `collectionName`: { + Usage: `Human-readable label that identifies the collection.`, + }, + `databaseName`: { + Usage: `Human-readable label that identifies the database.`, + }, + `end`: { + Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -8225,67 +8306,48 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `metrics`: { + Usage: `List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics.`, }, - `providers`: { - Usage: `Cloud providers whose regions to retrieve. When you specify multiple providers, the response can return only tiers and regions that support multi-cloud clusters.`, + `period`: { + Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, }, - `tier`: { - Usage: `Cluster tier for which to retrieve the regions.`, + `start`: { + Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-11-15`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `clusterView`: `[clusterView]`, + `collectionName`: `mycoll`, + `databaseName`: `mydb`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `period`: `PT10H`, }, }, }, }, }, - `listClusterSuggestedIndexes`: { + `listGroupClusterCollStatPinnedNamespaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + Usage: `Human-readable label that identifies the cluster to retrieve pinned namespaces for.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `namespaces`: { - Usage: `Namespaces from which to retrieve suggested indexes. A namespace consists of one database and one collection resource written as ` + "`" + `.` + "`" + `: ` + "`" + `.` + "`" + `. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each namespace. Omit this parameter to return results for all namespaces.`, - }, - `processIds`: { - Usage: `ProcessIds from which to retrieve suggested indexes. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each processId.`, - }, - `since`: { - Usage: `Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. -- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, - }, - `until`: { - Usage: `Date and time up until which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you specify the **until** parameter, you must specify the **since** parameter. -- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-11-15`: {{ Source: `-`, Flags: map[string]string{ @@ -8296,8 +8358,17 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listClusters`: { + `listGroupClusterFtsIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, + }, + `collectionName`: { + Usage: `Name of the collection that contains one or more Atlas Search indexes.`, + }, + `databaseName`: { + Usage: `Human-readable label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -8306,40 +8377,37 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `includeDeletedWithRetainedBackups`: { - Usage: `Flag that indicates whether to return Clusters with retain backups.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ - Source: `list_clusters`, - Name: `List all clusters in a project`, - Description: `Returns all clusters in the specified project`, + `2023-01-01`: {{ + Source: `-`, Flags: map[string]string{ - `groupId`: `[your-project-id]`, + `clusterName`: `[clusterName]`, + `collectionName`: `[collectionName]`, + `databaseName`: `[databaseName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listClustersForAllProjects`: { + `listGroupClusterOnlineArchives`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that contains the collection for which you want to return the online archives.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, @@ -8353,94 +8421,106 @@ var metadata = metadatatypes.Metadata{ Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: nil, - }, - `listConnectedOrgConfigs`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, + }, + }, + `listGroupClusterPerformanceAdvisorDropIndexSuggestions`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listCustomDatabaseRoles`: { + `listGroupClusterPerformanceAdvisorSchemaAdvice`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listDataFederationPrivateEndpoints`: { + `listGroupClusterPerformanceAdvisorSuggestedIndexes`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + `namespaces`: { + Usage: `Namespaces from which to retrieve suggested indexes. A namespace consists of one database and one collection resource written as ` + "`" + `.` + "`" + `: ` + "`" + `.` + "`" + `. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each namespace. Omit this parameter to return results for all namespaces.`, }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, + `processIds`: { + Usage: `ProcessIds from which to retrieve suggested indexes. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each processId.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `since`: { + Usage: `Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. +- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `until`: { + Usage: `Date and time up until which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you specify the **until** parameter, you must specify the **since** parameter. +- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listDatabaseUserCertificates`: { + `listGroupClusterProviderRegions`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8462,8 +8542,11 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `username`: { - Usage: `Human-readable label that represents the MongoDB database user account whose certificates you want to return.`, + `providers`: { + Usage: `Cloud providers whose regions to retrieve. When you specify multiple providers, the response can return only tiers and regions that support multi-cloud clusters.`, + }, + `tier`: { + Usage: `Cluster tier for which to retrieve the regions.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -8471,15 +8554,20 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `username`: `[username]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listDatabaseUsers`: { + `listGroupClusterQueryShapeInsightSummaries`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, + `commands`: { + Usage: `Retrieve query shape statistics matching specified MongoDB commands. To include multiple commands, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each command. The currently supported parameters are find, distinct, and aggregate. Omit this parameter to return results for all supported commands.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -8488,32 +8576,57 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, + `nSummaries`: { + Usage: `Maximum number of query statistic summaries to return.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `namespaces`: { + Usage: `Namespaces from which to retrieve query shape statistics. A namespace consists of one database and one collection resource written as ` + "`" + `.` + "`" + `: ` + "`" + `.` + "`" + `. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each namespace. Omit this parameter to return results for all namespaces.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processIds`: { + Usage: `ProcessIds from which to retrieve query shape statistics. A processId is a combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests. To include multiple processIds, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each processId.`, + }, + `queryShapeHashes`: { + Usage: `A list of SHA256 hashes of desired query shapes, output by MongoDB commands like $queryStats and $explain or slow query logs. To include multiple series, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each series. Omit this parameter to return results for all available series.`, + }, + `series`: { + Usage: `Query shape statistics data series to retrieve. A series represents a specific metric about query execution. To include multiple series, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each series. Omit this parameter to return results for all available series.`, + }, + `since`: { + Usage: `Date and time from which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you don't specify the **until** parameter, the endpoint returns data covering from the **since** value and the current time. +- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, + }, + `until`: { + Usage: `Date and time up until which to retrieve query shape statistics. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you specify the **until** parameter, you must specify the **since** parameter. +- If you specify neither the **since** nor the **until** parameters, the endpoint returns data from the previous 24 hours.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-03-12`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listDatabases`: { + `listGroupClusterRestoreJobs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `batchId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the batch of restore jobs to return. Timestamp in ISO 8601 date and time format in UTC when creating a restore job for a sharded cluster, Application creates a separate job for each shard, plus another for the config host. Each of these jobs comprise one batch. A restore job for a replica set can't be part of a batch.`, + }, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -8534,24 +8647,30 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processId`: `mongodb.example.com:27017`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listDiskMeasurements`: { + `listGroupClusterSearchIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, + }, + `collectionName`: { + Usage: `Name of the collection that contains one or more Atlas Search indexes.`, + }, + `databaseName`: { + Usage: `Label that identifies the database that contains the collection with one or more Atlas Search indexes.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -8560,28 +8679,29 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `partitionName`: { - Usage: `Human-readable label of the disk or partition to which the measurements apply.`, - }, - `processId`: { - Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `partitionName`: `[partitionName]`, - `processId`: `mongodb.example.com:27017`, + `clusterName`: `[clusterName]`, + `collectionName`: `[collectionName]`, + `databaseName`: `[databaseName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listDiskPartitions`: { + `listGroupClusterSearchIndexes`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Name of the cluster that contains the collection with one or more Atlas Search indexes.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -8590,62 +8710,38 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processId`: `mongodb.example.com:27017`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listDropIndexes`: { + `listGroupClusterSnapshots`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster.`, }, + `completed`: { + Usage: `Human-readable label that specifies whether to return only completed, incomplete, or all snapshots. By default, MongoDB Cloud only returns completed snapshots.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - }, - Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ - Source: `-`, - - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, - }, - }, - }, - `listEventTypes`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, @@ -8659,9 +8755,19 @@ var metadata = metadatatypes.Metadata{ Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: nil, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, + }, + }, }, - `listExportBuckets`: { + `listGroupClusters`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8674,6 +8780,9 @@ var metadata = metadatatypes.Metadata{ `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, + `includeDeletedWithRetainedBackups`: { + Usage: `Flag that indicates whether to return Clusters with retain backups.`, + }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, @@ -8685,17 +8794,19 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ - Source: `-`, + `2024-08-05`: {{ + Source: `list_clusters`, + Name: `List all clusters in a project`, + Description: `Returns all clusters in the specified project`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `[your-project-id]`, }, }, }, }, }, - `listFederatedDatabases`: { + `listGroupCollStatMetrics`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8705,15 +8816,9 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `type`: { - Usage: `Type of Federated Database Instances to return.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-11-15`: {{ Source: `-`, Flags: map[string]string{ @@ -8723,7 +8828,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listFlexBackupRestoreJobs`: { + `listGroupContainerAll`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8739,9 +8844,6 @@ var metadata = metadatatypes.Metadata{ `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `name`: { - Usage: `Human-readable label that identifies the flex cluster.`, - }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, @@ -8750,18 +8852,17 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, }, }, }, }, }, - `listFlexBackups`: { + `listGroupContainers`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8777,29 +8878,29 @@ var metadata = metadatatypes.Metadata{ `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `name`: { - Usage: `Human-readable label that identifies the flex cluster.`, - }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `providerName`: { + Usage: `Cloud service provider that serves the desired network peering containers.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `providerName`: `[providerName]`, }, }, }, }, }, - `listFlexClusters`: { + `listGroupCustomDbRoleRoles`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -8809,21 +8910,40 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + }, + }, + `listGroupDataFederation`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `type`: { + Usage: `Type of Federated Database Instances to return.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2024-11-13`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ @@ -8833,25 +8953,21 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listIdentityProviders`: { + `listGroupDataFederationLimits`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, - }, - `idpType`: { - Usage: `The types of the target identity providers.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `protocol`: { - Usage: `The protocols of the target identity providers.`, + `tenantName`: { + Usage: `Human-readable label that identifies the federated database instance for which you want to retrieve query limits.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -8859,45 +8975,37 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `listIndexMetrics`: { + `listGroupDatabaseUserCerts`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `collectionName`: { - Usage: `Human-readable label that identifies the collection.`, - }, - `databaseName`: { - Usage: `Human-readable label that identifies the database.`, - }, - `end`: { - Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `granularity`: { - Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `metrics`: { - Usage: `List that contains the measurements that MongoDB Atlas reports for the associated data series.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, - `period`: { - Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - `processId`: { - Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, - `start`: { - Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `username`: { + Usage: `Human-readable label that represents the MongoDB database user account whose certificates you want to return.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -8905,25 +9013,22 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `collectionName`: `mycoll`, - `databaseName`: `mydb`, - `granularity`: `PT1M`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - `metrics`: `[metrics]`, - `period`: `PT10H`, - `processId`: `my.host.name.com:27017`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `username`: `[username]`, }, }, }, }, }, - `listInvoices`: { + `listGroupDatabaseUsers`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `fromDate`: { - Usage: `Retrieve the invoices the startDates of which are greater than or equal to the fromDate. If omit, the invoices return will go back to earliest startDate.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, @@ -8931,49 +9036,28 @@ var metadata = metadatatypes.Metadata{ `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `orderBy`: { - Usage: `Field used to order the returned invoices by. Use in combination of sortBy parameter to control the order of the result.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `sortBy`: { - Usage: `Field used to sort the returned invoices by. Use in combination with orderBy parameter to control the order of the result.`, - }, - `statusNames`: { - Usage: `Statuses of the invoice to be retrieved. Omit to return invoices of all statuses.`, - }, - `toDate`: { - Usage: `Retrieve the invoices the endDates of which are smaller than or equal to the toDate. If omit, the invoices return will go further to latest endDate.`, - }, - `viewLinkedInvoices`: { - Usage: `Flag that indicates whether to return linked invoices in the linkedInvoices field.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `fromDate`: `2023-01-01`, - `orderBy`: `desc`, - `orgId`: `4888442a3354817a7320eb61`, - `toDate`: `2023-01-01`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listLegacyBackupCheckpoints`: { + `listGroupEncryptionAtRestPrivateEndpoints`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that contains the checkpoints that you want to return.`, + `cloudProvider`: { + Usage: `Human-readable label that identifies the cloud provider for the private endpoints to return.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9001,24 +9085,31 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `cloudProvider`: `[cloudProvider]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listLegacyBackupRestoreJobs`: { + `listGroupEvents`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `batchId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the batch of restore jobs to return. Timestamp in ISO 8601 date and time format in UTC when creating a restore job for a sharded cluster, Application creates a separate job for each shard, plus another for the config host. Each of these jobs comprise one batch. A restore job for a replica set can't be part of a batch.`, - }, - `clusterName`: { - Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, + `clusterNames`: { + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `eventType`: { + Usage: `Category of incident recorded at this moment in time. + +**IMPORTANT**: The complete list of event type values changes frequently.`, + }, + `excludedEventType`: { + Usage: `Category of event that you would like to exclude from query results, such as CLUSTER_CREATED + +**IMPORTANT**: Event type names change frequently. Verify that you specify the event type correctly by checking the complete list of event types.`, + }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. @@ -9027,9 +9118,18 @@ var metadata = metadatatypes.Metadata{ `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, + `includeRaw`: { + Usage: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, + }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, + `maxDate`: { + Usage: `Date and time from when MongoDB Cloud stops returning events. This parameter uses the ISO 8601 timestamp format in UTC.`, + }, + `minDate`: { + Usage: `Date and time from when MongoDB Cloud starts returning events. This parameter uses the ISO 8601 timestamp format in UTC.`, + }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, @@ -9042,21 +9142,14 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listLegacySnapshots`: { + `listGroupFlexClusterBackupRestoreJobs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, - `completed`: { - Usage: `Human-readable label that specifies whether to return only completed, incomplete, or all snapshots. By default, MongoDB Cloud only returns completed snapshots.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9071,6 +9164,9 @@ var metadata = metadatatypes.Metadata{ `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, + `name`: { + Usage: `Human-readable label that identifies the flex cluster.`, + }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, @@ -9079,18 +9175,18 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, }, }, }, }, }, - `listMetricTypes`: { + `listGroupFlexClusterBackupSnapshots`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9100,27 +9196,36 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `processId`: { - Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `name`: { + Usage: `Human-readable label that identifies the flex cluster.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processId`: `my.host.name.com:27017`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, }, }, }, }, }, - `listOnlineArchives`: { + `listGroupFlexClusters`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that contains the collection for which you want to return the online archives.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9143,73 +9248,95 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listOrgResourcePolicies`: { + `listGroupHostFtsMetricIndexMeasurements`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `collectionName`: { + Usage: `Human-readable label that identifies the collection.`, + }, + `databaseName`: { + Usage: `Human-readable label that identifies the database.`, + }, + `end`: { + Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `granularity`: { + Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `metrics`: { + Usage: `List that contains the measurements that MongoDB Atlas reports for the associated data series.`, + }, + `period`: { + Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + }, + `processId`: { + Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `start`: { + Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `collectionName`: `mycoll`, + `databaseName`: `mydb`, + `granularity`: `PT1M`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `metrics`: `[metrics]`, + `period`: `PT10H`, + `processId`: `my.host.name.com:27017`, }, }, }, }, }, - `listOrganizationEvents`: { + `listGroupHostFtsMetricMeasurements`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `end`: { + Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `eventType`: { - Usage: `Category of incident recorded at this moment in time. - -**IMPORTANT**: The complete list of event type values changes frequently.`, - }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `includeRaw`: { - Usage: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `maxDate`: { - Usage: `Date and time from when MongoDB Cloud stops returning events. This parameter uses the ISO 8601 timestamp format in UTC.`, + `granularity`: { + Usage: `Duration that specifies the interval at which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC.`, }, - `minDate`: { - Usage: `Date and time from when MongoDB Cloud starts returning events. This parameter uses the ISO 8601 timestamp format in UTC.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `metrics`: { + Usage: `List that contains the metrics that you want MongoDB Atlas to report for the associated data series. If you don't set this parameter, this resource returns all hardware and status metrics for the associated data series.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `period`: { + Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `processId`: { + Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `start`: { + Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -9217,25 +9344,28 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `granularity`: `PT1M`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `metrics`: `[metrics]`, + `period`: `PT10H`, + `processId`: `my.host.name.com:27017`, }, }, }, }, }, - `listOrganizationInvitations`: { + `listGroupHostFtsMetrics`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `username`: { - Usage: `Email address of the user account invited to this organization. If you exclude this parameter, this resource returns all pending invitations.`, + `processId`: { + Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -9243,29 +9373,29 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processId`: `my.host.name.com:27017`, }, }, }, }, }, - `listOrganizationProjects`: { + `listGroupIntegrations`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `name`: { - Usage: `Human-readable label of the project to use to filter the returned list. Performs a case-insensitive search for a project within the organization which is prefixed by the specified name.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, @@ -9278,107 +9408,66 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listOrganizationTeams`: { + `listGroupInvites`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `username`: { + Usage: `Email address of the user account invited to this project.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listOrganizationUsers`: { + `listGroupLimits`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `orgMembershipStatus`: { - Usage: `Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `username`: { - Usage: `Email address to filter users by. Not supported in deprecated versions.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2025-02-19`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, - `orgMembershipStatus`: `ACTIVE`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listOrganizations`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `name`: { - Usage: `Human-readable label of the organization to use to filter the returned list. Performs a case-insensitive search for an organization that starts with the specified name.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `listPeeringConnections`: { + `listGroupPeers`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9415,8 +9504,11 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listPeeringContainerByCloudProvider`: { + `listGroupPipelineRuns`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `createdBefore`: { + Usage: `If specified, Atlas returns only Data Lake Pipeline runs initiated before this time and date.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9434,12 +9526,12 @@ var metadata = metadatatypes.Metadata{ `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `providerName`: { - Usage: `Cloud service provider that serves the desired network peering containers.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ @@ -9447,13 +9539,13 @@ var metadata = metadatatypes.Metadata{ Flags: map[string]string{ `groupId`: `32b6e34b3d91647abb20e7b8`, - `providerName`: `[providerName]`, + `pipelineName`: `[pipelineName]`, }, }, }, }, }, - `listPeeringContainers`: { + `listGroupPipelines`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9463,14 +9555,30 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + }, + `listGroupPrivateEndpointEndpointService`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `cloudProvider`: { + Usage: `Cloud service provider that manages this private endpoint service.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -9481,22 +9589,25 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `cloudProvider`: `[cloudProvider]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listPendingInvoices`: { + `listGroupPrivateEndpointServerlessInstanceEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `instanceName`: { + Usage: `Human-readable label that identifies the serverless instance associated with the tenant endpoint.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -9504,17 +9615,15 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `instanceName`: `[instanceName]`, }, }, }, }, }, - `listPipelineRuns`: { + `listGroupPrivateNetworkSettingEndpointIds`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `createdBefore`: { - Usage: `If specified, Atlas returns only Data Lake Pipeline runs initiated before this time and date.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9532,9 +9641,6 @@ var metadata = metadatatypes.Metadata{ `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -9544,15 +9650,23 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `pipelineName`: `[pipelineName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listPipelineSchedules`: { + `listGroupProcessCollStatMeasurements`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `collectionName`: { + Usage: `Human-readable label that identifies the collection.`, + }, + `databaseName`: { + Usage: `Human-readable label that identifies the database.`, + }, + `end`: { + Usage: `Date and time when MongoDB Cloud stops reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9561,30 +9675,36 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + `metrics`: { + Usage: `List that contains the metrics that you want to retrieve for the associated data series. If you don't set this parameter, this resource returns data series for all Coll Stats Latency metrics.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `period`: { + Usage: `Duration over which Atlas reports the metrics. This parameter expresses its value in the ISO 8601 duration format in UTC. Include this parameter when you do not set **start** and **end**.`, + }, + `processId`: { + Usage: `Combination of hostname and IANA port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (mongod or mongos). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `start`: { + Usage: `Date and time when MongoDB Cloud begins reporting the metrics. This parameter expresses its value in the ISO 8601 timestamp format in UTC. Include this parameter when you do not set **period**.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-11-15`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `pipelineName`: `[pipelineName]`, + `collectionName`: `mycoll`, + `databaseName`: `mydb`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `period`: `PT10H`, + `processId`: `my.host.name.com:27017`, }, }, }, }, }, - `listPipelineSnapshots`: { + `listGroupProcessDatabases`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `completedAfter`: { - Usage: `Date and time after which MongoDB Cloud created the snapshot. If specified, MongoDB Cloud returns available backup snapshots created after this time and date only. This parameter expresses its value in the ISO 8601 timestamp format in UTC.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9602,26 +9722,26 @@ var metadata = metadatatypes.Metadata{ `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processId`: { + Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `pipelineName`: `[pipelineName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processId`: `mongodb.example.com:27017`, }, }, }, }, }, - `listPipelines`: { + `listGroupProcessDisks`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9631,22 +9751,41 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `processId`: { + Usage: `Combination of hostname and Internet Assigned Numbers Authority (IANA) port that serves the MongoDB process. The host must be the hostname, fully qualified domain name (FQDN), or Internet Protocol address (IPv4 or IPv6) of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processId`: `mongodb.example.com:27017`, }, }, }, }, }, - `listPrivateEndpointServices`: { + `listGroupProcessPerformanceAdvisorNamespaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `cloudProvider`: { - Usage: `Cloud service provider that manages this private endpoint service.`, + `duration`: { + Usage: `Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. + +- If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. +- If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9659,21 +9798,36 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processId`: { + Usage: `Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `since`: { + Usage: `Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. +- If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `cloudProvider`: `[cloudProvider]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processId`: `[processId]`, }, }, }, }, }, - `listPrivateLinkConnections`: { + `listGroupProcessPerformanceAdvisorSlowQueryLogs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `duration`: { + Usage: `Length of time expressed during which the query finds slow queries among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. + +- If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. +- If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9682,29 +9836,54 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, + `includeMetrics`: { + Usage: `Whether or not to include metrics extracted from the slow query log as separate fields.`, }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `includeOpType`: { + Usage: `Whether or not to include the operation type (read/write/command) extracted from the slow query log as a separate field.`, + }, + `includeReplicaState`: { + Usage: `Whether or not to include the replica state of the host when the slow query log was generated as a separate field.`, + }, + `nLogs`: { + Usage: `Maximum number of lines from the log to return.`, + }, + `namespaces`: { + Usage: `Namespaces from which to retrieve slow queries. A namespace consists of one database and one collection resource written as ` + "`" + `.` + "`" + `: ` + "`" + `.` + "`" + `. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each namespace. Omit this parameter to return results for all namespaces.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processId`: { + Usage: `Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `since`: { + Usage: `Date and time from which the query retrieves the slow queries. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. +- If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processId`: `[processId]`, }, }, }, }, }, - `listProjectApiKeys`: { + `listGroupProcessPerformanceAdvisorSuggestedIndexes`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `duration`: { + Usage: `Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. + +- If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. +- If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9719,42 +9898,48 @@ var metadata = metadatatypes.Metadata{ `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, + `nExamples`: { + Usage: `Maximum number of example queries that benefit from the suggested index.`, + }, + `nIndexes`: { + Usage: `Number that indicates the maximum indexes to suggest.`, + }, + `namespaces`: { + Usage: `Namespaces from which to retrieve suggested indexes. A namespace consists of one database and one collection resource written as ` + "`" + `.` + "`" + `: ` + "`" + `.` + "`" + `. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each namespace. Omit this parameter to return results for all namespaces.`, + }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processId`: { + Usage: `Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, + }, + `since`: { + Usage: `Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). + +- If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. +- If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processId`: `[processId]`, }, }, }, }, }, - `listProjectEvents`: { + `listGroupProcesses`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterNames`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `eventType`: { - Usage: `Category of incident recorded at this moment in time. - -**IMPORTANT**: The complete list of event type values changes frequently.`, - }, - `excludedEventType`: { - Usage: `Category of event that you would like to exclude from query results, such as CLUSTER_CREATED - -**IMPORTANT**: Event type names change frequently. Verify that you specify the event type correctly by checking the complete list of event types.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. @@ -9763,18 +9948,9 @@ var metadata = metadatatypes.Metadata{ `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, - `includeRaw`: { - Usage: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, - }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `maxDate`: { - Usage: `Date and time from when MongoDB Cloud stops returning events. This parameter uses the ISO 8601 timestamp format in UTC.`, - }, - `minDate`: { - Usage: `Date and time from when MongoDB Cloud starts returning events. This parameter uses the ISO 8601 timestamp format in UTC.`, - }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, @@ -9784,17 +9960,22 @@ var metadata = metadatatypes.Metadata{ }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `-`, + Source: `list_atlas_processes`, + Name: `List all processes for a project`, + Description: `Returns details of all processes for the specified project`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `[your-project-id]`, }, }, }, }, }, - `listProjectInvitations`: { + `listGroupServerlessBackupRestoreJobs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the serverless instance.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9803,26 +9984,36 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `username`: { - Usage: `Email address of the user account invited to this project.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listProjectIpAccessLists`: { + `listGroupServerlessBackupSnapshots`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the serverless instance.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -9846,18 +10037,17 @@ var metadata = metadatatypes.Metadata{ }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ - Source: `project_ip_access_list_list`, - Name: `Return project IP access list`, - Description: `Returns all access list entries from the specified project's IP access list.`, + Source: `-`, Flags: map[string]string{ - `groupId`: `[your-project-id]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listProjectLimits`: { + `listGroupServerlessInstances`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9867,6 +10057,15 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, @@ -9882,7 +10081,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listProjectServiceAccountAccessList`: { + `listGroupServiceAccountAccessList`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clientId`: { Usage: `The Client ID of the Service Account.`, @@ -9920,7 +10119,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listProjectServiceAccounts`: { + `listGroupServiceAccounts`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9951,7 +10150,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listProjectTeams`: { + `listGroupStreamActiveVpcPeeringConnections`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -9961,9 +10160,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, @@ -9975,7 +10171,7 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-11-13`: {{ Source: `-`, Flags: map[string]string{ @@ -9985,85 +10181,43 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listProjectUsers`: { + `listGroupStreamConnections`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `flattenTeams`: { - Usage: `Flag that indicates whether the returned list should include users who belong to a team with a role in this project. You might not have assigned the individual users a role in this project. If ` + "`" + `"flattenTeams" : false` + "`" + `, this resource returns only users with a role in the project. If ` + "`" + `"flattenTeams" : true` + "`" + `, this resource returns both users with roles in the project and users who belong to teams with roles in the project.`, - }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `includeOrgUsers`: { - Usage: `Flag that indicates whether the returned list should include users with implicit access to the project, the Organization Owner or Organization Read Only role. You might not have assigned the individual users a role in this project. If ` + "`" + `"includeOrgUsers": false` + "`" + `, this resource returns only users with a role in the project. If ` + "`" + `"includeOrgUsers": true` + "`" + `, this resource returns both users with roles in the project and users who have implicit access to the project through their organization role.`, - }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `orgMembershipStatus`: { - Usage: `Flag that indicates whether to filter the returned list by users organization membership status. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, - }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `username`: { - Usage: `Email address to filter users by. Not supported in deprecated versions.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2025-02-19`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `orgMembershipStatus`: `ACTIVE`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `listProjects`: { + `listGroupStreamPrivateLinkConnections`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `list_projects`, - Name: `Get a list of all projects`, - Description: `Get a list of all projects inside of the organisation`, - }, - }, - }, - }, - `listReplicaSetBackups`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -10072,9 +10226,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, @@ -10086,69 +10237,18 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, - }, - }, - }, - `listRoleMappings`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, - `orgId`: `4888442a3354817a7320eb61`, - }, - }, - }, - }, - }, - `listSchemaAdvice`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listServerlessBackupRestoreJobs`: { + `listGroupStreamVpcPeeringConnections`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the serverless instance.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -10157,9 +10257,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, @@ -10169,24 +10266,24 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `requesterAccountId`: { + Usage: `The Account ID of the VPC Peering connection/s.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `requesterAccountId`: `[requesterAccountId]`, }, }, }, }, }, - `listServerlessBackups`: { + `listGroupStreamWorkspaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the serverless instance.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -10195,9 +10292,6 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, @@ -10209,18 +10303,17 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2023-02-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `listServerlessInstances`: { + `listGroupTeams`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -10254,37 +10347,55 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listServerlessPrivateEndpoints`: { + `listGroupUsers`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `flattenTeams`: { + Usage: `Flag that indicates whether the returned list should include users who belong to a team with a role in this project. You might not have assigned the individual users a role in this project. If ` + "`" + `"flattenTeams" : false` + "`" + `, this resource returns only users with a role in the project. If ` + "`" + `"flattenTeams" : true` + "`" + `, this resource returns both users with roles in the project and users who belong to teams with roles in the project.`, + }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `instanceName`: { - Usage: `Human-readable label that identifies the serverless instance associated with the tenant endpoint.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `includeOrgUsers`: { + Usage: `Flag that indicates whether the returned list should include users with implicit access to the project, the Organization Owner or Organization Read Only role. You might not have assigned the individual users a role in this project. If ` + "`" + `"includeOrgUsers": false` + "`" + `, this resource returns only users with a role in the project. If ` + "`" + `"includeOrgUsers": true` + "`" + `, this resource returns both users with roles in the project and users who have implicit access to the project through their organization role.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `orgMembershipStatus`: { + Usage: `Flag that indicates whether to filter the returned list by users organization membership status. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `username`: { + Usage: `Email address to filter users by. Not supported in deprecated versions.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-02-19`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `instanceName`: `[instanceName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `orgMembershipStatus`: `ACTIVE`, }, }, }, }, }, - `listServiceAccountAccessList`: { + `listGroups`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -10294,9 +10405,6 @@ var metadata = metadatatypes.Metadata{ `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, @@ -10305,25 +10413,25 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ - Source: `-`, - - Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `orgId`: `4888442a3354817a7320eb61`, - }, + `2023-01-01`: {{ + Source: `list_projects`, + Name: `Get a list of all projects`, + Description: `Get a list of all projects inside of the organisation`, }, }, }, }, - `listServiceAccountProjects`: { + `listOrgApiKeyAccessListEntries`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key for which you want to return access list entries.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, @@ -10338,22 +10446,25 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clientId`: `mdb_sa_id_1234567890abcdef12345678`, - `orgId`: `4888442a3354817a7320eb61`, + `apiUserId`: `[apiUserId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listServiceAccounts`: { + `listOrgApiKeys`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, @@ -10368,7 +10479,7 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ @@ -10378,47 +10489,36 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listShardedClusterBackups`: { + `listOrgEvents`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + `eventType`: { + Usage: `Category of incident recorded at this moment in time. -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, +**IMPORTANT**: The complete list of event type values changes frequently.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, + `includeRaw`: { + Usage: `Flag that indicates whether to include the raw document in the output. The raw document contains additional meta information about the event.`, }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - }, - }, - `listSharedClusterBackupRestoreJobs`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `maxDate`: { + Usage: `Date and time from when MongoDB Cloud stops returning events. This parameter uses the ISO 8601 timestamp format in UTC.`, }, - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + `minDate`: { + Usage: `Date and time from when MongoDB Cloud starts returning events. This parameter uses the ISO 8601 timestamp format in UTC.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -10429,296 +10529,206 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listSharedClusterBackups`: { + `listOrgInvites`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `username`: { + Usage: `Email address of the user account invited to this organization. If you exclude this parameter, this resource returns all pending invitations.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listSlowQueries`: { + `listOrgInvoicePending`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `duration`: { - Usage: `Length of time expressed during which the query finds slow queries among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. - -- If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. -- If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `includeMetrics`: { - Usage: `Whether or not to include metrics extracted from the slow query log as separate fields.`, - }, - `includeOpType`: { - Usage: `Whether or not to include the operation type (read/write/command) extracted from the slow query log as a separate field.`, - }, - `includeReplicaState`: { - Usage: `Whether or not to include the replica state of the host when the slow query log was generated as a separate field.`, - }, - `nLogs`: { - Usage: `Maximum number of lines from the log to return.`, - }, - `namespaces`: { - Usage: `Namespaces from which to retrieve slow queries. A namespace consists of one database and one collection resource written as ` + "`" + `.` + "`" + `: ` + "`" + `.` + "`" + `. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each namespace. Omit this parameter to return results for all namespaces.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, - `since`: { - Usage: `Date and time from which the query retrieves the slow queries. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. -- If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processId`: `[processId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listSlowQueryNamespaces`: { + `listOrgInvoices`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `duration`: { - Usage: `Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. - -- If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. -- If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `processId`: { - Usage: `Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, - `since`: { - Usage: `Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. -- If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours.`, + `fromDate`: { + Usage: `Retrieve the invoices the startDates of which are greater than or equal to the fromDate. If omit, the invoices return will go back to earliest startDate.`, }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processId`: `[processId]`, - }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - }, - }, - `listSourceProjects`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + `orderBy`: { + Usage: `Field used to order the returned invoices by. Use in combination of sortBy parameter to control the order of the result.`, }, `orgId`: { Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `sortBy`: { + Usage: `Field used to sort the returned invoices by. Use in combination with orderBy parameter to control the order of the result.`, + }, + `statusNames`: { + Usage: `Statuses of the invoice to be retrieved. Omit to return invoices of all statuses.`, + }, + `toDate`: { + Usage: `Retrieve the invoices the endDates of which are smaller than or equal to the toDate. If omit, the invoices return will go further to latest endDate.`, + }, + `viewLinkedInvoices`: { + Usage: `Flag that indicates whether to return linked invoices in the linkedInvoices field.`, + }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, + `fromDate`: `2023-01-01`, + `orderBy`: `desc`, + `orgId`: `4888442a3354817a7320eb61`, + `toDate`: `2023-01-01`, }, }, }, }, }, - `listStreamConnections`: { + `listOrgLiveMigrationAvailableProjects`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `tenantName`: `[tenantName]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listStreamInstances`: { + `listOrgResourcePolicies`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listStreamProcessors`: { + `listOrgServiceAccountAccessList`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clientId`: { + Usage: `The Client ID of the Service Account.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `tenantName`: `[tenantName]`, + `clientId`: `mdb_sa_id_1234567890abcdef12345678`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listSuggestedIndexes`: { + `listOrgServiceAccounts`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `duration`: { - Usage: `Length of time expressed during which the query finds suggested indexes among the managed namespaces in the cluster. This parameter expresses its value in milliseconds. - -- If you don't specify the **since** parameter, the endpoint returns data covering the duration before the current time. -- If you specify neither the **duration** nor **since** parameters, the endpoint returns data from the previous 24 hours.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, - `nExamples`: { - Usage: `Maximum number of example queries that benefit from the suggested index.`, - }, - `nIndexes`: { - Usage: `Number that indicates the maximum indexes to suggest.`, - }, - `namespaces`: { - Usage: `Namespaces from which to retrieve suggested indexes. A namespace consists of one database and one collection resource written as ` + "`" + `.` + "`" + `: ` + "`" + `.` + "`" + `. To include multiple namespaces, pass the parameter multiple times delimited with an ampersand (` + "`" + `&` + "`" + `) between each namespace. Omit this parameter to return results for all namespaces.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, @@ -10726,29 +10736,19 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processId`: { - Usage: `Combination of host and port that serves the MongoDB process. The host must be the hostname, FQDN, IPv4 address, or IPv6 address of the host that runs the MongoDB process (` + "`" + `mongod` + "`" + ` or ` + "`" + `mongos` + "`" + `). The port must be the IANA port on which the MongoDB process listens for requests.`, - }, - `since`: { - Usage: `Date and time from which the query retrieves the suggested indexes. This parameter expresses its value in the number of milliseconds that have elapsed since the [UNIX epoch](https://en.wikipedia.org/wiki/Unix_time). - -- If you don't specify the **duration** parameter, the endpoint returns data covering from the **since** value and the current time. -- If you specify neither the **duration** nor the **since** parameters, the endpoint returns data from the previous 24 hours.`, - }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processId`: `[processId]`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `listTeamUsers`: { + `listOrgTeamUsers`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -10791,22 +10791,20 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `listThirdPartyIntegrations`: { + `listOrgTeams`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, `includeCount`: { Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, `itemsPerPage`: { Usage: `Number of items that the response returns per page.`, }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, `pageNum`: { Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, @@ -10819,52 +10817,75 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `orgId`: `4888442a3354817a7320eb61`, }, }, }, }, }, - `loadSampleDataset`: { + `listOrgUsers`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, - `name`: { - Usage: `Human-readable label that identifies the cluster into which you load the sample dataset.`, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `orgMembershipStatus`: { + Usage: `Organization membership status to filter users by. If you exclude this parameter, this resource returns both pending and active users. Not supported in deprecated versions.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `username`: { + Usage: `Email address to filter users by. Not supported in deprecated versions.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-02-19`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `name`: `[name]`, + `orgId`: `4888442a3354817a7320eb61`, + `orgMembershipStatus`: `ACTIVE`, }, }, }, }, }, - `migrateProjectToAnotherOrg`: { + `listOrgs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `name`: { + Usage: `Human-readable label of the organization to use to filter the returned list. Performs a case-insensitive search for an organization that starts with the specified name.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `modifyStreamProcessor`: { + `migrateGroup`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -10874,19 +10895,10 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `processorName`: { - Usage: `Human-readable label that identifies the stream processor.`, - }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: nil, }, - `pausePipeline`: { + `pauseGroupPipeline`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -10915,26 +10927,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `pinFeatureCompatibilityVersion`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, - }, - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `pinNamespacesPatch`: { + `pinGroupClusterCollStatPinnedNamespaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Human-readable label that identifies the cluster to pin namespaces to.`, @@ -10950,10 +10943,10 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `pinNamespacesPut`: { + `pinGroupClusterFeatureCompatibilityVersion`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster to pin namespaces to.`, + Usage: `Human-readable label that identifies this cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -10963,30 +10956,13 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - }, - Examples: nil, - }, - `queryLineItemsFromSingleInvoice`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `invoiceId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `rejectVpcPeeringConnection`: { + `rejectGroupStreamVpcPeeringConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11012,7 +10988,7 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `removeConnectedOrgConfig`: { + `removeFederationSettingConnectedOrgConfig`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11036,55 +11012,63 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `removeOrganizationRole`: { + `removeGroupApiKey`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `apiUserId`: `[apiUserId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, }, }, - Examples: nil, }, - `removeOrganizationUser`: { + `removeGroupTeam`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the [Return All MongoDB Cloud Users in One Organization](#tag/MongoDB-Cloud-Users/operation/listOrganizationUsers) resource and filter by username.`, + `teamId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the team that you want to remove from the specified project.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2025-02-19`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `orgId`: `4888442a3354817a7320eb61`, - `userId`: `[userId]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `teamId`: `[teamId]`, }, }, }, }, }, - `removeProjectApiKey`: { + `removeGroupUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11096,20 +11080,23 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the [Return All MongoDB Cloud Users in One Project](#tag/MongoDB-Cloud-Users/operation/listProjectUsers) resource and filter by username.`, + }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-02-19`: {{ Source: `-`, Flags: map[string]string{ - `apiUserId`: `[apiUserId]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `userId`: `[userId]`, }, }, }, }, }, - `removeProjectRole`: { + `removeGroupUserRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11128,62 +11115,55 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `removeProjectTeam`: { + `removeOrgTeamUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `teamId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the team that you want to remove from the specified project.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `teamId`: `[teamId]`, - }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `teamId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the team to remove the MongoDB user from.`, }, }, + Examples: nil, }, - `removeProjectUser`: { + `removeOrgTeamUserFromTeam`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `teamId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the team from which you want to remove one database application user.`, + }, `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the project. If you need to lookup a user's userId or verify a user's status in the organization, use the [Return All MongoDB Cloud Users in One Project](#tag/MongoDB-Cloud-Users/operation/listProjectUsers) resource and filter by username.`, + Usage: `Unique 24-hexadecimal digit string that identifies MongoDB Cloud user that you want to remove from the specified team.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2025-02-19`: {{ + `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `userId`: `[userId]`, + `orgId`: `4888442a3354817a7320eb61`, + `teamId`: `[teamId]`, + `userId`: `[userId]`, }, }, }, }, }, - `removeTeamUser`: { + `removeOrgUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11194,27 +11174,23 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `teamId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the team from which you want to remove one database application user.`, - }, `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies MongoDB Cloud user that you want to remove from the specified team.`, + Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the [Return All MongoDB Cloud Users in One Organization](#tag/MongoDB-Cloud-Users/operation/listOrganizationUsers) resource and filter by username.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2025-02-19`: {{ Source: `-`, Flags: map[string]string{ `orgId`: `4888442a3354817a7320eb61`, - `teamId`: `[teamId]`, `userId`: `[userId]`, }, }, }, }, }, - `removeUserFromTeam`: { + `removeOrgUserRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11225,13 +11201,13 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `teamId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the team to remove the MongoDB user from.`, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, }, }, Examples: nil, }, - `renameTeam`: { + `renameOrgTeam`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11248,7 +11224,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `requestEncryptionAtRestPrivateEndpointDeletion`: { + `requestGroupEncryptionAtRestPrivateEndpointDeletion`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `cloudProvider`: { Usage: `Human-readable label that identifies the cloud provider of the private endpoint to delete.`, @@ -11281,7 +11257,33 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `resetMaintenanceWindow`: { + `requestGroupSampleDatasetLoad`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `name`: { + Usage: `Human-readable label that identifies the cluster into which you load the sample dataset.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + `name`: `[name]`, + }, + }, + }, + }, + }, + `resetGroupMaintenanceWindow`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11303,7 +11305,36 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `resumePipeline`: { + `restartGroupClusterPrimaries`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-02-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, + }, + }, + }, + `resumeGroupPipeline`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11332,16 +11363,35 @@ var metadata = metadatatypes.Metadata{ }, }, }, - `returnAllControlPlaneIpAddresses`: { + `revokeFederationSettingIdentityProviderJwks`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `identityProviderId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the identity provider to connect.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2023-11-15`: {{ + Source: `-`, + + Flags: map[string]string{ + `federationSettingsId`: `55fa922fb343282757d9554e`, + `identityProviderId`: `32b6e34b3d91647abb20e7b8`, + }, + }, + }, }, - Examples: nil, }, - `returnAllIpAddresses`: { + `revokeGroupClusterMongoDbEmployeeAccess`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies this cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11355,17 +11405,38 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-08-05`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `returnFederatedDatabaseQueryLimit`: { + `searchOrgInvoiceLineItems`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `invoiceId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + }, + Examples: nil, + }, + `setGroupDataFederationLimit`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11384,13 +11455,64 @@ var metadata = metadatatypes.Metadata{ | bytesProcessed.daily | Limit on the number of bytes processed for the data federation instance for the current day | N/A | | bytesProcessed.weekly | Limit on the number of bytes processed for the data federation instance for the current week | N/A | | bytesProcessed.monthly | Limit on the number of bytes processed for the data federation instance for the current month | N/A | +`, + }, + `tenantName`: { + Usage: `Human-readable label that identifies the federated database instance to which the query limit applies.`, + }, + }, + Examples: nil, + }, + `setGroupLimit`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `limitName`: { + Usage: `Human-readable label that identifies this project limit. + +| Limit Name | Description | Default | API Override Limit | +| --- | --- | --- | --- | +| atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | +| atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | +| atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | +| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | +| atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | +| atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | +| dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | +| dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | +| dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | +| dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | +| atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| +| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| `, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the federated database instance to which the query limit applies.`, + }, + Examples: nil, + }, + `setGroupServerlessPerformanceAdvisorAutoIndexing`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, + `enable`: { + Usage: `Value that we want to set for the Serverless Auto Indexing toggle.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: map[string][]metadatatypes.Example{ @@ -11398,15 +11520,34 @@ var metadata = metadatatypes.Metadata{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `limitName`: `[limitName]`, - `tenantName`: `[tenantName]`, + `clusterName`: `[clusterName]`, + `enable`: `[enable]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `returnFederatedDatabaseQueryLimits`: { + `startGroupClusterOutageSimulation`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster to undergo an outage simulation.`, + }, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: nil, + }, + `startGroupStreamProcessor`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11419,50 +11560,85 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `processorName`: { + Usage: `Human-readable label that identifies the stream processor.`, + }, `tenantName`: { - Usage: `Human-readable label that identifies the federated database instance for which you want to retrieve query limits.`, + Usage: `Human-readable label that identifies the stream instance.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `tenantName`: `[tenantName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processorName`: `[processorName]`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `revokeJwksFromIdentityProvider`: { + `startGroupStreamProcessorWith`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `processorName`: { + Usage: `Human-readable label that identifies the stream processor.`, + }, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, + }, + }, + Examples: nil, + }, + `stopGroupStreamProcessor`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + `processorName`: { + Usage: `Human-readable label that identifies the stream processor.`, }, - `identityProviderId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the identity provider to connect.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, }, }, Examples: map[string][]metadatatypes.Example{ - `2023-11-15`: {{ + `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `federationSettingsId`: `55fa922fb343282757d9554e`, - `identityProviderId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `processorName`: `[processorName]`, + `tenantName`: `[tenantName]`, }, }, }, }, }, - `revokeMongoDbEmployeeAccess`: { + `takeGroupClusterBackupSnapshots`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11476,20 +11652,29 @@ var metadata = metadatatypes.Metadata{ Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: map[string][]metadatatypes.Example{ - `2024-08-05`: {{ - Source: `-`, + Examples: nil, + }, + `tenantGroupFlexClusterUpgrade`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, + Examples: nil, }, - `saveLdapConfiguration`: { + `toggleGroupAlertConfig`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `alertConfigId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration that triggered this alert.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11504,7 +11689,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `setProjectLimit`: { + `toggleGroupAwsCustomDns`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11513,26 +11698,6 @@ var metadata = metadatatypes.Metadata{ Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `limitName`: { - Usage: `Human-readable label that identifies this project limit. - -| Limit Name | Description | Default | API Override Limit | -| --- | --- | --- | --- | -| atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | -| atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | -| atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | -| atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | -| atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | -| atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | -| dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | -| dataFederation.bytesProcessed.daily | Limit on the number of bytes processed across all Data Federation tenants for the current day | N/A | N/A | -| dataFederation.bytesProcessed.weekly | Limit on the number of bytes processed across all Data Federation tenants for the current week | N/A | N/A | -| dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | -| atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| -| atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| -| atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | -`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -11540,41 +11705,30 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `setServerlessAutoIndexing`: { + `toggleGroupMaintenanceWindowAutoDefer`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, - `enable`: { - Usage: `Value that we want to set for the Serverless Auto Indexing toggle.`, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, `groupId`: { Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2023-01-01`: {{ Source: `-`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `enable`: `[enable]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `startOutageSimulation`: { + `toggleGroupPrivateEndpointRegionalMode`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster to undergo an outage simulation.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11589,7 +11743,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `startStreamProcessor`: { + `triggerGroupPipeline`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11599,31 +11753,20 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processorName`: { - Usage: `Human-readable label that identifies the stream processor.`, - }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processorName`: `[processorName]`, - `tenantName`: `[tenantName]`, - }, - }, - }, }, + Examples: nil, }, - `startStreamProcessorWith`: { + `unpinGroupClusterCollStatUnpinNamespaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster to unpin namespaces from.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11632,20 +11775,14 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `processorName`: { - Usage: `Human-readable label that identifies the stream processor.`, - }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: nil, }, - `stopStreamProcessor`: { + `unpinGroupClusterFeatureCompatibilityVersion`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies this cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11657,50 +11794,66 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `processorName`: { - Usage: `Human-readable label that identifies the stream processor.`, - }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: map[string][]metadatatypes.Example{ `2024-05-30`: {{ Source: `-`, Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - `processorName`: `[processorName]`, - `tenantName`: `[tenantName]`, + `clusterName`: `[clusterName]`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `takeSnapshot`: { + `updateFederationSettingConnectedOrgConfig`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the connected organization configuration to update.`, }, + }, + Examples: nil, + }, + `updateFederationSettingConnectedOrgConfigRoleMapping`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `id`: { + Usage: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to update.`, + }, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, }, Examples: nil, }, - `testFailover`: { + `updateFederationSettingIdentityProvider`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `federationSettingsId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, + }, + `identityProviderId`: { + Usage: `Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id.`, }, + }, + Examples: nil, + }, + `updateGroup`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11714,21 +11867,30 @@ var metadata = metadatatypes.Metadata{ }, }, Examples: map[string][]metadatatypes.Example{ - `2023-02-01`: {{ - Source: `-`, - + `2023-01-01`: {{ + Source: `update_project`, + Name: `Update project name and tags`, + Description: `Update the value of the existing project to "MongoTube - Production" and change the tags to an environment tag set to "production"`, + Value: `{ + "name": "MongoTube - Production", + "tags": [ + { + "key": "environment", + "value": "production" + } + ] +}`, Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, + `groupId`: `32b6e34b3d91647abb20e7b8`, }, }, }, }, }, - `toggleAlertConfiguration`: { + `updateGroupAlertConfig`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `alertConfigId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration that triggered this alert.`, + Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11744,8 +11906,11 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `toggleAwsCustomDns`: { + `updateGroupApiKeyRoles`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11754,13 +11919,22 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `toggleMaintenanceAutoDefer`: { + `updateGroupAuditLog`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11770,20 +11944,36 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, + Examples: nil, + }, + `updateGroupBackupCompliancePolicy`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `overwriteBackupPolicies`: { + Usage: `Flag that indicates whether to overwrite non complying backup policies with the new data protection settings or not.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, + Examples: nil, }, - `toggleRegionalizedPrivateEndpointSetting`: { + `updateGroupCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11792,14 +11982,46 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2024-10-23`: {{ + Source: `update_cluster`, + Name: `Update a cluster's configuration`, + Description: `Updates the cluster to increase disk size to 20GB and increase node count to 5`, + Value: `{ + "replicationSpecs": [ + { + "regionConfigs": [ + { + "electableSpecs": { + "diskSizeGB": 20, + "instanceSize": "M10", + "nodeCount": 5 + }, + "priority": 7, + "providerName": "AWS", + "regionName": "US_EAST_1" + } + ] + } + ] +}`, + Flags: map[string]string{ + `clusterName`: `[your-cluster-name]`, + `groupId`: `[your-project-id]`, + }, + }, }, }, - Examples: nil, }, - `triggerSnapshotIngestion`: { + `updateGroupClusterBackupSchedule`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -11808,19 +12030,16 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `unpinFeatureCompatibilityVersion`: { + `updateGroupClusterBackupSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies this cluster.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11833,23 +12052,16 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - }, - Examples: map[string][]metadatatypes.Example{ - `2024-05-30`: {{ - Source: `-`, - - Flags: map[string]string{ - `clusterName`: `[clusterName]`, - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, }, }, + Examples: nil, }, - `unpinNamespaces`: { + `updateGroupClusterCollStatPinnedNamespaces`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster to unpin namespaces from.`, + Usage: `Human-readable label that identifies the cluster to pin namespaces to.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11862,10 +12074,10 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateAlertConfiguration`: { + `updateGroupClusterFtsIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `alertConfigId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the alert configuration.`, + `clusterName`: { + Usage: `Name of the cluster that contains the collection whose Atlas Search index to update.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11875,22 +12087,30 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, + `indexId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the Atlas Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes.`, + }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `updateApiKey`: { + `updateGroupClusterOnlineArchive`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key you want to update.`, + `archiveId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the online archive to update.`, + }, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster that contains the specified collection from which Application created the online archive.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -11898,10 +12118,10 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateApiKeyRoles`: { + `updateGroupClusterProcessArgs`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `apiUserId`: { - Usage: `Unique 24-hexadecimal digit string that identifies this organization API key that you want to unassign from one project.`, + `clusterName`: { + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -11911,22 +12131,13 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `updateAtlasSearchDeployment`: { + `updateGroupClusterSearchDeployment`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Label that identifies the cluster to update the Search Nodes for.`, @@ -11945,7 +12156,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateAtlasSearchIndex`: { + `updateGroupClusterSearchIndex`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Name of the cluster that contains the collection whose Atlas Search index you want to update.`, @@ -11967,7 +12178,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateAtlasSearchIndexByName`: { + `updateGroupClusterSearchIndexByName`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { Usage: `Name of the cluster that contains the collection whose Atlas Search index you want to update.`, @@ -11995,10 +12206,10 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateAtlasSearchIndexDeprecated`: { + `updateGroupClusterSnapshot`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Name of the cluster that contains the collection whose Atlas Search index to update.`, + Usage: `Human-readable label that identifies the cluster.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12008,35 +12219,19 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `indexId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the Atlas Search [index](https://dochub.mongodb.org/core/index-definitions-fts). Use the [Get All Atlas Search Indexes for a Collection API](https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/) endpoint to find the IDs of all Atlas Search indexes.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - }, - Examples: nil, - }, - `updateAuditingConfiguration`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `snapshotId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, }, }, Examples: nil, }, - `updateBackupSchedule`: { + `updateGroupClusterSnapshotSchedule`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12052,58 +12247,10 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateCluster`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: map[string][]metadatatypes.Example{ - `2024-10-23`: {{ - Source: `update_cluster`, - Name: `Update a cluster's configuration`, - Description: `Updates the cluster to increase disk size to 20GB and increase node count to 5`, - Value: `{ - "replicationSpecs": [ - { - "regionConfigs": [ - { - "electableSpecs": { - "diskSizeGB": 20, - "instanceSize": "M10", - "nodeCount": 5 - }, - "priority": 7, - "providerName": "AWS", - "regionName": "US_EAST_1" - } - ] - } - ] -}`, - Flags: map[string]string{ - `clusterName`: `[your-cluster-name]`, - `groupId`: `[your-project-id]`, - }, - }, - }, - }, - }, - `updateClusterAdvancedConfiguration`: { + `updateGroupContainer`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, + `containerId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12119,21 +12266,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateConnectedOrgConfig`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the connected organization configuration to update.`, - }, - }, - Examples: nil, - }, - `updateCustomDatabaseRole`: { + `updateGroupCustomDbRoleRole`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12152,7 +12285,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateDataProtectionSettings`: { + `updateGroupDataFederation`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12162,16 +12295,19 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `overwriteBackupPolicies`: { - Usage: `Flag that indicates whether to overwrite non complying backup policies with the new data protection settings or not.`, - }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `skipRoleValidation`: { + Usage: `Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check.`, + }, + `tenantName`: { + Usage: `Human-readable label that identifies the federated database instance to update.`, + }, }, Examples: nil, }, - `updateDatabaseUser`: { + `updateGroupDatabaseUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `databaseName`: { Usage: `The database against which the database user authenticates. Database users must provide both a username and authentication database to log into MongoDB. If the user authenticates with AWS IAM, x.509, LDAP, or OIDC Workload this value should be ` + "`" + `$external` + "`" + `. If the user authenticates with SCRAM-SHA or OIDC Workforce, this value should be ` + "`" + `admin` + "`" + `.`, @@ -12206,23 +12342,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateEncryptionAtRest`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `updateFederatedDatabase`: { + `updateGroupEncryptionAtRest`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12235,16 +12355,10 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `skipRoleValidation`: { - Usage: `Flag that indicates whether this request should check if the requesting IAM role can read from the S3 bucket. AWS checks if the role can list the objects in the bucket before writing to it. Some IAM roles only need write permissions. This flag allows you to skip that check.`, - }, - `tenantName`: { - Usage: `Human-readable label that identifies the federated database instance to update.`, - }, }, Examples: nil, }, - `updateFlexCluster`: { + `updateGroupFlexCluster`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12263,25 +12377,8 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateIdentityProvider`: { + `updateGroupIntegration`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, - }, - `identityProviderId`: { - Usage: `Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id.`, - }, - }, - Examples: nil, - }, - `updateLegacySnapshotRetention`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -12290,27 +12387,17 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, }, - }, - Examples: nil, - }, - `updateLegacySnapshotSchedule`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster with the snapshot you want to return.`, + `integrationType`: { + Usage: `Human-readable label that identifies the service which you want to integrate with MongoDB Cloud.`, }, - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -12318,27 +12405,8 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateMaintenanceWindow`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - }, - Examples: nil, - }, - `updateOnlineArchive`: { + `updateGroupInviteById`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `archiveId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the online archive to update.`, - }, - `clusterName`: { - Usage: `Human-readable label that identifies the cluster that contains the specified collection from which Application created the online archive.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -12347,36 +12415,21 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - }, - Examples: nil, - }, - `updateOrgResourcePolicy`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, - }, - `resourcePolicyId`: { - Usage: `Unique 24-hexadecimal digit string that identifies an atlas resource policy.`, + `invitationId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, }, }, Examples: nil, }, - `updateOrganization`: { + `updateGroupInvites`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -12384,30 +12437,31 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateOrganizationInvitation`: { + `updateGroupMaintenanceWindow`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, }, Examples: nil, }, - `updateOrganizationInvitationById`: { + `updateGroupPeer`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `invitationId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `peerId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to update.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -12415,55 +12469,58 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateOrganizationRoles`: { + `updateGroupPipeline`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, - }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the user to modify.`, + `pipelineName`: { + Usage: `Human-readable label that identifies the Data Lake Pipeline.`, }, }, Examples: nil, }, - `updateOrganizationSettings`: { + `updateGroupPrivateEndpointServerlessInstanceEndpoint`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `endpointId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the tenant endpoint which will be updated.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pretty`: { - Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + `instanceName`: { + Usage: `Human-readable label that identifies the serverless instance associated with the tenant endpoint that will be updated.`, }, }, Examples: nil, }, - `updateOrganizationUser`: { + `updateGroupPushBasedLogExport`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `orgId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, - }, }, Examples: nil, }, - `updatePeeringConnection`: { + `updateGroupServerlessInstance`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12473,8 +12530,8 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `peerId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the network peering connection that you want to update.`, + `name`: { + Usage: `Human-readable label that identifies the serverless instance.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -12482,10 +12539,10 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updatePeeringContainer`: { + `updateGroupServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `containerId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the MongoDB Cloud network container that you want to remove.`, + `clientId`: { + Usage: `The Client ID of the Service Account.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12501,7 +12558,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updatePipeline`: { + `updateGroupSettings`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12511,14 +12568,17 @@ var metadata = metadatatypes.Metadata{ **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, }, - `pipelineName`: { - Usage: `Human-readable label that identifies the Data Lake Pipeline.`, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `updateProject`: { + `updateGroupStreamConnection`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `connectionName`: { + Usage: `Human-readable label that identifies the stream connection.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -12530,29 +12590,13 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `update_project`, - Name: `Update project name and tags`, - Description: `Update the value of the existing project to "MongoTube - Production" and change the tags to an environment tag set to "production"`, - Value: `{ - "name": "MongoTube - Production", - "tags": [ - { - "key": "environment", - "value": "production" - } - ] -}`, - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, }, }, + Examples: nil, }, - `updateProjectInvitation`: { + `updateGroupStreamProcessor`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12565,26 +12609,16 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - }, - Examples: nil, - }, - `updateProjectInvitationById`: { - Parameters: map[string]metadatatypes.ParameterMetadata{ - `envelope`: { - Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, - }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `processorName`: { + Usage: `Human-readable label that identifies the stream processor.`, }, - `invitationId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance.`, }, }, Examples: nil, }, - `updateProjectRoles`: { + `updateGroupStreamWorkspace`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12597,17 +12631,14 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `userId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the user to modify.`, + `tenantName`: { + Usage: `Human-readable label that identifies the stream instance to update.`, }, }, Examples: nil, }, - `updateProjectServiceAccount`: { + `updateGroupTeam`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -12619,10 +12650,13 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `teamId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the team for which you want to update roles.`, + }, }, Examples: nil, }, - `updateProjectSettings`: { + `updateGroupUserRoles`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12635,10 +12669,13 @@ var metadata = metadatatypes.Metadata{ `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the user to modify.`, + }, }, Examples: nil, }, - `updatePushBasedLogConfiguration`: { + `updateGroupUserSecurity`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12654,35 +12691,30 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateRoleMapping`: { + `updateOrg`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `federationSettingsId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your federation.`, - }, - `id`: { - Usage: `Unique 24-hexadecimal digit string that identifies the role mapping that you want to update.`, - }, `orgId`: { Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, }, Examples: nil, }, - `updateServerlessInstance`: { + `updateOrgApiKey`: { Parameters: map[string]metadatatypes.ParameterMetadata{ + `apiUserId`: { + Usage: `Unique 24-hexadecimal digit string that identifies this organization API key you want to update.`, + }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `name`: { - Usage: `Human-readable label that identifies the serverless instance.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, @@ -12690,30 +12722,25 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateServerlessPrivateEndpoint`: { + `updateOrgInviteById`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `endpointId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the tenant endpoint which will be updated.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `invitationId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the invitation.`, }, - `instanceName`: { - Usage: `Human-readable label that identifies the serverless instance associated with the tenant endpoint that will be updated.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, Examples: nil, }, - `updateServiceAccount`: { + `updateOrgInvites`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clientId`: { - Usage: `The Client ID of the Service Account.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, @@ -12726,117 +12753,89 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `updateSnapshotRetention`: { + `updateOrgResourcePolicy`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `clusterName`: { - Usage: `Human-readable label that identifies the cluster.`, - }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `snapshotId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the desired snapshot.`, + `resourcePolicyId`: { + Usage: `Unique 24-hexadecimal digit string that identifies an atlas resource policy.`, }, }, Examples: nil, }, - `updateStreamConnection`: { + `updateOrgServiceAccount`: { Parameters: map[string]metadatatypes.ParameterMetadata{ - `connectionName`: { - Usage: `Human-readable label that identifies the stream connection.`, + `clientId`: { + Usage: `The Client ID of the Service Account.`, }, `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance.`, - }, }, Examples: nil, }, - `updateStreamInstance`: { + `updateOrgSettings`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `tenantName`: { - Usage: `Human-readable label that identifies the stream instance to update.`, - }, }, Examples: nil, }, - `updateTeamRoles`: { + `updateOrgUser`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, - `teamId`: { - Usage: `Unique 24-hexadecimal digit string that identifies the team for which you want to update roles.`, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the pending or active user in the organization. If you need to lookup a user's userId or verify a user's status in the organization, use the Return All MongoDB Cloud Users in One Organization resource and filter by username.`, }, }, Examples: nil, }, - `updateThirdPartyIntegration`: { + `updateOrgUserRoles`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, }, - `groupId`: { - Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. - -**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, - }, - `includeCount`: { - Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, - }, - `integrationType`: { - Usage: `Human-readable label that identifies the service which you want to integrate with MongoDB Cloud.`, - }, - `itemsPerPage`: { - Usage: `Number of items that the response returns per page.`, - }, - `pageNum`: { - Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + `orgId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the organization that contains your projects. Use the [/orgs](#tag/Organizations/operation/listOrganizations) endpoint to retrieve all organizations to which the authenticated user has access.`, }, `pretty`: { Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, + `userId`: { + Usage: `Unique 24-hexadecimal digit string that identifies the user to modify.`, + }, }, Examples: nil, }, - `upgradeFlexCluster`: { + `upgradeGroupClusterTenantUpgrade`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12852,7 +12851,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `upgradeSharedCluster`: { + `upgradeGroupClusterTenantUpgradeToServerless`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12868,7 +12867,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `upgradeSharedClusterToServerless`: { + `validateGroupLiveMigrations`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12884,7 +12883,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `validateAtlasResourcePolicy`: { + `validateOrgResourcePolicies`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12898,7 +12897,7 @@ var metadata = metadatatypes.Metadata{ }, Examples: nil, }, - `validateMigration`: { + `verifyGroupPrivateIpMode`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12912,9 +12911,18 @@ var metadata = metadatatypes.Metadata{ Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: nil, + Examples: map[string][]metadatatypes.Example{ + `2023-01-01`: {{ + Source: `-`, + + Flags: map[string]string{ + `groupId`: `32b6e34b3d91647abb20e7b8`, + }, + }, + }, + }, }, - `verifyConnectViaPeeringOnlyModeForOneProject`: { + `verifyGroupUserSecurityLdap`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, @@ -12928,18 +12936,9 @@ var metadata = metadatatypes.Metadata{ Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, }, }, - Examples: map[string][]metadatatypes.Example{ - `2023-01-01`: {{ - Source: `-`, - - Flags: map[string]string{ - `groupId`: `32b6e34b3d91647abb20e7b8`, - }, - }, - }, - }, + Examples: nil, }, - `verifyLdapConfiguration`: { + `withGroupStreamSampleConnections`: { Parameters: map[string]metadatatypes.ParameterMetadata{ `envelope`: { Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, diff --git a/tools/internal/specs/overlays/watchers.yaml b/tools/internal/specs/overlays/watchers.yaml index 78544ebab6..3907e490c8 100644 --- a/tools/internal/specs/overlays/watchers.yaml +++ b/tools/internal/specs/overlays/watchers.yaml @@ -9,9 +9,8 @@ actions: watcher: get: version: "2024-08-05" - operation-id: getCluster + operation-id: createGroupCluster params: - clusterName: body:$.name groupId: body:$.groupId expect: match: @@ -23,8 +22,8 @@ actions: x-xgen-atlascli: watcher: get: - version: "2024-08-05" - operation-id: getCluster + version: "2023-01-01" + operation-id: deleteGroupCluster params: clusterName: input:clusterName groupId: input:groupId @@ -36,7 +35,7 @@ actions: watcher: get: version: "2024-08-05" - operation-id: getCluster + operation-id: updateGroupCluster params: clusterName: input:clusterName groupId: input:groupId @@ -51,7 +50,7 @@ actions: watcher: get: version: "2024-05-30" - operation-id: getAtlasSearchDeployment + operation-id: updateGroupClusterSearchDeployment params: clusterName: input:clusterName groupId: input:groupId @@ -66,7 +65,7 @@ actions: watcher: get: version: "2024-05-30" - operation-id: getAtlasSearchDeployment + operation-id: deleteGroupClusterSearchDeployment params: clusterName: input:clusterName groupId: input:groupId @@ -78,7 +77,7 @@ actions: watcher: get: version: "2023-10-01" - operation-id: getDataProtectionSettings + operation-id: updateGroupBackupCompliancePolicy params: groupId: input:groupId expect: @@ -92,10 +91,9 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getLdapConfigurationStatus + operation-id: verifyGroupUserSecurityLdap params: groupId: input:groupId - requestId: body:$.requestId expect: match: path: $.status @@ -107,11 +105,10 @@ actions: x-xgen-atlascli: watcher: get: - version: "2024-11-13" - operation-id: getFlexCluster + version: "2023-01-01" + operation-id: createGroupServerlessInstance params: groupId: input:groupId - name: body:$.name expect: match: path: $.status @@ -122,8 +119,8 @@ actions: x-xgen-atlascli: watcher: get: - version: "2024-11-13" - operation-id: getFlexCluster + version: "2023-01-01" + operation-id: updateGroupServerlessInstance params: groupId: input:groupId name: input:name @@ -137,8 +134,8 @@ actions: x-xgen-atlascli: watcher: get: - version: "2024-11-13" - operation-id: getFlexCluster + version: "2023-01-01" + operation-id: deleteGroupServerlessInstance params: groupId: input:groupId name: input:name @@ -150,11 +147,10 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getReplicaSetBackup + operation-id: takeGroupClusterBackupSnapshots params: groupId: input:groupId clusterName: input:clusterName - snapshotId: body:$.id expect: match: path: $.status @@ -167,7 +163,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getReplicaSetBackup + operation-id: updateGroupClusterBackupSnapshot params: groupId: input:groupId clusterName: input:clusterName @@ -184,7 +180,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getReplicaSetBackup + operation-id: deleteGroupClusterBackupSnapshot params: groupId: input:groupId clusterName: input:clusterName @@ -197,9 +193,8 @@ actions: watcher: get: version: "2024-11-13" - operation-id: getFlexCluster + operation-id: createGroupFlexCluster params: - name: body:$.name groupId: body:$.groupId expect: match: @@ -212,9 +207,8 @@ actions: watcher: get: version: "2024-11-13" - operation-id: getFlexCluster + operation-id: createGroupFlexCluster params: - name: body:$.name groupId: input:groupId expect: match: @@ -227,7 +221,7 @@ actions: watcher: get: version: "2024-11-13" - operation-id: getFlexCluster + operation-id: updateGroupFlexCluster params: name: input:name groupId: input:groupId @@ -242,7 +236,7 @@ actions: watcher: get: version: "2024-11-13" - operation-id: getFlexCluster + operation-id: deleteGroupFlexCluster params: name: input:name groupId: input:groupId @@ -254,11 +248,10 @@ actions: watcher: get: version: "2024-11-13" - operation-id: getFlexBackupRestoreJob + operation-id: createGroupFlexClusterBackupRestoreJob params: name: input:name groupId: input:groupId - restoreJobId: body:$.id expect: match: path: $.status @@ -271,11 +264,9 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getPrivateEndpointService + operation-id: createGroupPrivateEndpointEndpointService params: - cloudProvider: body:$.cloudProvider groupId: input:groupId - endpointServiceId: body:$.id expect: match: path: $.status @@ -288,7 +279,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getPrivateEndpointService + operation-id: deleteGroupPrivateEndpointEndpointService params: cloudProvider: body:$.cloudProvider groupId: input:groupId @@ -301,10 +292,9 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getPipeline + operation-id: createGroupPipeline params: groupId: input:groupId - pipelineName: body:$.name expect: match: path: $.state @@ -316,7 +306,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getPipeline + operation-id: updateGroupPipeline params: groupId: input:groupId pipelineName: input:pipelineName @@ -331,7 +321,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getPipeline + operation-id: deleteGroupPipeline params: groupId: input:groupId pipelineName: input:pipelineName @@ -343,11 +333,10 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getBackupExportJob + operation-id: createGroupClusterBackupExport params: groupId: input:groupId clusterName: input:clusterName - exportId: body:$.id expect: match: path: $.state @@ -361,10 +350,10 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getSampleDatasetLoadStatus + operation-id: requestGroupSampleDatasetLoad params: groupId: input:groupId - sampleDatasetId: body:$.id + name: input:name expect: match: path: $.state @@ -377,11 +366,10 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getOnlineArchive + operation-id: createGroupClusterOnlineArchive params: groupId: input:groupId clusterName: input:clusterName - archiveId: body:$.id expect: match: path: $.state @@ -397,7 +385,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getOnlineArchive + operation-id: updateGroupClusterOnlineArchive params: groupId: input:groupId clusterName: input:clusterName @@ -417,7 +405,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getOnlineArchive + operation-id: deleteGroupClusterOnlineArchive params: groupId: input:groupId clusterName: input:clusterName @@ -430,7 +418,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getServerlessBackup + operation-id: createGroupServerlessBackupSnapshot params: groupId: input:groupId clusterName: input:clusterName @@ -447,7 +435,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getOutageSimulation + operation-id: startGroupClusterOutageSimulation params: groupId: input:groupId clusterName: input:clusterName @@ -462,7 +450,7 @@ actions: watcher: get: version: "2023-01-01" - operation-id: getOutageSimulation + operation-id: endGroupClusterOutageSimulation params: groupId: input:groupId clusterName: input:clusterName diff --git a/tools/internal/specs/spec-with-overlays.yaml b/tools/internal/specs/spec-with-overlays.yaml index 3e0d5603b5..ff402970fa 100644 --- a/tools/internal/specs/spec-with-overlays.yaml +++ b/tools/internal/specs/spec-with-overlays.yaml @@ -930,6 +930,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. enum: - US_GOV_WEST_1 @@ -971,6 +973,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object status: description: State of the Encryption At Rest private endpoint. @@ -1092,10 +1096,12 @@ components: mapping: aws: '#/components/schemas/AWSAccountDetails' azure: '#/components/schemas/AzureAccountDetails' + gcp: '#/components/schemas/GCPAccountDetails' propertyName: cloudProvider oneOf: - $ref: '#/components/schemas/AWSAccountDetails' - $ref: '#/components/schemas/AzureAccountDetails' + - $ref: '#/components/schemas/GCPAccountDetails' type: object AcknowledgeAlert: description: Acknowledging an alert prevents successive notifications. Specify the acknowledgeUntil date and optional comment or unacknowledgeAlert boolean. @@ -3769,7 +3775,7 @@ components: - name type: object AtlasResourcePolicyAuditForNdsGroup: - description: Atlas resource policy audits indicate org level changes to resource policies + description: Atlas resource policy audits indicate organization level changes to resource policies. properties: apiKeyId: description: Unique 24-hexadecimal digit string that identifies the API Key that triggered the event. If this resource returns this parameter, it doesn't return the **userId** parameter. @@ -3873,7 +3879,7 @@ components: title: Atlas Resource Policy Audits For NDS Group type: object AtlasResourcePolicyAuditForOrg: - description: Atlas resource policy audits indicate org level changes to resource policies + description: Atlas resource policy audits indicate organization level changes to resource policies. properties: apiKeyId: description: Unique 24-hexadecimal digit string that identifies the API Key that triggered the event. If this resource returns this parameter, it doesn't return the **userId** parameter. @@ -4006,7 +4012,7 @@ components: title: Atlas Search Analyzer type: object AtlasTenantClusterUpgradeRequest20240805: - description: Request containing target state of tenant cluster to be upgraded + description: Request containing target state of tenant cluster to be upgraded. properties: acceptDataRisksAndForceReplicaSetReconfig: description: If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set **acceptDataRisksAndForceReplicaSetReconfig** to the current date. This parameter expresses its value in the ISO 8601 timestamp format in UTC. @@ -4120,6 +4126,14 @@ components: pattern: ^([a-f0-9]{24})$ readOnly: true type: string + internalClusterRole: + description: 'Internal classification of the cluster''s role. Possible values: NONE (regular user cluster), SYSTEM_CLUSTER (system cluster for backup), INTERNAL_SHADOW_CLUSTER (internal use shadow cluster for testing).' + enum: + - NONE + - SYSTEM_CLUSTER + - INTERNAL_SHADOW_CLUSTER + readOnly: true + type: string labels: deprecated: true description: |- @@ -5193,6 +5207,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. enum: - US_GOV_WEST_1 @@ -5234,6 +5250,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object status: description: State of the Encryption At Rest private endpoint. @@ -6263,6 +6281,8 @@ components: - M400_NVME title: AWS Instance Sizes type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - enum: - M10 - M20 @@ -6288,6 +6308,8 @@ components: - M600_NVME title: Azure Instance Sizes type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - enum: - M10 - M20 @@ -7153,7 +7175,7 @@ components: - metricName type: object ChartsAudit: - description: Audit events related to Atlas Charts + description: Audit events related to Atlas Charts. properties: apiKeyId: description: Unique 24-hexadecimal digit string that identifies the API Key that triggered the event. If this resource returns this parameter, it doesn't return the **userId** parameter. @@ -8104,6 +8126,10 @@ components: AZURE: '#/components/schemas/CloudProviderAccessAzureServicePrincipal' GCP: '#/components/schemas/CloudProviderAccessGCPServiceAccount' propertyName: providerName + oneOf: + - $ref: '#/components/schemas/CloudProviderAccessAWSIAMRole' + - $ref: '#/components/schemas/CloudProviderAccessAzureServicePrincipal' + - $ref: '#/components/schemas/CloudProviderAccessGCPServiceAccount' properties: providerName: description: Human-readable label that identifies the cloud provider of the role. @@ -8332,6 +8358,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Microsoft Azure Regions. enum: - US_CENTRAL @@ -8389,6 +8417,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Google Compute Regions. enum: - EASTERN_US @@ -8443,6 +8473,8 @@ components: - ASIA_SOUTHEAST_2 title: GCP Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object title: Cloud Service Provider Settings for Multi-Cloud Clusters type: object @@ -8524,6 +8556,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Microsoft Azure Regions. enum: - US_CENTRAL @@ -8581,6 +8615,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Google Compute Regions. enum: - EASTERN_US @@ -8635,6 +8671,8 @@ components: - ASIA_SOUTHEAST_2 title: GCP Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object title: Cloud Service Provider Settings type: object @@ -9099,6 +9137,14 @@ components: pattern: ^([a-f0-9]{24})$ readOnly: true type: string + internalClusterRole: + description: 'Internal classification of the cluster''s role. Possible values: NONE (regular user cluster), SYSTEM_CLUSTER (system cluster for backup), INTERNAL_SHADOW_CLUSTER (internal use shadow cluster for testing).' + enum: + - NONE + - SYSTEM_CLUSTER + - INTERNAL_SHADOW_CLUSTER + readOnly: true + type: string labels: deprecated: true description: |- @@ -10338,7 +10384,7 @@ components: description: Request body for a cost explorer query. properties: clusters: - description: The list of projects to be included in the Cost Explorer Query. + description: The list of clusters to be included in the Cost Explorer Query. items: example: 32b6e34b3d91647abb20e7b8 pattern: ^([a-f0-9]{24})$ @@ -10374,7 +10420,7 @@ components: type: string type: array services: - description: The list of projects to be included in the Cost Explorer Query. + description: The list of SKU services to be included in the Cost Explorer Query. items: enum: - Atlas @@ -10508,7 +10554,7 @@ components: title: AWS type: object CreateAtlasOrganizationApiKey: - description: Details of the programmatic API key to be created. + description: Organization Service Account that Atlas creates for this organization. If omitted, Atlas doesn't create an organization Service Account for this organization. If specified, this object requires all body parameters. Note that API Keys cannot be specified in the same request. properties: desc: description: Purpose or explanation provided when someone created this organization API key. @@ -10838,11 +10884,23 @@ components: description: 'MongoDB find query that selects documents to archive. The specified query follows the syntax of the `db.collection.find(query)` command. This query can''t use the empty document (`{}`) to return all documents. Set this parameter when **"criteria.type" : "CUSTOM"**.' type: string type: object - description: '**CUSTOM criteria.type**.' + description: Custom archival criteria. required: - query title: Archival Criteria type: object + CustomSessionTimeouts: + description: Defines the session timeout settings for managing user sessions at the organization level. When set to null, the field's value is unset, and the default timeout settings are applied. + properties: + absoluteSessionTimeoutInSeconds: + description: Specifies the absolute session timeout duration in seconds. When set to null, the field's value is unset, and the default value of 43,200 seconds (12 hours) is applied. Accepted values range between a minimum of 3,600 seconds (1 hour) and a maximum of 43,200 seconds (12 hours). + format: int32 + type: integer + idleSessionTimeoutInSeconds: + description: 'Specifies the idle session timeout duration in seconds. When set to null, the field''s value is unset, and the default behavior depends on the context: no timeout for Atlas Commercial, and 600 seconds (10 minutes) for Atlas for Government. Accepted values start at a minimum of 300 seconds (5 minutes). For Atlas Commercial, the maximum value cannot exceed the configured absolute session timeout. For Atlas for Government, the maximum value is capped at 600 seconds (10 minutes).' + format: int32 + type: integer + type: object CustomZoneMappings: properties: customZoneMappings: @@ -11235,7 +11293,6 @@ components: mapping: atlas.project.deployment.clusters: '#/components/schemas/DefaultLimit' atlas.project.deployment.nodesPerPrivateLinkRegion: '#/components/schemas/DefaultLimit' - atlas.project.deployment.salesSoldM0s: '#/components/schemas/DefaultLimit' atlas.project.deployment.serverlessMTMs: '#/components/schemas/DefaultLimit' atlas.project.security.databaseAccess.customRoles: '#/components/schemas/DefaultLimit' atlas.project.security.databaseAccess.users: '#/components/schemas/DefaultLimit' @@ -12819,6 +12876,10 @@ components: default: false description: Toggle sending database metrics that includes database names and metrics on the number of collections, storage size, and index size. type: boolean + sendQueryStatsMetrics: + default: false + description: Toggle sending query shape metrics that includes query hash and metrics on latency, execution frequency, documents returned, and timestamps. + type: boolean sendUserProvidedResourceTags: default: false description: Toggle sending user provided group and cluster resource tags with the datadog metrics. @@ -12939,7 +13000,7 @@ components: format: int32 type: integer type: object - description: '**DATE criteria.type**.' + description: Date-Based archival criteria. title: Archival Criteria type: object DbDataSizeTotalDataMetricThresholdView: @@ -13137,6 +13198,8 @@ components: - USERS_WITHOUT_MULTI_FACTOR_AUTH - ENCRYPTION_AT_REST_KMS_NETWORK_ACCESS_DENIED - ENCRYPTION_AT_REST_CONFIG_NO_LONGER_VALID + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRED title: Group Event Types type: string - enum: @@ -13342,6 +13405,8 @@ components: - USERS_WITHOUT_MULTI_FACTOR_AUTH - ENCRYPTION_AT_REST_KMS_NETWORK_ACCESS_DENIED - ENCRYPTION_AT_REST_CONFIG_NO_LONGER_VALID + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRED title: Group Event Types type: string - enum: @@ -13561,6 +13626,7 @@ components: - CLUSTER_CONNECTION_CREATE_COLLECTION - CLUSTER_CONNECTION_SAMPLE_COLLECTION_FIELD_NAMES - CLUSTER_CONNECTION_SAMPLE_COLLECTION_FIELD_NAMES_AND_TYPES + - CLUSTER_CONNECTION_GET_NAMESPACES_AND_PROJECT_SQL_SCHEMA_DATA title: Cluster Connection Audit Types type: string - enum: @@ -13668,6 +13734,10 @@ components: - ENCRYPTION_AT_REST_KMS_NETWORK_ACCESS_RESTORED - ENCRYPTION_AT_REST_CONFIG_NO_LONGER_VALID - ENCRYPTION_AT_REST_CONFIG_IS_VALID + - GROUP_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRED + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRED title: Group Event Types type: string - enum: @@ -13835,6 +13905,11 @@ components: - EMPLOYEE_DOWNLOADED_CLUSTER_LOGS title: Access Event Types type: string + - enum: + - QUERY_SHAPE_BLOCKED + - QUERY_SHAPE_UNBLOCKED + title: Query Shape Event Types + type: string type: object groupId: description: Unique 24-hexadecimal digit string that identifies the project in which the event occurred. The **eventId** identifies the specific event. @@ -13948,6 +14023,8 @@ components: - ROLE_MAPPING_DELETED title: Federation Settings Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - GROUP_DELETED - GROUP_CREATED @@ -14065,7 +14142,7 @@ components: title: Any Other Events type: object DefaultLimit: - description: Details of user managed limits + description: Details of user managed limits. properties: currentUsage: description: Amount that indicates the current usage of the limit. @@ -14879,6 +14956,9 @@ components: url: https://www.mongodb.com/docs/atlas/security/set-up-unified-aws-access/ pattern: ^([a-f0-9]{24})$ type: string + requirePrivateNetworking: + description: Indicates whether to do exports over PrivateLink as opposed to public IPs. Defaults to False. + type: boolean type: object required: - bucketName @@ -14927,6 +15007,9 @@ components: example: us-east-1 readOnly: true type: string + requirePrivateNetworking: + description: Indicates whether to use privatelink. User supplied. + type: boolean required: - _id - bucketName @@ -15925,7 +16008,7 @@ components: description: One index key paired with its sort order. A value of `1` indicates an ascending sort order. A value of `-1` indicates a descending sort order. Keys in indexes with multiple keys appear in the same order that they appear in the index. type: object x-xgen-IPA-exception: - xgen-IPA-117-objects-must-be-well-defined: Schema predates IPA validation + xgen-IPA-117-objects-must-be-well-defined: Schema predates IPA validation. type: array name: description: Name of index. @@ -16057,6 +16140,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. enum: - US_GOV_WEST_1 @@ -16098,6 +16183,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object status: description: State of the Encryption At Rest private endpoint. @@ -16321,7 +16408,7 @@ components: - CRITICAL type: string EventTypeDetails: - description: A singular type of event + description: A singular type of event. properties: alertable: description: Whether or not this event type can be configured as an alert via the API. @@ -16442,6 +16529,7 @@ components: - CLUSTER_CONNECTION_CREATE_COLLECTION - CLUSTER_CONNECTION_SAMPLE_COLLECTION_FIELD_NAMES - CLUSTER_CONNECTION_SAMPLE_COLLECTION_FIELD_NAMES_AND_TYPES + - CLUSTER_CONNECTION_GET_NAMESPACES_AND_PROJECT_SQL_SCHEMA_DATA title: Cluster Connection Audit Types type: string - enum: @@ -16578,6 +16666,10 @@ components: - ENCRYPTION_AT_REST_KMS_NETWORK_ACCESS_RESTORED - ENCRYPTION_AT_REST_CONFIG_NO_LONGER_VALID - ENCRYPTION_AT_REST_CONFIG_IS_VALID + - GROUP_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRED + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRED title: Group Event Types type: string - enum: @@ -16604,6 +16696,7 @@ components: - SSH_KEY_NDS_HOST_ACCESS_REFRESHED - SSH_KEY_NDS_HOST_ACCESS_ATTEMPT - SSH_KEY_NDS_HOST_ACCESS_GRANTED + - SSH_KEY_NDS_HOST_ACCESS_LEVEL_CHANGED - HOST_SSH_SESSION_ENDED - HOST_X509_CERTIFICATE_CERTIFICATE_GENERATED_FOR_SUPPORT_ACCESS - PUSH_BASED_LOG_EXPORT_RESUMED @@ -16616,6 +16709,8 @@ components: - HOST_SECURITY_CHECKUP_NOT_MET title: Host Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - INSIDE_METRIC_THRESHOLD - OUTSIDE_METRIC_THRESHOLD @@ -16766,6 +16861,7 @@ components: - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_ENABLED - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_UPDATED - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_DISABLED + - ONLINE_ARCHIVE_DELETE_AFTER_DATE_UPDATED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_ADDED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_DELETED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_UPDATED @@ -16825,6 +16921,18 @@ components: - PUSH_BASED_LOG_EXPORT_ENABLED - PUSH_BASED_LOG_EXPORT_CONFIGURATION_UPDATED - PUSH_BASED_LOG_EXPORT_DISABLED + - LOG_STREAMING_ENABLED + - LOG_STREAMING_CONFIGURATION_UPDATED + - LOG_STREAMING_DISABLED + - DATADOG_LOG_STREAMING_ENABLED + - DATADOG_LOG_STREAMING_CONFIGURATION_UPDATED + - DATADOG_LOG_STREAMING_DISABLED + - SPLUNK_LOG_STREAMING_ENABLED + - SPLUNK_LOG_STREAMING_CONFIGURATION_UPDATED + - SPLUNK_LOG_STREAMING_DISABLED + - S3_LOG_STREAMING_ENABLED + - S3_LOG_STREAMING_CONFIGURATION_UPDATED + - S3_LOG_STREAMING_DISABLED - AZURE_CLUSTER_PREFERRED_STORAGE_TYPE_UPDATED - CONTAINER_DELETED - REGIONALIZED_PRIVATE_ENDPOINT_MODE_ENABLED @@ -16861,8 +16969,12 @@ components: - AZ_BALANCING_OVERRIDE_MODIFIED - FTDC_SETTINGS_UPDATED - PROXY_PROTOCOL_FOR_PRIVATE_LINK_MODE_UPDATED + - MONGOTUNE_WRITE_BLOCK_POLICY_ELIGIBLE + - MONGOTUNE_WRITE_BLOCK_POLICY_INELIGIBLE title: NDS Audit Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - DB_CHECK_SUBMITTED - DB_CHECK_UPDATED @@ -17102,6 +17214,11 @@ components: - RESOURCE_POLICY_VIOLATED title: Atlas Resource Policy Audit Types type: string + - enum: + - QUERY_SHAPE_BLOCKED + - QUERY_SHAPE_UNBLOCKED + title: Query Shape Event Types + type: string type: object EventTypeForOrg: oneOf: @@ -17218,6 +17335,8 @@ components: - EVERGREEN_PRIORITY_MODIFIED title: Billing Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - FEDERATION_SETTINGS_CREATED - FEDERATION_SETTINGS_DELETED @@ -17245,6 +17364,8 @@ components: - ROLE_MAPPING_DELETED title: Federation Settings Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - GROUP_DELETED - GROUP_CREATED @@ -17336,6 +17457,8 @@ components: - SANDBOX_DISABLED_FOR_ORG title: Org Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - AWS_SELF_SERVE_ACCOUNT_LINKED - AWS_SELF_SERVE_ACCOUNT_LINK_PENDING @@ -17485,7 +17608,7 @@ components: - metricName type: object ExtraRetentionSetting: - description: extra retention setting item in the desired backup policy. + description: Extra retention setting item in the desired backup policy. properties: frequencyType: description: The frequency type for the extra retention settings for the cluster. @@ -19595,6 +19718,30 @@ components: required: - metricName type: object + GCPAccountDetails: + properties: + cidrBlock: + description: The VPC CIDR Block. + type: string + cloudProvider: + description: Cloud provider. + type: string + gcpProjectId: + description: The GCP Project ID. + type: string + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + vpcNetworkName: + description: The name of the VPC network. + type: string + type: object GCPCloudProviderContainer: allOf: - $ref: '#/components/schemas/CloudProviderContainer' @@ -19669,8 +19816,6 @@ components: - WESTERN_EUROPE - WESTERN_US type: string - x-xgen-IPA-exception: - xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation type: array type: object description: Collection of settings that configures the network container for a virtual private connection on Amazon Web Services. @@ -21419,6 +21564,7 @@ components: - SSH_KEY_NDS_HOST_ACCESS_REFRESHED - SSH_KEY_NDS_HOST_ACCESS_ATTEMPT - SSH_KEY_NDS_HOST_ACCESS_GRANTED + - SSH_KEY_NDS_HOST_ACCESS_LEVEL_CHANGED - HOST_SSH_SESSION_ENDED - HOST_X509_CERTIFICATE_CERTIFICATE_GENERATED_FOR_SUPPORT_ACCESS - PUSH_BASED_LOG_EXPORT_RESUMED @@ -24163,7 +24309,7 @@ components: title: Cluster Description type: object LegacyAtlasTenantClusterUpgradeRequest: - description: Request containing target state of tenant cluster to be upgraded + description: Request containing target state of tenant cluster to be upgraded. properties: acceptDataRisksAndForceReplicaSetReconfig: description: If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set **acceptDataRisksAndForceReplicaSetReconfig** to the current date. This parameter expresses its value in the ISO 8601 timestamp format in UTC. @@ -25973,7 +26119,7 @@ components: type: array type: object MetricDataPoint: - description: value of, and metadata provided for, one data point generated at a particular moment in time. If no data point exists for a particular moment in time, the `value` parameter returns `null`. + description: Value of, and metadata provided for, one data point generated at a particular moment in time. If no data point exists for a particular moment in time, the `value` parameter returns `null`. properties: timestamp: description: Date and time when this data point occurred. This parameter expresses its value in the ISO 8601 timestamp format in UTC. @@ -25987,7 +26133,7 @@ components: readOnly: true type: object MetricDataPoint_Atlas: - description: value of, and metadata provided for, one data point generated at a particular moment in time. If no data point exists for a particular moment in time, the `value` parameter returns `null`. + description: Value of, and metadata provided for, one data point generated at a particular moment in time. If no data point exists for a particular moment in time, the `value` parameter returns `null`. properties: timestamp: description: Date and time when this data point occurred. This parameter expresses its value in the ISO 8601 timestamp format in UTC. @@ -26521,6 +26667,7 @@ components: - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_ENABLED - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_UPDATED - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_DISABLED + - ONLINE_ARCHIVE_DELETE_AFTER_DATE_UPDATED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_ADDED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_DELETED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_UPDATED @@ -26580,6 +26727,18 @@ components: - PUSH_BASED_LOG_EXPORT_ENABLED - PUSH_BASED_LOG_EXPORT_CONFIGURATION_UPDATED - PUSH_BASED_LOG_EXPORT_DISABLED + - LOG_STREAMING_ENABLED + - LOG_STREAMING_CONFIGURATION_UPDATED + - LOG_STREAMING_DISABLED + - DATADOG_LOG_STREAMING_ENABLED + - DATADOG_LOG_STREAMING_CONFIGURATION_UPDATED + - DATADOG_LOG_STREAMING_DISABLED + - SPLUNK_LOG_STREAMING_ENABLED + - SPLUNK_LOG_STREAMING_CONFIGURATION_UPDATED + - SPLUNK_LOG_STREAMING_DISABLED + - S3_LOG_STREAMING_ENABLED + - S3_LOG_STREAMING_CONFIGURATION_UPDATED + - S3_LOG_STREAMING_DISABLED - AZURE_CLUSTER_PREFERRED_STORAGE_TYPE_UPDATED - CONTAINER_DELETED - REGIONALIZED_PRIVATE_ENDPOINT_MODE_ENABLED @@ -26616,6 +26775,8 @@ components: - AZ_BALANCING_OVERRIDE_MODIFIED - FTDC_SETTINGS_UPDATED - PROXY_PROTOCOL_FOR_PRIVATE_LINK_MODE_UPDATED + - MONGOTUNE_WRITE_BLOCK_POLICY_ELIGIBLE + - MONGOTUNE_WRITE_BLOCK_POLICY_INELIGIBLE example: CLUSTER_CREATED title: NDS Audit Types type: string @@ -27380,7 +27541,10 @@ components: ***IMPORTANT**: Effective Wednesday, June 16th, 2021, New Relic no longer supports the plugin-based integration with MongoDB. We do not recommend that you sign up for the plugin-based integration. - To learn more, see the New Relic Plugin EOL Statement. Consider configuring an alternative monitoring integration before June 16th to maintain visibility into your MongoDB deployments. + Consider configuring an alternative monitoring integration before June 16th to maintain visibility into your MongoDB deployments. + externalDocs: + description: New Relic Plugin EOL Statement + url: https://discuss.newrelic.com/t/new-relic-plugin-eol-wednesday-june-16th-2021/127267 properties: accountId: description: Unique 40-hexadecimal digit string that identifies your New Relic account. @@ -28859,7 +29023,7 @@ components: readOnly: true type: object OrgServiceAccountRequest: - description: Organization Service Account that Atlas creates for this organization. If omitted, Atlas doesn't create an organization Service Account for this organization. If specified, this object requires all body parameters. + description: Organization Service Account that Atlas creates for this organization. If omitted, Atlas doesn't create an organization Service Account for this organization. If specified, this object requires all body parameters. Note that API Keys cannot be specified in the same request. properties: description: description: Human readable description for the Service Account. @@ -29231,6 +29395,8 @@ components: apiAccessListRequired: description: Flag that indicates whether to require API operations to originate from an IP Address added to the API access list for the specified organization. type: boolean + customSessionTimeouts: + $ref: '#/components/schemas/CustomSessionTimeouts' genAIFeaturesEnabled: default: true description: Flag that indicates whether this organization has access to generative AI features. This setting only applies to Atlas Commercial and is enabled by default. Once this setting is turned on, Project Owners may be able to enable or disable individual AI features at the project level. @@ -31063,8 +31229,8 @@ components: readOnly: true type: object x-xgen-IPA-exception: - xgen-IPA-117-objects-must-be-well-defined: Schema predates IPA validation - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-117-objects-must-be-well-defined: Schema predates IPA validation. + xgen-IPA-124-array-max-items: Schema predates IPA validation. readOnly: true type: array stats: @@ -31256,7 +31422,7 @@ components: type: array type: object PinnedNamespaces: - description: Pinned namespaces view for cluster + description: Pinned namespaces view for cluster. properties: clusterId: description: Unique 24-hexadecimal digit string that identifies the request cluster. @@ -31762,6 +31928,9 @@ components: queryShapeHash: description: A hexadecimal string that represents the hash of a MongoDB query shape. type: string + systemQuery: + description: Indicates whether this query shape represents a system-initiated query. + type: boolean totalTimeToResponseMicros: description: Time in microseconds spent from the beginning of query processing to the first server response. format: double @@ -32602,7 +32771,7 @@ components: title: Replication Specifications type: object RequestAccepted: - description: Accepted + description: Accepted. type: object ResourceEventTypeView: description: Unique identifier of event type. @@ -36077,6 +36246,14 @@ components: StreamsKafkaAuthentication: description: User credentials required to connect to a Kafka Cluster. Includes the authentication type, as well as the parameters for that authentication mode. properties: + clientId: + description: OIDC client identifier for authentication to the Kafka cluster. This field is not supported yet. + type: string + clientSecret: + description: OIDC client secret for authentication to the Kafka cluster. This field is not supported yet. + format: password + type: string + writeOnly: true links: description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. externalDocs: @@ -36087,13 +36264,22 @@ components: readOnly: true type: array mechanism: - description: Style of authentication. Can be one of PLAIN, SCRAM-256, or SCRAM-512. + description: Style of authentication. Can be one of PLAIN, SCRAM-256, SCRAM-512, or OAUTHBEARER. + type: string + method: + description: SASL OAUTHBEARER authentication method. Can only be OIDC currently. This field is not supported yet. type: string password: description: Password of the account to connect to the Kafka cluster. format: password type: string writeOnly: true + saslOauthbearerExtensions: + description: SASL OAUTHBEARER extensions parameter for additional OAuth2 configuration. This field is not supported yet. + type: string + scope: + description: OIDC scope parameter defining the access permissions requested. This field is not supported yet. + type: string sslCertificate: description: SSL certificate for client authentication to Kafka. type: string @@ -36105,6 +36291,9 @@ components: description: Password for the SSL key, if it is password protected. type: string writeOnly: true + tokenEndpointUrl: + description: OIDC token endpoint URL for obtaining access tokens. This field is not supported yet. + type: string username: description: Username of the account to connect to the Kafka cluster. type: string @@ -36169,10 +36358,6 @@ components: name: description: Reserved. Will be used by PRIVATE_LINK connection type. type: string - tgwId: - description: Reserved. Will be used by TRANSIT_GATEWAY connection type. - pattern: ^(tgw-)[0-9a-zA-Z]+$ - type: string tgwRouteId: description: Reserved. Will be used by TRANSIT_GATEWAY connection type. example: 32b6e34b3d91647abb20e7b8 @@ -36187,9 +36372,6 @@ components: - TRANSIT_GATEWAY title: Networking Access Type type: string - vpcCIDR: - description: Reserved. Will be used by TRANSIT_GATEWAY connection type. - type: string type: object StreamsKafkaSecurity: description: Properties for the secure transport connection to Kafka. For SSL, this can include the trusted certificate to use. @@ -36245,7 +36427,7 @@ components: title: Streams Matcher Fields type: string StreamsModifyStreamProcessor: - description: A request to modify an existing stream processor + description: A request to modify an existing stream processor. properties: links: description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. @@ -36336,6 +36518,13 @@ components: description: Error message if the state is FAILED. readOnly: true type: string + gcpServiceAttachmentUris: + description: Service Attachment URIs of each availability zone for the GCP Confluent cluster. + items: + type: string + maxItems: 3 + type: array + uniqueItems: true interfaceEndpointId: description: Interface endpoint ID that is created from the service endpoint ID provided. readOnly: true @@ -36508,7 +36697,7 @@ components: type: boolean type: object StreamsStartStreamProcessorWith: - description: A request to start a stream processor + description: A request to start a stream processor. properties: links: description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. @@ -37405,7 +37594,7 @@ components: definition: $ref: '#/components/schemas/TextSearchIndexDefinition' type: object - description: Text Search Index Create Request + description: Text Search Index Create Request. required: - collectionName - database @@ -38907,7 +39096,7 @@ components: definition: $ref: '#/components/schemas/VectorSearchIndexDefinition' type: object - description: Vector Search Index Create Request + description: Vector Search Index Create Request. required: - collectionName - database @@ -39855,7 +40044,7 @@ info: termsOfService: https://www.mongodb.com/mongodb-management-service-terms-and-conditions title: MongoDB Atlas Administration API version: "2.0" - x-xgen-sha: 71ac9e4b796c59607af25b073aa510451ae85fdb + x-xgen-sha: 6d1feb3f4a77896c6eda8ce3e744affc6a1f024c openapi: 3.0.1 paths: /api/atlas/v2: @@ -39883,14 +40072,17 @@ paths: $ref: '#/components/responses/forbidden' "500": $ref: '#/components/responses/internalServerError' - summary: Return the status of this MongoDB application + summary: Return the Status of This MongoDB Application tags: - Root x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Root/operation/getSystemStatus + x-xgen-method-verb-override: + customMethod: false + verb: getSystemStatus /api/atlas/v2/alertConfigs/matchers/fieldNames: get: description: Get all field names that the `matchers.fieldName` parameter accepts when you create or update an Alert Configuration. You can successfully call this endpoint with any assigned role. - operationId: listAlertConfigurationMatchersFieldNames + operationId: listAlertConfigMatcherFieldNames parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -39903,7 +40095,7 @@ paths: $ref: '#/components/schemas/MatcherFieldView' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -39915,11 +40107,12 @@ paths: summary: Return All Alert Configuration Matchers Field Names tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurationMatchersFieldNames + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigMatcherFieldNames + x-xgen-operation-id-override: listMatcherFieldNames /api/atlas/v2/clusters: get: description: Returns the details for all clusters in all projects to which you have access. Clusters contain a group of hosts that maintain the same data set. The response does not include multi-cloud clusters. To use this resource, the requesting Service Account or API Key can have any cluster-level role. - operationId: listClustersForAllProjects + operationId: listClusterDetails parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -39943,7 +40136,10 @@ paths: summary: Return All Authorized Clusters in All Projects tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listClustersForAllProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listClusterDetails + x-xgen-method-verb-override: + customMethod: false + verb: listDetails /api/atlas/v2/eventTypes: get: description: Returns a list of all event types, along with a description and additional metadata about each event. @@ -39975,7 +40171,7 @@ paths: /api/atlas/v2/federationSettings/{federationSettingsId}: delete: description: 'Deletes the federation settings instance and all associated data, including identity providers and domains. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the last remaining connected organization. **Note**: requests to this resource will fail if there is more than one connected organization in the federation.' - operationId: deleteFederationApp + operationId: deleteFederationSetting parameters: - $ref: '#/components/parameters/federationSettingsId' responses: @@ -39997,11 +40193,11 @@ paths: summary: Delete One Federation Settings Instance tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteFederationApp + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteFederationSetting /api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs: get: description: Returns all connected org configs in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected orgs. - operationId: listConnectedOrgConfigs + operationId: listFederationSettingConnectedOrgConfigs parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40028,11 +40224,12 @@ paths: summary: Return All Organization Configurations from One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listConnectedOrgConfigs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listFederationSettingConnectedOrgConfigs + x-xgen-operation-id-override: listConnectedOrgConfigs /api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}: delete: description: 'Removes one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This request fails if only one connected organization exists in the federation.' - operationId: removeConnectedOrgConfig + operationId: removeFederationSettingConnectedOrgConfig parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40063,13 +40260,14 @@ paths: summary: Remove One Organization Configuration from One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/removeConnectedOrgConfig + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/removeFederationSettingConnectedOrgConfig x-xgen-method-verb-override: customMethod: "True" verb: remove + x-xgen-operation-id-override: removeConnectedOrgConfig get: description: Returns the specified connected org config from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. - operationId: getConnectedOrgConfig + operationId: getFederationSettingConnectedOrgConfig parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40088,7 +40286,7 @@ paths: schema: $ref: '#/components/schemas/ConnectedOrgConfig' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -40104,10 +40302,11 @@ paths: summary: Return One Organization Configuration from One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getConnectedOrgConfig + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettingConnectedOrgConfig + x-xgen-operation-id-override: getConnectedOrgConfig patch: description: "Updates one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. \n\n**Note** If the organization configuration has no associated identity provider, you can't use this resource to update role mappings or post authorization role grants. \n\n**Note**: The domainRestrictionEnabled field defaults to false if not provided in the request. \n\n**Note**: If the identityProviderId field is not provided, you will disconnect the organization and the identity provider. \n\n**Note**: Currently connected data access identity providers missing from the dataAccessIdentityProviderIds field will be disconnected." - operationId: updateConnectedOrgConfig + operationId: updateFederationSettingConnectedOrgConfig parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40147,11 +40346,12 @@ paths: summary: Update One Organization Configuration in One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateConnectedOrgConfig + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateFederationSettingConnectedOrgConfig + x-xgen-operation-id-override: updateConnectedOrgConfig /api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings: get: description: Returns all role mappings from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: listRoleMappings + operationId: listFederationSettingConnectedOrgConfigRoleMappings parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40177,10 +40377,11 @@ paths: summary: Return All Role Mappings from One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listRoleMappings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listFederationSettingConnectedOrgConfigRoleMappings + x-xgen-operation-id-override: listRoleMappings post: description: Adds one role mapping to the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: createRoleMapping + operationId: createFederationSettingConnectedOrgConfigRoleMapping parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40213,11 +40414,12 @@ paths: summary: Create One Role Mapping in One Organization Configuration tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/createRoleMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/createFederationSettingConnectedOrgConfigRoleMapping + x-xgen-operation-id-override: createRoleMapping /api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings/{id}: delete: description: Removes one role mapping in the specified organization from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: deleteRoleMapping + operationId: deleteFederationSettingConnectedOrgConfigRoleMapping parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the role mapping that you want to remove. @@ -40249,10 +40451,11 @@ paths: summary: Remove One Role Mapping from One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteRoleMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteFederationSettingConnectedOrgConfigRoleMapping + x-xgen-operation-id-override: deleteRoleMapping get: description: Returns one role mapping from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: getRoleMapping + operationId: getFederationSettingConnectedOrgConfigRoleMapping parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the role mapping that you want to return. @@ -40272,7 +40475,7 @@ paths: schema: $ref: '#/components/schemas/AuthFederationRoleMapping' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -40288,10 +40491,11 @@ paths: summary: Return One Role Mapping from One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getRoleMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettingConnectedOrgConfigRoleMapping + x-xgen-operation-id-override: getRoleMapping put: description: Updates one role mapping in the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: updateRoleMapping + operationId: updateFederationSettingConnectedOrgConfigRoleMapping parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the role mapping that you want to update. @@ -40332,11 +40536,12 @@ paths: summary: Update One Role Mapping in One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateRoleMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateFederationSettingConnectedOrgConfigRoleMapping + x-xgen-operation-id-override: updateRoleMapping /api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders: get: description: Returns all identity providers with the provided protocol and type in the specified federation. If no protocol is specified, only SAML identity providers will be returned. If no idpType is specified, only WORKFORCE identity providers will be returned. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - operationId: listIdentityProviders + operationId: listFederationSettingIdentityProviders parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40371,7 +40576,7 @@ paths: schema: $ref: '#/components/schemas/PaginatedFederationIdentityProvider' x-xgen-IPA-exception: - xgen-IPA-105-list-method-response-is-get-method-response: API predates IPA validation + xgen-IPA-105-list-method-response-is-get-method-response: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -40387,13 +40592,14 @@ paths: summary: Return All Identity Providers in One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listIdentityProviders + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listFederationSettingIdentityProviders + x-xgen-operation-id-override: listIdentityProviders post: description: |- Creates one identity provider within the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. **Note**: This resource only supports the creation of OIDC identity providers. - operationId: createIdentityProvider + operationId: createFederationSettingIdentityProvider parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40425,14 +40631,15 @@ paths: summary: Create One Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/createIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/createFederationSettingIdentityProvider + x-xgen-operation-id-override: createIdentityProvider /api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}: delete: description: "Deletes one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. \n\n**Note**: Requests to this resource will fail if the identity provider has any connected organizations. Before deleting an identity provider, disconnect all organizations and confirm that no organization in your account uses this identity provider." externalDocs: description: Manage Organization Mapping for Federated Authentication url: https://www.mongodb.com/docs/atlas/security/manage-org-mapping/ - operationId: deleteIdentityProvider + operationId: deleteFederationSettingIdentityProvider parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the identity provider to connect. @@ -40462,10 +40669,11 @@ paths: summary: Delete One Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteFederationSettingIdentityProvider + x-xgen-operation-id-override: deleteIdentityProvider get: description: Returns one identity provider in the specified federation by the identity provider's id. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - operationId: getIdentityProvider + operationId: getFederationSettingIdentityProvider parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id. @@ -40484,13 +40692,13 @@ paths: $ref: '#/components/schemas/FederationSamlIdentityProvider' x-sunset: "2025-01-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2023-11-15+json: schema: $ref: '#/components/schemas/FederationIdentityProvider' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-11-15" description: OK "400": @@ -40506,13 +40714,14 @@ paths: summary: Return One Identity Provider by ID tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettingIdentityProvider + x-xgen-operation-id-override: getIdentityProvider patch: description: |- Updates one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. **Note**: Changing authorization types and/or updating authorization claims can prevent current users and/or groups from accessing the database. - operationId: updateIdentityProvider + operationId: updateFederationSettingIdentityProvider parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id. @@ -40559,14 +40768,15 @@ paths: summary: Update One Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateFederationSettingIdentityProvider + x-xgen-operation-id-override: updateIdentityProvider /api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}/jwks: delete: description: "Revokes the JWKS tokens from the requested OIDC identity provider. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. \n\n**Note**: Revoking your JWKS tokens immediately refreshes your IdP public keys from all your Atlas clusters, invalidating previously signed access tokens and logging out all users. You may need to restart your MongoDB clients. All organizations connected to the identity provider will be affected." externalDocs: description: Configure OIDC Authorization url: https://www.mongodb.com/docs/atlas/security-oidc/#revoke-jwks - operationId: revokeJwksFromIdentityProvider + operationId: revokeFederationSettingIdentityProviderJwks parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the identity provider to connect. @@ -40596,14 +40806,15 @@ paths: summary: Revoke JWKS from One OIDC Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/revokeJwksFromIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/revokeFederationSettingIdentityProviderJwks x-xgen-method-verb-override: customMethod: "True" verb: revoke + x-xgen-operation-id-override: revokeIdentityProviderJwks /api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}/metadata.xml: get: description: Returns the metadata of one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - operationId: getIdentityProviderMetadata + operationId: getFederationSettingIdentityProviderMetadata parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/identityProviderId' @@ -40628,14 +40839,15 @@ paths: summary: Return Metadata of One Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getIdentityProviderMetadata + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettingIdentityProviderMetadata x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getIdentityProviderMetadata /api/atlas/v2/groups: get: description: Returns details about all projects. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Organization Read Only role or higher. - operationId: listProjects + operationId: listGroups parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -40663,7 +40875,7 @@ paths: summary: Return All Projects tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listGroups requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -40674,7 +40886,7 @@ paths: description: Get a list of all projects inside of the organisation post: description: Creates one project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Read Write role. - operationId: createProject + operationId: createGroup parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -40724,11 +40936,11 @@ paths: summary: Create One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createGroup /api/atlas/v2/groups/{groupId}: delete: description: Removes the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. You can delete a project only if there are no Online Archives for the clusters in the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteProject + operationId: deleteGroup parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40754,7 +40966,7 @@ paths: summary: Remove One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteGroup requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -40765,7 +40977,7 @@ paths: description: Deletes an existing project get: description: Returns details about the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProject + operationId: getGroup parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40777,8 +40989,7 @@ paths: schema: $ref: '#/components/schemas/Group' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: API predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -40794,7 +41005,7 @@ paths: summary: Return One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroup requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -40805,7 +41016,7 @@ paths: description: Get a project using a project id patch: description: Updates the human-readable label that identifies the specified project, or the tags associated with the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateProject + operationId: updateGroup parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40847,12 +41058,12 @@ paths: summary: Update One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroup /api/atlas/v2/groups/{groupId}/access: post: deprecated: true description: Adds one MongoDB Cloud user to the specified project. If the MongoDB Cloud user is not a member of the project's organization, then the user must accept their invitation to the organization to access information within the specified project. If the MongoDB Cloud User is already a member of the project's organization, then they will be added to the project immediately and an invitation will not be returned by this resource. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. - operationId: addUserToProject + operationId: addGroupAccessUser parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/pretty' @@ -40889,17 +41100,18 @@ paths: summary: Add One MongoDB Cloud User to One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/addUserToProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/addGroupAccessUser x-xgen-method-verb-override: customMethod: "True" verb: addUser + x-xgen-operation-id-override: addGroupUser /api/atlas/v2/groups/{groupId}/accessList: get: description: Returns all access list entries from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The `/groups/{GROUP-ID}/accessList` endpoint manages the database IP access list. This endpoint is distinct from the `orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist` endpoint, which manages the access list for MongoDB Cloud organizations. externalDocs: description: IP access list url: https://docs.atlas.mongodb.com/security/ip-access-list/#std-label-access-list - operationId: listProjectIpAccessLists + operationId: listGroupAccessListEntries parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40931,7 +41143,11 @@ paths: - Project IP Access List x-xgen-changelog: "2025-05-08": Corrects an issue where the endpoint would include Atlas internal entries. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/listProjectIpAccessLists + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/listGroupAccessListEntries + x-xgen-method-verb-override: + customMethod: false + verb: listEntries + x-xgen-operation-id-override: listAccessListEntries requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -40945,7 +41161,7 @@ paths: externalDocs: description: IP access list url: https://docs.atlas.mongodb.com/security/ip-access-list/#std-label-access-list - operationId: createProjectIpAccessList + operationId: createGroupAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40995,14 +41211,18 @@ paths: summary: Add Entries to Project IP Access List tags: - Project IP Access List - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/createProjectIpAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/createGroupAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: createEntry + x-xgen-operation-id-override: createAccessListEntry /api/atlas/v2/groups/{groupId}/accessList/{entryValue}: delete: description: Removes one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains one IP address, one CIDR-notated block of IP addresses, or one AWS Security Group ID. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The `/groups/{GROUP-ID}/accessList` endpoint manages the database IP access list. This endpoint is distinct from the `orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist` endpoint, which manages the access list for MongoDB Cloud organizations. externalDocs: description: IP access list url: https://docs.atlas.mongodb.com/security/ip-access-list/#std-label-access-list - operationId: deleteProjectIpAccessList + operationId: deleteGroupAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41043,7 +41263,11 @@ paths: summary: Remove One Entry from One Project IP Access List tags: - Project IP Access List - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/deleteProjectIpAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/deleteGroupAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: deleteEntry + x-xgen-operation-id-override: deleteAccessListEntry requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -41057,7 +41281,7 @@ paths: externalDocs: description: IP access list url: https://docs.atlas.mongodb.com/security/ip-access-list/#std-label-access-list - operationId: getProjectIpList + operationId: getGroupAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41083,7 +41307,7 @@ paths: schema: $ref: '#/components/schemas/NetworkPermissionEntry' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41097,7 +41321,11 @@ paths: summary: Return One Project IP Access List Entry tags: - Project IP Access List - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/getProjectIpList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/getGroupAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: getEntry + x-xgen-operation-id-override: getAccessListEntry requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -41109,7 +41337,7 @@ paths: /api/atlas/v2/groups/{groupId}/accessList/{entryValue}/status: get: description: Returns the status of one project IP access list entry. This resource checks if the provided project IP access list entry applies to all cloud providers serving clusters from the specified project. - operationId: getProjectIpAccessListStatus + operationId: getGroupAccessListStatus parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41135,7 +41363,7 @@ paths: schema: $ref: '#/components/schemas/NetworkPermissionEntryStatus' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -41151,7 +41379,8 @@ paths: summary: Return Status of One Project IP Access List Entry tags: - Project IP Access List - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/getProjectIpAccessListStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/getGroupAccessListStatus + x-xgen-operation-id-override: getAccessListStatus requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -41166,7 +41395,7 @@ paths: Returns all alert configurations for one project. These alert configurations apply to any component in the project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This resource remains under revision and may change. - operationId: listAlertConfigurations + operationId: listGroupAlertConfigs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41193,13 +41422,14 @@ paths: summary: Return All Alert Configurations in One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listGroupAlertConfigs + x-xgen-operation-id-override: listAlertConfigs post: description: |- Creates one alert configuration for the specified project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. This resource remains under revision and may change. - operationId: createAlertConfiguration + operationId: createGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41232,7 +41462,8 @@ paths: summary: Create One Alert Configuration in One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/createAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/createGroupAlertConfig + x-xgen-operation-id-override: createAlertConfig /api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}: delete: description: |- @@ -41242,7 +41473,7 @@ paths: externalDocs: description: Return All Alert Configurations for One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurations - operationId: deleteAlertConfiguration + operationId: deleteGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41272,7 +41503,8 @@ paths: summary: Remove One Alert Configuration from One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/deleteAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/deleteGroupAlertConfig + x-xgen-operation-id-override: deleteAlertConfig get: description: |- Returns the specified alert configuration from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. @@ -41281,7 +41513,7 @@ paths: externalDocs: description: Return All Alert Configurations for One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurations - operationId: getAlertConfiguration + operationId: getGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41301,7 +41533,7 @@ paths: schema: $ref: '#/components/schemas/GroupAlertsConfig' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41315,7 +41547,8 @@ paths: summary: Return One Alert Configuration from One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/getAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/getGroupAlertConfig + x-xgen-operation-id-override: getAlertConfig patch: description: |- Enables or disables the specified alert configuration in the specified project. The resource enables the specified alert configuration if currently enabled. The resource disables the specified alert configuration if currently disabled. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -41326,7 +41559,7 @@ paths: externalDocs: description: Update One Alert Configuration url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/updateAlertConfiguration - operationId: toggleAlertConfiguration + operationId: toggleGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41365,10 +41598,11 @@ paths: summary: Toggle State of One Alert Configuration in One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/toggleAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/toggleGroupAlertConfig x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: toggle + x-xgen-operation-id-override: toggleAlertConfig put: description: |- Updates one alert configuration in the specified project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -41379,7 +41613,7 @@ paths: externalDocs: description: Toggle One State of One Alert Configuration in One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/toggleAlertConfiguration - operationId: updateAlertConfiguration + operationId: updateGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41420,7 +41654,8 @@ paths: summary: Update One Alert Configuration in One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/updateAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/updateGroupAlertConfig + x-xgen-operation-id-override: updateAlertConfig /api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}/alerts: get: description: |- @@ -41430,7 +41665,7 @@ paths: externalDocs: description: Return All Alert Configurations for One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurations - operationId: listAlertsByAlertConfigurationId + operationId: getGroupAlertConfigAlerts parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41453,8 +41688,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedAlertView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41468,14 +41703,15 @@ paths: summary: Return All Open Alerts for One Alert Configuration tags: - Alerts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlertsByAlertConfigurationId + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/getGroupAlertConfigAlerts + x-xgen-operation-id-override: getAlertConfigAlerts /api/atlas/v2/groups/{groupId}/alerts: get: description: |- Returns all alerts. These alerts apply to all components in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This resource remains under revision and may change. - operationId: listAlerts + operationId: listGroupAlerts parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41513,7 +41749,8 @@ paths: summary: Return All Alerts from One Project tags: - Alerts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlerts + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listGroupAlerts + x-xgen-operation-id-override: listAlerts /api/atlas/v2/groups/{groupId}/alerts/{alertId}: get: description: |- @@ -41523,7 +41760,7 @@ paths: externalDocs: description: Return All Alerts from One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlerts - operationId: getAlert + operationId: getGroupAlert parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41542,7 +41779,7 @@ paths: schema: $ref: '#/components/schemas/AlertViewForNdsGroup' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41556,7 +41793,8 @@ paths: summary: Return One Alert from One Project tags: - Alerts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/getAlert + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/getGroupAlert + x-xgen-operation-id-override: getAlert patch: description: |- Confirms receipt of one existing alert. This alert applies to any component in one project. Acknowledging an alert prevents successive notifications. You receive an alert when a monitored component meets or exceeds a value you set until you acknowledge the alert. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. @@ -41565,7 +41803,7 @@ paths: externalDocs: description: Return All Alerts from One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlerts - operationId: acknowledgeAlert + operationId: acknowledgeGroupAlert parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41613,10 +41851,11 @@ paths: summary: Acknowledge One Alert from One Project tags: - Alerts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/acknowledgeAlert + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/acknowledgeGroupAlert x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: acknowledge + x-xgen-operation-id-override: acknowledgeAlert /api/atlas/v2/groups/{groupId}/alerts/{alertId}/alertConfigs: get: description: |- @@ -41626,7 +41865,7 @@ paths: externalDocs: description: Return All Alerts from One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlerts - operationId: listAlertConfigurationsByAlertId + operationId: getGroupAlertAlertConfigs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41648,8 +41887,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedAlertConfigView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41663,14 +41902,15 @@ paths: summary: Return All Alert Configurations Set for One Alert tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurationsByAlertId + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/getGroupAlertAlertConfigs + x-xgen-operation-id-override: getAlertConfigs /api/atlas/v2/groups/{groupId}/apiKeys: get: description: Returns all organization API keys that you assigned to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: listProjectApiKeys + operationId: listGroupApiKeys parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41697,10 +41937,10 @@ paths: summary: Return All Organization API Keys Assigned to One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listProjectApiKeys + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listGroupApiKeys post: description: Creates and assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createProjectApiKey + operationId: createGroupApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41731,14 +41971,14 @@ paths: summary: Create and Assign One Organization API Key to One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createProjectApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createGroupApiKey /api/atlas/v2/groups/{groupId}/apiKeys/{apiUserId}: delete: description: Removes one organization API key from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: removeProjectApiKey + operationId: removeGroupApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41769,13 +42009,13 @@ paths: summary: Unassign One Organization API Key from One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/removeProjectApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/removeGroupApiKey x-xgen-method-verb-override: customMethod: "True" verb: remove patch: description: Updates the roles of the organization API key that you specify for the project that you specify. You must specify at least one valid role for the project. The application removes any roles that you do not include in this request if they were previously set in the organization API key that you specify for the project. - operationId: updateApiKeyRoles + operationId: updateGroupApiKeyRoles parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/pageNum' @@ -41818,13 +42058,14 @@ paths: summary: Update Organization API Key Roles for One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateApiKeyRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateGroupApiKeyRoles x-xgen-method-verb-override: customMethod: "True" verb: updateRoles + x-xgen-operation-id-override: updateApiKeyRoles post: description: Assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can then use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: addProjectApiKey + operationId: addGroupApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41862,14 +42103,14 @@ paths: summary: Assign One Organization API Key to One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/addProjectApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/addGroupApiKey x-xgen-method-verb-override: customMethod: "True" verb: add /api/atlas/v2/groups/{groupId}/auditLog: get: description: Returns the auditing configuration for the specified project. The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for `M0`, `M2`, `M5`, or serverless clusters. - operationId: getAuditingConfiguration + operationId: getGroupAuditLog parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41881,7 +42122,7 @@ paths: schema: $ref: '#/components/schemas/AuditLog' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41895,10 +42136,10 @@ paths: summary: Return Auditing Configuration for One Project tags: - Auditing - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Auditing/operation/getAuditingConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Auditing/operation/getGroupAuditLog patch: description: Updates the auditing configuration for the specified project. The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for `M0`, `M2`, `M5`, or serverless clusters. - operationId: updateAuditingConfiguration + operationId: updateGroupAuditLog parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41931,11 +42172,12 @@ paths: summary: Update Auditing Configuration for One Project tags: - Auditing - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Auditing/operation/updateAuditingConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Auditing/operation/updateGroupAuditLog + x-xgen-operation-id-override: updateAuditLog /api/atlas/v2/groups/{groupId}/awsCustomDNS: get: description: Returns the custom DNS configuration for AWS clusters in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getAwsCustomDns + operationId: getGroupAwsCustomDns parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41947,7 +42189,7 @@ paths: schema: $ref: '#/components/schemas/AWSCustomDNSEnabledView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41961,10 +42203,11 @@ paths: summary: Return One Custom DNS Configuration for Atlas Clusters on AWS tags: - AWS Clusters DNS - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/AWS-Clusters-DNS/operation/getAwsCustomDns + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/AWS-Clusters-DNS/operation/getGroupAwsCustomDns + x-xgen-operation-id-override: getAwsCustomDns patch: description: Enables or disables the custom DNS configuration for AWS clusters in the specified project. Enable custom DNS if you use AWS VPC peering and use your own DNS servers. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: toggleAwsCustomDns + operationId: toggleGroupAwsCustomDns parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41995,14 +42238,15 @@ paths: summary: Update State of One Custom DNS Configuration for Atlas Clusters on AWS tags: - AWS Clusters DNS - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/AWS-Clusters-DNS/operation/toggleAwsCustomDns + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/AWS-Clusters-DNS/operation/toggleGroupAwsCustomDns x-xgen-method-verb-override: customMethod: "True" verb: toggle + x-xgen-operation-id-override: toggleAwsCustomDns /api/atlas/v2/groups/{groupId}/backup/exportBuckets: get: description: Returns all Export Buckets associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listExportBuckets + operationId: listGroupBackupExportBuckets parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42034,10 +42278,11 @@ paths: summary: Return All Snapshot Export Buckets tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listExportBuckets + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupBackupExportBuckets + x-xgen-operation-id-override: listExportBuckets post: description: Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. Once created, an snapshots can be exported to the Export Bucket and its referenced AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createExportBucket + operationId: createGroupBackupExportBucket parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42052,6 +42297,7 @@ paths: bucketName: export-bucket cloudProvider: AWS iamRoleId: 668c5f0ed436263134491592 + requirePrivateNetworking: false schema: $ref: '#/components/schemas/DiskBackupSnapshotAWSExportBucketRequest' x-xgen-version: "2023-01-01" @@ -42063,6 +42309,7 @@ paths: bucketName: export-bucket cloudProvider: AWS iamRoleId: 668c5f0ed436263134491592 + requirePrivateNetworking: false Azure: description: Azure value: @@ -42097,6 +42344,7 @@ paths: - href: https://cloud.mongodb.com/api/atlas rel: self region: us-east-1 + requirePrivateNetworking: true schema: $ref: '#/components/schemas/DiskBackupSnapshotAWSExportBucketResponse' x-sunset: "2026-05-30" @@ -42114,6 +42362,7 @@ paths: - href: https://cloud.mongodb.com/api/atlas rel: self region: us-east-1 + requirePrivateNetworking: true Azure: description: Azure value: @@ -42153,11 +42402,12 @@ paths: summary: Create One Snapshot Export Bucket tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createExportBucket + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createGroupBackupExportBucket + x-xgen-operation-id-override: createExportBucket /api/atlas/v2/groups/{groupId}/backup/exportBuckets/{exportBucketId}: delete: description: Deletes an Export Bucket. Auto export must be disabled on all clusters in this Project exporting to this Export Bucket before revoking access. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: deleteExportBucket + operationId: deleteGroupBackupExportBucket parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42188,10 +42438,11 @@ paths: summary: Delete One Snapshot Export Bucket tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteExportBucket + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteGroupBackupExportBucket + x-xgen-operation-id-override: deleteExportBucket get: description: Returns one Export Bucket associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getExportBucket + operationId: getGroupBackupExportBucket parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42219,6 +42470,7 @@ paths: - href: https://cloud.mongodb.com/api/atlas rel: self region: us-east-1 + requirePrivateNetworking: true schema: $ref: '#/components/schemas/DiskBackupSnapshotAWSExportBucketResponse' x-sunset: "2026-05-30" @@ -42236,6 +42488,7 @@ paths: - href: https://cloud.mongodb.com/api/atlas rel: self region: us-east-1 + requirePrivateNetworking: true Azure: description: Azure value: @@ -42273,11 +42526,12 @@ paths: summary: Return One Snapshot Export Bucket tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getExportBucket + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupBackupExportBucket + x-xgen-operation-id-override: getExportBucket /api/atlas/v2/groups/{groupId}/backupCompliancePolicy: delete: description: Disables the Backup Compliance Policy settings with the specified project. As a prerequisite, a support ticket needs to be file first, instructions in https://www.mongodb.com/docs/atlas/backup/cloud-backup/backup-compliance-policy/. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: disableDataProtectionSettings + operationId: disableGroupBackupCompliancePolicy parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42301,15 +42555,16 @@ paths: summary: Disable Backup Compliance Policy Settings tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/disableDataProtectionSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/disableGroupBackupCompliancePolicy x-xgen-method-verb-override: customMethod: "True" verb: disable + x-xgen-operation-id-override: disableCompliancePolicy x-xgen-atlascli: watcher: get: version: "2023-10-01" - operation-id: getDataProtectionSettings + operation-id: updateGroupBackupCompliancePolicy params: groupId: input:groupId expect: @@ -42319,7 +42574,7 @@ paths: - ACTIVE get: description: Returns the Backup Compliance Policy settings with the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getDataProtectionSettings + operationId: getGroupBackupCompliancePolicy parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42332,13 +42587,13 @@ paths: $ref: '#/components/schemas/DataProtectionSettings' x-sunset: "2026-10-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2023-10-01+json: schema: $ref: '#/components/schemas/DataProtectionSettings20231001' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-10-01" description: OK "401": @@ -42352,10 +42607,11 @@ paths: summary: Return Backup Compliance Policy Settings tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getDataProtectionSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupBackupCompliancePolicy + x-xgen-operation-id-override: getCompliancePolicy put: description: Updates the Backup Compliance Policy settings for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateDataProtectionSettings + operationId: updateGroupBackupCompliancePolicy parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42404,12 +42660,13 @@ paths: summary: Update Backup Compliance Policy Settings tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateDataProtectionSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateGroupBackupCompliancePolicy + x-xgen-operation-id-override: updateCompliancePolicy x-xgen-atlascli: watcher: get: version: "2023-10-01" - operation-id: getDataProtectionSettings + operation-id: updateGroupBackupCompliancePolicy params: groupId: input:groupId expect: @@ -42420,7 +42677,7 @@ paths: /api/atlas/v2/groups/{groupId}/cloudProviderAccess: get: description: Returns all cloud provider access roles with access to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: listCloudProviderAccessRoles + operationId: listGroupCloudProviderAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42432,9 +42689,9 @@ paths: schema: $ref: '#/components/schemas/CloudProviderAccessRoles' x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -42448,13 +42705,14 @@ paths: summary: Return All Cloud Provider Access Roles tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/listCloudProviderAccessRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/listGroupCloudProviderAccess + x-xgen-operation-id-override: listCloudProviderAccess post: description: Creates one access role for the specified cloud provider. Some MongoDB Cloud features use these cloud provider access roles for authentication. To use this resource, the requesting Service Account or API Key must have the Project Owner role. For the GCP provider, if the project folder is not yet provisioned, Atlas will now create the role asynchronously. An intermediate role with status `IN_PROGRESS` will be returned, and the final service account will be provisioned. Once the GCP project is set up, subsequent requests will create the service account synchronously. externalDocs: description: Set Up Access to Cloud Providers url: https://www.mongodb.com/docs/atlas/security/cloud-provider-access/ - operationId: createCloudProviderAccessRole + operationId: createGroupCloudProviderAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42485,11 +42743,12 @@ paths: summary: Create One Cloud Provider Access Role tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/createCloudProviderAccessRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/createGroupCloudProviderAccess + x-xgen-operation-id-override: createCloudProviderAccess /api/atlas/v2/groups/{groupId}/cloudProviderAccess/{cloudProvider}/{roleId}: delete: description: Revokes access to the specified project for the specified access role. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deauthorizeCloudProviderAccessRole + operationId: deauthorizeGroupCloudProviderAccessRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42530,14 +42789,15 @@ paths: summary: Deauthorize One Cloud Provider Access Role tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/deauthorizeCloudProviderAccessRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/deauthorizeGroupCloudProviderAccessRole x-xgen-method-verb-override: customMethod: "True" verb: deauthorizeRole + x-xgen-operation-id-override: deauthorizeProviderAccessRole /api/atlas/v2/groups/{groupId}/cloudProviderAccess/{roleId}: get: description: Returns the access role with the specified id and with access to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getCloudProviderAccessRole + operationId: getGroupCloudProviderAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42556,7 +42816,7 @@ paths: schema: $ref: '#/components/schemas/CloudProviderAccessRole' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -42570,13 +42830,14 @@ paths: summary: Return One Cloud Provider Access Role tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/getCloudProviderAccessRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/getGroupCloudProviderAccess + x-xgen-operation-id-override: getCloudProviderAccess patch: description: Grants access to the specified project for the specified access role. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API endpoint is one step in a procedure to create unified access for MongoDB Cloud services. This is not required for GCP service account access. externalDocs: description: Set Up Access to Cloud Providers url: https://www.mongodb.com/docs/atlas/security/cloud-provider-access/ - operationId: authorizeCloudProviderAccessRole + operationId: authorizeGroupCloudProviderAccessRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42618,10 +42879,11 @@ paths: summary: Authorize One Cloud Provider Access Role tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/authorizeCloudProviderAccessRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/authorizeGroupCloudProviderAccessRole x-xgen-method-verb-override: customMethod: "True" verb: authorizeRole + x-xgen-operation-id-override: authorizeProviderAccessRole /api/atlas/v2/groups/{groupId}/clusters: get: description: |- @@ -42631,7 +42893,7 @@ paths: externalDocs: description: listFlexClusters url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/listFlexClusters - operationId: listClusters + operationId: listGroupClusters parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42677,7 +42939,8 @@ paths: summary: Return All Clusters in One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listClusters + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listGroupClusters + x-xgen-operation-id-override: listClusters requestBody: content: application/vnd.atlas.2024-08-05+json: @@ -42694,7 +42957,7 @@ paths: externalDocs: description: createFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/createFlexCluster - operationId: createCluster + operationId: createGroupCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42927,14 +43190,14 @@ paths: - Clusters x-xgen-changelog: "2025-06-05": Fixed a bug that previously permitted users to configure multiple regionConfigs for the same region and cloud provider within a replicationSpec - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/createCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/createGroupCluster + x-xgen-operation-id-override: createCluster x-xgen-atlascli: watcher: get: version: "2024-08-05" - operation-id: getCluster + operation-id: createGroupCluster params: - clusterName: body:$.name groupId: body:$.groupId expect: match: @@ -42950,7 +43213,7 @@ paths: externalDocs: description: deleteFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/deleteFlexCluster - operationId: deleteCluster + operationId: deleteGroupCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -42997,7 +43260,8 @@ paths: summary: Remove One Cluster from One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/deleteCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/deleteGroupCluster + x-xgen-operation-id-override: deleteCluster requestBody: content: application/vnd.atlas.2023-02-01+json: @@ -43009,8 +43273,8 @@ paths: x-xgen-atlascli: watcher: get: - version: "2024-08-05" - operation-id: getCluster + version: "2023-01-01" + operation-id: deleteGroupCluster params: clusterName: input:clusterName groupId: input:groupId @@ -43024,7 +43288,7 @@ paths: externalDocs: description: getFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/getFlexCluster - operationId: getCluster + operationId: getGroupCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43050,20 +43314,20 @@ paths: $ref: '#/components/schemas/LegacyAtlasCluster' x-sunset: "2026-11-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2023-02-01+json: schema: $ref: '#/components/schemas/AdvancedClusterDescription' x-sunset: "2026-03-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-02-01" application/vnd.atlas.2024-08-05+json: schema: $ref: '#/components/schemas/ClusterDescription20240805' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -43079,7 +43343,8 @@ paths: summary: Return One Cluster from One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getGroupCluster + x-xgen-operation-id-override: getCluster requestBody: content: application/vnd.atlas.2024-08-05+json: @@ -43090,7 +43355,7 @@ paths: description: Returns the details for the specified cluster in the project patch: description: 'Updates the details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can update clusters with asymmetrically-sized shards. To update a cluster''s termination protection, the requesting Service Account or API Key must have the Project Owner role. For all other updates, the requesting Service Account or API Key must have the Project Cluster Manager role. You can''t modify a paused cluster (`paused : true`). You must call this endpoint to set `paused : false`. After this endpoint responds with `paused : false`, you can call it again with the changes you want to make to the cluster. This feature is not available for serverless clusters.' - operationId: updateCluster + operationId: updateGroupCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43180,12 +43445,13 @@ paths: - Clusters x-xgen-changelog: "2025-06-05": Fixed a bug that previously permitted users to configure multiple regionConfigs for the same region and cloud provider within a replicationSpec - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/updateCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/updateGroupCluster + x-xgen-operation-id-override: updateCluster x-xgen-atlascli: watcher: get: version: "2024-08-05" - operation-id: getCluster + operation-id: updateGroupCluster params: clusterName: input:clusterName groupId: input:groupId @@ -43197,7 +43463,7 @@ paths: /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/{clusterView}/{databaseName}/{collectionName}/collStats/measurements: get: description: Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. - operationId: getCollStatsLatencyNamespaceClusterMeasurements + operationId: listGroupClusterCollStatMeasurements parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster to retrieve metrics for. @@ -43280,11 +43546,12 @@ paths: summary: Return Cluster-Level Query Latency tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespaceClusterMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/listGroupClusterCollStatMeasurements + x-xgen-operation-id-override: listCollStatMeasurements /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/{clusterView}/collStats/namespaces: get: description: Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. - operationId: getCollStatsLatencyNamespacesForCluster + operationId: getGroupClusterCollStatNamespaces parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster to pin namespaces to. @@ -43324,18 +43591,19 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return Ranked Namespaces from a Cluster + summary: Return Ranked Namespaces from One Cluster tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespacesForCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getGroupClusterCollStatNamespaces x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getClusterNamespaces /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/autoScalingConfiguration: get: deprecated: true description: Returns the internal configuration of AutoScaling for sharded clusters. This endpoint can be used for diagnostic purposes to ensure that sharded clusters updated from older APIs have gained support for AutoScaling each shard independently. - operationId: autoScalingConfiguration + operationId: autoGroupClusterScalingConfiguration parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43354,7 +43622,7 @@ paths: schema: $ref: '#/components/schemas/ClusterDescriptionAutoScalingModeConfiguration' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -43370,13 +43638,14 @@ paths: summary: Return Auto Scaling Configuration for One Sharded Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/autoScalingConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/autoGroupClusterScalingConfiguration x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: autoScalingConfiguration /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports: get: description: Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: listBackupExportJobs + operationId: listGroupClusterBackupExports parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43410,10 +43679,11 @@ paths: summary: Return All Snapshot Export Jobs tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listBackupExportJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupClusterBackupExports + x-xgen-operation-id-override: listBackupExports post: description: Exports one backup Snapshot for dedicated Atlas cluster using Cloud Backups to an Export Bucket. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: createBackupExportJob + operationId: createGroupClusterBackupExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43454,16 +43724,16 @@ paths: summary: Create One Snapshot Export Job tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createBackupExportJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createGroupClusterBackupExport + x-xgen-operation-id-override: createBackupExport x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getBackupExportJob + operation-id: createGroupClusterBackupExport params: groupId: input:groupId clusterName: input:clusterName - exportId: body:$.id expect: match: path: $.state @@ -43474,7 +43744,7 @@ paths: /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports/{exportId}: get: description: Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: getBackupExportJob + operationId: getGroupClusterBackupExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43512,11 +43782,12 @@ paths: summary: Return One Snapshot Export Job tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getBackupExportJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupExport + x-xgen-operation-id-override: getBackupExport /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs: get: description: Returns all cloud backup restore jobs for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: listBackupRestoreJobs + operationId: listGroupClusterBackupRestoreJobs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43550,13 +43821,14 @@ paths: summary: Return All Restore Jobs for One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupClusterBackupRestoreJobs + x-xgen-operation-id-override: listBackupRestoreJobs post: description: |- 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 Service Account or API Key must have the Project Backup Manager role. - operationId: createBackupRestoreJob + operationId: createGroupClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43595,14 +43867,15 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Restore One Snapshot of One Cluster + summary: Create One Restore Job of One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createGroupClusterBackupRestoreJob + x-xgen-operation-id-override: createBackupRestoreJob /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs/{restoreJobId}: delete: description: Cancels one cloud backup restore job of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: cancelBackupRestoreJob + operationId: cancelGroupClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43642,13 +43915,14 @@ paths: summary: Cancel One Restore Job for One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/cancelBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/cancelGroupClusterBackupRestoreJob x-xgen-method-verb-override: customMethod: "True" verb: cancel + x-xgen-operation-id-override: cancelBackupRestoreJob get: description: Returns one cloud backup restore job for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: getBackupRestoreJob + operationId: getGroupClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43686,11 +43960,12 @@ paths: summary: Return One Restore Job for One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupRestoreJob + x-xgen-operation-id-override: getBackupRestoreJob /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/schedule: delete: description: Removes all cloud backup schedules for the specified cluster. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: deleteAllBackupSchedules + operationId: deleteGroupClusterBackupSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43727,10 +44002,11 @@ paths: summary: Remove All Cloud Backup Schedules tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteAllBackupSchedules + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteGroupClusterBackupSchedule + x-xgen-operation-id-override: deleteClusterBackupSchedule get: description: Returns the cloud backup schedule for the specified cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getBackupSchedule + operationId: getGroupClusterBackupSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43766,13 +44042,14 @@ paths: summary: Return One Cloud Backup Schedule tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getBackupSchedule + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupSchedule x-xgen-method-verb-override: customMethod: "False" verb: get + x-xgen-operation-id-override: getBackupSchedule patch: description: Updates the cloud backup schedule for one cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateBackupSchedule + operationId: updateGroupClusterBackupSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43823,11 +44100,12 @@ paths: summary: Update Cloud Backup Schedule for One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateBackupSchedule + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateGroupClusterBackupSchedule + x-xgen-operation-id-override: updateBackupSchedule /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots: get: description: Returns all snapshots of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - operationId: listReplicaSetBackups + operationId: listGroupClusterBackupSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43863,13 +44141,14 @@ paths: summary: Return All Replica Set Cloud Backups tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listReplicaSetBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupClusterBackupSnapshots + x-xgen-operation-id-override: listBackupSnapshots post: description: |- Takes one on-demand snapshot for the specified cluster. 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 Service Account or API Key must have the Project Backup Manager role. - operationId: takeSnapshot + operationId: takeGroupClusterBackupSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43909,19 +44188,19 @@ paths: summary: Take One On-Demand Snapshot tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/takeSnapshot + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/takeGroupClusterBackupSnapshots x-xgen-method-verb-override: customMethod: "True" verb: take + x-xgen-operation-id-override: takeSnapshots x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getReplicaSetBackup + operation-id: takeGroupClusterBackupSnapshots params: groupId: input:groupId clusterName: input:clusterName - snapshotId: body:$.id expect: match: path: $.status @@ -43931,7 +44210,7 @@ paths: /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/{snapshotId}: delete: description: Removes the specified snapshot. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: deleteReplicaSetBackup + operationId: deleteGroupClusterBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43969,12 +44248,13 @@ paths: summary: Remove One Replica Set Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteReplicaSetBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteGroupClusterBackupSnapshot + x-xgen-operation-id-override: deleteClusterBackupSnapshot x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getReplicaSetBackup + operation-id: deleteGroupClusterBackupSnapshot params: groupId: input:groupId clusterName: input:clusterName @@ -43983,7 +44263,7 @@ paths: http-code: 404 get: description: Returns one snapshot from the specified cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - operationId: getReplicaSetBackup + operationId: getGroupClusterBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44009,7 +44289,7 @@ paths: schema: $ref: '#/components/schemas/DiskBackupReplicaSet' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -44025,10 +44305,11 @@ paths: summary: Return One Replica Set Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getReplicaSetBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupSnapshot + x-xgen-operation-id-override: getClusterBackupSnapshot patch: description: Changes the expiration date for one cloud backup snapshot for one cluster in the specified project, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: updateSnapshotRetention + operationId: updateGroupClusterBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44075,7 +44356,8 @@ paths: summary: Update Expiration Date for One Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateSnapshotRetention + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateGroupClusterBackupSnapshot + x-xgen-operation-id-override: updateBackupSnapshot x-xgen-atlascli: override: description: | @@ -44083,7 +44365,7 @@ paths: watcher: get: version: "2023-01-01" - operation-id: getReplicaSetBackup + operation-id: updateGroupClusterBackupSnapshot params: groupId: input:groupId clusterName: input:clusterName @@ -44097,7 +44379,7 @@ paths: /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedCluster/{snapshotId}: delete: description: Removes one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: deleteShardedClusterBackup + operationId: deleteGroupClusterBackupSnapshotShardedCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44133,10 +44415,11 @@ paths: summary: Remove One Sharded Cluster Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteShardedClusterBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteGroupClusterBackupSnapshotShardedCluster + x-xgen-operation-id-override: deleteBackupShardedCluster get: description: Returns one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - operationId: getShardedClusterBackup + operationId: getGroupClusterBackupSnapshotShardedCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44162,7 +44445,7 @@ paths: schema: $ref: '#/components/schemas/DiskBackupShardedClusterSnapshot' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -44178,11 +44461,12 @@ paths: summary: Return One Sharded Cluster Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getShardedClusterBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupSnapshotShardedCluster + x-xgen-operation-id-override: getBackupShardedCluster /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedClusters: get: description: Returns all snapshots of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - operationId: listShardedClusterBackups + operationId: listGroupClusterBackupSnapshotShardedClusters parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44215,7 +44499,8 @@ paths: summary: Return All Sharded Cluster Cloud Backups tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listShardedClusterBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupClusterBackupSnapshotShardedClusters + x-xgen-operation-id-override: listBackupShardedClusters /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/download: post: deprecated: true @@ -44226,7 +44511,7 @@ paths: externalDocs: description: downloadFlexBackup url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/downloadFlexBackup - operationId: downloadSharedClusterBackup + operationId: downloadGroupClusterBackupTenant parameters: - description: Human-readable label that identifies the cluster. in: path @@ -44269,9 +44554,10 @@ paths: summary: Download One M2 or M5 Cluster Snapshot tags: - Shared-Tier Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/downloadSharedClusterBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/downloadGroupClusterBackupTenant x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: downloadClusterBackupTenant /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restore: post: deprecated: true @@ -44282,7 +44568,7 @@ paths: externalDocs: description: createFlexBackupRestoreJob url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/createFlexBackupRestoreJob - operationId: createSharedClusterBackupRestoreJob + operationId: createGroupClusterBackupTenantRestore parameters: - description: Human-readable label that identifies the cluster. in: path @@ -44325,7 +44611,8 @@ paths: summary: Create One Restore Job for One M2 or M5 Cluster tags: - Shared-Tier Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/createSharedClusterBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/createGroupClusterBackupTenantRestore + x-xgen-operation-id-override: createBackupTenantRestore /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restores: get: deprecated: true @@ -44336,7 +44623,7 @@ paths: externalDocs: description: listFlexBackupRestoreJobs url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/listFlexBackupRestoreJobs - operationId: listSharedClusterBackupRestoreJobs + operationId: listGroupClusterBackupTenantRestores parameters: - description: Human-readable label that identifies the cluster. in: path @@ -44370,7 +44657,8 @@ paths: summary: Return All Restore Jobs for One M2 or M5 Cluster tags: - Shared-Tier Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/listSharedClusterBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/listGroupClusterBackupTenantRestores + x-xgen-operation-id-override: listBackupTenantRestores /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restores/{restoreId}: get: deprecated: true @@ -44381,7 +44669,7 @@ paths: externalDocs: description: getFlexBackupRestoreJob url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/getFlexBackupRestoreJob - operationId: getSharedClusterBackupRestoreJob + operationId: getGroupClusterBackupTenantRestore parameters: - description: Human-readable label that identifies the cluster. in: path @@ -44422,7 +44710,8 @@ paths: summary: Return One Restore Job for One M2 or M5 Cluster tags: - Shared-Tier Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/getSharedClusterBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/getGroupClusterBackupTenantRestore + x-xgen-operation-id-override: getBackupTenantRestore /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/snapshots: get: deprecated: true @@ -44433,7 +44722,7 @@ paths: externalDocs: description: listFlexBackups url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/listFlexBackups - operationId: listSharedClusterBackups + operationId: listGroupClusterBackupTenantSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44467,7 +44756,8 @@ paths: summary: Return All Snapshots for One M2 or M5 Cluster tags: - Shared-Tier Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/listSharedClusterBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/listGroupClusterBackupTenantSnapshots + x-xgen-operation-id-override: listClusterBackupSnapshots /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/snapshots/{snapshotId}: get: deprecated: true @@ -44478,7 +44768,7 @@ paths: externalDocs: description: getFlexBackup url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/getFlexBackup - operationId: getSharedClusterBackup + operationId: getGroupClusterBackupTenantSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44519,12 +44809,13 @@ paths: summary: Return One Snapshot of One M2 or M5 Cluster tags: - Shared-Tier Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/getSharedClusterBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/getGroupClusterBackupTenantSnapshot + x-xgen-operation-id-override: getBackupTenantSnapshot /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backupCheckpoints: get: deprecated: true description: Returns all legacy backup checkpoints for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listLegacyBackupCheckpoints + operationId: listGroupClusterBackupCheckpoints parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44558,12 +44849,13 @@ paths: summary: Return All Legacy Backup Checkpoints tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listLegacyBackupCheckpoints + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listGroupClusterBackupCheckpoints + x-xgen-operation-id-override: listClusterBackupCheckpoints /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backupCheckpoints/{checkpointId}: get: deprecated: true description: Returns one legacy backup checkpoint for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getLegacyBackupCheckpoint + operationId: getGroupClusterBackupCheckpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44589,7 +44881,7 @@ paths: schema: $ref: '#/components/schemas/ApiAtlasCheckpointView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -44605,11 +44897,12 @@ paths: summary: Return One Legacy Backup Checkpoint tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getLegacyBackupCheckpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getGroupClusterBackupCheckpoint + x-xgen-operation-id-override: getClusterBackupCheckpoint /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/pinned: get: description: Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. - operationId: getPinnedNamespaces + operationId: listGroupClusterCollStatPinnedNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -44641,13 +44934,14 @@ paths: summary: Return Pinned Namespaces tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getPinnedNamespaces + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/listGroupClusterCollStatPinnedNamespaces x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: listNamespaces + x-xgen-operation-id-override: listPinnedNamespaces patch: description: Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. - operationId: pinNamespacesPatch + operationId: updateGroupClusterCollStatPinnedNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -44693,17 +44987,18 @@ paths: summary: Add Pinned Namespaces tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/pinNamespacesPatch + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/updateGroupClusterCollStatPinnedNamespaces x-xgen-method-verb-override: customMethod: "True" verb: updateNamespaces + x-xgen-operation-id-override: updatePinnedNamespaces x-xgen-atlascli: override: description: | Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. put: description: Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. This initializes a pinned namespaces list or replaces any existing pinned namespaces list for the Group and Cluster. - operationId: pinNamespacesPut + operationId: pinGroupClusterCollStatPinnedNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -44749,14 +45044,15 @@ paths: summary: Pin Namespaces tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/pinNamespacesPut + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/pinGroupClusterCollStatPinnedNamespaces x-xgen-method-verb-override: customMethod: "True" verb: pinNamespaces + x-xgen-operation-id-override: pinNamespaces /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/unpin: patch: description: Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. - operationId: unpinNamespaces + operationId: unpinGroupClusterCollStatUnpinNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -44792,13 +45088,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Unpin namespaces + summary: Unpin Namespaces tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/unpinNamespaces + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/unpinGroupClusterCollStatUnpinNamespaces x-xgen-method-verb-override: customMethod: "True" verb: unpinNamespaces + x-xgen-operation-id-override: unpinNamespaces /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes: post: deprecated: true @@ -44806,7 +45103,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: createAtlasSearchIndexDeprecated + operationId: createGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44849,7 +45146,8 @@ paths: summary: Create One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createAtlasSearchIndexDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createGroupClusterFtsIndex + x-xgen-operation-id-override: createClusterFtsIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{databaseName}/{collectionName}: get: deprecated: true @@ -44857,7 +45155,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: listAtlasSearchIndexesDeprecated + operationId: listGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44890,7 +45188,7 @@ paths: $ref: '#/components/schemas/ClusterSearchIndex' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-sunset: "2026-11-30" x-xgen-version: "2023-01-01" description: OK @@ -44905,7 +45203,11 @@ paths: summary: Return All Atlas Search Indexes for One Collection tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listAtlasSearchIndexesDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listGroupClusterFtsIndex + x-xgen-method-verb-override: + customMethod: false + verb: list + x-xgen-operation-id-override: listClusterFtsIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}: delete: deprecated: true @@ -44913,7 +45215,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: deleteAtlasSearchIndexDeprecated + operationId: deleteGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44954,14 +45256,15 @@ paths: summary: Remove One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteAtlasSearchIndexDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteGroupClusterFtsIndex + x-xgen-operation-id-override: deleteClusterFtsIndex get: deprecated: true description: Returns one Atlas Search index in the specified project. You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: getAtlasSearchIndexDeprecated + operationId: getGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45002,14 +45305,15 @@ paths: summary: Return One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getAtlasSearchIndexDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getGroupClusterFtsIndex + x-xgen-operation-id-override: getClusterFtsIndex patch: deprecated: true description: Updates one Atlas Search index that you identified with its unique ID. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: updateAtlasSearchIndexDeprecated + operationId: updateGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45061,14 +45365,15 @@ paths: summary: Update One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateAtlasSearchIndexDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateGroupClusterFtsIndex + x-xgen-operation-id-override: updateClusterFtsIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites: get: description: Returns one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: getManagedNamespace + operationId: getGroupClusterGlobalWrites parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45088,20 +45393,20 @@ paths: $ref: '#/components/schemas/GeoSharding' x-sunset: "2026-11-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2023-02-01+json: schema: $ref: '#/components/schemas/GeoSharding' x-sunset: "2026-03-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-02-01" application/vnd.atlas.2024-08-05+json: schema: $ref: '#/components/schemas/GeoSharding20240805' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -45115,14 +45420,15 @@ paths: summary: Return One Managed Namespace in One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/getManagedNamespace + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/getGroupClusterGlobalWrites + x-xgen-operation-id-override: getClusterGlobalWrites /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites/customZoneMapping: delete: description: Removes all custom zone mappings for the specified global cluster. A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. Removing the custom zone mappings restores the default mapping. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: deleteAllCustomZoneMappings + operationId: deleteGroupClusterGlobalWriteCustomZoneMapping parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45163,13 +45469,14 @@ paths: summary: Remove All Custom Zone Mappings from One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/deleteAllCustomZoneMappings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/deleteGroupClusterGlobalWriteCustomZoneMapping + x-xgen-operation-id-override: deleteCustomZoneMapping post: description: Creates one custom zone mapping for the specified global cluster. A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: createCustomZoneMapping + operationId: createGroupClusterGlobalWriteCustomZoneMapping parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45226,14 +45533,15 @@ paths: summary: Add One Custom Zone Mapping to One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/createCustomZoneMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/createGroupClusterGlobalWriteCustomZoneMapping + x-xgen-operation-id-override: createCustomZoneMapping /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites/managedNamespaces: delete: description: Removes one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. Deleting a managed namespace does not remove the associated collection or data. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: deleteManagedNamespace + operationId: deleteGroupClusterGlobalWriteManagedNamespaces parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45286,13 +45594,14 @@ paths: summary: Remove One Managed Namespace from One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/deleteManagedNamespace + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/deleteGroupClusterGlobalWriteManagedNamespaces + x-xgen-operation-id-override: deleteManagedNamespaces post: description: Creates one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: createManagedNamespace + operationId: createGroupClusterGlobalWriteManagedNamespace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45351,14 +45660,15 @@ paths: summary: Create One Managed Namespace in One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/createManagedNamespace + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/createGroupClusterGlobalWriteManagedNamespace + x-xgen-operation-id-override: createManagedNamespace /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/index: post: description: Creates an index on the cluster identified by its name in a rolling manner. Creating the index in this way allows index builds on one replica set member as a standalone at a time, starting with the secondary members. Creating indexes in this way requires at least one replica set election. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Rolling Index Builds on Replica Sets url: https://docs.mongodb.com/manual/tutorial/build-indexes-on-replica-sets/ - operationId: createRollingIndex + operationId: createGroupClusterIndexRollingIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45463,14 +45773,18 @@ paths: summary: Create One Rolling Index tags: - Rolling Index - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Rolling-Index/operation/createRollingIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Rolling-Index/operation/createGroupClusterIndexRollingIndex + x-xgen-method-verb-override: + customMethod: false + verb: createRollingIndex + x-xgen-operation-id-override: createRollingIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives: get: description: Returns details of all online archives. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: listOnlineArchives + operationId: listGroupClusterOnlineArchives parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45504,13 +45818,14 @@ paths: summary: Return All Online Archives for One Cluster tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/listOnlineArchives + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/listGroupClusterOnlineArchives + x-xgen-operation-id-override: listOnlineArchives post: description: Creates one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: createOnlineArchive + operationId: createGroupClusterOnlineArchive parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45554,16 +45869,16 @@ paths: - Online Archive x-xgen-changelog: "2023-08-02": If 'criteria':'DATE' is specified, then you must specify 'DATE' values in partition fields - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/createOnlineArchive + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/createGroupClusterOnlineArchive + x-xgen-operation-id-override: createOnlineArchive x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getOnlineArchive + operation-id: createGroupClusterOnlineArchive params: groupId: input:groupId clusterName: input:clusterName - archiveId: body:$.id expect: match: path: $.state @@ -45579,7 +45894,7 @@ paths: externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: deleteOnlineArchive + operationId: deleteGroupClusterOnlineArchive parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -45615,12 +45930,13 @@ paths: summary: Remove One Online Archive tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/deleteOnlineArchive + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/deleteGroupClusterOnlineArchive + x-xgen-operation-id-override: deleteOnlineArchive x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getOnlineArchive + operation-id: deleteGroupClusterOnlineArchive params: groupId: input:groupId clusterName: input:clusterName @@ -45632,7 +45948,7 @@ paths: externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: getOnlineArchive + operationId: getGroupClusterOnlineArchive parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45658,7 +45974,7 @@ paths: schema: $ref: '#/components/schemas/BackupOnlineArchive' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -45674,13 +45990,14 @@ paths: summary: Return One Online Archive tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/getOnlineArchive + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/getGroupClusterOnlineArchive + x-xgen-operation-id-override: getOnlineArchive patch: description: Updates, pauses, or resumes one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: updateOnlineArchive + operationId: updateGroupClusterOnlineArchive parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45729,12 +46046,13 @@ paths: summary: Update One Online Archive tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/updateOnlineArchive + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/updateGroupClusterOnlineArchive + x-xgen-operation-id-override: updateOnlineArchive x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getOnlineArchive + operation-id: updateGroupClusterOnlineArchive params: groupId: input:groupId clusterName: input:clusterName @@ -45754,7 +46072,7 @@ paths: externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: downloadOnlineArchiveQueryLogs + operationId: downloadGroupClusterOnlineArchiveQueryLogs parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -45814,17 +46132,18 @@ paths: summary: Download Online Archive Query Logs tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/downloadOnlineArchiveQueryLogs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/downloadGroupClusterOnlineArchiveQueryLogs x-xgen-method-verb-override: customMethod: "True" verb: download + x-xgen-operation-id-override: downloadQueryLogs /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/outageSimulation: delete: description: Ends a cluster outage simulation. externalDocs: description: Cluster Outage Simulation url: https://dochub.mongodb.org/core/test-regional-outage - operationId: endOutageSimulation + operationId: endGroupClusterOutageSimulation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45857,15 +46176,16 @@ paths: summary: End One Outage Simulation tags: - Cluster Outage Simulation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/endOutageSimulation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/endGroupClusterOutageSimulation x-xgen-method-verb-override: customMethod: "True" verb: end + x-xgen-operation-id-override: endOutageSimulation x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getOutageSimulation + operation-id: endGroupClusterOutageSimulation params: groupId: input:groupId clusterName: input:clusterName @@ -45876,7 +46196,7 @@ paths: externalDocs: description: Cluster Outage Simulation url: https://dochub.mongodb.org/core/test-regional-outage - operationId: getOutageSimulation + operationId: getGroupClusterOutageSimulation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45913,16 +46233,17 @@ paths: summary: Return One Outage Simulation tags: - Cluster Outage Simulation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/getOutageSimulation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/getGroupClusterOutageSimulation x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getOutageSimulation post: description: Starts a cluster outage simulation. externalDocs: description: Cluster Outage Simulation url: https://dochub.mongodb.org/core/test-regional-outage - operationId: startOutageSimulation + operationId: startGroupClusterOutageSimulation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45962,15 +46283,16 @@ paths: summary: Start One Outage Simulation tags: - Cluster Outage Simulation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/startOutageSimulation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/startGroupClusterOutageSimulation x-xgen-method-verb-override: customMethod: "True" verb: start + x-xgen-operation-id-override: startOutageSimulation x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getOutageSimulation + operation-id: startGroupClusterOutageSimulation params: groupId: input:groupId clusterName: input:clusterName @@ -45982,7 +46304,7 @@ paths: /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/dropIndexSuggestions: get: description: Returns the indexes that the Performance Advisor suggests to drop. The Performance Advisor suggests dropping unused, redundant, and hidden indexes to improve write performance and increase storage space. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDropIndexes + operationId: listGroupClusterPerformanceAdvisorDropIndexSuggestions parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -46015,11 +46337,12 @@ paths: summary: Return All Suggested Indexes to Drop tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listDropIndexes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupClusterPerformanceAdvisorDropIndexSuggestions + x-xgen-operation-id-override: listDropIndexSuggestions /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/schemaAdvice: get: description: Returns the schema suggestions that the Performance Advisor detects. The Performance Advisor provides holistic schema recommendations for your cluster by sampling documents in your most active collections and collections with slow-running queries. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listSchemaAdvice + operationId: listGroupClusterPerformanceAdvisorSchemaAdvice parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -46052,11 +46375,12 @@ paths: summary: Return Schema Advice tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listSchemaAdvice + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupClusterPerformanceAdvisorSchemaAdvice + x-xgen-operation-id-override: listSchemaAdvice /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/suggestedIndexes: get: description: Returns the indexes that the Performance Advisor suggests. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listClusterSuggestedIndexes + operationId: listGroupClusterPerformanceAdvisorSuggestedIndexes parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -46132,14 +46456,15 @@ paths: summary: Return All Suggested Indexes tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listClusterSuggestedIndexes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupClusterPerformanceAdvisorSuggestedIndexes + x-xgen-operation-id-override: listClusterSuggestedIndexes /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/processArgs: get: description: Returns the advanced configuration details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. This feature isn't available for `M0` free clusters, `M2` and `M5` shared-tier clusters, flex clusters, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: getClusterAdvancedConfiguration + operationId: getGroupClusterProcessArgs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46159,13 +46484,13 @@ paths: $ref: '#/components/schemas/ClusterDescriptionProcessArgs' x-sunset: "2026-03-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2024-08-05+json: schema: $ref: '#/components/schemas/ClusterDescriptionProcessArgs20240805' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "400": @@ -46181,13 +46506,14 @@ paths: summary: Return Advanced Configuration Options for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getClusterAdvancedConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getGroupClusterProcessArgs + x-xgen-operation-id-override: getProcessArgs patch: description: Updates the advanced configuration details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. This feature isn't available for `M0` free clusters, `M2` and `M5` shared-tier clusters, flex clusters, or serverless clusters. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: updateClusterAdvancedConfiguration + operationId: updateGroupClusterProcessArgs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46237,7 +46563,8 @@ paths: summary: Update Advanced Configuration Options for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/updateClusterAdvancedConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/updateGroupClusterProcessArgs + x-xgen-operation-id-override: updateProcessArgs /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/queryShapeInsights/{queryShapeHash}/details: get: description: Returns the metadata and statistics summary for a given query shape hash. @@ -46320,10 +46647,11 @@ paths: tags: - Query Shape Insights x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Query-Shape-Insights/operation/getGroupClusterQueryShapeInsightDetails + x-xgen-operation-id-override: getQueryShapeDetails /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/queryShapeInsights/summaries: get: description: Returns a list of query shape statistics summaries for a given cluster. Query shape statistics provide performance insights about MongoDB queries, helping users identify problematic query patterns and potential optimizations. - operationId: getGroupClusterQueryShapeInsightSummaries + operationId: listGroupClusterQueryShapeInsightSummaries parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -46463,11 +46791,12 @@ paths: summary: Return Query Statistic Summaries tags: - Query Shape Insights - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Query-Shape-Insights/operation/getGroupClusterQueryShapeInsightSummaries + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Query-Shape-Insights/operation/listGroupClusterQueryShapeInsightSummaries + x-xgen-operation-id-override: listQueryShapeSummaries /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restartPrimaries: post: description: Starts a failover test for the specified cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. A failover test checks how MongoDB Cloud handles the failure of the cluster's primary node. During the test, MongoDB Cloud shuts down the primary node and elects a new primary. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. - operationId: testFailover + operationId: restartGroupClusterPrimaries parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46499,9 +46828,10 @@ paths: summary: Test Failover for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/testFailover + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/restartGroupClusterPrimaries x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: restartPrimaries /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restoreJobs: get: deprecated: true @@ -46512,7 +46842,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: listLegacyBackupRestoreJobs + operationId: listGroupClusterRestoreJobs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46554,14 +46884,15 @@ paths: summary: Return All Legacy Backup Restore Jobs tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listLegacyBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listGroupClusterRestoreJobs + x-xgen-operation-id-override: listClusterRestoreJobs post: deprecated: true description: Restores one legacy backup for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This endpoint doesn't support creating checkpoint restore jobs for sharded clusters, or creating restore jobs for queryable backup snapshots. If you create an automated restore job by specifying `delivery.methodName` of `AUTOMATED_RESTORE` in your request body, MongoDB Cloud removes all existing data on the target cluster prior to the restore. externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: createLegacyBackupRestoreJob + operationId: createGroupClusterRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46601,7 +46932,8 @@ paths: summary: Create One Legacy Backup Restore Job tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/createLegacyBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/createGroupClusterRestoreJob + x-xgen-operation-id-override: createClusterRestoreJob /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restoreJobs/{jobId}: get: deprecated: true @@ -46612,7 +46944,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: getLegacyBackupRestoreJob + operationId: getGroupClusterRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46638,8 +46970,8 @@ paths: schema: $ref: '#/components/schemas/BackupRestoreJob' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: API predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-response-has-no-input-fields: API predates IPA validation. + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -46655,11 +46987,12 @@ paths: summary: Return One Legacy Backup Restore Job tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getLegacyBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getGroupClusterRestoreJob + x-xgen-operation-id-override: getClusterRestoreJob /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment: delete: description: Deletes the Search Nodes for the specified cluster. - operationId: deleteAtlasSearchDeployment + operationId: deleteGroupClusterSearchDeployment parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -46698,12 +47031,13 @@ paths: summary: Delete Search Nodes tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteAtlasSearchDeployment + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteGroupClusterSearchDeployment + x-xgen-operation-id-override: deleteClusterSearchDeployment x-xgen-atlascli: watcher: get: version: "2024-05-30" - operation-id: getAtlasSearchDeployment + operation-id: deleteGroupClusterSearchDeployment params: clusterName: input:clusterName groupId: input:groupId @@ -46711,7 +47045,7 @@ paths: http-code: 404 get: description: Returns the Search Nodes for the specified cluster. - operationId: getAtlasSearchDeployment + operationId: getGroupClusterSearchDeployment parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -46756,13 +47090,14 @@ paths: - Atlas Search x-xgen-changelog: "2025-03-12": Updates the return of the API when no nodes exist, the endpoint returns 200 with an empty JSON ({}) instead of 400. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getAtlasSearchDeployment + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getGroupClusterSearchDeployment x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getClusterSearchDeployment patch: description: Updates the Search Nodes for the specified cluster. - operationId: updateAtlasSearchDeployment + operationId: updateGroupClusterSearchDeployment parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -46812,12 +47147,13 @@ paths: summary: Update Search Nodes tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateAtlasSearchDeployment + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateGroupClusterSearchDeployment + x-xgen-operation-id-override: updateClusterSearchDeployment x-xgen-atlascli: watcher: get: version: "2024-05-30" - operation-id: getAtlasSearchDeployment + operation-id: updateGroupClusterSearchDeployment params: clusterName: input:clusterName groupId: input:groupId @@ -46828,7 +47164,7 @@ paths: - IDLE post: description: Creates Search Nodes for the specified cluster. - operationId: createAtlasSearchDeployment + operationId: createGroupClusterSearchDeployment parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -46881,12 +47217,13 @@ paths: summary: Create Search Nodes tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createAtlasSearchDeployment + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createGroupClusterSearchDeployment + x-xgen-operation-id-override: createClusterSearchDeployment x-xgen-atlascli: watcher: get: version: "2024-05-30" - operation-id: getAtlasSearchDeployment + operation-id: updateGroupClusterSearchDeployment params: clusterName: input:clusterName groupId: input:groupId @@ -46901,7 +47238,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: listAtlasSearchIndexesCluster + operationId: listGroupClusterSearchIndexes parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46922,7 +47259,7 @@ paths: $ref: '#/components/schemas/SearchIndexResponse' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2024-05-30" description: OK "400": @@ -46944,13 +47281,14 @@ paths: summary: Return All Atlas Search Indexes for One Cluster tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listAtlasSearchIndexesCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listGroupClusterSearchIndexes + x-xgen-operation-id-override: listClusterSearchIndexes post: description: Creates one Atlas Search index on the specified collection. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: createAtlasSearchIndex + operationId: createGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46992,14 +47330,15 @@ paths: summary: Create One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createAtlasSearchIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createGroupClusterSearchIndex + x-xgen-operation-id-override: createClusterSearchIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}: get: description: Returns all Atlas Search indexes on the specified collection. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: listAtlasSearchIndexes + operationId: listGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47032,7 +47371,7 @@ paths: $ref: '#/components/schemas/SearchIndexResponse' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2024-05-30" description: OK "400": @@ -47054,14 +47393,18 @@ paths: summary: Return All Atlas Search Indexes for One Collection tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listAtlasSearchIndexes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listGroupClusterSearchIndex + x-xgen-method-verb-override: + customMethod: false + verb: list + x-xgen-operation-id-override: listSearchIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}/{indexName}: delete: description: Removes one Atlas Search index that you identified with its database, collection, and name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: deleteAtlasSearchIndexByName + operationId: deleteGroupClusterSearchIndexByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47110,13 +47453,17 @@ paths: summary: Remove One Atlas Search Index by Name tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteAtlasSearchIndexByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteGroupClusterSearchIndexByName + x-xgen-method-verb-override: + customMethod: true + verb: deleteByName + x-xgen-operation-id-override: deleteIndexByName get: description: Returns one Atlas Search index in the specified project. You identify this index using its database, collection and name. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: getAtlasSearchIndexByName + operationId: getGroupClusterSearchIndexByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47167,10 +47514,11 @@ paths: summary: Return One Atlas Search Index by Name tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getAtlasSearchIndexByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getGroupClusterSearchIndexByName x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: getByName + x-xgen-operation-id-override: getIndexByName x-xgen-atlascli: override: description: | @@ -47180,7 +47528,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: updateAtlasSearchIndexByName + operationId: updateGroupClusterSearchIndexByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47240,17 +47588,18 @@ paths: summary: Update One Atlas Search Index by Name tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateAtlasSearchIndexByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateGroupClusterSearchIndexByName x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: updateByName + x-xgen-operation-id-override: updateIndexByName /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{indexId}: delete: description: Removes one Atlas Search index that you identified with its unique ID. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: deleteAtlasSearchIndex + operationId: deleteGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47290,13 +47639,14 @@ paths: summary: Remove One Atlas Search Index by ID tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteAtlasSearchIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteGroupClusterSearchIndex + x-xgen-operation-id-override: deleteClusterSearchIndex get: description: Returns one Atlas Search index in the specified project. You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: getAtlasSearchIndex + operationId: getGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47344,7 +47694,8 @@ paths: summary: Return One Atlas Search Index by ID tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getAtlasSearchIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getGroupClusterSearchIndex + x-xgen-operation-id-override: getClusterSearchIndex x-xgen-atlascli: override: description: | @@ -47354,7 +47705,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: updateAtlasSearchIndex + operationId: updateGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47405,7 +47756,8 @@ paths: summary: Update One Atlas Search Index by ID tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateAtlasSearchIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateGroupClusterSearchIndex + x-xgen-operation-id-override: updateClusterSearchIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshotSchedule: get: deprecated: true @@ -47416,7 +47768,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: getLegacySnapshotSchedule + operationId: getGroupClusterSnapshotSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47435,7 +47787,7 @@ paths: schema: $ref: '#/components/schemas/ApiAtlasSnapshotScheduleView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -47449,7 +47801,8 @@ paths: summary: Return One Snapshot Schedule tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getLegacySnapshotSchedule + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getGroupClusterSnapshotSchedule + x-xgen-operation-id-override: getClusterSnapshotSchedule patch: deprecated: true description: |- @@ -47459,7 +47812,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: updateLegacySnapshotSchedule + operationId: updateGroupClusterSnapshotSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -47499,7 +47852,8 @@ paths: summary: Update Snapshot Schedule for One Cluster tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/updateLegacySnapshotSchedule + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/updateGroupClusterSnapshotSchedule + x-xgen-operation-id-override: updateClusterSnapshotSchedule /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshots: get: deprecated: true @@ -47507,7 +47861,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: listLegacySnapshots + operationId: listGroupClusterSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47551,7 +47905,8 @@ paths: summary: Return All Legacy Backup Snapshots tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listLegacySnapshots + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listGroupClusterSnapshots + x-xgen-operation-id-override: listClusterSnapshots /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshots/{snapshotId}: delete: deprecated: true @@ -47559,7 +47914,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: deleteLegacySnapshot + operationId: deleteGroupClusterSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47597,14 +47952,15 @@ paths: summary: Remove One Legacy Backup Snapshot tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/deleteLegacySnapshot + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/deleteGroupClusterSnapshot + x-xgen-operation-id-override: deleteClusterSnapshot get: deprecated: true description: Returns one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: getLegacySnapshot + operationId: getGroupClusterSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47630,7 +47986,7 @@ paths: schema: $ref: '#/components/schemas/BackupSnapshot' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -47644,14 +48000,15 @@ paths: summary: Return One Legacy Backup Snapshot tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getLegacySnapshot + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getGroupClusterSnapshot + x-xgen-operation-id-override: getClusterSnapshot patch: deprecated: true description: Changes the expiration date for one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: updateLegacySnapshotRetention + operationId: updateGroupClusterSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47696,11 +48053,12 @@ paths: summary: Update Expiration Date for One Legacy Backup Snapshot tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/updateLegacySnapshotRetention + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/updateGroupClusterSnapshot + x-xgen-operation-id-override: updateClusterSnapshot /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/status: get: description: Returns the status of all changes that you made to the specified cluster in the specified project. Use this resource to check the progress MongoDB Cloud has made in processing your changes. The response does not include the deployment of new dedicated clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getClusterStatus + operationId: getGroupClusterStatus parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47719,7 +48077,7 @@ paths: schema: $ref: '#/components/schemas/ClusterStatus' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -47733,11 +48091,12 @@ paths: summary: Return Status of All Cluster Operations tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getClusterStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getGroupClusterStatus + x-xgen-operation-id-override: getClusterStatus /api/atlas/v2/groups/{groupId}/clusters/{clusterName}:grantMongoDBEmployeeAccess: post: description: Grants MongoDB employee cluster access for the given duration and at the specified level for one cluster. - operationId: grantMongoDbEmployeeAccess + operationId: grantGroupClusterMongoDbEmployeeAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -47778,11 +48137,12 @@ paths: summary: Grant MongoDB Employee Cluster Access for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/grantMongoDbEmployeeAccess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/grantGroupClusterMongoDbEmployeeAccess + x-xgen-operation-id-override: grantMongoEmployeeAccess /api/atlas/v2/groups/{groupId}/clusters/{clusterName}:pinFeatureCompatibilityVersion: post: description: Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. If an FCV pin already exists for the cluster, calling this method will only update the expiration date of the existing pin and will not repin the FCV. - operationId: pinFeatureCompatibilityVersion + operationId: pinGroupClusterFeatureCompatibilityVersion parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -47822,11 +48182,12 @@ paths: summary: Pin Feature Compatibility Version for One Cluster in One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/pinFeatureCompatibilityVersion + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/pinGroupClusterFeatureCompatibilityVersion + x-xgen-operation-id-override: pinFeatureCompatibilityVersion /api/atlas/v2/groups/{groupId}/clusters/{clusterName}:revokeMongoDBEmployeeAccess: post: description: Revokes a previously granted MongoDB employee cluster access. - operationId: revokeMongoDbEmployeeAccess + operationId: revokeGroupClusterMongoDbEmployeeAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -47859,11 +48220,12 @@ paths: summary: Revoke MongoDB Employee Cluster Access for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/revokeMongoDbEmployeeAccess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/revokeGroupClusterMongoDbEmployeeAccess + x-xgen-operation-id-override: revokeMongoEmployeeAccess /api/atlas/v2/groups/{groupId}/clusters/{clusterName}:unpinFeatureCompatibilityVersion: post: description: Unpins the current fixed Feature Compatibility Version (FCV). This feature is not available for clusters on rapid release. - operationId: unpinFeatureCompatibilityVersion + operationId: unpinGroupClusterFeatureCompatibilityVersion parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47898,11 +48260,12 @@ paths: summary: Unpin Feature Compatibility Version for One Cluster in One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/unpinFeatureCompatibilityVersion + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/unpinGroupClusterFeatureCompatibilityVersion + x-xgen-operation-id-override: unpinFeatureCompatibilityVersion /api/atlas/v2/groups/{groupId}/clusters/{hostName}/logs/{logName}.gz: get: description: 'Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. MongoDB updates process and audit logs from the cluster backend infrastructure every five minutes. Logs are stored in chunks approximately five minutes in length, but this duration may vary. If you poll the API for log files, we recommend polling every five minutes even though consecutive polls could contain some overlapping logs. This feature isn''t available for `M0` free clusters, `M2`, `M5`, flex, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip".' - operationId: getHostLogs + operationId: downloadGroupClusterLog parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47988,10 +48351,11 @@ paths: summary: Download Logs for One Cluster Host in One Project tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getHostLogs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/downloadGroupClusterLog x-xgen-method-verb-override: customMethod: "True" verb: download + x-xgen-operation-id-override: downloadClusterLog requestBody: content: application/vnd.atlas.2023-02-01+gzip: @@ -48003,7 +48367,7 @@ paths: /api/atlas/v2/groups/{groupId}/clusters/provider/regions: get: description: Returns the list of regions available for the specified cloud provider at the specified tier. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listCloudProviderRegions + operationId: listGroupClusterProviderRegions parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48042,14 +48406,15 @@ paths: summary: Return All Cloud Provider Regions tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listCloudProviderRegions + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listGroupClusterProviderRegions + x-xgen-operation-id-override: listClusterProviderRegions /api/atlas/v2/groups/{groupId}/clusters/tenantUpgrade: post: description: "Upgrades a shared-tier cluster to a Flex or Dedicated (M10+) cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. Each project supports up to 25 clusters. \n\nThis endpoint can also be used to upgrade Flex clusters that were created using the [createCluster](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/createCluster) API or former M2/M5 clusters that have been migrated to Flex clusters, using instanceSizeName to “M2” or “M5” until January 2026. This functionality will be available until January 2026, after which it will only be available for M0 clusters. Please use the upgradeFlexCluster endpoint instead." externalDocs: description: upgradeFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/upgradeFlexCluster - operationId: upgradeSharedCluster + operationId: upgradeGroupClusterTenantUpgrade parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48086,10 +48451,11 @@ paths: summary: Upgrade One Shared-Tier Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/upgradeSharedCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/upgradeGroupClusterTenantUpgrade x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: upgrade + x-xgen-operation-id-override: upgradeTenantUpgrade /api/atlas/v2/groups/{groupId}/clusters/tenantUpgradeToServerless: post: deprecated: true @@ -48100,7 +48466,7 @@ paths: externalDocs: description: upgradeFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/upgradeFlexCluster - operationId: upgradeSharedClusterToServerless + operationId: upgradeGroupClusterTenantUpgradeToServerless parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48138,14 +48504,15 @@ paths: summary: Upgrade One Shared-Tier Cluster to One Serverless Instance tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/upgradeSharedClusterToServerless + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/upgradeGroupClusterTenantUpgradeToServerless x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: upgrade + x-xgen-operation-id-override: upgradeClusterToServerless /api/atlas/v2/groups/{groupId}/collStats/metrics: get: description: Returns all available Coll Stats Latency metric names and their respective units for the specified project at the time of request. - operationId: getCollStatsLatencyNamespaceMetrics + operationId: listGroupCollStatMetrics parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -48165,14 +48532,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return all metric names + summary: Return All Metric Names tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespaceMetrics + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/listGroupCollStatMetrics + x-xgen-operation-id-override: listCollStatMetrics /api/atlas/v2/groups/{groupId}/containers: get: description: Returns details about all network peering containers in the specified project for the specified cloud provider. If you do not specify the cloud provider, MongoDB Cloud returns details about all network peering containers in the project for Amazon Web Services (AWS). To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPeeringContainerByCloudProvider + operationId: listGroupContainers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48192,7 +48560,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. responses: "200": content: @@ -48212,10 +48580,10 @@ paths: summary: Return All Network Peering Containers in One Project for One Cloud Provider tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listPeeringContainerByCloudProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listGroupContainers post: description: Creates one new network peering container in the specified project. MongoDB Cloud can deploy Network Peering connections in a network peering container. GCP can have one container per project. AWS and Azure can have one container per cloud provider region. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createPeeringContainer + operationId: createGroupContainer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48250,11 +48618,11 @@ paths: summary: Create One Network Peering Container tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/createPeeringContainer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/createGroupContainer /api/atlas/v2/groups/{groupId}/containers/{containerId}: delete: description: Removes one network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deletePeeringContainer + operationId: deleteGroupContainer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48288,10 +48656,10 @@ paths: summary: Remove One Network Peering Container tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/deletePeeringContainer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/deleteGroupContainer get: description: Returns details about one network peering container in one specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPeeringContainer + operationId: getGroupContainer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48311,7 +48679,7 @@ paths: schema: $ref: '#/components/schemas/CloudProviderContainer' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -48325,10 +48693,10 @@ paths: summary: Return One Network Peering Container tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/getPeeringContainer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/getGroupContainer patch: description: Updates the network details and labels of one specified network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updatePeeringContainer + operationId: updateGroupContainer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48371,11 +48739,11 @@ paths: summary: Update One Network Peering Container tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/updatePeeringContainer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/updateGroupContainer /api/atlas/v2/groups/{groupId}/containers/all: get: description: Returns details about all network peering containers in the specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPeeringContainers + operationId: listGroupContainerAll parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48402,14 +48770,14 @@ paths: summary: Return All Network Peering Containers in One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listPeeringContainers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listGroupContainerAll x-xgen-method-verb-override: customMethod: "False" verb: list /api/atlas/v2/groups/{groupId}/customDBRoles/roles: get: description: Returns all custom roles for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listCustomDatabaseRoles + operationId: listGroupCustomDbRoleRoles parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48423,7 +48791,7 @@ paths: $ref: '#/components/schemas/UserCustomDBRole' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -48437,10 +48805,11 @@ paths: summary: Return All Custom Roles in One Project tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/listCustomDatabaseRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/listGroupCustomDbRoleRoles + x-xgen-operation-id-override: listCustomDbRoles post: description: Creates one custom role in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: createCustomDatabaseRole + operationId: createGroupCustomDbRoleRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48475,11 +48844,12 @@ paths: summary: Create One Custom Role tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/createCustomDatabaseRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/createGroupCustomDbRoleRole + x-xgen-operation-id-override: createCustomDbRole /api/atlas/v2/groups/{groupId}/customDBRoles/roles/{roleName}: delete: description: Removes one custom role from the specified project. You can't remove a custom role that would leave one or more child roles with no parent roles or actions. You also can't remove a custom role that would leave one or more database users without roles. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: deleteCustomDatabaseRole + operationId: deleteGroupCustomDbRoleRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48511,10 +48881,11 @@ paths: summary: Remove One Custom Role from One Project tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/deleteCustomDatabaseRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/deleteGroupCustomDbRoleRole + x-xgen-operation-id-override: deleteCustomDbRole get: description: Returns one custom role for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getCustomDatabaseRole + operationId: getGroupCustomDbRoleRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48544,10 +48915,11 @@ paths: summary: Return One Custom Role in One Project tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/getCustomDatabaseRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/getGroupCustomDbRoleRole + x-xgen-operation-id-override: getCustomDbRole patch: description: Updates one custom role in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: updateCustomDatabaseRole + operationId: updateGroupCustomDbRoleRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48588,11 +48960,12 @@ paths: summary: Update One Custom Role in One Project tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/updateCustomDatabaseRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/updateGroupCustomDbRoleRole + x-xgen-operation-id-override: updateCustomDbRole /api/atlas/v2/groups/{groupId}/dataFederation: get: description: Returns the details of all federated database instances in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or higher role. - operationId: listFederatedDatabases + operationId: listGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48615,11 +48988,11 @@ paths: $ref: '#/components/schemas/DataLakeTenant' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -48633,10 +49006,11 @@ paths: summary: Return All Federated Database Instances in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listFederatedDatabases + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listGroupDataFederation + x-xgen-operation-id-override: listDataFederation post: description: Creates one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - operationId: createFederatedDatabase + operationId: createGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48675,11 +49049,12 @@ paths: summary: Create One Federated Database Instance in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createFederatedDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createGroupDataFederation + x-xgen-operation-id-override: createDataFederation /api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}: delete: description: Removes one federated database instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - operationId: deleteFederatedDatabase + operationId: deleteGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48707,10 +49082,11 @@ paths: summary: Remove One Federated Database Instance from One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteFederatedDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteGroupDataFederation + x-xgen-operation-id-override: deleteDataFederation get: description: Returns the details of one federated database instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - operationId: getFederatedDatabase + operationId: getGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48727,8 +49103,8 @@ paths: schema: $ref: '#/components/schemas/DataLakeTenant' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation. + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -48744,10 +49120,11 @@ paths: summary: Return One Federated Database Instance in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getFederatedDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getGroupDataFederation + x-xgen-operation-id-override: getDataFederation patch: description: Updates the details of one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or higher role. - operationId: updateFederatedDatabase + operationId: updateGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48792,11 +49169,12 @@ paths: summary: Update One Federated Database Instance in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/updateFederatedDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/updateGroupDataFederation + x-xgen-operation-id-override: updateDataFederation /api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits: get: description: Returns query limits for a federated databases instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: returnFederatedDatabaseQueryLimits + operationId: listGroupDataFederationLimits parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48816,11 +49194,11 @@ paths: $ref: '#/components/schemas/DataFederationTenantQueryLimit' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -48834,11 +49212,12 @@ paths: summary: Return All Query Limits for One Federated Database Instance tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/returnFederatedDatabaseQueryLimits + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listGroupDataFederationLimits + x-xgen-operation-id-override: listDataFederationLimits /api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits/{limitName}: delete: description: Deletes one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteOneDataFederationInstanceQueryLimit + operationId: deleteGroupDataFederationLimit parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48886,10 +49265,11 @@ paths: summary: Delete One Query Limit for One Federated Database Instance tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteOneDataFederationInstanceQueryLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteGroupDataFederationLimit + x-xgen-operation-id-override: deleteDataFederationLimit get: description: Returns the details of one query limit for the specified federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: returnFederatedDatabaseQueryLimit + operationId: getGroupDataFederationLimit parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48926,7 +49306,7 @@ paths: schema: $ref: '#/components/schemas/DataFederationTenantQueryLimit' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -48940,10 +49320,11 @@ paths: summary: Return One Federated Database Instance Query Limit for One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/returnFederatedDatabaseQueryLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getGroupDataFederationLimit + x-xgen-operation-id-override: getDataFederationLimit patch: description: Creates or updates one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createOneDataFederationQueryLimit + operationId: setGroupDataFederationLimit parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49000,14 +49381,15 @@ paths: summary: Configure One Query Limit for One Federated Database Instance tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createOneDataFederationQueryLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/setGroupDataFederationLimit x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: set + x-xgen-operation-id-override: setDataFederationLimit /api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/queryLogs.gz: get: description: 'Downloads the query logs for the specified federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Data Access Read Write roles. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip".' - operationId: downloadFederatedDatabaseQueryLogs + operationId: downloadGroupDataFederationQueryLogs parameters: - $ref: '#/components/parameters/groupId' - description: Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. @@ -49057,14 +49439,15 @@ paths: summary: Download Query Logs for One Federated Database Instance tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/downloadFederatedDatabaseQueryLogs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/downloadGroupDataFederationQueryLogs x-xgen-method-verb-override: customMethod: "True" verb: download + x-xgen-operation-id-override: downloadFederationQueryLogs /api/atlas/v2/groups/{groupId}/databaseUsers: get: description: Returns all database users that belong to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDatabaseUsers + operationId: listGroupDatabaseUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49091,13 +49474,14 @@ paths: summary: Return All Database Users in One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/listDatabaseUsers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/listGroupDatabaseUsers + x-xgen-operation-id-override: listDatabaseUsers post: description: Creates one database user in the specified project. This MongoDB Cloud supports a maximum of 100 database users per project. If you require more than 100 database users on a project, contact Support. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. externalDocs: description: Contact MongoDB Support url: https://cloud.mongodb.com/support - operationId: createDatabaseUser + operationId: createGroupDatabaseUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49223,11 +49607,12 @@ paths: summary: Create One Database User in One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/createDatabaseUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/createGroupDatabaseUser + x-xgen-operation-id-override: createDatabaseUser /api/atlas/v2/groups/{groupId}/databaseUsers/{databaseName}/{username}: delete: description: Removes one database user from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: deleteDatabaseUser + operationId: deleteGroupDatabaseUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49259,9 +49644,9 @@ paths: example: 'SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName' type: string x-xgen-IPA-exception: - xgen-IPA-117-description-must-not-use-html: Description predates IPA validation + xgen-IPA-117-description-must-not-use-html: Description predates IPA validation. xgen-IPA-117-description-should-not-use-inline-links: Parameters don't support externalDocs - xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation + xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation. responses: "204": content: @@ -49279,10 +49664,11 @@ paths: summary: Remove One Database User from One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/deleteDatabaseUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/deleteGroupDatabaseUser + x-xgen-operation-id-override: deleteDatabaseUser get: description: Returns one database user that belong to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getDatabaseUser + operationId: getGroupDatabaseUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49314,9 +49700,9 @@ paths: example: 'SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName' type: string x-xgen-IPA-exception: - xgen-IPA-117-description-must-not-use-html: Description predates IPA validation + xgen-IPA-117-description-must-not-use-html: Description predates IPA validation. xgen-IPA-117-description-should-not-use-inline-links: Parameters don't support externalDocs - xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation + xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation. responses: "200": content: @@ -49336,10 +49722,11 @@ paths: summary: Return One Database User from One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/getDatabaseUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/getGroupDatabaseUser + x-xgen-operation-id-override: getDatabaseUser patch: description: Updates one database user that belongs to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: updateDatabaseUser + operationId: updateGroupDatabaseUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49371,9 +49758,9 @@ paths: example: 'SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName' type: string x-xgen-IPA-exception: - xgen-IPA-117-description-must-not-use-html: Description predates IPA validation + xgen-IPA-117-description-must-not-use-html: Description predates IPA validation. xgen-IPA-117-description-should-not-use-inline-links: Parameters don't support externalDocs - xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation + xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation. requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -49404,11 +49791,12 @@ paths: summary: Update One Database User in One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/updateDatabaseUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/updateGroupDatabaseUser + x-xgen-operation-id-override: updateDatabaseUser /api/atlas/v2/groups/{groupId}/databaseUsers/{username}/certs: get: description: Returns all unexpired X.509 certificates for the specified MongoDB user. This MongoDB user belongs to one project. Atlas manages these certificates and the MongoDB user. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDatabaseUserCertificates + operationId: listGroupDatabaseUserCerts parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49443,7 +49831,8 @@ paths: summary: Return All X.509 Certificates Assigned to One Database User tags: - X.509 Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/listDatabaseUserCertificates + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/listGroupDatabaseUserCerts + x-xgen-operation-id-override: listDatabaseUserCerts post: description: |- Generates one X.509 certificate for the specified MongoDB user. Atlas manages the certificate and MongoDB user that belong to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -49454,7 +49843,7 @@ paths: externalDocs: description: Self-Managed X.509 url: https://www.mongodb.com/docs/atlas/security-self-managed-x509/#std-label-self-managed-x509 - operationId: createDatabaseUserCertificate + operationId: createGroupDatabaseUserCert parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49496,14 +49885,15 @@ paths: summary: Create One X.509 Certificate for One Database User tags: - X.509 Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/createDatabaseUserCertificate + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/createGroupDatabaseUserCert + x-xgen-operation-id-override: createDatabaseUserCert /api/atlas/v2/groups/{groupId}/dbAccessHistory/clusters/{clusterName}: get: description: 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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. externalDocs: description: Database Access History url: https://docs.atlas.mongodb.com/access-tracking/ - operationId: listAccessLogsByClusterName + operationId: getGroupDbAccessHistoryCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49570,14 +49960,15 @@ paths: summary: Return Database Access History for One Cluster by Cluster Name tags: - Access Tracking - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/listAccessLogsByClusterName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/getGroupDbAccessHistoryCluster + x-xgen-operation-id-override: getAccessHistoryCluster /api/atlas/v2/groups/{groupId}/dbAccessHistory/processes/{hostname}: get: description: 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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. externalDocs: description: Database Access History url: https://docs.atlas.mongodb.com/access-tracking/ - operationId: listAccessLogsByHostname + operationId: getGroupDbAccessHistoryProcess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49641,14 +50032,15 @@ paths: summary: Return Database Access History for One Cluster by Hostname tags: - Access Tracking - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/listAccessLogsByHostname + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/getGroupDbAccessHistoryProcess + x-xgen-operation-id-override: getAccessHistoryProcess /api/atlas/v2/groups/{groupId}/encryptionAtRest: get: description: |- Returns the configuration for encryption at rest using the keys you manage through your cloud provider. MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. **LIMITED TO M10 OR GREATER:** MongoDB Cloud limits this feature to dedicated cluster tiers of M10 and greater. - operationId: getEncryptionAtRest + operationId: getGroupEncryptionAtRest parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49660,8 +50052,8 @@ paths: schema: $ref: '#/components/schemas/EncryptionAtRest' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation. + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -49672,16 +50064,17 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Configuration for Encryption at Rest using Customer-Managed Keys for One Project + summary: Return One Configuration for Encryption at Rest Using Customer-Managed Keys for One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getEncryptionAtRest + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getGroupEncryptionAtRest + x-xgen-operation-id-override: getEncryptionAtRest patch: description: |- Updates the configuration for encryption at rest using the keys you manage through your cloud provider. MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. This feature isn't available for `M0` free clusters, `M2`, `M5`, or serverless clusters. After you configure at least one Encryption at Rest using a Customer Key Management provider for the MongoDB Cloud project, Project Owners can enable Encryption at Rest using Customer Key Management for each MongoDB Cloud cluster for which they require encryption. The Encryption at Rest using Customer Key Management provider doesn't have to match the cluster cloud service provider. MongoDB Cloud doesn't automatically rotate user-managed encryption keys. Defer to your preferred Encryption at Rest using Customer Key Management provider's documentation and guidance for best practices on key rotation. MongoDB Cloud automatically creates a 90-day key rotation alert when you configure Encryption at Rest using Customer Key Management using your Key Management in an MongoDB Cloud project. MongoDB Cloud encrypts all storage whether or not you use your own key management. - operationId: updateEncryptionAtRest + operationId: updateGroupEncryptionAtRest parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49698,7 +50091,7 @@ paths: - To use AWS Key Management Service (KMS), MongoDB Cloud requires all the fields in the **awsKms** object. - To use Azure Key Vault, MongoDB Cloud requires all the fields in the **azureKeyVault** object. - - To use Google Cloud Key Management Service (KMS), MongoDB Cloud requires all the fields in the **googleCloudKms** object. + - To use Google Cloud Key Management Service (KMS), MongoDB Cloud requires all the fields in the **googleCloudKms** object For authentication, you must provide either serviceAccountKey (static credentials) or roleId (service-account–based authentication) Once roleId is configured, serviceAccountKey is no longer supported. If you enabled Encryption at Rest using Customer Key Management, administrators can pass only the changed fields for the **awsKms**, **azureKeyVault**, or **googleCloudKms** object to update the configuration to this endpoint. required: true @@ -49722,14 +50115,15 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Update Encryption at Rest Configuration for One Project + summary: Update Encryption at Rest Configuration in One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/updateEncryptionAtRest + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/updateGroupEncryptionAtRest + x-xgen-operation-id-override: updateEncryptionAtRest /api/atlas/v2/groups/{groupId}/encryptionAtRest/{cloudProvider}/privateEndpoints: get: description: Returns the private endpoints of the specified cloud provider for encryption at rest using customer key management. - operationId: getEncryptionAtRestPrivateEndpointsForCloudProvider + operationId: listGroupEncryptionAtRestPrivateEndpoints parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49762,13 +50156,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return Private Endpoints of a Cloud Provider for Encryption at Rest Using Customer Key Management for One Project + summary: Return Private Endpoints for Encryption at Rest Using Customer Key Management for One Cloud Provider in One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getEncryptionAtRestPrivateEndpointsForCloudProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/listGroupEncryptionAtRestPrivateEndpoints + x-xgen-operation-id-override: listRestPrivateEndpoints post: description: Creates a private endpoint in the specified region for encryption at rest using customer key management. - operationId: createEncryptionAtRestPrivateEndpoint + operationId: createGroupEncryptionAtRestPrivateEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49805,14 +50200,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Create One Private Endpoint in a Specified Region for Encryption at Rest Using Customer Key Management + summary: Create One Private Endpoint for Encryption at Rest Using Customer Key Management for One Cloud Provider in One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/createEncryptionAtRestPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/createGroupEncryptionAtRestPrivateEndpoint + x-xgen-operation-id-override: createRestPrivateEndpoint /api/atlas/v2/groups/{groupId}/encryptionAtRest/{cloudProvider}/privateEndpoints/{endpointId}: delete: description: Deletes one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. - operationId: requestEncryptionAtRestPrivateEndpointDeletion + operationId: requestGroupEncryptionAtRestPrivateEndpointDeletion parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49847,16 +50243,17 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Delete One Private Endpoint for Encryption at Rest Using Customer Key Management + summary: Delete One Private Endpoint for Encryption at Rest Using Customer Key Management for One Cloud Provider from One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/requestEncryptionAtRestPrivateEndpointDeletion + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/requestGroupEncryptionAtRestPrivateEndpointDeletion x-xgen-method-verb-override: customMethod: "True" verb: requestDeletion + x-xgen-operation-id-override: requestPrivateEndpointDeletion get: description: Returns one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. - operationId: getEncryptionAtRestPrivateEndpoint + operationId: getGroupEncryptionAtRestPrivateEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49884,7 +50281,7 @@ paths: schema: $ref: '#/components/schemas/EARPrivateEndpoint' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -49895,17 +50292,18 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Private Endpoint for Encryption at Rest Using Customer Key Management + summary: Return One Private Endpoint for Encryption at Rest Using Customer Key Management for One Cloud Provider in One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getEncryptionAtRestPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getGroupEncryptionAtRestPrivateEndpoint + x-xgen-operation-id-override: getRestPrivateEndpoint /api/atlas/v2/groups/{groupId}/events: get: description: |- Returns events for the specified project. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This resource remains under revision and may change. - operationId: listProjectEvents + operationId: listGroupEvents parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49973,7 +50371,7 @@ paths: schema: $ref: '#/components/schemas/GroupPaginatedEventView' x-xgen-IPA-exception: - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -49991,7 +50389,7 @@ paths: summary: Return Events from One Project tags: - Events - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listProjectEvents + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listGroupEvents /api/atlas/v2/groups/{groupId}/events/{eventId}: get: description: |- @@ -50001,7 +50399,7 @@ paths: externalDocs: description: Return Events from One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listProjectEvents - operationId: getProjectEvent + operationId: getGroupEvent parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50026,7 +50424,7 @@ paths: schema: $ref: '#/components/schemas/EventViewForNdsGroup' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -50040,11 +50438,11 @@ paths: summary: Return One Event from One Project tags: - Events - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/getProjectEvent + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/getGroupEvent /api/atlas/v2/groups/{groupId}/flexClusters: get: description: Returns details for all flex clusters in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listFlexClusters + operationId: listGroupFlexClusters parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50073,10 +50471,11 @@ paths: summary: Return All Flex Clusters from One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/listFlexClusters + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/listGroupFlexClusters + x-xgen-operation-id-override: listFlexClusters post: description: Creates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createFlexCluster + operationId: createGroupFlexCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50113,14 +50512,14 @@ paths: summary: Create One Flex Cluster in One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/createFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/createGroupFlexCluster + x-xgen-operation-id-override: createFlexCluster x-xgen-atlascli: watcher: get: version: "2024-11-13" - operation-id: getFlexCluster + operation-id: createGroupFlexCluster params: - name: body:$.name groupId: input:groupId expect: match: @@ -50131,7 +50530,7 @@ paths: /api/atlas/v2/groups/{groupId}/flexClusters/{name}: delete: description: Removes one flex cluster from the specified project. The flex cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteFlexCluster + operationId: deleteGroupFlexCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -50164,12 +50563,13 @@ paths: summary: Remove One Flex Cluster from One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/deleteFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/deleteGroupFlexCluster + x-xgen-operation-id-override: deleteFlexCluster x-xgen-atlascli: watcher: get: version: "2024-11-13" - operation-id: getFlexCluster + operation-id: deleteGroupFlexCluster params: name: input:name groupId: input:groupId @@ -50177,7 +50577,7 @@ paths: http-code: 404 get: description: Returns details for one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getFlexCluster + operationId: getGroupFlexCluster parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -50196,7 +50596,7 @@ paths: schema: $ref: '#/components/schemas/FlexClusterDescription20241113' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-11-13" description: OK "400": @@ -50214,10 +50614,11 @@ paths: summary: Return One Flex Cluster from One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/getFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/getGroupFlexCluster + x-xgen-operation-id-override: getFlexCluster patch: description: Updates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateFlexCluster + operationId: updateGroupFlexCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50259,12 +50660,13 @@ paths: summary: Update One Flex Cluster in One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/updateFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/updateGroupFlexCluster + x-xgen-operation-id-override: updateFlexCluster x-xgen-atlascli: watcher: get: version: "2024-11-13" - operation-id: getFlexCluster + operation-id: updateGroupFlexCluster params: name: input:name groupId: input:groupId @@ -50276,7 +50678,7 @@ paths: /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/download: post: description: Requests one snapshot for the specified flex cluster. This resource returns a `snapshotURL` that you can use to download the snapshot. This `snapshotURL` remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: downloadFlexBackup + operationId: downloadGroupFlexClusterBackup parameters: - description: Human-readable label that identifies the flex cluster. in: path @@ -50318,13 +50720,14 @@ paths: summary: Download One Flex Cluster Snapshot tags: - Flex Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/downloadFlexBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/downloadGroupFlexClusterBackup x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: downloadFlexBackup /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/restoreJobs: get: description: Returns all restore jobs for one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: listFlexBackupRestoreJobs + operationId: listGroupFlexClusterBackupRestoreJobs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50360,10 +50763,11 @@ paths: summary: Return All Restore Jobs for One Flex Cluster tags: - Flex Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/listFlexBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/listGroupFlexClusterBackupRestoreJobs + x-xgen-operation-id-override: listFlexRestoreJobs post: description: Restores one snapshot of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createFlexBackupRestoreJob + operationId: createGroupFlexClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50402,19 +50806,19 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Restore One Snapshot of One Flex Cluster + summary: Create One Restore Job for One Flex Cluster tags: - Flex Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/createFlexBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/createGroupFlexClusterBackupRestoreJob + x-xgen-operation-id-override: createFlexRestoreJob x-xgen-atlascli: watcher: get: version: "2024-11-13" - operation-id: getFlexBackupRestoreJob + operation-id: createGroupFlexClusterBackupRestoreJob params: name: input:name groupId: input:groupId - restoreJobId: body:$.id expect: match: path: $.status @@ -50424,7 +50828,7 @@ paths: /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/restoreJobs/{restoreJobId}: get: description: Returns one restore job for one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getFlexBackupRestoreJob + operationId: getGroupFlexClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50464,11 +50868,12 @@ paths: summary: Return One Restore Job for One Flex Cluster tags: - Flex Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/getFlexBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/getGroupFlexClusterBackupRestoreJob + x-xgen-operation-id-override: getFlexRestoreJob /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/snapshots: get: description: Returns all snapshots of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listFlexBackups + operationId: listGroupFlexClusterBackupSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50501,14 +50906,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return All Snapshots of One Flex Cluster + summary: Return All Snapshots for One Flex Cluster tags: - Flex Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/listFlexBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/listGroupFlexClusterBackupSnapshots + x-xgen-operation-id-override: listFlexBackupSnapshots /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/snapshots/{snapshotId}: get: description: Returns one snapshot of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getFlexBackup + operationId: getGroupFlexClusterBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50545,14 +50951,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Snapshot of One Flex Cluster + summary: Return One Snapshot for One Flex Cluster tags: - Flex Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/getFlexBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/getGroupFlexClusterBackupSnapshot + x-xgen-operation-id-override: getFlexBackupSnapshot /api/atlas/v2/groups/{groupId}/flexClusters:tenantUpgrade: post: description: Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. - operationId: upgradeFlexCluster + operationId: tenantGroupFlexClusterUpgrade parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50589,11 +50996,12 @@ paths: summary: Upgrade One Flex Cluster tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/upgradeFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/tenantGroupFlexClusterUpgrade + x-xgen-operation-id-override: tenantUpgrade /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics: get: description: Returns all Atlas Search metric types available for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. - operationId: listMetricTypes + operationId: listGroupHostFtsMetrics parameters: - $ref: '#/components/parameters/processId' - $ref: '#/components/parameters/groupId' @@ -50621,11 +51029,12 @@ paths: summary: Return All Atlas Search Metric Types for One Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listMetricTypes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupHostFtsMetrics + x-xgen-operation-id-override: listHostFtsMetrics /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/{indexName}/measurements: get: description: Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. You must have the Project Read Only or higher role to view the Atlas Search metric types. - operationId: getIndexMetrics + operationId: getGroupHostFtsMetricIndexMeasurements parameters: - $ref: '#/components/parameters/processId' - $ref: '#/components/parameters/indexName' @@ -50667,7 +51076,7 @@ paths: schema: $ref: '#/components/schemas/MeasurementsIndexes' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50685,11 +51094,12 @@ paths: summary: Return Atlas Search Metrics for One Index in One Namespace tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getIndexMetrics + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupHostFtsMetricIndexMeasurements + x-xgen-operation-id-override: getIndexMeasurements /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/measurements: get: description: Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. - operationId: listIndexMetrics + operationId: listGroupHostFtsMetricIndexMeasurements parameters: - $ref: '#/components/parameters/processId' - $ref: '#/components/parameters/databaseName' @@ -50730,7 +51140,7 @@ paths: schema: $ref: '#/components/schemas/MeasurementsIndexes' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50748,11 +51158,15 @@ paths: summary: Return All Atlas Search Index Metrics for One Namespace tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listIndexMetrics + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupHostFtsMetricIndexMeasurements + x-xgen-method-verb-override: + customMethod: false + verb: list + x-xgen-operation-id-override: listIndexMeasurements /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/measurements: get: description: Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. - operationId: getMeasurements + operationId: listGroupHostFtsMetricMeasurements parameters: - $ref: '#/components/parameters/processId' - $ref: '#/components/parameters/groupId' @@ -50808,11 +51222,12 @@ paths: summary: Return Atlas Search Hardware and Status Metrics tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupHostFtsMetricMeasurements + x-xgen-operation-id-override: listMeasurements /api/atlas/v2/groups/{groupId}/integrations: get: description: Returns the settings that permit integrations with all configured third-party services. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: listThirdPartyIntegrations + operationId: listGroupIntegrations parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50841,11 +51256,11 @@ paths: summary: Return All Active Third-Party Service Integrations tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/listThirdPartyIntegrations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/listGroupIntegrations /api/atlas/v2/groups/{groupId}/integrations/{integrationType}: delete: description: Removes the settings that permit configuring one third-party service integration. These settings apply to all databases managed in one MongoDB Cloud project. If you delete an integration from a project, you remove that integration configuration only for that project. This action doesn't affect any other project or organization's configured `{INTEGRATION-TYPE}` integrations. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: deleteThirdPartyIntegration + operationId: deleteGroupIntegration parameters: - description: Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. in: path @@ -50887,10 +51302,10 @@ paths: summary: Remove One Third-Party Service Integration tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/deleteThirdPartyIntegration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/deleteGroupIntegration get: description: Returns the settings for configuring integration with one third-party service. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: getThirdPartyIntegration + operationId: getGroupIntegration parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50920,7 +51335,7 @@ paths: schema: $ref: '#/components/schemas/ThirdPartyIntegration' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50936,10 +51351,10 @@ paths: summary: Return One Third-Party Service Integration tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/getThirdPartyIntegration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/getGroupIntegration post: description: Adds the settings for configuring one third-party service integration. These settings apply to all databases managed in the specified MongoDB Cloud project. Each project can have only one configuration per `{INTEGRATION-TYPE}`. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: createThirdPartyIntegration + operationId: createGroupIntegration parameters: - description: Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. in: path @@ -50992,13 +51407,13 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Configure One Third-Party Service Integration + summary: Create One Third-Party Service Integration tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/createThirdPartyIntegration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/createGroupIntegration put: description: Updates the settings for configuring integration with one third-party service. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: updateThirdPartyIntegration + operationId: updateGroupIntegration parameters: - description: Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. in: path @@ -51038,7 +51453,7 @@ paths: schema: $ref: '#/components/schemas/PaginatedIntegrationView' x-xgen-IPA-exception: - xgen-IPA-107-update-method-response-is-get-method-response: Content predates IPA validation + xgen-IPA-107-update-method-response-is-get-method-response: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -51054,12 +51469,12 @@ paths: summary: Update One Third-Party Service Integration tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/updateThirdPartyIntegration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/updateGroupIntegration /api/atlas/v2/groups/{groupId}/invites: get: deprecated: true description: Returns all pending invitations to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: listProjectInvitations + operationId: listGroupInvites parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51079,12 +51494,12 @@ paths: $ref: '#/components/schemas/GroupInvitation' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-sunset: "2026-07-31" x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -51095,14 +51510,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return All Project Invitations + summary: Return All Invitations in One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listProjectInvitations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listGroupInvites patch: deprecated: true description: Updates the details of one pending invitation to the specified project. To specify which invitation to update, provide the username of the invited user. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateProjectInvitation + operationId: updateGroupInvites parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51133,10 +51548,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update One Project Invitation + summary: Update One Invitation in One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroupInvites x-xgen-atlascli: override: description: | @@ -51144,7 +51559,7 @@ paths: post: deprecated: true description: Invites one MongoDB Cloud user to join the specified project. The MongoDB Cloud user must accept the invitation to access information within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createProjectInvitation + operationId: createGroupInvite parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/pretty' @@ -51173,15 +51588,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Invite One MongoDB Cloud User to One Project + summary: Create Invitation for One MongoDB Cloud User in One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createGroupInvite /api/atlas/v2/groups/{groupId}/invites/{invitationId}: delete: deprecated: true description: Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteProjectInvitation + operationId: deleteGroupInvite parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51207,14 +51622,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Remove One Project Invitation + summary: Remove One Invitation from One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteProjectInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteGroupInvite get: deprecated: true description: Returns the details of one pending invitation to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getProjectInvitation + operationId: getGroupInvite parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51234,7 +51649,7 @@ paths: $ref: '#/components/schemas/GroupInvitation' x-sunset: "2026-07-31" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -51245,14 +51660,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Project Invitation + summary: Return One Invitation in One Project by Invitation ID tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupInvite patch: deprecated: true description: Updates the details of one pending invitation to the specified project. To specify which invitation to update, provide the unique identification string for that invitation. Use the Return All Project Invitations endpoint to retrieve IDs for all pending project invitations. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateProjectInvitationById + operationId: updateGroupInviteById parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51289,10 +51704,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update One Project Invitation by Invitation ID + summary: Update One Invitation in One Project by Invitation ID tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectInvitationById + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroupInviteById + x-xgen-method-verb-override: + customMethod: false + verb: updateById + x-xgen-operation-id-override: updateInviteById x-xgen-atlascli: override: description: | @@ -51300,7 +51719,7 @@ paths: /api/atlas/v2/groups/{groupId}/ipAddresses: get: description: Returns all IP addresses for this project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: returnAllIpAddresses + operationId: getGroupIpAddresses parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -51312,7 +51731,7 @@ paths: schema: $ref: '#/components/schemas/GroupIPAddresses' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -51326,11 +51745,11 @@ paths: summary: Return All IP Addresses for One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/returnAllIpAddresses + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupIpAddresses /api/atlas/v2/groups/{groupId}/limits: get: description: Returns all the limits for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listProjectLimits + operationId: listGroupLimits parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51344,11 +51763,11 @@ paths: $ref: '#/components/schemas/DataFederationLimit' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -51366,21 +51785,21 @@ paths: summary: Return All Limits for One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listProjectLimits + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listGroupLimits /api/atlas/v2/groups/{groupId}/limits/{limitName}: delete: description: Removes the specified project limit. Depending on the limit, Atlas either resets the limit to its default value or removes the limit entirely. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteProjectLimit + operationId: deleteGroupLimit parameters: - description: | Human-readable label that identifies this project limit. | Limit Name | Description | Default | API Override Limit | | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | @@ -51389,7 +51808,6 @@ paths: | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | in: path name: limitName required: true @@ -51408,7 +51826,6 @@ paths: - dataFederation.bytesProcessed.monthly - atlas.project.deployment.privateServiceConnectionsPerRegionGroup - atlas.project.deployment.privateServiceConnectionsSubnetMask - - atlas.project.deployment.salesSoldM0s type: string - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51434,20 +51851,20 @@ paths: summary: Remove One Project Limit tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteProjectLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteGroupLimit get: description: Returns the specified limit for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProjectLimit + operationId: getGroupLimit parameters: - description: | Human-readable label that identifies this project limit. | Limit Name | Description | Default | API Override Limit | | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | @@ -51456,7 +51873,6 @@ paths: | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | in: path name: limitName required: true @@ -51475,7 +51891,6 @@ paths: - dataFederation.bytesProcessed.monthly - atlas.project.deployment.privateServiceConnectionsPerRegionGroup - atlas.project.deployment.privateServiceConnectionsSubnetMask - - atlas.project.deployment.salesSoldM0s type: string - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51487,7 +51902,7 @@ paths: schema: $ref: '#/components/schemas/DataFederationLimit' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -51505,23 +51920,23 @@ paths: summary: Return One Limit for One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupLimit patch: description: |- Sets the specified project limit. To use this resource, the requesting Service Account or API Key must have the Project Owner role. **NOTE**: Increasing the following configuration limits might lead to slower response times in the MongoDB Cloud UI or increased user management overhead leading to authentication or authorization re-architecture. If possible, we recommend that you create additional projects to gain access to more of these resources for a more sustainable growth pattern. - operationId: setProjectLimit + operationId: setGroupLimit parameters: - description: | Human-readable label that identifies this project limit. | Limit Name | Description | Default | API Override Limit | | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | @@ -51530,7 +51945,6 @@ paths: | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | in: path name: limitName required: true @@ -51549,7 +51963,6 @@ paths: - dataFederation.bytesProcessed.monthly - atlas.project.deployment.privateServiceConnectionsPerRegionGroup - atlas.project.deployment.privateServiceConnectionsSubnetMask - - atlas.project.deployment.salesSoldM0s type: string - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51584,7 +51997,7 @@ paths: summary: Set One Project Limit tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/setProjectLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/setGroupLimit x-xgen-method-verb-override: customMethod: "True" verb: set @@ -51601,7 +52014,7 @@ paths: externalDocs: description: Validate Migration url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/validateMigration - operationId: createPushMigration + operationId: createGroupLiveMigration parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51641,14 +52054,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Migrate One Local Managed Cluster to MongoDB Atlas + summary: Create One Migration for One Local Managed Cluster to MongoDB Atlas tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/createPushMigration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/createGroupLiveMigration /api/atlas/v2/groups/{groupId}/liveMigrations/{liveMigrationId}: get: description: Return details of one cluster migration job. Each push live migration job uses one migration host. Your API Key must have the Organization Member role to successfully call this resource. - operationId: getPushMigration + operationId: getGroupLiveMigration parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/liveMigrationId' @@ -51673,11 +52086,11 @@ paths: summary: Return One Migration Job tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/getPushMigration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/getGroupLiveMigration /api/atlas/v2/groups/{groupId}/liveMigrations/{liveMigrationId}/cutover: put: description: Cut over the migrated cluster to MongoDB Atlas. Confirm when the cut over completes. When the cut over completes, MongoDB Atlas completes the live migration process and stops synchronizing with the source cluster. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: cutoverMigration + operationId: cutoverGroupLiveMigration parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/liveMigrationId' @@ -51702,13 +52115,14 @@ paths: summary: Cut Over One Migrated Cluster tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/cutoverMigration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/cutoverGroupLiveMigration x-xgen-method-verb-override: - customMethod: "True" + customMethod: true + x-xgen-operation-id-override: cutoverMigration /api/atlas/v2/groups/{groupId}/liveMigrations/validate: post: description: Verifies whether the provided credentials, available disk space, MongoDB versions, and so on meet the requirements of the migration request. If the check passes, the migration can proceed. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: validateMigration + operationId: validateGroupLiveMigrations parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51751,13 +52165,14 @@ paths: summary: Validate One Migration Request tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/validateMigration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/validateGroupLiveMigrations x-xgen-method-verb-override: - customMethod: "True" + customMethod: true + x-xgen-operation-id-override: validateLiveMigrations /api/atlas/v2/groups/{groupId}/liveMigrations/validate/{validationId}: get: description: Return the status of one migration validation job. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: getValidationStatus + operationId: getGroupLiveMigrationValidateStatus parameters: - $ref: '#/components/parameters/groupId' - description: Unique 24-hexadecimal digit string that identifies the validation job. @@ -51790,14 +52205,15 @@ paths: summary: Return One Migration Validation Job tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/getValidationStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/getGroupLiveMigrationValidateStatus x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: getStatus + x-xgen-operation-id-override: getMigrationValidateStatus /api/atlas/v2/groups/{groupId}/maintenanceWindow: delete: description: Resets the maintenance window for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: resetMaintenanceWindow + operationId: resetGroupMaintenanceWindow parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51820,13 +52236,14 @@ paths: summary: Reset One Maintenance Window for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/resetMaintenanceWindow + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/resetGroupMaintenanceWindow x-xgen-method-verb-override: customMethod: "True" verb: reset + x-xgen-operation-id-override: resetMaintenanceWindow get: description: Returns the maintenance window for the specified project. MongoDB Cloud starts those maintenance activities when needed. You can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getMaintenanceWindow + operationId: getGroupMaintenanceWindow parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51838,7 +52255,7 @@ paths: schema: $ref: '#/components/schemas/GroupMaintenanceWindow' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -51852,10 +52269,11 @@ paths: summary: Return One Maintenance Window for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/getMaintenanceWindow + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/getGroupMaintenanceWindow + x-xgen-operation-id-override: getMaintenanceWindow patch: description: Updates the maintenance window for the specified project. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. Updating the maintenance window will reset any maintenance deferrals for this project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateMaintenanceWindow + operationId: updateGroupMaintenanceWindow parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51885,11 +52303,12 @@ paths: summary: Update One Maintenance Window for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/updateMaintenanceWindow + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/updateGroupMaintenanceWindow + x-xgen-operation-id-override: updateMaintenanceWindow /api/atlas/v2/groups/{groupId}/maintenanceWindow/autoDefer: post: description: Toggles automatic deferral of the maintenance window for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: toggleMaintenanceAutoDefer + operationId: toggleGroupMaintenanceWindowAutoDefer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51912,14 +52331,15 @@ paths: summary: Toggle Automatic Deferral of Maintenance for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/toggleMaintenanceAutoDefer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/toggleGroupMaintenanceWindowAutoDefer x-xgen-method-verb-override: customMethod: "True" verb: toggle + x-xgen-operation-id-override: toggleMaintenanceAutoDefer /api/atlas/v2/groups/{groupId}/maintenanceWindow/defer: post: description: Defers the maintenance window for the specified project. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deferMaintenanceWindow + operationId: deferGroupMaintenanceWindow parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51942,13 +52362,14 @@ paths: summary: Defer One Maintenance Window for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/deferMaintenanceWindow + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/deferGroupMaintenanceWindow x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: deferMaintenanceWindow /api/atlas/v2/groups/{groupId}/managedSlowMs: get: description: Get whether the Managed Slow MS feature is enabled. - operationId: getManagedSlowMs + operationId: getGroupManagedSlowMs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51960,7 +52381,7 @@ paths: schema: type: boolean x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -51976,11 +52397,12 @@ paths: summary: Return Managed Slow Operation Threshold Status tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/getManagedSlowMs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/getGroupManagedSlowMs + x-xgen-operation-id-override: getManagedSlowMs /api/atlas/v2/groups/{groupId}/managedSlowMs/disable: delete: description: Disables the slow operation threshold that MongoDB Cloud calculated for the specified project. The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: disableSlowOperationThresholding + operationId: disableGroupManagedSlowMs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52004,13 +52426,14 @@ paths: summary: Disable Managed Slow Operation Threshold tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/disableSlowOperationThresholding + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/disableGroupManagedSlowMs x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: disableManagedSlowMs /api/atlas/v2/groups/{groupId}/managedSlowMs/enable: post: description: Enables MongoDB Cloud to use its slow operation threshold for the specified project. The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: enableSlowOperationThresholding + operationId: enableGroupManagedSlowMs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52034,13 +52457,14 @@ paths: summary: Enable Managed Slow Operation Threshold tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/enableSlowOperationThresholding + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/enableGroupManagedSlowMs x-xgen-method-verb-override: - customMethod: "True" + customMethod: true + x-xgen-operation-id-override: enableManagedSlowMs /api/atlas/v2/groups/{groupId}/mongoDBVersions: get: description: Returns the MongoDB Long Term Support Major Versions available to new clusters in this project. - operationId: getProjectLtsVersions + operationId: getGroupMongoDbVersions parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -52085,8 +52509,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedAvailableVersionView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52104,11 +52528,12 @@ paths: summary: Return All Available MongoDB LTS Versions for Clusters in One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectLtsVersions + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupMongoDbVersions + x-xgen-operation-id-override: getMongoDbVersions /api/atlas/v2/groups/{groupId}/peers: get: description: Returns details about all network peering connections in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPeeringConnections + operationId: listGroupPeers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52127,7 +52552,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. responses: "200": content: @@ -52149,13 +52574,13 @@ paths: summary: Return All Network Peering Connections in One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listPeeringConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listGroupPeers post: description: Creates one new network peering connection in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations and prerequisites, see the Network Peering Documentation. externalDocs: description: Azure Network Peering Prerequisites url: https://docs.atlas.mongodb.com/reference/api/vpc-create-peering-connection/#prerequisites - operationId: createPeeringConnection + operationId: createGroupPeer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52190,11 +52615,11 @@ paths: summary: Create One Network Peering Connection tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/createPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/createGroupPeer /api/atlas/v2/groups/{groupId}/peers/{peerId}: delete: description: Removes one network peering connection in the specified project. If you Removes the last network peering connection associated with a project, MongoDB Cloud also removes any AWS security groups from the project IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deletePeeringConnection + operationId: deleteGroupPeer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52227,10 +52652,10 @@ paths: summary: Remove One Network Peering Connection tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/deletePeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/deleteGroupPeer get: description: Returns details about one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPeeringConnection + operationId: getGroupPeer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52249,7 +52674,7 @@ paths: schema: $ref: '#/components/schemas/BaseNetworkPeeringConnectionSettings' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52265,10 +52690,10 @@ paths: summary: Return One Network Peering Connection in One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/getPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/getGroupPeer patch: description: Updates one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updatePeeringConnection + operationId: updateGroupPeer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52310,12 +52735,12 @@ paths: summary: Update One Network Peering Connection tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/updatePeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/updateGroupPeer /api/atlas/v2/groups/{groupId}/pipelines: get: deprecated: true description: Returns a list of Data Lake Pipelines. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPipelines + operationId: listGroupPipelines parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52328,12 +52753,12 @@ paths: $ref: '#/components/schemas/DataLakeIngestionPipeline' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation - x-sunset: "2025-09-09" + xgen-IPA-124-array-max-items: Schema predates IPA validation. + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52349,14 +52774,15 @@ paths: summary: Return All Data Lake Pipelines in One Project tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listPipelines + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listGroupPipelines + x-xgen-operation-id-override: listPipelines post: deprecated: true description: Creates one Data Lake Pipeline. externalDocs: description: Data Lake Pipelines are deprecated. Please see Data Lake Deprecation Guide. url: https://dochub.mongodb.org/core/data-lake-deprecation - operationId: createPipeline + operationId: createGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52373,7 +52799,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52389,15 +52815,15 @@ paths: summary: Create One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/createPipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/createGroupPipeline + x-xgen-operation-id-override: createPipeline x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getPipeline + operation-id: createGroupPipeline params: groupId: input:groupId - pipelineName: body:$.name expect: match: path: $.state @@ -52407,7 +52833,7 @@ paths: delete: deprecated: true description: Removes one Data Lake Pipeline. - operationId: deletePipeline + operationId: deleteGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52422,7 +52848,7 @@ paths: "200": content: application/vnd.atlas.2023-01-01+json: - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "401": @@ -52436,12 +52862,13 @@ paths: summary: Remove One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/deletePipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/deleteGroupPipeline + x-xgen-operation-id-override: deletePipeline x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getPipeline + operation-id: deleteGroupPipeline params: groupId: input:groupId pipelineName: input:pipelineName @@ -52450,7 +52877,7 @@ paths: get: deprecated: true description: Returns the details of one Data Lake Pipeline within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPipeline + operationId: getGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52468,9 +52895,9 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52486,11 +52913,12 @@ paths: summary: Return One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getPipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getGroupPipeline + x-xgen-operation-id-override: getPipeline patch: deprecated: true description: Updates one Data Lake Pipeline. - operationId: updatePipeline + operationId: updateGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52514,7 +52942,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52532,12 +52960,13 @@ paths: summary: Update One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/updatePipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/updateGroupPipeline + x-xgen-operation-id-override: updatePipeline x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getPipeline + operation-id: updateGroupPipeline params: groupId: input:groupId pipelineName: input:pipelineName @@ -52550,7 +52979,7 @@ paths: get: deprecated: true description: Returns a list of backup schedule policy items that you can use as a Data Lake Pipeline source. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPipelineSchedules + operationId: getGroupPipelineAvailableSchedules parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52571,11 +53000,11 @@ paths: $ref: '#/components/schemas/DiskBackupApiPolicyItem' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation - x-sunset: "2025-09-09" + xgen-IPA-124-array-max-items: Schema predates IPA validation. + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52591,12 +53020,13 @@ paths: summary: Return All Ingestion Schedules for One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listPipelineSchedules + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getGroupPipelineAvailableSchedules + x-xgen-operation-id-override: getAvailablePipelineSchedules /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/availableSnapshots: get: deprecated: true description: Returns a list of backup snapshots that you can use to trigger an on demand pipeline run. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPipelineSnapshots + operationId: getGroupPipelineAvailableSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52623,10 +53053,10 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/PaginatedBackupSnapshotView' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52642,12 +53072,13 @@ paths: summary: Return All Backup Snapshots for One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listPipelineSnapshots + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getGroupPipelineAvailableSnapshots + x-xgen-operation-id-override: getAvailablePipelineSnapshots /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/pause: post: deprecated: true description: Pauses ingestion for a Data Lake Pipeline within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: pausePipeline + operationId: pauseGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52665,7 +53096,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52681,14 +53112,15 @@ paths: summary: Pause One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/pausePipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/pauseGroupPipeline x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: pausePipeline /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/resume: post: deprecated: true description: Resumes ingestion for a Data Lake Pipeline within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: resumePipeline + operationId: resumeGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52706,7 +53138,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52722,14 +53154,15 @@ paths: summary: Resume One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/resumePipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/resumeGroupPipeline x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: resumePipeline /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/runs: get: deprecated: true description: Returns a list of past Data Lake Pipeline runs. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPipelineRuns + operationId: listGroupPipelineRuns parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52744,7 +53177,7 @@ paths: format: date-time type: string x-xgen-IPA-exception: - xgen-IPA-121-date-time-fields-mention-iso-8601: Schema predates IPA validation + xgen-IPA-121-date-time-fields-mention-iso-8601: Schema predates IPA validation. - description: Human-readable label that identifies the Data Lake Pipeline. in: path name: pipelineName @@ -52758,7 +53191,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/PaginatedPipelineRunView' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52774,12 +53207,13 @@ paths: summary: Return All Data Lake Pipeline Runs in One Project tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listPipelineRuns + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listGroupPipelineRuns + x-xgen-operation-id-override: listPipelineRuns /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/runs/{pipelineRunId}: delete: deprecated: true description: Deletes dataset that Atlas generated during the specified pipeline run. - operationId: deletePipelineRunDataset + operationId: deleteGroupPipelineRun parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52805,7 +53239,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/RequestAccepted' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: Accepted "400": @@ -52821,11 +53255,12 @@ paths: summary: Delete One Pipeline Run Dataset tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/deletePipelineRunDataset + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/deleteGroupPipelineRun + x-xgen-operation-id-override: deletePipelineRun get: deprecated: true description: Returns the details of one Data Lake Pipeline run within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPipelineRun + operationId: getGroupPipelineRun parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52851,9 +53286,9 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/IngestionPipelineRun' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52869,12 +53304,13 @@ paths: summary: Return One Data Lake Pipeline Run tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getPipelineRun + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getGroupPipelineRun + x-xgen-operation-id-override: getPipelineRun /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/trigger: post: deprecated: true description: Triggers a Data Lake Pipeline ingestion of a specified snapshot. - operationId: triggerSnapshotIngestion + operationId: triggerGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52899,7 +53335,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/IngestionPipelineRun' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52915,13 +53351,14 @@ paths: summary: Trigger On-Demand Snapshot Ingestion tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/triggerSnapshotIngestion + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/triggerGroupPipeline x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: triggerPipeline /api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService: get: description: Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPrivateEndpointServices + operationId: listGroupPrivateEndpointEndpointService parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52938,7 +53375,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. responses: "200": content: @@ -52948,11 +53385,11 @@ paths: $ref: '#/components/schemas/EndpointService' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52968,11 +53405,12 @@ paths: summary: Return All Private Endpoint Services for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/listPrivateEndpointServices + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/listGroupPrivateEndpointEndpointService + x-xgen-operation-id-override: listPrivateEndpointService /api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}: delete: description: Removes one private endpoint service from the specified project. This cloud service provider manages the private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deletePrivateEndpointService + operationId: deleteGroupPrivateEndpointEndpointService parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52989,7 +53427,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to delete. in: path name: endpointServiceId @@ -53016,12 +53454,13 @@ paths: summary: Remove One Private Endpoint Service for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/deletePrivateEndpointService + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/deleteGroupPrivateEndpointEndpointService + x-xgen-operation-id-override: deletePrivateEndpointService x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getPrivateEndpointService + operation-id: deleteGroupPrivateEndpointEndpointService params: cloudProvider: body:$.cloudProvider groupId: input:groupId @@ -53030,7 +53469,7 @@ paths: http-code: 404 get: description: Returns the name, interfaces, and state of the specified private endpoint service from one project. The cloud service provider hosted this private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPrivateEndpointService + operationId: getGroupPrivateEndpointEndpointService parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53047,7 +53486,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to return. in: path name: endpointServiceId @@ -53062,7 +53501,7 @@ paths: schema: $ref: '#/components/schemas/EndpointService' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -53078,11 +53517,12 @@ paths: summary: Return One Private Endpoint Service for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getPrivateEndpointService + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getGroupPrivateEndpointEndpointService + x-xgen-operation-id-override: getPrivateEndpointService /api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}/endpoint: post: description: Creates one private endpoint for the specified cloud service provider. This cloud service provider manages the private endpoint service, which in turn manages the private endpoints for the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations, limitations, and prerequisites, see the MongoDB documentation for setting up a private endpoint. - operationId: createPrivateEndpoint + operationId: createGroupPrivateEndpointEndpointServiceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53099,7 +53539,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to create a private endpoint. in: path name: endpointServiceId @@ -53139,11 +53579,12 @@ paths: summary: Create One Private Endpoint for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/createPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/createGroupPrivateEndpointEndpointServiceEndpoint + x-xgen-operation-id-override: createPrivateEndpoint /api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}/endpoint/{endpointId}: delete: description: Removes one private endpoint from the specified project and private endpoint service, as managed by the specified cloud service provider. When the last private endpoint is removed from a given private endpoint service, that private endpoint service is also removed. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deletePrivateEndpoint + operationId: deleteGroupPrivateEndpointEndpointServiceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53160,7 +53601,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique string that identifies the private endpoint you want to delete. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints. in: path name: endpointId @@ -53194,10 +53635,11 @@ paths: summary: Remove One Private Endpoint for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/deletePrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/deleteGroupPrivateEndpointEndpointServiceEndpoint + x-xgen-operation-id-override: deletePrivateEndpoint get: description: Returns the connection state of the specified private endpoint. The private endpoint service manages this private endpoint which belongs to one project hosted from one cloud service provider. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPrivateEndpoint + operationId: getGroupPrivateEndpointEndpointServiceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53214,7 +53656,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique string that identifies the private endpoint you want to return. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints. in: path name: endpointId @@ -53236,7 +53678,7 @@ paths: schema: $ref: '#/components/schemas/PrivateLinkEndpoint' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -53252,14 +53694,15 @@ paths: summary: Return One Private Endpoint for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getGroupPrivateEndpointEndpointServiceEndpoint + x-xgen-operation-id-override: getPrivateEndpoint /api/atlas/v2/groups/{groupId}/privateEndpoint/endpointService: post: description: Creates one private endpoint service for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. When you create a private endpoint service, MongoDB Cloud creates a network container in the project for the cloud provider for which you create the private endpoint service if one doesn't already exist. To learn more about private endpoint terminology in MongoDB Cloud, see Private Endpoint Concepts. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Private Endpoint Concepts url: https://dochub.mongodb.org/core/private-endpoint-concepts - operationId: createPrivateEndpointService + operationId: createGroupPrivateEndpointEndpointService parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53292,16 +53735,15 @@ paths: summary: Create One Private Endpoint Service for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/createPrivateEndpointService + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/createGroupPrivateEndpointEndpointService + x-xgen-operation-id-override: createPrivateEndpointService x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getPrivateEndpointService + operation-id: createGroupPrivateEndpointEndpointService params: - cloudProvider: body:$.cloudProvider groupId: input:groupId - endpointServiceId: body:$.id expect: match: path: $.status @@ -53311,7 +53753,7 @@ paths: /api/atlas/v2/groups/{groupId}/privateEndpoint/regionalMode: get: description: Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. The cloud service provider manages the private endpoint for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getRegionalizedPrivateEndpointSetting + operationId: getGroupPrivateEndpointRegionalMode parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53335,13 +53777,14 @@ paths: summary: Return Regionalized Private Endpoint Status tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getRegionalizedPrivateEndpointSetting + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getGroupPrivateEndpointRegionalMode x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getRegionalEndpointMode patch: description: Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. The cloud service provider manages the private endpoints for the project. Connection strings to existing multi-region and global sharded clusters change when you enable this setting. You must update your applications to use the new connection strings. This might cause downtime. To use this resource, the requesting Service Account or API Key must have the Project Owner role and all clusters in the deployment must be sharded clusters. Once enabled, you cannot create replica sets. - operationId: toggleRegionalizedPrivateEndpointSetting + operationId: toggleGroupPrivateEndpointRegionalMode parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53374,17 +53817,18 @@ paths: summary: Toggle Regionalized Private Endpoint Status tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/toggleRegionalizedPrivateEndpointSetting + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/toggleGroupPrivateEndpointRegionalMode x-xgen-method-verb-override: customMethod: "True" verb: toggle + x-xgen-operation-id-override: toggleRegionalEndpointMode /api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint: get: description: |- Returns all private endpoints for one serverless instance. You must have at least the Project Read Only role for the project to successfully call this resource. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - operationId: listServerlessPrivateEndpoints + operationId: listGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53404,11 +53848,11 @@ paths: $ref: '#/components/schemas/ServerlessTenantEndpoint' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -53424,7 +53868,8 @@ paths: summary: Return All Private Endpoints for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/listServerlessPrivateEndpoints + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/listGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: listServerlessPrivateEndpoint post: description: |- Creates one private endpoint for one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -53435,7 +53880,7 @@ paths: externalDocs: description: Set Up a Private Endpoint for a Serverless Instance Tutorial url: https://dochub.mongodb.org/core/serverless-private-endpoint - operationId: createServerlessPrivateEndpoint + operationId: createGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53474,14 +53919,15 @@ paths: summary: Create One Private Endpoint for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/createServerlessPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/createGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: createServerlessPrivateEndpoint /api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint/{endpointId}: delete: description: |- Remove one private endpoint from one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - operationId: deleteServerlessPrivateEndpoint + operationId: deleteGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53518,13 +53964,14 @@ paths: summary: Remove One Private Endpoint for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/deleteServerlessPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/deleteGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: deleteServerlessPrivateEndpoint get: description: |- Return one private endpoint for one serverless instance. Identify this endpoint using its unique ID. You must have at least the Project Read Only role for the project to successfully call this resource. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - operationId: getServerlessPrivateEndpoint + operationId: getGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53549,7 +53996,7 @@ paths: schema: $ref: '#/components/schemas/ServerlessTenantEndpoint' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -53565,13 +54012,14 @@ paths: summary: Return One Private Endpoint for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/getServerlessPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/getGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: getServerlessPrivateEndpoint patch: description: |- Updates one private endpoint for one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - operationId: updateServerlessPrivateEndpoint + operationId: updateGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53617,7 +54065,8 @@ paths: summary: Update One Private Endpoint for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/updateServerlessPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/updateGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: updateServerlessPrivateEndpoint /api/atlas/v2/groups/{groupId}/privateIpMode: get: deprecated: true @@ -53625,7 +54074,7 @@ paths: externalDocs: description: Changes to Connection Strings url: https://docs.atlas.mongodb.com/reference/faq/connection-changes/ - operationId: verifyConnectViaPeeringOnlyModeForOneProject + operationId: verifyGroupPrivateIpMode parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53637,7 +54086,7 @@ paths: schema: $ref: '#/components/schemas/PrivateIPModeView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53651,17 +54100,18 @@ paths: summary: Verify Connect via Peering-Only Mode for One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/verifyConnectViaPeeringOnlyModeForOneProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/verifyGroupPrivateIpMode x-xgen-method-verb-override: customMethod: "True" verb: verify + x-xgen-operation-id-override: verifyPrivateIpMode patch: deprecated: true description: Disables Connect via Peering Only mode for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Changes to Connection Strings url: https://docs.atlas.mongodb.com/reference/faq/connection-changes/ - operationId: disablePeering + operationId: disableGroupPrivateIpModePeering parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53694,14 +54144,15 @@ paths: summary: Disable Connect via Peering-Only Mode for One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/disablePeering + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/disableGroupPrivateIpModePeering x-xgen-method-verb-override: customMethod: "True" verb: disablePeering + x-xgen-operation-id-override: disablePeering /api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds: get: description: Returns all private endpoints for Federated Database Instances and Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - operationId: listDataFederationPrivateEndpoints + operationId: listGroupPrivateNetworkSettingEndpointIds parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53730,7 +54181,8 @@ paths: summary: Return All Federated Database Instance and Online Archive Private Endpoints in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listDataFederationPrivateEndpoints + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listGroupPrivateNetworkSettingEndpointIds + x-xgen-operation-id-override: listPrivateEndpointIds post: description: |- Adds one private endpoint for Federated Database Instances and Online Archives to the specified projects. If the endpoint ID already exists and the associated comment is unchanged, Atlas Data Federation makes no change to the endpoint ID list. If the endpoint ID already exists and the associated comment is changed, Atlas Data Federation updates the comment value only in the endpoint ID list. If the endpoint ID doesn't exist, Atlas Data Federation appends the new endpoint to the list of endpoints in the endpoint ID list. Each region has an associated service name for the various endpoints in each region. @@ -53752,7 +54204,7 @@ paths: `ap-south-1` is `com.amazonaws.vpce.ap-south-1.vpce-svc-03eb8a541f96d356d`. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - operationId: createDataFederationPrivateEndpoint + operationId: createGroupPrivateNetworkSettingEndpointId parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53785,11 +54237,12 @@ paths: summary: Create One Federated Database Instance and Online Archive Private Endpoint for One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createDataFederationPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createGroupPrivateNetworkSettingEndpointId + x-xgen-operation-id-override: createPrivateEndpointId /api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds/{endpointId}: delete: description: Removes one private endpoint for Federated Database Instances and Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteDataFederationPrivateEndpoint + operationId: deleteGroupPrivateNetworkSettingEndpointId parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53818,10 +54271,11 @@ paths: summary: Remove One Federated Database Instance and Online Archive Private Endpoint from One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteDataFederationPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteGroupPrivateNetworkSettingEndpointId + x-xgen-operation-id-override: deletePrivateEndpointId get: description: Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - operationId: getDataFederationPrivateEndpoint + operationId: getGroupPrivateNetworkSettingEndpointId parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53854,11 +54308,12 @@ paths: summary: Return One Federated Database Instance and Online Archive Private Endpoint in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getDataFederationPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getGroupPrivateNetworkSettingEndpointId + x-xgen-operation-id-override: getPrivateEndpointId /api/atlas/v2/groups/{groupId}/processes: get: description: Returns details of all processes for the specified project. A MongoDB process can be either a `mongod` or `mongos`. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listAtlasProcesses + operationId: listGroupProcesses parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53888,7 +54343,7 @@ paths: summary: Return All MongoDB Processes in One Project tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listAtlasProcesses + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupProcesses requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -53900,7 +54355,7 @@ paths: /api/atlas/v2/groups/{groupId}/processes/{processId}: get: description: Returns the processes for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getAtlasProcess + operationId: getGroupProcess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53920,7 +54375,7 @@ paths: schema: $ref: '#/components/schemas/ApiHostView_Atlas' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53934,11 +54389,11 @@ paths: summary: Return One MongoDB Process by ID tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getAtlasProcess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcess /api/atlas/v2/groups/{groupId}/processes/{processId}/{databaseName}/{collectionName}/collStats/measurements: get: description: Get a list of the Coll Stats Latency process-level measurements for the given namespace. - operationId: getCollStatsLatencyNamespaceHostMeasurements + operationId: listGroupProcessCollStatMeasurements parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/processId' @@ -54003,11 +54458,12 @@ paths: summary: Return Host-Level Query Latency tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespaceHostMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/listGroupProcessCollStatMeasurements + x-xgen-operation-id-override: listProcessMeasurements /api/atlas/v2/groups/{groupId}/processes/{processId}/collStats/namespaces: get: description: Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. - operationId: getCollStatsLatencyNamespacesForHost + operationId: getGroupProcessCollStatNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/processId' @@ -54031,20 +54487,21 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return Ranked Namespaces from a Host + summary: Return Ranked Namespaces from One Host tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespacesForHost + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getGroupProcessCollStatNamespaces x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getProcessNamespaces /api/atlas/v2/groups/{groupId}/processes/{processId}/databases: get: description: Returns the list of databases running on the specified host for the specified project. `M0` free clusters, `M2`, `M5`, serverless, and Flex clusters have some operational limits. The MongoDB Cloud process must be a `mongod`. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Operational Limits url: https://www.mongodb.com/docs/atlas/reference/limitations/ - operationId: listDatabases + operationId: listGroupProcessDatabases parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54079,11 +54536,12 @@ paths: summary: Return Available Databases for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listDatabases + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupProcessDatabases + x-xgen-operation-id-override: listDatabases /api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}: get: description: Returns one database running on the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getDatabase + operationId: getGroupProcessDatabase parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54109,7 +54567,7 @@ paths: schema: $ref: '#/components/schemas/MesurementsDatabase' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -54123,11 +54581,12 @@ paths: summary: Return One Database for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessDatabase + x-xgen-operation-id-override: getDatabase /api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}/measurements: get: description: Returns the measurements of one database for the specified host for the specified project. Returns the database's on-disk storage space based on the MongoDB `dbStats` command output. To calculate some metric series, Atlas takes the rate between every two adjacent points. For these metric series, the first data point has a null value because Atlas can't calculate a rate for the first data point given the query time range. Atlas retrieves database metrics every 20 minutes but reduces frequency when necessary to optimize database performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getDatabaseMeasurements + operationId: getGroupProcessDatabaseMeasurements parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54179,7 +54638,7 @@ paths: schema: $ref: '#/components/schemas/ApiMeasurementsGeneralView_Atlas' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -54193,11 +54652,12 @@ paths: summary: Return Measurements for One Database in One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getDatabaseMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessDatabaseMeasurements + x-xgen-operation-id-override: getDatabaseMeasurements /api/atlas/v2/groups/{groupId}/processes/{processId}/disks: get: description: Returns the list of disks or partitions for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDiskPartitions + operationId: listGroupProcessDisks parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54232,11 +54692,12 @@ paths: summary: Return Available Disks for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listDiskPartitions + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupProcessDisks + x-xgen-operation-id-override: listProcessDisks /api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}: get: description: Returns measurement details for one disk or partition for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDiskMeasurements + operationId: getGroupProcessDisk parameters: - $ref: '#/components/parameters/envelope' - description: Human-readable label of the disk or partition to which the measurements apply. @@ -54261,7 +54722,7 @@ paths: schema: $ref: '#/components/schemas/MeasurementDiskPartition' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -54275,7 +54736,8 @@ paths: summary: Return Measurements for One Disk tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listDiskMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessDisk + x-xgen-operation-id-override: getProcessDisk /api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}/measurements: get: description: |- @@ -54286,7 +54748,7 @@ paths: - Amount of free and used disk space on the disk partition used for the MongoDB process To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getDiskMeasurements + operationId: getGroupProcessDiskMeasurements parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54350,7 +54812,7 @@ paths: schema: $ref: '#/components/schemas/ApiMeasurementsGeneralView_Atlas' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -54364,7 +54826,8 @@ paths: summary: Return Measurements of One Disk for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getDiskMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessDiskMeasurements + x-xgen-operation-id-override: getProcessDiskMeasurements /api/atlas/v2/groups/{groupId}/processes/{processId}/measurements: get: description: |- @@ -54376,7 +54839,7 @@ paths: - Measurements for the host, such as CPU usage or number of I/O operations To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getHostMeasurements + operationId: getGroupProcessMeasurements parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54552,7 +55015,7 @@ paths: schema: $ref: '#/components/schemas/ApiMeasurementsGeneralView_Atlas' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -54566,11 +55029,12 @@ paths: summary: Return Measurements for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getHostMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessMeasurements + x-xgen-operation-id-override: getProcessMeasurements /api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/namespaces: get: description: Returns up to 20 namespaces for collections experiencing slow queries on the specified host. If you specify a secondary member of a replica set that hasn't received any database read operations, the endpoint doesn't return any namespaces. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listSlowQueryNamespaces + operationId: listGroupProcessPerformanceAdvisorNamespaces parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54626,11 +55090,12 @@ paths: summary: Return All Namespaces for One Host tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listSlowQueryNamespaces + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupProcessPerformanceAdvisorNamespaces + x-xgen-operation-id-override: listPerformanceAdvisorNamespaces /api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/slowQueryLogs: get: description: Returns log lines for slow queries that the Performance Advisor and Query Profiler identified. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. MongoDB Cloud bases the threshold for slow queries on the average time of operations on your cluster. This enables workload-relevant recommendations. To use this resource, the requesting Service Account or API Key must have any Project Data Access role or the Project Observability Viewer role. - operationId: listSlowQueries + operationId: listGroupProcessPerformanceAdvisorSlowQueryLogs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54721,11 +55186,12 @@ paths: summary: Return Slow Queries tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listSlowQueries + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupProcessPerformanceAdvisorSlowQueryLogs + x-xgen-operation-id-override: listSlowQueryLogs /api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/suggestedIndexes: get: description: Returns the indexes that the Performance Advisor suggests. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listSuggestedIndexes + operationId: listGroupProcessPerformanceAdvisorSuggestedIndexes parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54805,11 +55271,12 @@ paths: summary: Return All Suggested Indexes tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listSuggestedIndexes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupProcessPerformanceAdvisorSuggestedIndexes + x-xgen-operation-id-override: listSuggestedIndexes /api/atlas/v2/groups/{groupId}/pushBasedLogExport: delete: description: Disables the push-based log export feature by resetting the project level settings to its default configuration. - operationId: deletePushBasedLogConfiguration + operationId: deleteGroupPushBasedLogExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54833,10 +55300,11 @@ paths: summary: Disable Push-Based Log Export for One Project tags: - Push-Based Log Export - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/deletePushBasedLogConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/deleteGroupPushBasedLogExport + x-xgen-operation-id-override: deleteLogExport get: description: Fetches the current project level settings for the push-based log export feature. - operationId: getPushBasedLogConfiguration + operationId: getGroupPushBasedLogExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54860,16 +55328,17 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return Push-Based Log Export Configuration for One Project + summary: Return One Push-Based Log Export Configuration in One Project tags: - Push-Based Log Export - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/getPushBasedLogConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/getGroupPushBasedLogExport x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getLogExport patch: description: Updates the project level settings for the push-based log export feature. - operationId: updatePushBasedLogConfiguration + operationId: updateGroupPushBasedLogExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54898,13 +55367,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update Push-Based Log Export for One Project + summary: Update One Push-Based Log Export Configuration in One Project tags: - Push-Based Log Export - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/updatePushBasedLogConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/updateGroupPushBasedLogExport + x-xgen-operation-id-override: updateLogExport post: description: Configures the project level settings for the push-based log export feature. - operationId: createPushBasedLogConfiguration + operationId: createGroupPushBasedLogExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54933,14 +55403,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Enable Push-Based Log Export for One Project + summary: Create One Push-Based Log Export Configuration in One Project tags: - Push-Based Log Export - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/createPushBasedLogConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/createGroupPushBasedLogExport + x-xgen-operation-id-override: createLogExport /api/atlas/v2/groups/{groupId}/sampleDatasetLoad/{name}: post: description: Requests loading the MongoDB sample dataset into the specified cluster. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: loadSampleDataset + operationId: requestGroupSampleDatasetLoad parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54974,18 +55445,19 @@ paths: summary: Load Sample Dataset into One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/loadSampleDataset + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/requestGroupSampleDatasetLoad x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: request + x-xgen-operation-id-override: requestSampleDatasetLoad x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getSampleDatasetLoadStatus + operation-id: requestGroupSampleDatasetLoad params: groupId: input:groupId - sampleDatasetId: body:$.id + name: input:name expect: match: path: $.state @@ -54995,7 +55467,7 @@ paths: /api/atlas/v2/groups/{groupId}/sampleDatasetLoad/{sampleDatasetId}: get: description: Checks the progress of loading the sample dataset into one cluster. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getSampleDatasetLoadStatus + operationId: getGroupSampleDatasetLoad parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55013,7 +55485,7 @@ paths: schema: $ref: '#/components/schemas/SampleDatasetStatus' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -55027,7 +55499,8 @@ paths: summary: Return Status of Sample Dataset Load for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getSampleDatasetLoadStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getGroupSampleDatasetLoad + x-xgen-operation-id-override: getSampleDatasetLoad /api/atlas/v2/groups/{groupId}/serverless: get: description: |- @@ -55037,7 +55510,7 @@ paths: externalDocs: description: listFlexClusters url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/listFlexClusters - operationId: listServerlessInstances + operationId: listGroupServerlessInstances parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55066,7 +55539,11 @@ paths: summary: Return All Serverless Instances in One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/listServerlessInstances + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/listGroupServerlessInstances + x-xgen-method-verb-override: + customMethod: false + verb: listInstances + x-xgen-operation-id-override: listServerlessInstances post: description: |- Update as of Feb 2025: This endpoint now creates a Flex cluster instead. This endpoint will no longer be supported starting January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect. Please use the createFlexCluster endpoint instead. @@ -55075,7 +55552,7 @@ paths: externalDocs: description: createFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/createFlexCluster - operationId: createServerlessInstance + operationId: createGroupServerlessInstance parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55112,15 +55589,18 @@ paths: summary: Create One Serverless Instance in One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/createServerlessInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/createGroupServerlessInstance + x-xgen-method-verb-override: + customMethod: false + verb: createInstance + x-xgen-operation-id-override: createServerlessInstance x-xgen-atlascli: watcher: get: - version: "2024-11-13" - operation-id: getFlexCluster + version: "2023-01-01" + operation-id: createGroupServerlessInstance params: groupId: input:groupId - name: body:$.name expect: match: path: $.status @@ -55135,7 +55615,7 @@ paths: externalDocs: description: listFlexBackupRestoreJobs url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/listFlexBackupRestoreJobs - operationId: listServerlessBackupRestoreJobs + operationId: listGroupServerlessBackupRestoreJobs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55171,7 +55651,8 @@ paths: summary: Return All Restore Jobs for One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listServerlessBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupServerlessBackupRestoreJobs + x-xgen-operation-id-override: listServerlessRestoreJobs post: description: |- Restores one snapshot of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -55180,7 +55661,7 @@ paths: externalDocs: description: createFlexBackupRestoreJob url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/createFlexBackupRestoreJob - operationId: createServerlessBackupRestoreJob + operationId: createGroupServerlessBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55219,10 +55700,11 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Restore One Snapshot of One Serverless Instance + summary: Create One Restore Job for One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createServerlessBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createGroupServerlessBackupRestoreJob + x-xgen-operation-id-override: createServerlessRestoreJob /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/restoreJobs/{restoreJobId}: get: description: |- @@ -55232,7 +55714,7 @@ paths: externalDocs: description: getFlexBackupRestoreJob url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/getFlexBackupRestoreJob - operationId: getServerlessBackupRestoreJob + operationId: getGroupServerlessBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55258,7 +55740,7 @@ paths: schema: $ref: '#/components/schemas/ServerlessBackupRestoreJob' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -55274,7 +55756,8 @@ paths: summary: Return One Restore Job for One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getServerlessBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupServerlessBackupRestoreJob + x-xgen-operation-id-override: getServerlessRestoreJob /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/snapshots: get: description: |- @@ -55284,7 +55767,7 @@ paths: externalDocs: description: listFlexBackups url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/listFlexBackups - operationId: listServerlessBackups + operationId: listGroupServerlessBackupSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55320,7 +55803,8 @@ paths: summary: Return All Snapshots of One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listServerlessBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupServerlessBackupSnapshots + x-xgen-operation-id-override: listServerlessBackupSnapshots /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/snapshots/{snapshotId}: get: description: |- @@ -55330,7 +55814,7 @@ paths: externalDocs: description: getFlexBackup url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/getFlexBackup - operationId: getServerlessBackup + operationId: getGroupServerlessBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55356,7 +55840,7 @@ paths: schema: $ref: '#/components/schemas/ServerlessBackupSnapshot' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -55372,14 +55856,15 @@ paths: summary: Return One Snapshot of One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getServerlessBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupServerlessBackupSnapshot + x-xgen-operation-id-override: getServerlessBackupSnapshot /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/performanceAdvisor/autoIndexing: get: description: Get whether the Serverless Auto Indexing feature is enabled. This endpoint returns a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. externalDocs: description: createServerlessInstance url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/createServerlessInstance - operationId: getServerlessAutoIndexing + operationId: getGroupServerlessPerformanceAdvisorAutoIndexing parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -55412,16 +55897,17 @@ paths: summary: Return Serverless Auto-Indexing Status tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/getServerlessAutoIndexing + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/getGroupServerlessPerformanceAdvisorAutoIndexing x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getServerlessAutoIndexing post: description: Set whether the Serverless Auto Indexing feature is enabled. This endpoint sets a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. externalDocs: description: createServerlessInstance url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/createServerlessInstance - operationId: setServerlessAutoIndexing + operationId: setGroupServerlessPerformanceAdvisorAutoIndexing parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -55457,10 +55943,11 @@ paths: summary: Set Serverless Auto-Indexing Status tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/setServerlessAutoIndexing + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/setGroupServerlessPerformanceAdvisorAutoIndexing x-xgen-method-verb-override: customMethod: "True" verb: set + x-xgen-operation-id-override: setServerlessAutoIndexing /api/atlas/v2/groups/{groupId}/serverless/{name}: delete: description: |- @@ -55470,7 +55957,7 @@ paths: externalDocs: description: deleteFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/deleteFlexCluster - operationId: deleteServerlessInstance + operationId: deleteGroupServerlessInstance parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -55505,12 +55992,16 @@ paths: summary: Remove One Serverless Instance from One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/deleteServerlessInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/deleteGroupServerlessInstance + x-xgen-method-verb-override: + customMethod: false + verb: deleteInstance + x-xgen-operation-id-override: deleteServerlessInstance x-xgen-atlascli: watcher: get: - version: "2024-11-13" - operation-id: getFlexCluster + version: "2023-01-01" + operation-id: deleteGroupServerlessInstance params: groupId: input:groupId name: input:name @@ -55524,7 +56015,7 @@ paths: externalDocs: description: getFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/getFlexCluster - operationId: getServerlessInstance + operationId: getGroupServerlessInstance parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -55543,7 +56034,7 @@ paths: schema: $ref: '#/components/schemas/ServerlessInstanceDescription' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -55561,7 +56052,11 @@ paths: summary: Return One Serverless Instance from One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/getServerlessInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/getGroupServerlessInstance + x-xgen-method-verb-override: + customMethod: false + verb: getInstance + x-xgen-operation-id-override: getServerlessInstance patch: description: |- Updates one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -55570,7 +56065,7 @@ paths: externalDocs: description: updateFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/updateFlexCluster - operationId: updateServerlessInstance + operationId: updateGroupServerlessInstance parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55612,12 +56107,16 @@ paths: summary: Update One Serverless Instance in One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/updateServerlessInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/updateGroupServerlessInstance + x-xgen-method-verb-override: + customMethod: false + verb: updateInstance + x-xgen-operation-id-override: updateServerlessInstance x-xgen-atlascli: watcher: get: - version: "2024-11-13" - operation-id: getFlexCluster + version: "2023-01-01" + operation-id: updateGroupServerlessInstance params: groupId: input:groupId name: input:name @@ -55629,7 +56128,7 @@ paths: /api/atlas/v2/groups/{groupId}/serviceAccounts: get: description: Returns all Service Accounts for the specified Project. - operationId: listProjectServiceAccounts + operationId: listGroupServiceAccounts parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/itemsPerPage' @@ -55655,10 +56154,10 @@ paths: summary: Return All Project Service Accounts tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listProjectServiceAccounts + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listGroupServiceAccounts post: description: Creates one Service Account for the specified Project. The Service Account will automatically be added as an Organization Member to the Organization that the specified Project is a part of. - operationId: createProjectServiceAccount + operationId: createGroupServiceAccount parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -55692,11 +56191,11 @@ paths: summary: Create One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createGroupServiceAccount /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}: delete: description: Removes the specified Service Account from the specified project. The Service Account will still be a part of the Organization it was created in, and the credentials will remain active until expired or manually revoked. - operationId: deleteProjectServiceAccount + operationId: deleteGroupServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -55727,10 +56226,10 @@ paths: summary: Remove One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteGroupServiceAccount get: description: Returns one Service Account in the specified Project. - operationId: getProjectServiceAccount + operationId: getGroupServiceAccount parameters: - $ref: '#/components/parameters/groupId' - description: The Client ID of the Service Account. @@ -55750,7 +56249,7 @@ paths: schema: $ref: '#/components/schemas/GroupServiceAccount' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -55764,10 +56263,10 @@ paths: summary: Return One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getGroupServiceAccount patch: description: Updates one Service Account in the specified Project. - operationId: updateProjectServiceAccount + operationId: updateGroupServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -55808,11 +56307,11 @@ paths: summary: Update One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/updateProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/updateGroupServiceAccount /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/accessList: get: description: Returns all access list entries that you configured for the specified Service Account for the project. - operationId: listProjectServiceAccountAccessList + operationId: listGroupServiceAccountAccessList parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -55847,10 +56346,11 @@ paths: summary: Return All Access List Entries for One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listProjectServiceAccountAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listGroupServiceAccountAccessList + x-xgen-operation-id-override: listAccessList post: description: Add Access List Entries for the specified Service Account for the project. Resources require all API requests to originate from IP addresses on the API access list. - operationId: createProjectServiceAccountAccessList + operationId: createGroupServiceAccountAccessList parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -55900,11 +56400,12 @@ paths: summary: Add Access List Entries for One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createProjectServiceAccountAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createGroupServiceAccountAccessList + x-xgen-operation-id-override: createAccessList /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/accessList/{ipAddress}: delete: description: Removes the specified access list entry from the specified Service Account for the project. You can't remove the requesting IP address from the access list. - operationId: deleteProjectServiceAccountAccessListEntry + operationId: deleteGroupServiceAccountAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55944,11 +56445,15 @@ paths: summary: Remove One Access List Entry from One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteProjectServiceAccountAccessListEntry + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteGroupServiceAccountAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: deleteEntry + x-xgen-operation-id-override: deleteGroupAccessEntry /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/secrets: post: description: Create a secret for the specified Service Account in the specified Project. - operationId: createProjectServiceAccountSecret + operationId: createGroupServiceAccountSecret parameters: - $ref: '#/components/parameters/groupId' - description: The Client ID of the Service Account. @@ -55989,11 +56494,12 @@ paths: summary: Create One Project Service Account Secret tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createProjectServiceAccountSecret + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createGroupServiceAccountSecret + x-xgen-operation-id-override: createGroupSecret /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/secrets/{secretId}: delete: description: Deletes the specified Service Account secret. - operationId: deleteProjectServiceAccountSecret + operationId: deleteGroupServiceAccountSecret parameters: - description: The Client ID of the Service Account. in: path @@ -56029,11 +56535,12 @@ paths: summary: Delete One Project Service Account Secret tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteProjectServiceAccountSecret + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteGroupServiceAccountSecret + x-xgen-operation-id-override: deleteGroupSecret /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}:invite: post: description: Assigns the specified Service Account to the specified Project. - operationId: addProjectServiceAccount + operationId: inviteGroupServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -56073,11 +56580,11 @@ paths: summary: Assign One Service Account to One Project tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/addProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/inviteGroupServiceAccount /api/atlas/v2/groups/{groupId}/settings: get: description: Returns details about the specified project's settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProjectSettings + operationId: getGroupSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56089,7 +56596,7 @@ paths: schema: $ref: '#/components/schemas/GroupSettings' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -56103,10 +56610,10 @@ paths: summary: Return Project Settings tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupSettings patch: description: Updates the settings of the specified project. You can update any of the options available. MongoDB cloud only updates the options provided in the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateProjectSettings + operationId: updateGroupSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56137,11 +56644,11 @@ paths: summary: Update Project Settings tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroupSettings /api/atlas/v2/groups/{groupId}/streams: get: description: Returns all stream instances for the specified project. - operationId: listStreamInstances + operationId: listGroupStreamWorkspaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -56169,10 +56676,14 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listStreamInstances + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamWorkspaces + x-xgen-method-verb-override: + customMethod: false + verb: listWorkspaces + x-xgen-operation-id-override: listStreamWorkspaces post: description: Creates one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - operationId: createStreamInstance + operationId: createGroupStreamWorkspace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56207,11 +56718,15 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createStreamInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createGroupStreamWorkspace + x-xgen-method-verb-override: + customMethod: false + verb: createWorkspace + x-xgen-operation-id-override: createStreamWorkspace /api/atlas/v2/groups/{groupId}/streams/{tenantName}: delete: description: Delete one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - operationId: deleteStreamInstance + operationId: deleteGroupStreamWorkspace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56241,10 +56756,14 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteStreamInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamWorkspace + x-xgen-method-verb-override: + customMethod: false + verb: deleteWorkspace + x-xgen-operation-id-override: deleteStreamWorkspace get: description: Returns the details of one stream instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - operationId: getStreamInstance + operationId: getGroupStreamWorkspace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56266,7 +56785,7 @@ paths: schema: $ref: '#/components/schemas/StreamsTenant' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-02-01" description: OK "400": @@ -56284,10 +56803,14 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getStreamInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamWorkspace + x-xgen-method-verb-override: + customMethod: false + verb: getWorkspace + x-xgen-operation-id-override: getStreamWorkspace patch: description: Update one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - operationId: updateStreamInstance + operationId: updateGroupStreamWorkspace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56328,11 +56851,15 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateStreamInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateGroupStreamWorkspace + x-xgen-method-verb-override: + customMethod: false + verb: updateWorkspace + x-xgen-operation-id-override: updateStreamWorkspace /api/atlas/v2/groups/{groupId}/streams/{tenantName}/auditLogs: get: description: 'Downloads the audit logs for the specified Atlas Streams Processing instance. By default, logs cover periods of 30 days. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip".' - operationId: downloadStreamTenantAuditLogs + operationId: downloadGroupStreamAuditLogs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56383,14 +56910,15 @@ paths: summary: Download Audit Logs for One Atlas Stream Processing Instance tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/downloadStreamTenantAuditLogs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/downloadGroupStreamAuditLogs x-xgen-method-verb-override: customMethod: "True" verb: download + x-xgen-operation-id-override: downloadAuditLogs /api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections: get: description: Returns all connections of the stream instance for the specified project.To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - operationId: listStreamConnections + operationId: listGroupStreamConnections parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -56424,14 +56952,15 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listStreamConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamConnections + x-xgen-operation-id-override: listStreamConnections x-xgen-atlascli: override: description: | Returns all connections of the stream instance for the specified project. To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. post: description: Creates one connection for a stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - operationId: createStreamConnection + operationId: createGroupStreamConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56474,11 +57003,12 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createStreamConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createGroupStreamConnection + x-xgen-operation-id-override: createStreamConnection /api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections/{connectionName}: delete: description: Delete one connection of the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: deleteStreamConnection + operationId: deleteGroupStreamConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56516,10 +57046,11 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteStreamConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamConnection + x-xgen-operation-id-override: deleteStreamConnection get: description: Returns the details of one stream connection within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getStreamConnection + operationId: getGroupStreamConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56542,7 +57073,7 @@ paths: schema: $ref: '#/components/schemas/StreamsConnection' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-02-01" description: OK "401": @@ -56558,10 +57089,11 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getStreamConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamConnection + x-xgen-operation-id-override: getStreamConnection patch: description: Update one connection for the specified stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: updateStreamConnection + operationId: updateGroupStreamConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56610,11 +57142,12 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateStreamConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateGroupStreamConnection + x-xgen-operation-id-override: updateStreamConnection /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor: post: description: Create one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: createStreamProcessor + operationId: createGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56655,11 +57188,12 @@ paths: summary: Create One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createGroupStreamProcessor + x-xgen-operation-id-override: createStreamProcessor /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}: delete: description: Delete a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: deleteStreamProcessor + operationId: deleteGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56693,10 +57227,11 @@ paths: summary: Delete One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamProcessor + x-xgen-operation-id-override: deleteStreamProcessor get: description: Get one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: getStreamProcessor + operationId: getGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56720,7 +57255,7 @@ paths: schema: $ref: '#/components/schemas/StreamsProcessorWithStats' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-05-30" description: OK "400": @@ -56736,10 +57271,11 @@ paths: summary: Return One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamProcessor + x-xgen-operation-id-override: getStreamProcessor patch: description: Modify one existing Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: modifyStreamProcessor + operationId: updateGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56784,11 +57320,12 @@ paths: summary: Update One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/modifyStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateGroupStreamProcessor + x-xgen-operation-id-override: updateStreamProcessor /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:start: post: description: Start a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: startStreamProcessor + operationId: startGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56822,11 +57359,12 @@ paths: summary: Start One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/startStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/startGroupStreamProcessor + x-xgen-operation-id-override: startStreamProcessor /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:startWith: post: description: Start a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: startStreamProcessorWith + operationId: startGroupStreamProcessorWith parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56867,11 +57405,12 @@ paths: summary: Start One Stream Processor With Options tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/startStreamProcessorWith + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/startGroupStreamProcessorWith + x-xgen-operation-id-override: startStreamProcessorWith /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:stop: post: description: Stop a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: stopStreamProcessor + operationId: stopGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56905,11 +57444,12 @@ paths: summary: Stop One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/stopStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/stopGroupStreamProcessor + x-xgen-operation-id-override: stopStreamProcessor /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processors: get: description: Returns all Stream Processors within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: listStreamProcessors + operationId: getGroupStreamProcessors parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56930,8 +57470,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedApiStreamsStreamProcessorWithStatsView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2024-05-30" description: OK "400": @@ -56947,11 +57487,12 @@ paths: summary: Return All Stream Processors in One Stream Instance tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listStreamProcessors + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamProcessors + x-xgen-operation-id-override: getStreamProcessors /api/atlas/v2/groups/{groupId}/streams/accountDetails: get: description: Returns the Account ID, and the VPC ID for the group and region specified. - operationId: getAccountDetails + operationId: getGroupStreamAccountDetails parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -56986,14 +57527,15 @@ paths: summary: Return Account ID and VPC ID for One Project and Region tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getAccountDetails + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamAccountDetails x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getAccountDetails /api/atlas/v2/groups/{groupId}/streams/activeVpcPeeringConnections: get: description: Returns a list of active incoming VPC Peering Connections. - operationId: getActiveVpcPeeringConnections + operationId: listGroupStreamActiveVpcPeeringConnections parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -57017,11 +57559,12 @@ paths: summary: Return All Active Incoming VPC Peering Connections tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getActiveVpcPeeringConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamActiveVpcPeeringConnections + x-xgen-operation-id-override: listActivePeeringConnections /api/atlas/v2/groups/{groupId}/streams/privateLinkConnections: get: description: Returns all Private Link connections for the specified project.To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - operationId: listPrivateLinkConnections + operationId: listGroupStreamPrivateLinkConnections parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -57049,14 +57592,15 @@ paths: - Streams x-xgen-changelog: "2024-10-02": The MongoDB Atlas Streams Processing Private Link API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listPrivateLinkConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamPrivateLinkConnections + x-xgen-operation-id-override: listPrivateLinkConnections x-xgen-atlascli: override: description: | Returns all Private Link connections for the specified project. To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. post: description: Creates one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - operationId: createPrivateLinkConnection + operationId: createGroupStreamPrivateLinkConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -57093,11 +57637,12 @@ paths: - Streams x-xgen-changelog: "2024-10-02": The MongoDB Atlas Streams Processing Private Link API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createPrivateLinkConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createGroupStreamPrivateLinkConnection + x-xgen-operation-id-override: createPrivateLinkConnection /api/atlas/v2/groups/{groupId}/streams/privateLinkConnections/{connectionId}: delete: description: Deletes one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - operationId: deletePrivateLinkConnection + operationId: deleteGroupStreamPrivateLinkConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -57127,10 +57672,11 @@ paths: - Streams x-xgen-changelog: "2024-10-02": The MongoDB Atlas Streams Processing Private Link API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deletePrivateLinkConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamPrivateLinkConnection + x-xgen-operation-id-override: deletePrivateLinkConnection get: description: Returns the details of one Private Link connection within the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPrivateLinkConnection + operationId: getGroupStreamPrivateLinkConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57161,11 +57707,12 @@ paths: - Streams x-xgen-changelog: "2024-10-02": The MongoDB Atlas Streams Processing Private Link API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getPrivateLinkConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamPrivateLinkConnection + x-xgen-operation-id-override: getPrivateLinkConnection /api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections: get: description: Returns a list of incoming VPC Peering Connections. - operationId: getVpcPeeringConnections + operationId: listGroupStreamVpcPeeringConnections parameters: - description: The Account ID of the VPC Peering connection/s. in: query @@ -57195,11 +57742,12 @@ paths: summary: Return All VPC Peering Connections tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getVpcPeeringConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamVpcPeeringConnections + x-xgen-operation-id-override: listVpcPeeringConnections /api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}: delete: description: Deletes an incoming VPC Peering connection. - operationId: deleteVpcPeeringConnection + operationId: deleteGroupStreamVpcPeeringConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57226,11 +57774,12 @@ paths: summary: Delete One VPC Peering Connection tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteVpcPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamVpcPeeringConnection + x-xgen-operation-id-override: deleteVpcPeeringConnection /api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}:accept: post: description: Requests the acceptance of an incoming VPC Peering connection. - operationId: acceptVpcPeeringConnection + operationId: acceptGroupStreamVpcPeeringConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57264,11 +57813,12 @@ paths: summary: Accept One Incoming VPC Peering Connection tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/acceptVpcPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/acceptGroupStreamVpcPeeringConnection + x-xgen-operation-id-override: acceptVpcPeeringConnection /api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}:reject: post: description: Requests the rejection of an incoming VPC Peering connection. - operationId: rejectVpcPeeringConnection + operationId: rejectGroupStreamVpcPeeringConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57295,11 +57845,12 @@ paths: summary: Reject One Incoming VPC Peering Connection tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/rejectVpcPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/rejectGroupStreamVpcPeeringConnection + x-xgen-operation-id-override: rejectVpcPeeringConnection /api/atlas/v2/groups/{groupId}/streams:withSampleConnections: post: description: Creates one stream instance in the specified project with sample connections. To use this resource the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - operationId: createStreamInstanceWithSampleConnections + operationId: withGroupStreamSampleConnections parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -57332,11 +57883,12 @@ paths: summary: Create One Stream Instance with Sample Connections tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createStreamInstanceWithSampleConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/withGroupStreamSampleConnections + x-xgen-operation-id-override: withStreamSampleConnections /api/atlas/v2/groups/{groupId}/teams: get: description: Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listProjectTeams + operationId: listGroupTeams parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57365,13 +57917,13 @@ paths: summary: Return All Teams in One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/listProjectTeams + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/listGroupTeams post: description: Adds one team to the specified project. All members of the team share the same project access. MongoDB Cloud limits the number of users to a maximum of 100 teams per project and a maximum of 250 teams per organization. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: addAllTeamsToProject + operationId: addGroupTeams parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -57406,7 +57958,7 @@ paths: summary: Add One Team to One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/addAllTeamsToProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/addGroupTeams x-xgen-method-verb-override: customMethod: "True" verb: add @@ -57420,7 +57972,7 @@ paths: externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: removeProjectTeam + operationId: removeGroupTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57450,13 +58002,13 @@ paths: summary: Remove One Team from One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/removeProjectTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/removeGroupTeam x-xgen-method-verb-override: customMethod: "True" verb: remove get: description: Returns one team to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProjectTeam + operationId: getGroupTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57475,7 +58027,7 @@ paths: schema: $ref: '#/components/schemas/TeamRole' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: Content predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -57491,13 +58043,13 @@ paths: summary: Return One Team in One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getProjectTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getGroupTeam patch: description: Updates the project roles assigned to the specified team. You can grant team roles for specific projects and grant project access roles to users in the team. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: updateTeamRoles + operationId: updateGroupTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57523,7 +58075,7 @@ paths: schema: $ref: '#/components/schemas/PaginatedTeamRoleView' x-xgen-IPA-exception: - xgen-IPA-107-update-method-response-is-get-method-response: Content predates IPA validation + xgen-IPA-107-update-method-response-is-get-method-response: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -57539,11 +58091,11 @@ paths: summary: Update Team Roles in One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/updateTeamRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/updateGroupTeam /api/atlas/v2/groups/{groupId}/userSecurity: get: description: Returns the current LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getLdapConfiguration + operationId: getGroupUserSecurity parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57555,8 +58107,8 @@ paths: schema: $ref: '#/components/schemas/UserSecurity' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation. + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -57570,13 +58122,14 @@ paths: summary: Return LDAP or X.509 Configuration tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/getLdapConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/getGroupUserSecurity + x-xgen-operation-id-override: getUserSecurity patch: description: |- Edits the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Updating this configuration triggers a rolling restart of the database. - operationId: saveLdapConfiguration + operationId: updateGroupUserSecurity parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57609,14 +58162,15 @@ paths: summary: Update LDAP or X.509 Configuration tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/saveLdapConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/updateGroupUserSecurity + x-xgen-operation-id-override: updateUserSecurity /api/atlas/v2/groups/{groupId}/userSecurity/customerX509: delete: description: |- Clears the customer-managed X.509 settings on a project, including the uploaded Certificate Authority, which disables self-managed X.509. Updating this configuration triggers a rolling restart of the database. You must have the Project Owner role to use this endpoint. - operationId: disableCustomerManagedX509 + operationId: disableGroupUserSecurityCustomerX509 parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57639,14 +58193,15 @@ paths: summary: Disable Customer-Managed X.509 tags: - X.509 Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/disableCustomerManagedX509 + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/disableGroupUserSecurityCustomerX509 x-xgen-method-verb-override: customMethod: "True" verb: disable + x-xgen-operation-id-override: disableSecurityCustomerX509 /api/atlas/v2/groups/{groupId}/userSecurity/ldap/userToDNMapping: delete: description: Removes the current LDAP Distinguished Name mapping captured in the ``userToDNMapping`` document from the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteLdapConfiguration + operationId: deleteGroupUserSecurityLdapUserToDnMapping parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57670,11 +58225,12 @@ paths: summary: Remove LDAP User to DN Mapping tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/deleteLdapConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/deleteGroupUserSecurityLdapUserToDnMapping + x-xgen-operation-id-override: deleteLdapUserMapping /api/atlas/v2/groups/{groupId}/userSecurity/ldap/verify: post: description: Verifies the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: verifyLdapConfiguration + operationId: verifyGroupUserSecurityLdap parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57707,17 +58263,17 @@ paths: summary: Verify LDAP Configuration in One Project tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/verifyLdapConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/verifyGroupUserSecurityLdap x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: verifyUserSecurityLdap x-xgen-atlascli: watcher: get: version: "2023-01-01" - operation-id: getLdapConfigurationStatus + operation-id: verifyGroupUserSecurityLdap params: groupId: input:groupId - requestId: body:$.requestId expect: match: path: $.status @@ -57727,7 +58283,7 @@ paths: /api/atlas/v2/groups/{groupId}/userSecurity/ldap/verify/{requestId}: get: description: Returns the status of one request to verify one LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getLdapConfigurationStatus + operationId: getGroupUserSecurityLdapVerify parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57758,10 +58314,11 @@ paths: summary: Return Status of LDAP Configuration Verification in One Project tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/getLdapConfigurationStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/getGroupUserSecurityLdapVerify x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getUserSecurityVerify /api/atlas/v2/groups/{groupId}/users: get: description: |- @@ -57773,7 +58330,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: listProjectUsers + operationId: listGroupUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57829,10 +58386,10 @@ paths: summary: Return All MongoDB Cloud Users in One Project tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listProjectUsers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listGroupUsers post: description: "Adds one MongoDB Cloud user to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. \n- If the user has a pending invitation to join the project's organization, MongoDB Cloud modifies it and grants project access. \n- If the user doesn't have an invitation to join the organization, MongoDB Cloud sends a new invitation that grants the user organization and project access. \n- If the user is already active in the project's organization, MongoDB Cloud grants access to the project. \n" - operationId: addProjectUser + operationId: addGroupUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57867,7 +58424,7 @@ paths: summary: Add One MongoDB Cloud User to One Project tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addProjectUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addGroupUsers x-xgen-method-verb-override: customMethod: "True" verb: add @@ -57882,7 +58439,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeProjectUser + operationId: removeGroupUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57918,7 +58475,7 @@ paths: summary: Remove One MongoDB Cloud User from One Project tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeProjectUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeGroupUser x-xgen-method-verb-override: customMethod: "True" verb: remove @@ -57929,7 +58486,7 @@ paths: **Note**: You can only use this resource to fetch information about MongoDB Cloud human users. To return information about an API Key, use the [Return One Organization API Key](#tag/Programmatic-API-Keys/operation/getApiKey) endpoint. **Note**: This resource does not return information about pending users invited via the deprecated [Invite One MongoDB Cloud User to Join One Project](#tag/Projects/operation/createProjectInvitation) endpoint. - operationId: getProjectUser + operationId: getGroupUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57962,12 +58519,12 @@ paths: summary: Return One MongoDB Cloud User in One Project tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getProjectUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getGroupUser /api/atlas/v2/groups/{groupId}/users/{userId}/roles: put: deprecated: true description: Updates the roles of the specified user in the specified project. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified project. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. - operationId: updateProjectRoles + operationId: updateGroupUserRoles parameters: - $ref: '#/components/parameters/groupId' - description: Unique 24-hexadecimal digit string that identifies the user to modify. @@ -58006,7 +58563,7 @@ paths: summary: Update Project Roles for One MongoDB Cloud User tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroupUserRoles /api/atlas/v2/groups/{groupId}/users/{userId}:addRole: post: description: |- @@ -58016,7 +58573,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: addProjectRole + operationId: addGroupUserRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -58058,7 +58615,7 @@ paths: summary: Add One Project Role to One MongoDB Cloud User tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addProjectRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addGroupUserRole /api/atlas/v2/groups/{groupId}/users/{userId}:removeRole: post: description: |- @@ -58068,7 +58625,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeProjectRole + operationId: removeGroupUserRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -58110,11 +58667,11 @@ paths: summary: Remove One Project Role from One MongoDB Cloud User tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeProjectRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeGroupUserRole /api/atlas/v2/groups/{groupId}:migrate: post: description: Migrates a project from its current organization to another organization. All project users and their roles will be copied to the same project in the destination organization. You must include an organization API key with the Organization Owner role for the destination organization to verify access to the destination organization when you authenticate with Programmatic API Keys. Otherwise, the requesting user must have the Organization Owner role in both organizations. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: migrateProjectToAnotherOrg + operationId: migrateGroup parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -58144,11 +58701,11 @@ paths: summary: Migrate One Project to Another Organization tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/migrateProjectToAnotherOrg + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/migrateGroup /api/atlas/v2/groups/byName/{groupName}: get: description: Returns details about the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProjectByName + operationId: getGroupByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -58183,7 +58740,7 @@ paths: summary: Return One Project by Name tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupByName x-xgen-atlascli: override: description: | @@ -58191,7 +58748,7 @@ paths: /api/atlas/v2/orgs: get: description: Returns all organizations to which the requesting Service Account or API Key has access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - operationId: listOrganizations + operationId: listOrgs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -58226,13 +58783,13 @@ paths: summary: Return All Organizations tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrganizations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrgs post: description: Creates one organization in MongoDB Cloud and links it to the requesting Service Account's or API Key's organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. The requesting Service Account's or API Key's organization must be a paying organization. To learn more, see Configure a Paying Organization in the MongoDB Atlas documentation. externalDocs: description: Configure a Paying Organization url: https://www.mongodb.com/docs/atlas/billing/#configure-a-paying-organization - operationId: createOrganization + operationId: createOrg parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -58250,7 +58807,7 @@ paths: schema: $ref: '#/components/schemas/CreateOrganizationResponse' x-xgen-IPA-exception: - xgen-IPA-106-create-method-response-is-get-method-response: Content predates IPA validation + xgen-IPA-106-create-method-response-is-get-method-response: Content predates IPA validation. x-xgen-version: "2023-01-01" description: Created "400": @@ -58268,7 +58825,7 @@ paths: summary: Create One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/createOrganization + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/createOrg /api/atlas/v2/orgs/{orgId}: delete: description: |- @@ -58277,7 +58834,7 @@ paths: - Organizations with active projects cannot be removed. - All projects in the organization must be removed before you can remove the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: deleteOrganization + operationId: deleteOrg parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58304,10 +58861,10 @@ paths: summary: Remove One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/deleteOrganization + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/deleteOrg get: description: Returns one organization to which the requesting Service Account or API Key has access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - operationId: getOrganization + operationId: getOrg parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58319,7 +58876,7 @@ paths: schema: $ref: '#/components/schemas/AtlasOrganization' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58337,10 +58894,10 @@ paths: summary: Return One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrganization + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrg patch: description: Updates one organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: updateOrganization + operationId: updateOrg parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58375,14 +58932,14 @@ paths: summary: Update One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganization + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrg /api/atlas/v2/orgs/{orgId}/apiKeys: get: description: Returns all organization API keys for the specified organization. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the console. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: listApiKeys + operationId: listOrgApiKeys parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -58409,13 +58966,13 @@ paths: summary: Return All Organization API Keys tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listApiKeys + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listOrgApiKeys post: description: Creates one API key for the specified organization. An organization API key grants programmatic access to an organization. You can't use the API key to log into the console. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: createApiKey + operationId: createOrgApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58446,14 +59003,14 @@ paths: summary: Create One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createOrgApiKey /api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}: delete: description: Removes one organization API key from the specified organization. When you remove an API key from an organization, MongoDB Cloud also removes that key from any projects that use that key. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Configure Atlas API Access url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-enable-api-access-list - operationId: deleteApiKey + operationId: deleteOrgApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58482,13 +59039,13 @@ paths: summary: Remove One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/deleteApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/deleteOrgApiKey get: description: Returns one organization API key. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the user interface. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: getApiKey + operationId: getOrgApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58507,7 +59064,7 @@ paths: schema: $ref: '#/components/schemas/ApiKeyUserDetails' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -58521,13 +59078,13 @@ paths: summary: Return One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getOrgApiKey patch: description: Updates one organization API key in the specified organization. The organization API keys grant programmatic access to an organization. To use this resource, the requesting API Key must have the Organization Owner role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: updateApiKey + operationId: updateOrgApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58567,14 +59124,14 @@ paths: summary: Update One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateOrgApiKey /api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList: get: description: Returns all access list entries that you configured for the specified organization API key. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#view-the-details-of-one-api-key-in-one-organization - operationId: listApiKeyAccessListsEntries + operationId: listOrgApiKeyAccessListEntries parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -58608,10 +59165,14 @@ paths: summary: Return All Access List Entries for One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listApiKeyAccessListsEntries + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listOrgApiKeyAccessListEntries + x-xgen-method-verb-override: + customMethod: false + verb: listEntries + x-xgen-operation-id-override: listOrgAccessEntries post: description: Creates the access list entries for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. - operationId: createApiKeyAccessList + operationId: createOrgApiKeyAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -58658,14 +59219,18 @@ paths: summary: Create One Access List Entry for One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createApiKeyAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createOrgApiKeyAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: createEntry + x-xgen-operation-id-override: createOrgAccessEntry /api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList/{ipAddress}: delete: description: Removes the specified access list entry from the specified organization API key. Resources require all API requests originate from the IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. In addition, you cannot remove the requesting IP address from the requesting organization API key. externalDocs: description: Configure Atlas API Access url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-enable-api-access-list - operationId: deleteApiKeyAccessListEntry + operationId: deleteOrgApiKeyAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58704,16 +59269,17 @@ paths: summary: Remove One Access List Entry for One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/deleteApiKeyAccessListEntry + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/deleteOrgApiKeyAccessListEntry x-xgen-method-verb-override: customMethod: "True" verb: deleteEntry + x-xgen-operation-id-override: deleteAccessEntry get: description: Returns one access list entry for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Configure Atlas API Access url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-enable-api-access-list - operationId: getApiKeyAccessList + operationId: getOrgApiKeyAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58752,11 +59318,15 @@ paths: summary: Return One Access List Entry for One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getApiKeyAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getOrgApiKeyAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: getEntry + x-xgen-operation-id-override: getOrgAccessEntry /api/atlas/v2/orgs/{orgId}/billing/costExplorer/usage: post: description: Creates a query process within the Cost Explorer for the given parameters. A token is returned that can be used to poll the status of the query and eventually retrieve the results. - operationId: createCostExplorerQueryProcess + operationId: createOrgBillingCostExplorerUsageProcess parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -58788,11 +59358,15 @@ paths: summary: Create One Cost Explorer Query Process tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/createCostExplorerQueryProcess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/createOrgBillingCostExplorerUsageProcess + x-xgen-method-verb-override: + customMethod: false + verb: createProcess + x-xgen-operation-id-override: createCostExplorerProcess /api/atlas/v2/orgs/{orgId}/billing/costExplorer/usage/{token}: get: description: Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. If the data is not ready, a 'processing' response willindicate that another request should be sent later to view the data. - operationId: getCostExplorerQueryProcess + operationId: getOrgBillingCostExplorerUsage parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -58839,17 +59413,18 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return results from a given Cost Explorer query, or notify that the results are not ready yet. + summary: Return Usage Details for One Cost Explorer Query tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getCostExplorerQueryProcess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getOrgBillingCostExplorerUsage + x-xgen-operation-id-override: getCostExplorerUsage /api/atlas/v2/orgs/{orgId}/events: get: description: |- Returns events for the specified organization. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This resource remains under revision and may change. - operationId: listOrganizationEvents + operationId: listOrgEvents parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -58898,7 +59473,7 @@ paths: schema: $ref: '#/components/schemas/OrgPaginatedEventView' x-xgen-IPA-exception: - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58914,7 +59489,7 @@ paths: summary: Return Events from One Organization tags: - Events - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listOrganizationEvents + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listOrgEvents /api/atlas/v2/orgs/{orgId}/events/{eventId}: get: description: |- @@ -58924,7 +59499,7 @@ paths: externalDocs: description: Return Events from One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listOrganizationEvents - operationId: getOrganizationEvent + operationId: getOrgEvent parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58949,7 +59524,7 @@ paths: schema: $ref: '#/components/schemas/EventViewForOrg' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -58963,11 +59538,11 @@ paths: summary: Return One Event from One Organization tags: - Events - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/getOrganizationEvent + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/getOrgEvent /api/atlas/v2/orgs/{orgId}/federationSettings: get: description: Returns information about the federation settings for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. - operationId: getFederationSettings + operationId: getOrgFederationSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58979,7 +59554,7 @@ paths: schema: $ref: '#/components/schemas/OrgFederationSettings' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58995,7 +59570,8 @@ paths: summary: Return Federation Settings for One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getOrgFederationSettings + x-xgen-operation-id-override: getFederationSettings /api/atlas/v2/orgs/{orgId}/groups: get: description: |- @@ -59007,7 +59583,7 @@ paths: - Create different alert settings. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - operationId: listOrganizationProjects + operationId: getOrgGroups parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -59027,9 +59603,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedAtlasGroupView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -59045,7 +59620,7 @@ paths: summary: Return All Projects in One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrganizationProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrgGroups /api/atlas/v2/orgs/{orgId}/invites: get: deprecated: true @@ -59056,7 +59631,7 @@ paths: externalDocs: description: Return All MongoDB Cloud Users in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listOrganizationUsers - operationId: listOrganizationInvitations + operationId: listOrgInvites parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59076,12 +59651,12 @@ paths: $ref: '#/components/schemas/OrganizationInvitation' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-sunset: "2026-07-31" x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -59094,10 +59669,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return All Organization Invitations + summary: Return All Invitations in One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrganizationInvitations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrgInvites patch: deprecated: true description: |- @@ -59107,7 +59682,7 @@ paths: externalDocs: description: Update One MongoDB Cloud User in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/updateOrganizationUser - operationId: updateOrganizationInvitation + operationId: updateOrgInvites parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59138,10 +59713,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update One Organization Invitation + summary: Update One Invitation in One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganizationInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrgInvites x-xgen-atlascli: override: description: | @@ -59155,7 +59730,7 @@ paths: externalDocs: description: Add One MongoDB Cloud User to One url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/createOrganizationUser - operationId: createOrganizationInvitation + operationId: createOrgInvite parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59186,10 +59761,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Invite One MongoDB Cloud User to One Atlas Organization + summary: Create Invitation for One MongoDB Cloud User in One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/createOrganizationInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/createOrgInvite /api/atlas/v2/orgs/{orgId}/invites/{invitationId}: delete: deprecated: true @@ -59200,7 +59775,7 @@ paths: externalDocs: description: Remove One MongoDB Cloud User in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrganizationUser - operationId: deleteOrganizationInvitation + operationId: deleteOrgInvite parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59228,10 +59803,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Remove One Organization Invitation + summary: Remove One Invitation from One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/deleteOrganizationInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/deleteOrgInvite get: deprecated: true description: |- @@ -59241,7 +59816,7 @@ paths: externalDocs: description: Return One MongoDB Cloud User in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getOrganizationUser - operationId: getOrganizationInvitation + operationId: getOrgInvite parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59260,7 +59835,7 @@ paths: $ref: '#/components/schemas/OrganizationInvitation' x-sunset: "2026-07-31" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -59273,10 +59848,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Organization Invitation + summary: Return One Invitation in One Organization by Invitation ID tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrganizationInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrgInvite patch: deprecated: true description: |- @@ -59286,7 +59861,7 @@ paths: externalDocs: description: Update One MongoDB Cloud User in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/updateOrganizationUser - operationId: updateOrganizationInvitationById + operationId: updateOrgInviteById parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59324,10 +59899,13 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update One Organization Invitation by Invitation ID + summary: Update One Invitation in One Organization by Invitation ID tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganizationInvitationById + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrgInviteById + x-xgen-method-verb-override: + customMethod: false + verb: updateById x-xgen-atlascli: override: description: | @@ -59337,7 +59915,7 @@ paths: description: |- Returns all invoices that MongoDB issued to the specified organization. This list includes all invoices regardless of invoice status. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner role. To compute the total owed amount of the invoices - sum up total owed of each invoice. It could be computed as a sum of owed amount of each payment included into the invoice. To compute payment's owed amount - use formula *totalBilledCents* * *unitPrice* + *salesTax* - *startingBalanceCents*. - operationId: listInvoices + operationId: listOrgInvoices parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -59408,7 +59986,7 @@ paths: schema: $ref: '#/components/schemas/PaginatedApiInvoiceMetadataView' x-xgen-IPA-exception: - xgen-IPA-105-list-method-response-is-get-method-response: API predates IPA validation + xgen-IPA-105-list-method-response-is-get-method-response: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -59422,13 +60000,14 @@ paths: summary: Return All Invoices for One Organization tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/listInvoices + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/listOrgInvoices + x-xgen-operation-id-override: listInvoices /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}: get: description: |- Returns one invoice that MongoDB issued to the specified organization. A unique 24-hexadecimal digit string identifies the invoice. You can choose to receive this invoice in JSON or CSV format. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner role. To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula *totalBilledCents* * *unitPrice* + *salesTax* - *startingBalanceCents*. - operationId: getInvoice + operationId: getOrgInvoice parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59458,7 +60037,7 @@ paths: schema: $ref: '#/components/schemas/BillingInvoice' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -59472,13 +60051,14 @@ paths: summary: Return One Invoice for One Organization tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getInvoice + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getOrgInvoice + x-xgen-operation-id-override: getInvoice /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/csv: get: description: |- Returns one invoice that MongoDB issued to the specified organization in CSV format. A unique 24-hexadecimal digit string identifies the invoice. To use this resource, the requesting Service Account or API Key have at least the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner Role. To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula *totalBilledCents* * *unitPrice* + *salesTax* - *startingBalanceCents*. - operationId: downloadInvoiceCsv + operationId: getOrgInvoiceCsv parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59516,11 +60096,12 @@ paths: summary: Return One Invoice as CSV for One Organization tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/downloadInvoiceCsv + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getOrgInvoiceCsv + x-xgen-operation-id-override: getInvoiceCsv /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/lineItems:search: get: description: Query the lineItems of the specified invoice and return the result JSON. A unique 24-hexadecimal digit string identifies the invoice. - operationId: queryLineItemsFromSingleInvoice + operationId: searchOrgInvoiceLineItems parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/itemsPerPage' @@ -59561,11 +60142,12 @@ paths: summary: Return All Line Items for One Invoice by Invoice ID tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/queryLineItemsFromSingleInvoice + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/searchOrgInvoiceLineItems + x-xgen-operation-id-override: searchInvoiceLineItems /api/atlas/v2/orgs/{orgId}/invoices/pending: get: description: Returns all invoices accruing charges for the current billing cycle for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner Role. - operationId: listPendingInvoices + operationId: listOrgInvoicePending parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59589,11 +60171,12 @@ paths: summary: Return All Pending Invoices for One Organization tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/listPendingInvoices + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/listOrgInvoicePending + x-xgen-operation-id-override: listInvoicePending /api/atlas/v2/orgs/{orgId}/liveMigrations/availableProjects: get: description: Return all projects that you can migrate to the specified organization. - operationId: listSourceProjects + operationId: listOrgLiveMigrationAvailableProjects parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -59607,7 +60190,7 @@ paths: $ref: '#/components/schemas/LiveImportAvailableProject' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -59623,11 +60206,12 @@ paths: summary: Return All Projects Available for Migration tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/listSourceProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/listOrgLiveMigrationAvailableProjects + x-xgen-operation-id-override: listAvailableProjects /api/atlas/v2/orgs/{orgId}/liveMigrations/linkTokens: delete: description: Remove one organization link and its associated public API key. MongoDB Atlas uses the link-token for push live migrations only. Live migrations (push) let you securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: deleteLinkToken + operationId: deleteOrgLiveMigrationLinkTokens parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -59650,10 +60234,11 @@ paths: summary: Remove One Link-Token tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/deleteLinkToken + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/deleteOrgLiveMigrationLinkTokens + x-xgen-operation-id-override: deleteLinkTokens post: description: Create one link-token that contains all the information required to complete the link. MongoDB Atlas uses the link-token for push live migrations only. Live migration (push) allows you to securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: createLinkToken + operationId: createOrgLiveMigrationLinkToken parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -59686,14 +60271,15 @@ paths: summary: Create One Link-Token tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/createLinkToken + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/createOrgLiveMigrationLinkToken + x-xgen-operation-id-override: createLinkToken /api/atlas/v2/orgs/{orgId}/nonCompliantResources: get: description: Return all non-compliant resources for an org. externalDocs: description: Atlas Resource Policies url: https://dochub.mongodb.org/core/atlas-resource-policies - operationId: getResourcesNonCompliant + operationId: getOrgNonCompliantResources parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -59707,10 +60293,10 @@ paths: $ref: '#/components/schemas/ApiAtlasNonCompliantResourceView' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "400": @@ -59726,7 +60312,8 @@ paths: summary: Return All Non-Compliant Resources tags: - Resource Policies - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies/operation/getResourcesNonCompliant + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies/operation/getOrgNonCompliantResources + x-xgen-operation-id-override: getNonCompliantResources /api/atlas/v2/orgs/{orgId}/resourcePolicies: get: description: Return all Atlas Resource Policies for the org. @@ -59747,11 +60334,11 @@ paths: $ref: '#/components/schemas/ApiAtlasResourcePolicyView' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2024-08-05" description: OK "400": @@ -59881,7 +60468,7 @@ paths: schema: $ref: '#/components/schemas/ApiAtlasResourcePolicyView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "400": @@ -59959,7 +60546,7 @@ paths: externalDocs: description: Atlas Resource Policies url: https://dochub.mongodb.org/core/atlas-resource-policies - operationId: validateAtlasResourcePolicy + operationId: validateOrgResourcePolicies parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -59998,11 +60585,12 @@ paths: summary: Validate One Atlas Resource Policy tags: - Resource Policies - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies/operation/validateAtlasResourcePolicy + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies/operation/validateOrgResourcePolicies + x-xgen-operation-id-override: validateResourcePolicies /api/atlas/v2/orgs/{orgId}/serviceAccounts: get: description: Returns all Service Accounts for the specified Organization. - operationId: listServiceAccounts + operationId: listOrgServiceAccounts parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/itemsPerPage' @@ -60028,10 +60616,10 @@ paths: summary: Return All Organization Service Accounts tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listServiceAccounts + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listOrgServiceAccounts post: description: Creates one Service Account for the specified Organization. - operationId: createServiceAccount + operationId: createOrgServiceAccount parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -60064,11 +60652,11 @@ paths: summary: Create One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createOrgServiceAccount /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}: delete: description: Deletes the specified Service Account. - operationId: deleteServiceAccount + operationId: deleteOrgServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -60098,10 +60686,10 @@ paths: summary: Delete One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteOrgServiceAccount get: description: Returns the specified Service Account. - operationId: getServiceAccount + operationId: getOrgServiceAccount parameters: - $ref: '#/components/parameters/orgId' - description: The Client ID of the Service Account. @@ -60121,7 +60709,7 @@ paths: schema: $ref: '#/components/schemas/OrgServiceAccount' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -60135,10 +60723,10 @@ paths: summary: Return One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getOrgServiceAccount patch: description: Updates the specified Service Account in the specified Organization. - operationId: updateServiceAccount + operationId: updateOrgServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -60179,11 +60767,11 @@ paths: summary: Update One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/updateServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/updateOrgServiceAccount /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/accessList: get: description: Returns all access list entries that you configured for the specified Service Account for the organization. - operationId: listServiceAccountAccessList + operationId: listOrgServiceAccountAccessList parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -60218,10 +60806,11 @@ paths: summary: Return All Access List Entries for One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listServiceAccountAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listOrgServiceAccountAccessList + x-xgen-operation-id-override: listOrgAccessList post: description: Add Access List Entries for the specified Service Account for the organization. Resources require all API requests to originate from IP addresses on the API access list. - operationId: createServiceAccountAccessList + operationId: createOrgServiceAccountAccessList parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -60271,11 +60860,12 @@ paths: summary: Add Access List Entries for One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createServiceAccountAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createOrgServiceAccountAccessList + x-xgen-operation-id-override: createOrgAccessList /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/accessList/{ipAddress}: delete: description: Removes the specified access list entry from the specified Service Account for the organization. You can't remove the requesting IP address from the access list. - operationId: deleteServiceAccountAccessListEntry + operationId: deleteOrgServiceAccountAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60315,14 +60905,15 @@ paths: summary: Remove One Access List Entry from One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteServiceAccountAccessListEntry + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteOrgServiceAccountAccessListEntry x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: deleteEntry + x-xgen-operation-id-override: deleteOrgAccessEntry /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/groups: get: description: Returns a list of all projects the specified Service Account is a part of. - operationId: listServiceAccountProjects + operationId: getOrgServiceAccountGroups parameters: - $ref: '#/components/parameters/orgId' - description: The Client ID of the Service Account. @@ -60344,8 +60935,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedServiceAccountGroup' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -60359,11 +60950,12 @@ paths: summary: Return All Service Account Project Assignments tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listServiceAccountProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getOrgServiceAccountGroups + x-xgen-operation-id-override: getServiceAccountGroups /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/secrets: post: description: Create a secret for the specified Service Account. - operationId: createServiceAccountSecret + operationId: createOrgServiceAccountSecret parameters: - $ref: '#/components/parameters/orgId' - description: The Client ID of the Service Account. @@ -60404,11 +60996,12 @@ paths: summary: Create One Organization Service Account Secret tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createServiceAccountSecret + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createOrgServiceAccountSecret + x-xgen-operation-id-override: createOrgSecret /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/secrets/{secretId}: delete: description: Deletes the specified Service Account secret. - operationId: deleteServiceAccountSecret + operationId: deleteOrgServiceAccountSecret parameters: - description: The Client ID of the Service Account. in: path @@ -60444,11 +61037,12 @@ paths: summary: Delete One Organization Service Account Secret tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteServiceAccountSecret + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteOrgServiceAccountSecret + x-xgen-operation-id-override: deleteOrgSecret /api/atlas/v2/orgs/{orgId}/settings: get: description: Returns details about the specified organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - operationId: getOrganizationSettings + operationId: getOrgSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60460,7 +61054,7 @@ paths: schema: $ref: '#/components/schemas/OrganizationSettings' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -60474,10 +61068,10 @@ paths: summary: Return Settings for One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrganizationSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrgSettings patch: description: Updates the organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: updateOrganizationSettings + operationId: updateOrgSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60512,14 +61106,14 @@ paths: summary: Update Settings for One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganizationSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrgSettings /api/atlas/v2/orgs/{orgId}/teams: get: description: Returns all teams that belong to the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud only returns teams for which you have access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: listOrganizationTeams + operationId: listOrgTeams parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/itemsPerPage' @@ -60548,13 +61142,13 @@ paths: summary: Return All Teams in One Organization tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/listOrganizationTeams + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/listOrgTeams post: description: Creates one team in the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud limits the number of teams to a maximum of 250 teams per organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: createTeam + operationId: createOrgTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60589,14 +61183,14 @@ paths: summary: Create One Team in One Organization tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/createTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/createOrgTeam /api/atlas/v2/orgs/{orgId}/teams/{teamId}: delete: description: Removes one team specified using its unique 24-hexadecimal digit identifier from the organization specified using its unique 24-hexadecimal digit identifier. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: deleteTeam + operationId: deleteOrgTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60627,13 +61221,13 @@ paths: summary: Remove One Team from One Organization tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/deleteTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/deleteOrgTeam get: description: Returns one team that you identified using its unique 24-hexadecimal digit ID. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: getTeamById + operationId: getOrgTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60666,13 +61260,13 @@ paths: summary: Return One Team by ID tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getTeamById + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getOrgTeam patch: description: Renames one team in the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: renameTeam + operationId: renameOrgTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60714,7 +61308,7 @@ paths: summary: Rename One Team tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/renameTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/renameOrgTeam x-xgen-method-verb-override: customMethod: "True" verb: rename @@ -60729,7 +61323,7 @@ paths: externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: listTeamUsers + operationId: listOrgTeamUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/itemsPerPage' @@ -60789,7 +61383,8 @@ paths: summary: Return All MongoDB Cloud Users Assigned to One Team tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listTeamUsers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listOrgTeamUsers + x-xgen-operation-id-override: listTeamUsers post: deprecated: true description: |- @@ -60799,7 +61394,7 @@ paths: externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: addTeamUser + operationId: addOrgTeamUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60844,10 +61439,11 @@ paths: summary: Assign MongoDB Cloud Users in One Organization to One Team tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/addTeamUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/addOrgTeamUsers x-xgen-method-verb-override: customMethod: "True" verb: add + x-xgen-operation-id-override: addTeamUsers /api/atlas/v2/orgs/{orgId}/teams/{teamId}/users/{userId}: delete: deprecated: true @@ -60858,7 +61454,7 @@ paths: externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: removeTeamUser + operationId: removeOrgTeamUserFromTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60897,10 +61493,11 @@ paths: summary: Remove One MongoDB Cloud User from One Team tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/removeTeamUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/removeOrgTeamUserFromTeam x-xgen-method-verb-override: customMethod: "True" - verb: remove + verb: removeFromTeam + x-xgen-operation-id-override: removeUserFromTeam /api/atlas/v2/orgs/{orgId}/teams/{teamId}:addUser: post: description: |- @@ -60910,7 +61507,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project endpoint' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectInvitation - operationId: addUserToTeam + operationId: addOrgTeamUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60950,7 +61547,7 @@ paths: summary: Add One MongoDB Cloud User to One Team tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addUserToTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addOrgTeamUser /api/atlas/v2/orgs/{orgId}/teams/{teamId}:removeUser: post: description: |- @@ -60960,7 +61557,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeUserFromTeam + operationId: removeOrgTeamUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61000,14 +61597,14 @@ paths: summary: Remove One MongoDB Cloud User from One Team tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeUserFromTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrgTeamUser /api/atlas/v2/orgs/{orgId}/teams/byName/{teamName}: get: description: Returns one team that you identified using its human-readable name. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: getTeamByName + operationId: getOrgTeamByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61039,7 +61636,8 @@ paths: summary: Return One Team by Name tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getTeamByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getOrgTeamByName + x-xgen-operation-id-override: getTeamByName /api/atlas/v2/orgs/{orgId}/users: get: description: |- @@ -61051,7 +61649,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: listOrganizationUsers + operationId: listOrgUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61097,13 +61695,13 @@ paths: summary: Return All MongoDB Cloud Users in One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listOrganizationUsers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listOrgUsers post: description: |- Invites one new or existing MongoDB Cloud user to join the organization. The invitation to join the organization will be sent to the username provided and must be accepted within 30 days. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. **Note**: If the user does not have an existing MongoDB Cloud account, they will be prompted to finish setting up an account upon accepting the invitation. If the user already has an account, they will still receive an invitation to access the organization. - operationId: createOrganizationUser + operationId: createOrgUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61138,7 +61736,7 @@ paths: summary: Add One MongoDB Cloud User to One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/createOrganizationUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/createOrgUser /api/atlas/v2/orgs/{orgId}/users/{userId}: delete: description: |- @@ -61150,7 +61748,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeOrganizationUser + operationId: removeOrgUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61186,7 +61784,7 @@ paths: summary: Remove One MongoDB Cloud User from One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrganizationUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrgUser x-xgen-method-verb-override: customMethod: "True" verb: remove @@ -61197,7 +61795,7 @@ paths: **Note**: This resource can only be used to fetch information about MongoDB Cloud human users. To return information about an API Key, use the [Return One Organization API Key](#tag/Programmatic-API-Keys/operation/getApiKey) endpoint. **Note**: This resource does not return information about pending users invited via the deprecated [Invite One MongoDB Cloud User to Join One Project](#tag/Projects/operation/createProjectInvitation) endpoint. - operationId: getOrganizationUser + operationId: getOrgUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61230,7 +61828,7 @@ paths: summary: Return One MongoDB Cloud User in One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getOrganizationUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getOrgUser patch: description: |- Updates one MongoDB Cloud user in the specified organization. You can update an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -61241,7 +61839,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: updateOrganizationUser + operationId: updateOrgUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61281,12 +61879,12 @@ paths: summary: Update One MongoDB Cloud User in One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/updateOrganizationUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/updateOrgUser /api/atlas/v2/orgs/{orgId}/users/{userId}/roles: put: deprecated: true description: Updates the roles of the specified user in the specified organization. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization User Admin role. - operationId: updateOrganizationRoles + operationId: updateOrgUserRoles parameters: - $ref: '#/components/parameters/orgId' - description: Unique 24-hexadecimal digit string that identifies the user to modify. @@ -61325,7 +61923,7 @@ paths: summary: Update Organization Roles for One MongoDB Cloud User tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganizationRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrgUserRoles /api/atlas/v2/orgs/{orgId}/users/{userId}:addRole: post: description: |- @@ -61337,7 +61935,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: addOrganizationRole + operationId: addOrgUserRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61379,7 +61977,8 @@ paths: summary: Add One Organization Role to One MongoDB Cloud User tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addOrganizationRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addOrgUserRole + x-xgen-operation-id-override: addOrgRole /api/atlas/v2/orgs/{orgId}/users/{userId}:removeRole: post: description: |- @@ -61391,7 +61990,7 @@ paths: externalDocs: description: Invite One MongoDB Cloud User to Join One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeOrganizationRole + operationId: removeOrgUserRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -61431,11 +62030,12 @@ paths: summary: Remove One Organization Role from One MongoDB Cloud User tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrganizationRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrgUserRole + x-xgen-operation-id-override: removeOrgRole /api/atlas/v2/unauth/controlPlaneIPAddresses: get: description: Returns all control plane IP addresses. - operationId: returnAllControlPlaneIpAddresses + operationId: listControlPlaneIpAddresses parameters: - $ref: '#/components/parameters/envelope' responses: @@ -61445,9 +62045,9 @@ paths: schema: $ref: '#/components/schemas/ControlPlaneIPAddresses' x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-11-15" description: OK "500": @@ -61456,7 +62056,8 @@ paths: summary: Return All Control Plane IP Addresses tags: - Root - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Root/operation/returnAllControlPlaneIpAddresses + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Root/operation/listControlPlaneIpAddresses + x-xgen-operation-id-override: listControlPlaneAddresses /api/atlas/v2/users: post: deprecated: true @@ -61524,7 +62125,7 @@ paths: $ref: '#/components/schemas/CloudAppUser' x-sunset: "9999-12-31" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -61546,7 +62147,7 @@ paths: externalDocs: description: Return One Organization API Key url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getApiKey - operationId: getUserByUsername + operationId: getUserByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -61577,7 +62178,7 @@ paths: summary: Return One MongoDB Cloud User by Username tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getUserByUsername + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getUserByName security: - ServiceAccounts: [] - DigestAuth: [] diff --git a/tools/internal/specs/spec.yaml b/tools/internal/specs/spec.yaml index afbf3078ad..0c5a60985e 100644 --- a/tools/internal/specs/spec.yaml +++ b/tools/internal/specs/spec.yaml @@ -927,6 +927,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. enum: - US_GOV_WEST_1 @@ -968,6 +970,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object status: description: State of the Encryption At Rest private endpoint. @@ -1089,10 +1093,12 @@ components: mapping: aws: '#/components/schemas/AWSAccountDetails' azure: '#/components/schemas/AzureAccountDetails' + gcp: '#/components/schemas/GCPAccountDetails' propertyName: cloudProvider oneOf: - $ref: '#/components/schemas/AWSAccountDetails' - $ref: '#/components/schemas/AzureAccountDetails' + - $ref: '#/components/schemas/GCPAccountDetails' type: object AcknowledgeAlert: description: Acknowledging an alert prevents successive notifications. Specify the acknowledgeUntil date and optional comment or unacknowledgeAlert boolean. @@ -3766,7 +3772,7 @@ components: - name type: object AtlasResourcePolicyAuditForNdsGroup: - description: Atlas resource policy audits indicate org level changes to resource policies + description: Atlas resource policy audits indicate organization level changes to resource policies. properties: apiKeyId: description: Unique 24-hexadecimal digit string that identifies the API Key that triggered the event. If this resource returns this parameter, it doesn't return the **userId** parameter. @@ -3870,7 +3876,7 @@ components: title: Atlas Resource Policy Audits For NDS Group type: object AtlasResourcePolicyAuditForOrg: - description: Atlas resource policy audits indicate org level changes to resource policies + description: Atlas resource policy audits indicate organization level changes to resource policies. properties: apiKeyId: description: Unique 24-hexadecimal digit string that identifies the API Key that triggered the event. If this resource returns this parameter, it doesn't return the **userId** parameter. @@ -4003,7 +4009,7 @@ components: title: Atlas Search Analyzer type: object AtlasTenantClusterUpgradeRequest20240805: - description: Request containing target state of tenant cluster to be upgraded + description: Request containing target state of tenant cluster to be upgraded. properties: acceptDataRisksAndForceReplicaSetReconfig: description: If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set **acceptDataRisksAndForceReplicaSetReconfig** to the current date. This parameter expresses its value in the ISO 8601 timestamp format in UTC. @@ -4117,6 +4123,14 @@ components: pattern: ^([a-f0-9]{24})$ readOnly: true type: string + internalClusterRole: + description: 'Internal classification of the cluster''s role. Possible values: NONE (regular user cluster), SYSTEM_CLUSTER (system cluster for backup), INTERNAL_SHADOW_CLUSTER (internal use shadow cluster for testing).' + enum: + - NONE + - SYSTEM_CLUSTER + - INTERNAL_SHADOW_CLUSTER + readOnly: true + type: string labels: deprecated: true description: |- @@ -5190,6 +5204,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. enum: - US_GOV_WEST_1 @@ -5231,6 +5247,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object status: description: State of the Encryption At Rest private endpoint. @@ -6260,6 +6278,8 @@ components: - M400_NVME title: AWS Instance Sizes type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - enum: - M10 - M20 @@ -6285,6 +6305,8 @@ components: - M600_NVME title: Azure Instance Sizes type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - enum: - M10 - M20 @@ -7150,7 +7172,7 @@ components: - metricName type: object ChartsAudit: - description: Audit events related to Atlas Charts + description: Audit events related to Atlas Charts. properties: apiKeyId: description: Unique 24-hexadecimal digit string that identifies the API Key that triggered the event. If this resource returns this parameter, it doesn't return the **userId** parameter. @@ -8101,6 +8123,10 @@ components: AZURE: '#/components/schemas/CloudProviderAccessAzureServicePrincipal' GCP: '#/components/schemas/CloudProviderAccessGCPServiceAccount' propertyName: providerName + oneOf: + - $ref: '#/components/schemas/CloudProviderAccessAWSIAMRole' + - $ref: '#/components/schemas/CloudProviderAccessAzureServicePrincipal' + - $ref: '#/components/schemas/CloudProviderAccessGCPServiceAccount' properties: providerName: description: Human-readable label that identifies the cloud provider of the role. @@ -8329,6 +8355,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Microsoft Azure Regions. enum: - US_CENTRAL @@ -8386,6 +8414,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Google Compute Regions. enum: - EASTERN_US @@ -8440,6 +8470,8 @@ components: - ASIA_SOUTHEAST_2 title: GCP Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object title: Cloud Service Provider Settings for Multi-Cloud Clusters type: object @@ -8521,6 +8553,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Microsoft Azure Regions. enum: - US_CENTRAL @@ -8578,6 +8612,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Google Compute Regions. enum: - EASTERN_US @@ -8632,6 +8668,8 @@ components: - ASIA_SOUTHEAST_2 title: GCP Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object title: Cloud Service Provider Settings type: object @@ -9096,6 +9134,14 @@ components: pattern: ^([a-f0-9]{24})$ readOnly: true type: string + internalClusterRole: + description: 'Internal classification of the cluster''s role. Possible values: NONE (regular user cluster), SYSTEM_CLUSTER (system cluster for backup), INTERNAL_SHADOW_CLUSTER (internal use shadow cluster for testing).' + enum: + - NONE + - SYSTEM_CLUSTER + - INTERNAL_SHADOW_CLUSTER + readOnly: true + type: string labels: deprecated: true description: |- @@ -10335,7 +10381,7 @@ components: description: Request body for a cost explorer query. properties: clusters: - description: The list of projects to be included in the Cost Explorer Query. + description: The list of clusters to be included in the Cost Explorer Query. items: example: 32b6e34b3d91647abb20e7b8 pattern: ^([a-f0-9]{24})$ @@ -10371,7 +10417,7 @@ components: type: string type: array services: - description: The list of projects to be included in the Cost Explorer Query. + description: The list of SKU services to be included in the Cost Explorer Query. items: enum: - Atlas @@ -10505,7 +10551,7 @@ components: title: AWS type: object CreateAtlasOrganizationApiKey: - description: Details of the programmatic API key to be created. + description: Organization Service Account that Atlas creates for this organization. If omitted, Atlas doesn't create an organization Service Account for this organization. If specified, this object requires all body parameters. Note that API Keys cannot be specified in the same request. properties: desc: description: Purpose or explanation provided when someone created this organization API key. @@ -10835,11 +10881,23 @@ components: description: 'MongoDB find query that selects documents to archive. The specified query follows the syntax of the `db.collection.find(query)` command. This query can''t use the empty document (`{}`) to return all documents. Set this parameter when **"criteria.type" : "CUSTOM"**.' type: string type: object - description: '**CUSTOM criteria.type**.' + description: Custom archival criteria. required: - query title: Archival Criteria type: object + CustomSessionTimeouts: + description: Defines the session timeout settings for managing user sessions at the organization level. When set to null, the field's value is unset, and the default timeout settings are applied. + properties: + absoluteSessionTimeoutInSeconds: + description: Specifies the absolute session timeout duration in seconds. When set to null, the field's value is unset, and the default value of 43,200 seconds (12 hours) is applied. Accepted values range between a minimum of 3,600 seconds (1 hour) and a maximum of 43,200 seconds (12 hours). + format: int32 + type: integer + idleSessionTimeoutInSeconds: + description: 'Specifies the idle session timeout duration in seconds. When set to null, the field''s value is unset, and the default behavior depends on the context: no timeout for Atlas Commercial, and 600 seconds (10 minutes) for Atlas for Government. Accepted values start at a minimum of 300 seconds (5 minutes). For Atlas Commercial, the maximum value cannot exceed the configured absolute session timeout. For Atlas for Government, the maximum value is capped at 600 seconds (10 minutes).' + format: int32 + type: integer + type: object CustomZoneMappings: properties: customZoneMappings: @@ -11232,7 +11290,6 @@ components: mapping: atlas.project.deployment.clusters: '#/components/schemas/DefaultLimit' atlas.project.deployment.nodesPerPrivateLinkRegion: '#/components/schemas/DefaultLimit' - atlas.project.deployment.salesSoldM0s: '#/components/schemas/DefaultLimit' atlas.project.deployment.serverlessMTMs: '#/components/schemas/DefaultLimit' atlas.project.security.databaseAccess.customRoles: '#/components/schemas/DefaultLimit' atlas.project.security.databaseAccess.users: '#/components/schemas/DefaultLimit' @@ -12816,6 +12873,10 @@ components: default: false description: Toggle sending database metrics that includes database names and metrics on the number of collections, storage size, and index size. type: boolean + sendQueryStatsMetrics: + default: false + description: Toggle sending query shape metrics that includes query hash and metrics on latency, execution frequency, documents returned, and timestamps. + type: boolean sendUserProvidedResourceTags: default: false description: Toggle sending user provided group and cluster resource tags with the datadog metrics. @@ -12936,7 +12997,7 @@ components: format: int32 type: integer type: object - description: '**DATE criteria.type**.' + description: Date-Based archival criteria. title: Archival Criteria type: object DbDataSizeTotalDataMetricThresholdView: @@ -13134,6 +13195,8 @@ components: - USERS_WITHOUT_MULTI_FACTOR_AUTH - ENCRYPTION_AT_REST_KMS_NETWORK_ACCESS_DENIED - ENCRYPTION_AT_REST_CONFIG_NO_LONGER_VALID + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRED title: Group Event Types type: string - enum: @@ -13339,6 +13402,8 @@ components: - USERS_WITHOUT_MULTI_FACTOR_AUTH - ENCRYPTION_AT_REST_KMS_NETWORK_ACCESS_DENIED - ENCRYPTION_AT_REST_CONFIG_NO_LONGER_VALID + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRED title: Group Event Types type: string - enum: @@ -13558,6 +13623,7 @@ components: - CLUSTER_CONNECTION_CREATE_COLLECTION - CLUSTER_CONNECTION_SAMPLE_COLLECTION_FIELD_NAMES - CLUSTER_CONNECTION_SAMPLE_COLLECTION_FIELD_NAMES_AND_TYPES + - CLUSTER_CONNECTION_GET_NAMESPACES_AND_PROJECT_SQL_SCHEMA_DATA title: Cluster Connection Audit Types type: string - enum: @@ -13665,6 +13731,10 @@ components: - ENCRYPTION_AT_REST_KMS_NETWORK_ACCESS_RESTORED - ENCRYPTION_AT_REST_CONFIG_NO_LONGER_VALID - ENCRYPTION_AT_REST_CONFIG_IS_VALID + - GROUP_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRED + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRED title: Group Event Types type: string - enum: @@ -13832,6 +13902,11 @@ components: - EMPLOYEE_DOWNLOADED_CLUSTER_LOGS title: Access Event Types type: string + - enum: + - QUERY_SHAPE_BLOCKED + - QUERY_SHAPE_UNBLOCKED + title: Query Shape Event Types + type: string type: object groupId: description: Unique 24-hexadecimal digit string that identifies the project in which the event occurred. The **eventId** identifies the specific event. @@ -13945,6 +14020,8 @@ components: - ROLE_MAPPING_DELETED title: Federation Settings Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - GROUP_DELETED - GROUP_CREATED @@ -14062,7 +14139,7 @@ components: title: Any Other Events type: object DefaultLimit: - description: Details of user managed limits + description: Details of user managed limits. properties: currentUsage: description: Amount that indicates the current usage of the limit. @@ -14876,6 +14953,9 @@ components: url: https://www.mongodb.com/docs/atlas/security/set-up-unified-aws-access/ pattern: ^([a-f0-9]{24})$ type: string + requirePrivateNetworking: + description: Indicates whether to do exports over PrivateLink as opposed to public IPs. Defaults to False. + type: boolean type: object required: - bucketName @@ -14924,6 +15004,9 @@ components: example: us-east-1 readOnly: true type: string + requirePrivateNetworking: + description: Indicates whether to use privatelink. User supplied. + type: boolean required: - _id - bucketName @@ -15922,7 +16005,7 @@ components: description: One index key paired with its sort order. A value of `1` indicates an ascending sort order. A value of `-1` indicates a descending sort order. Keys in indexes with multiple keys appear in the same order that they appear in the index. type: object x-xgen-IPA-exception: - xgen-IPA-117-objects-must-be-well-defined: Schema predates IPA validation + xgen-IPA-117-objects-must-be-well-defined: Schema predates IPA validation. type: array name: description: Name of index. @@ -16054,6 +16137,8 @@ components: - NEW_ZEALAND_NORTH title: Azure Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers - description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. enum: - US_GOV_WEST_1 @@ -16095,6 +16180,8 @@ components: - GLOBAL title: AWS Regions type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Enum values standardized by cloud providers type: object status: description: State of the Encryption At Rest private endpoint. @@ -16318,7 +16405,7 @@ components: - CRITICAL type: string EventTypeDetails: - description: A singular type of event + description: A singular type of event. properties: alertable: description: Whether or not this event type can be configured as an alert via the API. @@ -16439,6 +16526,7 @@ components: - CLUSTER_CONNECTION_CREATE_COLLECTION - CLUSTER_CONNECTION_SAMPLE_COLLECTION_FIELD_NAMES - CLUSTER_CONNECTION_SAMPLE_COLLECTION_FIELD_NAMES_AND_TYPES + - CLUSTER_CONNECTION_GET_NAMESPACES_AND_PROJECT_SQL_SCHEMA_DATA title: Cluster Connection Audit Types type: string - enum: @@ -16575,6 +16663,10 @@ components: - ENCRYPTION_AT_REST_KMS_NETWORK_ACCESS_RESTORED - ENCRYPTION_AT_REST_CONFIG_NO_LONGER_VALID - ENCRYPTION_AT_REST_CONFIG_IS_VALID + - GROUP_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRING + - GROUP_SERVICE_ACCOUNT_SECRETS_NO_LONGER_EXPIRED + - GROUP_SERVICE_ACCOUNT_SECRETS_EXPIRED title: Group Event Types type: string - enum: @@ -16601,6 +16693,7 @@ components: - SSH_KEY_NDS_HOST_ACCESS_REFRESHED - SSH_KEY_NDS_HOST_ACCESS_ATTEMPT - SSH_KEY_NDS_HOST_ACCESS_GRANTED + - SSH_KEY_NDS_HOST_ACCESS_LEVEL_CHANGED - HOST_SSH_SESSION_ENDED - HOST_X509_CERTIFICATE_CERTIFICATE_GENERATED_FOR_SUPPORT_ACCESS - PUSH_BASED_LOG_EXPORT_RESUMED @@ -16613,6 +16706,8 @@ components: - HOST_SECURITY_CHECKUP_NOT_MET title: Host Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - INSIDE_METRIC_THRESHOLD - OUTSIDE_METRIC_THRESHOLD @@ -16763,6 +16858,7 @@ components: - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_ENABLED - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_UPDATED - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_DISABLED + - ONLINE_ARCHIVE_DELETE_AFTER_DATE_UPDATED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_ADDED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_DELETED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_UPDATED @@ -16822,6 +16918,18 @@ components: - PUSH_BASED_LOG_EXPORT_ENABLED - PUSH_BASED_LOG_EXPORT_CONFIGURATION_UPDATED - PUSH_BASED_LOG_EXPORT_DISABLED + - LOG_STREAMING_ENABLED + - LOG_STREAMING_CONFIGURATION_UPDATED + - LOG_STREAMING_DISABLED + - DATADOG_LOG_STREAMING_ENABLED + - DATADOG_LOG_STREAMING_CONFIGURATION_UPDATED + - DATADOG_LOG_STREAMING_DISABLED + - SPLUNK_LOG_STREAMING_ENABLED + - SPLUNK_LOG_STREAMING_CONFIGURATION_UPDATED + - SPLUNK_LOG_STREAMING_DISABLED + - S3_LOG_STREAMING_ENABLED + - S3_LOG_STREAMING_CONFIGURATION_UPDATED + - S3_LOG_STREAMING_DISABLED - AZURE_CLUSTER_PREFERRED_STORAGE_TYPE_UPDATED - CONTAINER_DELETED - REGIONALIZED_PRIVATE_ENDPOINT_MODE_ENABLED @@ -16858,8 +16966,12 @@ components: - AZ_BALANCING_OVERRIDE_MODIFIED - FTDC_SETTINGS_UPDATED - PROXY_PROTOCOL_FOR_PRIVATE_LINK_MODE_UPDATED + - MONGOTUNE_WRITE_BLOCK_POLICY_ELIGIBLE + - MONGOTUNE_WRITE_BLOCK_POLICY_INELIGIBLE title: NDS Audit Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - DB_CHECK_SUBMITTED - DB_CHECK_UPDATED @@ -17099,6 +17211,11 @@ components: - RESOURCE_POLICY_VIOLATED title: Atlas Resource Policy Audit Types type: string + - enum: + - QUERY_SHAPE_BLOCKED + - QUERY_SHAPE_UNBLOCKED + title: Query Shape Event Types + type: string type: object EventTypeForOrg: oneOf: @@ -17215,6 +17332,8 @@ components: - EVERGREEN_PRIORITY_MODIFIED title: Billing Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - FEDERATION_SETTINGS_CREATED - FEDERATION_SETTINGS_DELETED @@ -17242,6 +17361,8 @@ components: - ROLE_MAPPING_DELETED title: Federation Settings Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - GROUP_DELETED - GROUP_CREATED @@ -17333,6 +17454,8 @@ components: - SANDBOX_DISABLED_FOR_ORG title: Org Event Types type: string + x-xgen-IPA-exception: + xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation. - enum: - AWS_SELF_SERVE_ACCOUNT_LINKED - AWS_SELF_SERVE_ACCOUNT_LINK_PENDING @@ -17482,7 +17605,7 @@ components: - metricName type: object ExtraRetentionSetting: - description: extra retention setting item in the desired backup policy. + description: Extra retention setting item in the desired backup policy. properties: frequencyType: description: The frequency type for the extra retention settings for the cluster. @@ -19592,6 +19715,30 @@ components: required: - metricName type: object + GCPAccountDetails: + properties: + cidrBlock: + description: The VPC CIDR Block. + type: string + cloudProvider: + description: Cloud provider. + type: string + gcpProjectId: + description: The GCP Project ID. + type: string + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + vpcNetworkName: + description: The name of the VPC network. + type: string + type: object GCPCloudProviderContainer: allOf: - $ref: '#/components/schemas/CloudProviderContainer' @@ -19666,8 +19813,6 @@ components: - WESTERN_EUROPE - WESTERN_US type: string - x-xgen-IPA-exception: - xgen-IPA-123-allowable-enum-values-should-not-exceed-20: Schema predates IPA validation type: array type: object description: Collection of settings that configures the network container for a virtual private connection on Amazon Web Services. @@ -21416,6 +21561,7 @@ components: - SSH_KEY_NDS_HOST_ACCESS_REFRESHED - SSH_KEY_NDS_HOST_ACCESS_ATTEMPT - SSH_KEY_NDS_HOST_ACCESS_GRANTED + - SSH_KEY_NDS_HOST_ACCESS_LEVEL_CHANGED - HOST_SSH_SESSION_ENDED - HOST_X509_CERTIFICATE_CERTIFICATE_GENERATED_FOR_SUPPORT_ACCESS - PUSH_BASED_LOG_EXPORT_RESUMED @@ -24160,7 +24306,7 @@ components: title: Cluster Description type: object LegacyAtlasTenantClusterUpgradeRequest: - description: Request containing target state of tenant cluster to be upgraded + description: Request containing target state of tenant cluster to be upgraded. properties: acceptDataRisksAndForceReplicaSetReconfig: description: If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set **acceptDataRisksAndForceReplicaSetReconfig** to the current date. This parameter expresses its value in the ISO 8601 timestamp format in UTC. @@ -25970,7 +26116,7 @@ components: type: array type: object MetricDataPoint: - description: value of, and metadata provided for, one data point generated at a particular moment in time. If no data point exists for a particular moment in time, the `value` parameter returns `null`. + description: Value of, and metadata provided for, one data point generated at a particular moment in time. If no data point exists for a particular moment in time, the `value` parameter returns `null`. properties: timestamp: description: Date and time when this data point occurred. This parameter expresses its value in the ISO 8601 timestamp format in UTC. @@ -25984,7 +26130,7 @@ components: readOnly: true type: object MetricDataPoint_Atlas: - description: value of, and metadata provided for, one data point generated at a particular moment in time. If no data point exists for a particular moment in time, the `value` parameter returns `null`. + description: Value of, and metadata provided for, one data point generated at a particular moment in time. If no data point exists for a particular moment in time, the `value` parameter returns `null`. properties: timestamp: description: Date and time when this data point occurred. This parameter expresses its value in the ISO 8601 timestamp format in UTC. @@ -26518,6 +26664,7 @@ components: - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_ENABLED - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_UPDATED - ONLINE_ARCHIVE_DATA_EXPIRATION_RULE_DISABLED + - ONLINE_ARCHIVE_DELETE_AFTER_DATE_UPDATED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_ADDED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_DELETED - CLOUD_PROVIDER_ACCESS_AWS_IAM_ROLE_UPDATED @@ -26577,6 +26724,18 @@ components: - PUSH_BASED_LOG_EXPORT_ENABLED - PUSH_BASED_LOG_EXPORT_CONFIGURATION_UPDATED - PUSH_BASED_LOG_EXPORT_DISABLED + - LOG_STREAMING_ENABLED + - LOG_STREAMING_CONFIGURATION_UPDATED + - LOG_STREAMING_DISABLED + - DATADOG_LOG_STREAMING_ENABLED + - DATADOG_LOG_STREAMING_CONFIGURATION_UPDATED + - DATADOG_LOG_STREAMING_DISABLED + - SPLUNK_LOG_STREAMING_ENABLED + - SPLUNK_LOG_STREAMING_CONFIGURATION_UPDATED + - SPLUNK_LOG_STREAMING_DISABLED + - S3_LOG_STREAMING_ENABLED + - S3_LOG_STREAMING_CONFIGURATION_UPDATED + - S3_LOG_STREAMING_DISABLED - AZURE_CLUSTER_PREFERRED_STORAGE_TYPE_UPDATED - CONTAINER_DELETED - REGIONALIZED_PRIVATE_ENDPOINT_MODE_ENABLED @@ -26613,6 +26772,8 @@ components: - AZ_BALANCING_OVERRIDE_MODIFIED - FTDC_SETTINGS_UPDATED - PROXY_PROTOCOL_FOR_PRIVATE_LINK_MODE_UPDATED + - MONGOTUNE_WRITE_BLOCK_POLICY_ELIGIBLE + - MONGOTUNE_WRITE_BLOCK_POLICY_INELIGIBLE example: CLUSTER_CREATED title: NDS Audit Types type: string @@ -27377,7 +27538,10 @@ components: ***IMPORTANT**: Effective Wednesday, June 16th, 2021, New Relic no longer supports the plugin-based integration with MongoDB. We do not recommend that you sign up for the plugin-based integration. - To learn more, see the New Relic Plugin EOL Statement. Consider configuring an alternative monitoring integration before June 16th to maintain visibility into your MongoDB deployments. + Consider configuring an alternative monitoring integration before June 16th to maintain visibility into your MongoDB deployments. + externalDocs: + description: New Relic Plugin EOL Statement + url: https://discuss.newrelic.com/t/new-relic-plugin-eol-wednesday-june-16th-2021/127267 properties: accountId: description: Unique 40-hexadecimal digit string that identifies your New Relic account. @@ -28856,7 +29020,7 @@ components: readOnly: true type: object OrgServiceAccountRequest: - description: Organization Service Account that Atlas creates for this organization. If omitted, Atlas doesn't create an organization Service Account for this organization. If specified, this object requires all body parameters. + description: Organization Service Account that Atlas creates for this organization. If omitted, Atlas doesn't create an organization Service Account for this organization. If specified, this object requires all body parameters. Note that API Keys cannot be specified in the same request. properties: description: description: Human readable description for the Service Account. @@ -29228,6 +29392,8 @@ components: apiAccessListRequired: description: Flag that indicates whether to require API operations to originate from an IP Address added to the API access list for the specified organization. type: boolean + customSessionTimeouts: + $ref: '#/components/schemas/CustomSessionTimeouts' genAIFeaturesEnabled: default: true description: Flag that indicates whether this organization has access to generative AI features. This setting only applies to Atlas Commercial and is enabled by default. Once this setting is turned on, Project Owners may be able to enable or disable individual AI features at the project level. @@ -31060,8 +31226,8 @@ components: readOnly: true type: object x-xgen-IPA-exception: - xgen-IPA-117-objects-must-be-well-defined: Schema predates IPA validation - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-117-objects-must-be-well-defined: Schema predates IPA validation. + xgen-IPA-124-array-max-items: Schema predates IPA validation. readOnly: true type: array stats: @@ -31253,7 +31419,7 @@ components: type: array type: object PinnedNamespaces: - description: Pinned namespaces view for cluster + description: Pinned namespaces view for cluster. properties: clusterId: description: Unique 24-hexadecimal digit string that identifies the request cluster. @@ -31759,6 +31925,9 @@ components: queryShapeHash: description: A hexadecimal string that represents the hash of a MongoDB query shape. type: string + systemQuery: + description: Indicates whether this query shape represents a system-initiated query. + type: boolean totalTimeToResponseMicros: description: Time in microseconds spent from the beginning of query processing to the first server response. format: double @@ -32599,7 +32768,7 @@ components: title: Replication Specifications type: object RequestAccepted: - description: Accepted + description: Accepted. type: object ResourceEventTypeView: description: Unique identifier of event type. @@ -36074,6 +36243,14 @@ components: StreamsKafkaAuthentication: description: User credentials required to connect to a Kafka Cluster. Includes the authentication type, as well as the parameters for that authentication mode. properties: + clientId: + description: OIDC client identifier for authentication to the Kafka cluster. This field is not supported yet. + type: string + clientSecret: + description: OIDC client secret for authentication to the Kafka cluster. This field is not supported yet. + format: password + type: string + writeOnly: true links: description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. externalDocs: @@ -36084,13 +36261,22 @@ components: readOnly: true type: array mechanism: - description: Style of authentication. Can be one of PLAIN, SCRAM-256, or SCRAM-512. + description: Style of authentication. Can be one of PLAIN, SCRAM-256, SCRAM-512, or OAUTHBEARER. + type: string + method: + description: SASL OAUTHBEARER authentication method. Can only be OIDC currently. This field is not supported yet. type: string password: description: Password of the account to connect to the Kafka cluster. format: password type: string writeOnly: true + saslOauthbearerExtensions: + description: SASL OAUTHBEARER extensions parameter for additional OAuth2 configuration. This field is not supported yet. + type: string + scope: + description: OIDC scope parameter defining the access permissions requested. This field is not supported yet. + type: string sslCertificate: description: SSL certificate for client authentication to Kafka. type: string @@ -36102,6 +36288,9 @@ components: description: Password for the SSL key, if it is password protected. type: string writeOnly: true + tokenEndpointUrl: + description: OIDC token endpoint URL for obtaining access tokens. This field is not supported yet. + type: string username: description: Username of the account to connect to the Kafka cluster. type: string @@ -36166,10 +36355,6 @@ components: name: description: Reserved. Will be used by PRIVATE_LINK connection type. type: string - tgwId: - description: Reserved. Will be used by TRANSIT_GATEWAY connection type. - pattern: ^(tgw-)[0-9a-zA-Z]+$ - type: string tgwRouteId: description: Reserved. Will be used by TRANSIT_GATEWAY connection type. example: 32b6e34b3d91647abb20e7b8 @@ -36184,9 +36369,6 @@ components: - TRANSIT_GATEWAY title: Networking Access Type type: string - vpcCIDR: - description: Reserved. Will be used by TRANSIT_GATEWAY connection type. - type: string type: object StreamsKafkaSecurity: description: Properties for the secure transport connection to Kafka. For SSL, this can include the trusted certificate to use. @@ -36242,7 +36424,7 @@ components: title: Streams Matcher Fields type: string StreamsModifyStreamProcessor: - description: A request to modify an existing stream processor + description: A request to modify an existing stream processor. properties: links: description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. @@ -36333,6 +36515,13 @@ components: description: Error message if the state is FAILED. readOnly: true type: string + gcpServiceAttachmentUris: + description: Service Attachment URIs of each availability zone for the GCP Confluent cluster. + items: + type: string + maxItems: 3 + type: array + uniqueItems: true interfaceEndpointId: description: Interface endpoint ID that is created from the service endpoint ID provided. readOnly: true @@ -36505,7 +36694,7 @@ components: type: boolean type: object StreamsStartStreamProcessorWith: - description: A request to start a stream processor + description: A request to start a stream processor. properties: links: description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. @@ -37402,7 +37591,7 @@ components: definition: $ref: '#/components/schemas/TextSearchIndexDefinition' type: object - description: Text Search Index Create Request + description: Text Search Index Create Request. required: - collectionName - database @@ -38904,7 +39093,7 @@ components: definition: $ref: '#/components/schemas/VectorSearchIndexDefinition' type: object - description: Vector Search Index Create Request + description: Vector Search Index Create Request. required: - collectionName - database @@ -39852,7 +40041,7 @@ info: termsOfService: https://www.mongodb.com/mongodb-management-service-terms-and-conditions title: MongoDB Atlas Administration API version: "2.0" - x-xgen-sha: 71ac9e4b796c59607af25b073aa510451ae85fdb + x-xgen-sha: 6d1feb3f4a77896c6eda8ce3e744affc6a1f024c openapi: 3.0.1 paths: /api/atlas/v2: @@ -39880,14 +40069,17 @@ paths: $ref: '#/components/responses/forbidden' "500": $ref: '#/components/responses/internalServerError' - summary: Return the status of this MongoDB application + summary: Return the Status of This MongoDB Application tags: - Root x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Root/operation/getSystemStatus + x-xgen-method-verb-override: + customMethod: false + verb: getSystemStatus /api/atlas/v2/alertConfigs/matchers/fieldNames: get: description: Get all field names that the `matchers.fieldName` parameter accepts when you create or update an Alert Configuration. You can successfully call this endpoint with any assigned role. - operationId: listAlertConfigurationMatchersFieldNames + operationId: listAlertConfigMatcherFieldNames parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -39900,7 +40092,7 @@ paths: $ref: '#/components/schemas/MatcherFieldView' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -39912,11 +40104,12 @@ paths: summary: Return All Alert Configuration Matchers Field Names tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurationMatchersFieldNames + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigMatcherFieldNames + x-xgen-operation-id-override: listMatcherFieldNames /api/atlas/v2/clusters: get: description: Returns the details for all clusters in all projects to which you have access. Clusters contain a group of hosts that maintain the same data set. The response does not include multi-cloud clusters. To use this resource, the requesting Service Account or API Key can have any cluster-level role. - operationId: listClustersForAllProjects + operationId: listClusterDetails parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -39940,7 +40133,10 @@ paths: summary: Return All Authorized Clusters in All Projects tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listClustersForAllProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listClusterDetails + x-xgen-method-verb-override: + customMethod: false + verb: listDetails /api/atlas/v2/eventTypes: get: description: Returns a list of all event types, along with a description and additional metadata about each event. @@ -39972,7 +40168,7 @@ paths: /api/atlas/v2/federationSettings/{federationSettingsId}: delete: description: 'Deletes the federation settings instance and all associated data, including identity providers and domains. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the last remaining connected organization. **Note**: requests to this resource will fail if there is more than one connected organization in the federation.' - operationId: deleteFederationApp + operationId: deleteFederationSetting parameters: - $ref: '#/components/parameters/federationSettingsId' responses: @@ -39994,11 +40190,11 @@ paths: summary: Delete One Federation Settings Instance tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteFederationApp + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteFederationSetting /api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs: get: description: Returns all connected org configs in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected orgs. - operationId: listConnectedOrgConfigs + operationId: listFederationSettingConnectedOrgConfigs parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40025,11 +40221,12 @@ paths: summary: Return All Organization Configurations from One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listConnectedOrgConfigs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listFederationSettingConnectedOrgConfigs + x-xgen-operation-id-override: listConnectedOrgConfigs /api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}: delete: description: 'Removes one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This request fails if only one connected organization exists in the federation.' - operationId: removeConnectedOrgConfig + operationId: removeFederationSettingConnectedOrgConfig parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40060,13 +40257,14 @@ paths: summary: Remove One Organization Configuration from One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/removeConnectedOrgConfig + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/removeFederationSettingConnectedOrgConfig x-xgen-method-verb-override: customMethod: "True" verb: remove + x-xgen-operation-id-override: removeConnectedOrgConfig get: description: Returns the specified connected org config from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. - operationId: getConnectedOrgConfig + operationId: getFederationSettingConnectedOrgConfig parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40085,7 +40283,7 @@ paths: schema: $ref: '#/components/schemas/ConnectedOrgConfig' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -40101,10 +40299,11 @@ paths: summary: Return One Organization Configuration from One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getConnectedOrgConfig + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettingConnectedOrgConfig + x-xgen-operation-id-override: getConnectedOrgConfig patch: description: "Updates one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. \n\n**Note** If the organization configuration has no associated identity provider, you can't use this resource to update role mappings or post authorization role grants. \n\n**Note**: The domainRestrictionEnabled field defaults to false if not provided in the request. \n\n**Note**: If the identityProviderId field is not provided, you will disconnect the organization and the identity provider. \n\n**Note**: Currently connected data access identity providers missing from the dataAccessIdentityProviderIds field will be disconnected." - operationId: updateConnectedOrgConfig + operationId: updateFederationSettingConnectedOrgConfig parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40144,11 +40343,12 @@ paths: summary: Update One Organization Configuration in One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateConnectedOrgConfig + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateFederationSettingConnectedOrgConfig + x-xgen-operation-id-override: updateConnectedOrgConfig /api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings: get: description: Returns all role mappings from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: listRoleMappings + operationId: listFederationSettingConnectedOrgConfigRoleMappings parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40174,10 +40374,11 @@ paths: summary: Return All Role Mappings from One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listRoleMappings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listFederationSettingConnectedOrgConfigRoleMappings + x-xgen-operation-id-override: listRoleMappings post: description: Adds one role mapping to the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: createRoleMapping + operationId: createFederationSettingConnectedOrgConfigRoleMapping parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40210,11 +40411,12 @@ paths: summary: Create One Role Mapping in One Organization Configuration tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/createRoleMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/createFederationSettingConnectedOrgConfigRoleMapping + x-xgen-operation-id-override: createRoleMapping /api/atlas/v2/federationSettings/{federationSettingsId}/connectedOrgConfigs/{orgId}/roleMappings/{id}: delete: description: Removes one role mapping in the specified organization from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: deleteRoleMapping + operationId: deleteFederationSettingConnectedOrgConfigRoleMapping parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the role mapping that you want to remove. @@ -40246,10 +40448,11 @@ paths: summary: Remove One Role Mapping from One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteRoleMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteFederationSettingConnectedOrgConfigRoleMapping + x-xgen-operation-id-override: deleteRoleMapping get: description: Returns one role mapping from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: getRoleMapping + operationId: getFederationSettingConnectedOrgConfigRoleMapping parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the role mapping that you want to return. @@ -40269,7 +40472,7 @@ paths: schema: $ref: '#/components/schemas/AuthFederationRoleMapping' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -40285,10 +40488,11 @@ paths: summary: Return One Role Mapping from One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getRoleMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettingConnectedOrgConfigRoleMapping + x-xgen-operation-id-override: getRoleMapping put: description: Updates one role mapping in the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: updateRoleMapping + operationId: updateFederationSettingConnectedOrgConfigRoleMapping parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the role mapping that you want to update. @@ -40329,11 +40533,12 @@ paths: summary: Update One Role Mapping in One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateRoleMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateFederationSettingConnectedOrgConfigRoleMapping + x-xgen-operation-id-override: updateRoleMapping /api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders: get: description: Returns all identity providers with the provided protocol and type in the specified federation. If no protocol is specified, only SAML identity providers will be returned. If no idpType is specified, only WORKFORCE identity providers will be returned. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - operationId: listIdentityProviders + operationId: listFederationSettingIdentityProviders parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40368,7 +40573,7 @@ paths: schema: $ref: '#/components/schemas/PaginatedFederationIdentityProvider' x-xgen-IPA-exception: - xgen-IPA-105-list-method-response-is-get-method-response: API predates IPA validation + xgen-IPA-105-list-method-response-is-get-method-response: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -40384,13 +40589,14 @@ paths: summary: Return All Identity Providers in One Federation tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listIdentityProviders + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/listFederationSettingIdentityProviders + x-xgen-operation-id-override: listIdentityProviders post: description: |- Creates one identity provider within the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. **Note**: This resource only supports the creation of OIDC identity providers. - operationId: createIdentityProvider + operationId: createFederationSettingIdentityProvider parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/envelope' @@ -40422,14 +40628,15 @@ paths: summary: Create One Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/createIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/createFederationSettingIdentityProvider + x-xgen-operation-id-override: createIdentityProvider /api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}: delete: description: "Deletes one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. \n\n**Note**: Requests to this resource will fail if the identity provider has any connected organizations. Before deleting an identity provider, disconnect all organizations and confirm that no organization in your account uses this identity provider." externalDocs: description: Manage Organization Mapping for Federated Authentication url: https://www.mongodb.com/docs/atlas/security/manage-org-mapping/ - operationId: deleteIdentityProvider + operationId: deleteFederationSettingIdentityProvider parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the identity provider to connect. @@ -40459,10 +40666,11 @@ paths: summary: Delete One Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/deleteFederationSettingIdentityProvider + x-xgen-operation-id-override: deleteIdentityProvider get: description: Returns one identity provider in the specified federation by the identity provider's id. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - operationId: getIdentityProvider + operationId: getFederationSettingIdentityProvider parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id. @@ -40481,13 +40689,13 @@ paths: $ref: '#/components/schemas/FederationSamlIdentityProvider' x-sunset: "2025-01-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2023-11-15+json: schema: $ref: '#/components/schemas/FederationIdentityProvider' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-11-15" description: OK "400": @@ -40503,13 +40711,14 @@ paths: summary: Return One Identity Provider by ID tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettingIdentityProvider + x-xgen-operation-id-override: getIdentityProvider patch: description: |- Updates one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. **Note**: Changing authorization types and/or updating authorization claims can prevent current users and/or groups from accessing the database. - operationId: updateIdentityProvider + operationId: updateFederationSettingIdentityProvider parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique string that identifies the identity provider to connect. If using an API version before 11-15-2023, use the legacy 20-hexadecimal digit id. This id can be found within the Federation Management Console > Identity Providers tab by clicking the info icon in the IdP ID row of a configured identity provider. For all other versions, use the 24-hexadecimal digit id. @@ -40556,14 +40765,15 @@ paths: summary: Update One Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/updateFederationSettingIdentityProvider + x-xgen-operation-id-override: updateIdentityProvider /api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}/jwks: delete: description: "Revokes the JWKS tokens from the requested OIDC identity provider. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. \n\n**Note**: Revoking your JWKS tokens immediately refreshes your IdP public keys from all your Atlas clusters, invalidating previously signed access tokens and logging out all users. You may need to restart your MongoDB clients. All organizations connected to the identity provider will be affected." externalDocs: description: Configure OIDC Authorization url: https://www.mongodb.com/docs/atlas/security-oidc/#revoke-jwks - operationId: revokeJwksFromIdentityProvider + operationId: revokeFederationSettingIdentityProviderJwks parameters: - $ref: '#/components/parameters/federationSettingsId' - description: Unique 24-hexadecimal digit string that identifies the identity provider to connect. @@ -40593,14 +40803,15 @@ paths: summary: Revoke JWKS from One OIDC Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/revokeJwksFromIdentityProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/revokeFederationSettingIdentityProviderJwks x-xgen-method-verb-override: customMethod: "True" verb: revoke + x-xgen-operation-id-override: revokeIdentityProviderJwks /api/atlas/v2/federationSettings/{federationSettingsId}/identityProviders/{identityProviderId}/metadata.xml: get: description: Returns the metadata of one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. - operationId: getIdentityProviderMetadata + operationId: getFederationSettingIdentityProviderMetadata parameters: - $ref: '#/components/parameters/federationSettingsId' - $ref: '#/components/parameters/identityProviderId' @@ -40625,14 +40836,15 @@ paths: summary: Return Metadata of One Identity Provider tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getIdentityProviderMetadata + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettingIdentityProviderMetadata x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getIdentityProviderMetadata /api/atlas/v2/groups: get: description: Returns details about all projects. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Organization Read Only role or higher. - operationId: listProjects + operationId: listGroups parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -40660,10 +40872,10 @@ paths: summary: Return All Projects tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listGroups post: description: Creates one project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Read Write role. - operationId: createProject + operationId: createGroup parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -40703,11 +40915,11 @@ paths: summary: Create One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createGroup /api/atlas/v2/groups/{groupId}: delete: description: Removes the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. You can delete a project only if there are no Online Archives for the clusters in the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteProject + operationId: deleteGroup parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40733,10 +40945,10 @@ paths: summary: Remove One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteGroup get: description: Returns details about the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProject + operationId: getGroup parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40748,8 +40960,7 @@ paths: schema: $ref: '#/components/schemas/Group' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: API predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -40765,10 +40976,10 @@ paths: summary: Return One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroup patch: description: Updates the human-readable label that identifies the specified project, or the tags associated with the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateProject + operationId: updateGroup parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40801,12 +41012,12 @@ paths: summary: Update One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroup /api/atlas/v2/groups/{groupId}/access: post: deprecated: true description: Adds one MongoDB Cloud user to the specified project. If the MongoDB Cloud user is not a member of the project's organization, then the user must accept their invitation to the organization to access information within the specified project. If the MongoDB Cloud User is already a member of the project's organization, then they will be added to the project immediately and an invitation will not be returned by this resource. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. - operationId: addUserToProject + operationId: addGroupAccessUser parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/pretty' @@ -40843,17 +41054,18 @@ paths: summary: Add One MongoDB Cloud User to One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/addUserToProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/addGroupAccessUser x-xgen-method-verb-override: customMethod: "True" verb: addUser + x-xgen-operation-id-override: addGroupUser /api/atlas/v2/groups/{groupId}/accessList: get: description: Returns all access list entries from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The `/groups/{GROUP-ID}/accessList` endpoint manages the database IP access list. This endpoint is distinct from the `orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist` endpoint, which manages the access list for MongoDB Cloud organizations. externalDocs: description: IP access list url: https://docs.atlas.mongodb.com/security/ip-access-list/#std-label-access-list - operationId: listProjectIpAccessLists + operationId: listGroupAccessListEntries parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40882,13 +41094,17 @@ paths: - Project IP Access List x-xgen-changelog: "2025-05-08": Corrects an issue where the endpoint would include Atlas internal entries. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/listProjectIpAccessLists + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/listGroupAccessListEntries + x-xgen-method-verb-override: + customMethod: false + verb: listEntries + x-xgen-operation-id-override: listAccessListEntries post: description: Adds one or more access list entries to the specified project. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. Write each entry as either one IP address or one CIDR-notated block of IP addresses. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The `/groups/{GROUP-ID}/accessList` endpoint manages the database IP access list. This endpoint is distinct from the `orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist` endpoint, which manages the access list for MongoDB Cloud organizations. This endpoint doesn't support concurrent `POST` requests. You must submit multiple `POST` requests synchronously. externalDocs: description: IP access list url: https://docs.atlas.mongodb.com/security/ip-access-list/#std-label-access-list - operationId: createProjectIpAccessList + operationId: createGroupAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40926,14 +41142,18 @@ paths: summary: Add Entries to Project IP Access List tags: - Project IP Access List - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/createProjectIpAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/createGroupAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: createEntry + x-xgen-operation-id-override: createAccessListEntry /api/atlas/v2/groups/{groupId}/accessList/{entryValue}: delete: description: Removes one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains one IP address, one CIDR-notated block of IP addresses, or one AWS Security Group ID. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The `/groups/{GROUP-ID}/accessList` endpoint manages the database IP access list. This endpoint is distinct from the `orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist` endpoint, which manages the access list for MongoDB Cloud organizations. externalDocs: description: IP access list url: https://docs.atlas.mongodb.com/security/ip-access-list/#std-label-access-list - operationId: deleteProjectIpAccessList + operationId: deleteGroupAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40968,13 +41188,17 @@ paths: summary: Remove One Entry from One Project IP Access List tags: - Project IP Access List - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/deleteProjectIpAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/deleteGroupAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: deleteEntry + x-xgen-operation-id-override: deleteAccessListEntry get: description: Returns one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. This endpoint (`/groups/{GROUP-ID}/accessList`) manages the Project IP Access List. It doesn't manage the access list for MongoDB Cloud organizations. TheProgrammatic API Keys endpoint (`/orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist`) manages those access lists. externalDocs: description: IP access list url: https://docs.atlas.mongodb.com/security/ip-access-list/#std-label-access-list - operationId: getProjectIpList + operationId: getGroupAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -40994,7 +41218,7 @@ paths: schema: $ref: '#/components/schemas/NetworkPermissionEntry' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41008,11 +41232,15 @@ paths: summary: Return One Project IP Access List Entry tags: - Project IP Access List - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/getProjectIpList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/getGroupAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: getEntry + x-xgen-operation-id-override: getAccessListEntry /api/atlas/v2/groups/{groupId}/accessList/{entryValue}/status: get: description: Returns the status of one project IP access list entry. This resource checks if the provided project IP access list entry applies to all cloud providers serving clusters from the specified project. - operationId: getProjectIpAccessListStatus + operationId: getGroupAccessListStatus parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41032,7 +41260,7 @@ paths: schema: $ref: '#/components/schemas/NetworkPermissionEntryStatus' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -41048,14 +41276,15 @@ paths: summary: Return Status of One Project IP Access List Entry tags: - Project IP Access List - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/getProjectIpAccessListStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Project-IP-Access-List/operation/getGroupAccessListStatus + x-xgen-operation-id-override: getAccessListStatus /api/atlas/v2/groups/{groupId}/alertConfigs: get: description: |- Returns all alert configurations for one project. These alert configurations apply to any component in the project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This resource remains under revision and may change. - operationId: listAlertConfigurations + operationId: listGroupAlertConfigs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41082,13 +41311,14 @@ paths: summary: Return All Alert Configurations in One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listGroupAlertConfigs + x-xgen-operation-id-override: listAlertConfigs post: description: |- Creates one alert configuration for the specified project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. This resource remains under revision and may change. - operationId: createAlertConfiguration + operationId: createGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41121,7 +41351,8 @@ paths: summary: Create One Alert Configuration in One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/createAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/createGroupAlertConfig + x-xgen-operation-id-override: createAlertConfig /api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}: delete: description: |- @@ -41131,7 +41362,7 @@ paths: externalDocs: description: Return All Alert Configurations for One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurations - operationId: deleteAlertConfiguration + operationId: deleteGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41161,7 +41392,8 @@ paths: summary: Remove One Alert Configuration from One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/deleteAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/deleteGroupAlertConfig + x-xgen-operation-id-override: deleteAlertConfig get: description: |- Returns the specified alert configuration from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. @@ -41170,7 +41402,7 @@ paths: externalDocs: description: Return All Alert Configurations for One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurations - operationId: getAlertConfiguration + operationId: getGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41190,7 +41422,7 @@ paths: schema: $ref: '#/components/schemas/GroupAlertsConfig' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41204,7 +41436,8 @@ paths: summary: Return One Alert Configuration from One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/getAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/getGroupAlertConfig + x-xgen-operation-id-override: getAlertConfig patch: description: |- Enables or disables the specified alert configuration in the specified project. The resource enables the specified alert configuration if currently enabled. The resource disables the specified alert configuration if currently disabled. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -41215,7 +41448,7 @@ paths: externalDocs: description: Update One Alert Configuration url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/updateAlertConfiguration - operationId: toggleAlertConfiguration + operationId: toggleGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41254,10 +41487,11 @@ paths: summary: Toggle State of One Alert Configuration in One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/toggleAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/toggleGroupAlertConfig x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: toggle + x-xgen-operation-id-override: toggleAlertConfig put: description: |- Updates one alert configuration in the specified project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -41268,7 +41502,7 @@ paths: externalDocs: description: Toggle One State of One Alert Configuration in One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/toggleAlertConfiguration - operationId: updateAlertConfiguration + operationId: updateGroupAlertConfig parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41309,7 +41543,8 @@ paths: summary: Update One Alert Configuration in One Project tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/updateAlertConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/updateGroupAlertConfig + x-xgen-operation-id-override: updateAlertConfig /api/atlas/v2/groups/{groupId}/alertConfigs/{alertConfigId}/alerts: get: description: |- @@ -41319,7 +41554,7 @@ paths: externalDocs: description: Return All Alert Configurations for One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurations - operationId: listAlertsByAlertConfigurationId + operationId: getGroupAlertConfigAlerts parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41342,8 +41577,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedAlertView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41357,14 +41592,15 @@ paths: summary: Return All Open Alerts for One Alert Configuration tags: - Alerts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlertsByAlertConfigurationId + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/getGroupAlertConfigAlerts + x-xgen-operation-id-override: getAlertConfigAlerts /api/atlas/v2/groups/{groupId}/alerts: get: description: |- Returns all alerts. These alerts apply to all components in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This resource remains under revision and may change. - operationId: listAlerts + operationId: listGroupAlerts parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41402,7 +41638,8 @@ paths: summary: Return All Alerts from One Project tags: - Alerts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlerts + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listGroupAlerts + x-xgen-operation-id-override: listAlerts /api/atlas/v2/groups/{groupId}/alerts/{alertId}: get: description: |- @@ -41412,7 +41649,7 @@ paths: externalDocs: description: Return All Alerts from One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlerts - operationId: getAlert + operationId: getGroupAlert parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41431,7 +41668,7 @@ paths: schema: $ref: '#/components/schemas/AlertViewForNdsGroup' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41445,7 +41682,8 @@ paths: summary: Return One Alert from One Project tags: - Alerts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/getAlert + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/getGroupAlert + x-xgen-operation-id-override: getAlert patch: description: |- Confirms receipt of one existing alert. This alert applies to any component in one project. Acknowledging an alert prevents successive notifications. You receive an alert when a monitored component meets or exceeds a value you set until you acknowledge the alert. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. @@ -41454,7 +41692,7 @@ paths: externalDocs: description: Return All Alerts from One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlerts - operationId: acknowledgeAlert + operationId: acknowledgeGroupAlert parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41502,10 +41740,11 @@ paths: summary: Acknowledge One Alert from One Project tags: - Alerts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/acknowledgeAlert + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/acknowledgeGroupAlert x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: acknowledge + x-xgen-operation-id-override: acknowledgeAlert /api/atlas/v2/groups/{groupId}/alerts/{alertId}/alertConfigs: get: description: |- @@ -41515,7 +41754,7 @@ paths: externalDocs: description: Return All Alerts from One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alerts/operation/listAlerts - operationId: listAlertConfigurationsByAlertId + operationId: getGroupAlertAlertConfigs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41537,8 +41776,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedAlertConfigView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41552,14 +41791,15 @@ paths: summary: Return All Alert Configurations Set for One Alert tags: - Alert Configurations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/listAlertConfigurationsByAlertId + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Alert-Configurations/operation/getGroupAlertAlertConfigs + x-xgen-operation-id-override: getAlertConfigs /api/atlas/v2/groups/{groupId}/apiKeys: get: description: Returns all organization API keys that you assigned to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: listProjectApiKeys + operationId: listGroupApiKeys parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41586,10 +41826,10 @@ paths: summary: Return All Organization API Keys Assigned to One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listProjectApiKeys + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listGroupApiKeys post: description: Creates and assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createProjectApiKey + operationId: createGroupApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41620,14 +41860,14 @@ paths: summary: Create and Assign One Organization API Key to One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createProjectApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createGroupApiKey /api/atlas/v2/groups/{groupId}/apiKeys/{apiUserId}: delete: description: Removes one organization API key from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: removeProjectApiKey + operationId: removeGroupApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41658,13 +41898,13 @@ paths: summary: Unassign One Organization API Key from One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/removeProjectApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/removeGroupApiKey x-xgen-method-verb-override: customMethod: "True" verb: remove patch: description: Updates the roles of the organization API key that you specify for the project that you specify. You must specify at least one valid role for the project. The application removes any roles that you do not include in this request if they were previously set in the organization API key that you specify for the project. - operationId: updateApiKeyRoles + operationId: updateGroupApiKeyRoles parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/pageNum' @@ -41707,13 +41947,14 @@ paths: summary: Update Organization API Key Roles for One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateApiKeyRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateGroupApiKeyRoles x-xgen-method-verb-override: customMethod: "True" verb: updateRoles + x-xgen-operation-id-override: updateApiKeyRoles post: description: Assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can then use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: addProjectApiKey + operationId: addGroupApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41751,14 +41992,14 @@ paths: summary: Assign One Organization API Key to One Project tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/addProjectApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/addGroupApiKey x-xgen-method-verb-override: customMethod: "True" verb: add /api/atlas/v2/groups/{groupId}/auditLog: get: description: Returns the auditing configuration for the specified project. The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for `M0`, `M2`, `M5`, or serverless clusters. - operationId: getAuditingConfiguration + operationId: getGroupAuditLog parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41770,7 +42011,7 @@ paths: schema: $ref: '#/components/schemas/AuditLog' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41784,10 +42025,10 @@ paths: summary: Return Auditing Configuration for One Project tags: - Auditing - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Auditing/operation/getAuditingConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Auditing/operation/getGroupAuditLog patch: description: Updates the auditing configuration for the specified project. The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for `M0`, `M2`, `M5`, or serverless clusters. - operationId: updateAuditingConfiguration + operationId: updateGroupAuditLog parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41820,11 +42061,12 @@ paths: summary: Update Auditing Configuration for One Project tags: - Auditing - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Auditing/operation/updateAuditingConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Auditing/operation/updateGroupAuditLog + x-xgen-operation-id-override: updateAuditLog /api/atlas/v2/groups/{groupId}/awsCustomDNS: get: description: Returns the custom DNS configuration for AWS clusters in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getAwsCustomDns + operationId: getGroupAwsCustomDns parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41836,7 +42078,7 @@ paths: schema: $ref: '#/components/schemas/AWSCustomDNSEnabledView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -41850,10 +42092,11 @@ paths: summary: Return One Custom DNS Configuration for Atlas Clusters on AWS tags: - AWS Clusters DNS - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/AWS-Clusters-DNS/operation/getAwsCustomDns + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/AWS-Clusters-DNS/operation/getGroupAwsCustomDns + x-xgen-operation-id-override: getAwsCustomDns patch: description: Enables or disables the custom DNS configuration for AWS clusters in the specified project. Enable custom DNS if you use AWS VPC peering and use your own DNS servers. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: toggleAwsCustomDns + operationId: toggleGroupAwsCustomDns parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41884,14 +42127,15 @@ paths: summary: Update State of One Custom DNS Configuration for Atlas Clusters on AWS tags: - AWS Clusters DNS - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/AWS-Clusters-DNS/operation/toggleAwsCustomDns + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/AWS-Clusters-DNS/operation/toggleGroupAwsCustomDns x-xgen-method-verb-override: customMethod: "True" verb: toggle + x-xgen-operation-id-override: toggleAwsCustomDns /api/atlas/v2/groups/{groupId}/backup/exportBuckets: get: description: Returns all Export Buckets associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listExportBuckets + operationId: listGroupBackupExportBuckets parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41923,10 +42167,11 @@ paths: summary: Return All Snapshot Export Buckets tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listExportBuckets + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupBackupExportBuckets + x-xgen-operation-id-override: listExportBuckets post: description: Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. Once created, an snapshots can be exported to the Export Bucket and its referenced AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createExportBucket + operationId: createGroupBackupExportBucket parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -41941,6 +42186,7 @@ paths: bucketName: export-bucket cloudProvider: AWS iamRoleId: 668c5f0ed436263134491592 + requirePrivateNetworking: false schema: $ref: '#/components/schemas/DiskBackupSnapshotAWSExportBucketRequest' x-xgen-version: "2023-01-01" @@ -41952,6 +42198,7 @@ paths: bucketName: export-bucket cloudProvider: AWS iamRoleId: 668c5f0ed436263134491592 + requirePrivateNetworking: false Azure: description: Azure value: @@ -41986,6 +42233,7 @@ paths: - href: https://cloud.mongodb.com/api/atlas rel: self region: us-east-1 + requirePrivateNetworking: true schema: $ref: '#/components/schemas/DiskBackupSnapshotAWSExportBucketResponse' x-sunset: "2026-05-30" @@ -42003,6 +42251,7 @@ paths: - href: https://cloud.mongodb.com/api/atlas rel: self region: us-east-1 + requirePrivateNetworking: true Azure: description: Azure value: @@ -42042,11 +42291,12 @@ paths: summary: Create One Snapshot Export Bucket tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createExportBucket + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createGroupBackupExportBucket + x-xgen-operation-id-override: createExportBucket /api/atlas/v2/groups/{groupId}/backup/exportBuckets/{exportBucketId}: delete: description: Deletes an Export Bucket. Auto export must be disabled on all clusters in this Project exporting to this Export Bucket before revoking access. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: deleteExportBucket + operationId: deleteGroupBackupExportBucket parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42077,10 +42327,11 @@ paths: summary: Delete One Snapshot Export Bucket tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteExportBucket + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteGroupBackupExportBucket + x-xgen-operation-id-override: deleteExportBucket get: description: Returns one Export Bucket associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getExportBucket + operationId: getGroupBackupExportBucket parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42108,6 +42359,7 @@ paths: - href: https://cloud.mongodb.com/api/atlas rel: self region: us-east-1 + requirePrivateNetworking: true schema: $ref: '#/components/schemas/DiskBackupSnapshotAWSExportBucketResponse' x-sunset: "2026-05-30" @@ -42125,6 +42377,7 @@ paths: - href: https://cloud.mongodb.com/api/atlas rel: self region: us-east-1 + requirePrivateNetworking: true Azure: description: Azure value: @@ -42162,11 +42415,12 @@ paths: summary: Return One Snapshot Export Bucket tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getExportBucket + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupBackupExportBucket + x-xgen-operation-id-override: getExportBucket /api/atlas/v2/groups/{groupId}/backupCompliancePolicy: delete: description: Disables the Backup Compliance Policy settings with the specified project. As a prerequisite, a support ticket needs to be file first, instructions in https://www.mongodb.com/docs/atlas/backup/cloud-backup/backup-compliance-policy/. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: disableDataProtectionSettings + operationId: disableGroupBackupCompliancePolicy parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42190,13 +42444,14 @@ paths: summary: Disable Backup Compliance Policy Settings tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/disableDataProtectionSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/disableGroupBackupCompliancePolicy x-xgen-method-verb-override: customMethod: "True" verb: disable + x-xgen-operation-id-override: disableCompliancePolicy get: description: Returns the Backup Compliance Policy settings with the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getDataProtectionSettings + operationId: getGroupBackupCompliancePolicy parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42209,13 +42464,13 @@ paths: $ref: '#/components/schemas/DataProtectionSettings' x-sunset: "2026-10-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2023-10-01+json: schema: $ref: '#/components/schemas/DataProtectionSettings20231001' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-10-01" description: OK "401": @@ -42229,10 +42484,11 @@ paths: summary: Return Backup Compliance Policy Settings tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getDataProtectionSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupBackupCompliancePolicy + x-xgen-operation-id-override: getCompliancePolicy put: description: Updates the Backup Compliance Policy settings for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateDataProtectionSettings + operationId: updateGroupBackupCompliancePolicy parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42281,11 +42537,12 @@ paths: summary: Update Backup Compliance Policy Settings tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateDataProtectionSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateGroupBackupCompliancePolicy + x-xgen-operation-id-override: updateCompliancePolicy /api/atlas/v2/groups/{groupId}/cloudProviderAccess: get: description: Returns all cloud provider access roles with access to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: listCloudProviderAccessRoles + operationId: listGroupCloudProviderAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42297,9 +42554,9 @@ paths: schema: $ref: '#/components/schemas/CloudProviderAccessRoles' x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -42313,13 +42570,14 @@ paths: summary: Return All Cloud Provider Access Roles tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/listCloudProviderAccessRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/listGroupCloudProviderAccess + x-xgen-operation-id-override: listCloudProviderAccess post: description: Creates one access role for the specified cloud provider. Some MongoDB Cloud features use these cloud provider access roles for authentication. To use this resource, the requesting Service Account or API Key must have the Project Owner role. For the GCP provider, if the project folder is not yet provisioned, Atlas will now create the role asynchronously. An intermediate role with status `IN_PROGRESS` will be returned, and the final service account will be provisioned. Once the GCP project is set up, subsequent requests will create the service account synchronously. externalDocs: description: Set Up Access to Cloud Providers url: https://www.mongodb.com/docs/atlas/security/cloud-provider-access/ - operationId: createCloudProviderAccessRole + operationId: createGroupCloudProviderAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42350,11 +42608,12 @@ paths: summary: Create One Cloud Provider Access Role tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/createCloudProviderAccessRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/createGroupCloudProviderAccess + x-xgen-operation-id-override: createCloudProviderAccess /api/atlas/v2/groups/{groupId}/cloudProviderAccess/{cloudProvider}/{roleId}: delete: description: Revokes access to the specified project for the specified access role. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deauthorizeCloudProviderAccessRole + operationId: deauthorizeGroupCloudProviderAccessRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42395,14 +42654,15 @@ paths: summary: Deauthorize One Cloud Provider Access Role tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/deauthorizeCloudProviderAccessRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/deauthorizeGroupCloudProviderAccessRole x-xgen-method-verb-override: customMethod: "True" verb: deauthorizeRole + x-xgen-operation-id-override: deauthorizeProviderAccessRole /api/atlas/v2/groups/{groupId}/cloudProviderAccess/{roleId}: get: description: Returns the access role with the specified id and with access to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getCloudProviderAccessRole + operationId: getGroupCloudProviderAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42421,7 +42681,7 @@ paths: schema: $ref: '#/components/schemas/CloudProviderAccessRole' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -42435,13 +42695,14 @@ paths: summary: Return One Cloud Provider Access Role tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/getCloudProviderAccessRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/getGroupCloudProviderAccess + x-xgen-operation-id-override: getCloudProviderAccess patch: description: Grants access to the specified project for the specified access role. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API endpoint is one step in a procedure to create unified access for MongoDB Cloud services. This is not required for GCP service account access. externalDocs: description: Set Up Access to Cloud Providers url: https://www.mongodb.com/docs/atlas/security/cloud-provider-access/ - operationId: authorizeCloudProviderAccessRole + operationId: authorizeGroupCloudProviderAccessRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42483,10 +42744,11 @@ paths: summary: Authorize One Cloud Provider Access Role tags: - Cloud Provider Access - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/authorizeCloudProviderAccessRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Provider-Access/operation/authorizeGroupCloudProviderAccessRole x-xgen-method-verb-override: customMethod: "True" verb: authorizeRole + x-xgen-operation-id-override: authorizeProviderAccessRole /api/atlas/v2/groups/{groupId}/clusters: get: description: |- @@ -42496,7 +42758,7 @@ paths: externalDocs: description: listFlexClusters url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/listFlexClusters - operationId: listClusters + operationId: listGroupClusters parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42539,7 +42801,8 @@ paths: summary: Return All Clusters in One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listClusters + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listGroupClusters + x-xgen-operation-id-override: listClusters post: description: |- Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. @@ -42548,7 +42811,7 @@ paths: externalDocs: description: createFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/createFlexCluster - operationId: createCluster + operationId: createGroupCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42763,7 +43026,8 @@ paths: - Clusters x-xgen-changelog: "2025-06-05": Fixed a bug that previously permitted users to configure multiple regionConfigs for the same region and cloud provider within a replicationSpec - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/createCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/createGroupCluster + x-xgen-operation-id-override: createCluster /api/atlas/v2/groups/{groupId}/clusters/{clusterName}: delete: description: |- @@ -42773,7 +43037,7 @@ paths: externalDocs: description: deleteFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/deleteFlexCluster - operationId: deleteCluster + operationId: deleteGroupCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -42814,7 +43078,8 @@ paths: summary: Remove One Cluster from One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/deleteCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/deleteGroupCluster + x-xgen-operation-id-override: deleteCluster get: description: |- Returns the details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. @@ -42823,7 +43088,7 @@ paths: externalDocs: description: getFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/getFlexCluster - operationId: getCluster + operationId: getGroupCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -42843,20 +43108,20 @@ paths: $ref: '#/components/schemas/LegacyAtlasCluster' x-sunset: "2026-11-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2023-02-01+json: schema: $ref: '#/components/schemas/AdvancedClusterDescription' x-sunset: "2026-03-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-02-01" application/vnd.atlas.2024-08-05+json: schema: $ref: '#/components/schemas/ClusterDescription20240805' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -42872,10 +43137,11 @@ paths: summary: Return One Cluster from One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getGroupCluster + x-xgen-operation-id-override: getCluster patch: description: 'Updates the details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can update clusters with asymmetrically-sized shards. To update a cluster''s termination protection, the requesting Service Account or API Key must have the Project Owner role. For all other updates, the requesting Service Account or API Key must have the Project Cluster Manager role. You can''t modify a paused cluster (`paused : true`). You must call this endpoint to set `paused : false`. After this endpoint responds with `paused : false`, you can call it again with the changes you want to make to the cluster. This feature is not available for serverless clusters.' - operationId: updateCluster + operationId: updateGroupCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -42945,11 +43211,12 @@ paths: - Clusters x-xgen-changelog: "2025-06-05": Fixed a bug that previously permitted users to configure multiple regionConfigs for the same region and cloud provider within a replicationSpec - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/updateCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/updateGroupCluster + x-xgen-operation-id-override: updateCluster /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/{clusterView}/{databaseName}/{collectionName}/collStats/measurements: get: description: Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. - operationId: getCollStatsLatencyNamespaceClusterMeasurements + operationId: listGroupClusterCollStatMeasurements parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster to retrieve metrics for. @@ -43032,11 +43299,12 @@ paths: summary: Return Cluster-Level Query Latency tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespaceClusterMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/listGroupClusterCollStatMeasurements + x-xgen-operation-id-override: listCollStatMeasurements /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/{clusterView}/collStats/namespaces: get: description: Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. - operationId: getCollStatsLatencyNamespacesForCluster + operationId: getGroupClusterCollStatNamespaces parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster to pin namespaces to. @@ -43076,18 +43344,19 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return Ranked Namespaces from a Cluster + summary: Return Ranked Namespaces from One Cluster tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespacesForCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getGroupClusterCollStatNamespaces x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getClusterNamespaces /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/autoScalingConfiguration: get: deprecated: true description: Returns the internal configuration of AutoScaling for sharded clusters. This endpoint can be used for diagnostic purposes to ensure that sharded clusters updated from older APIs have gained support for AutoScaling each shard independently. - operationId: autoScalingConfiguration + operationId: autoGroupClusterScalingConfiguration parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43106,7 +43375,7 @@ paths: schema: $ref: '#/components/schemas/ClusterDescriptionAutoScalingModeConfiguration' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -43122,13 +43391,14 @@ paths: summary: Return Auto Scaling Configuration for One Sharded Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/autoScalingConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/autoGroupClusterScalingConfiguration x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: autoScalingConfiguration /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports: get: description: Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: listBackupExportJobs + operationId: listGroupClusterBackupExports parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43162,10 +43432,11 @@ paths: summary: Return All Snapshot Export Jobs tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listBackupExportJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupClusterBackupExports + x-xgen-operation-id-override: listBackupExports post: description: Exports one backup Snapshot for dedicated Atlas cluster using Cloud Backups to an Export Bucket. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: createBackupExportJob + operationId: createGroupClusterBackupExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43206,11 +43477,12 @@ paths: summary: Create One Snapshot Export Job tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createBackupExportJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createGroupClusterBackupExport + x-xgen-operation-id-override: createBackupExport /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/exports/{exportId}: get: description: Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: getBackupExportJob + operationId: getGroupClusterBackupExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43248,11 +43520,12 @@ paths: summary: Return One Snapshot Export Job tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getBackupExportJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupExport + x-xgen-operation-id-override: getBackupExport /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs: get: description: Returns all cloud backup restore jobs for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: listBackupRestoreJobs + operationId: listGroupClusterBackupRestoreJobs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43286,13 +43559,14 @@ paths: summary: Return All Restore Jobs for One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupClusterBackupRestoreJobs + x-xgen-operation-id-override: listBackupRestoreJobs post: description: |- 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 Service Account or API Key must have the Project Backup Manager role. - operationId: createBackupRestoreJob + operationId: createGroupClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43331,14 +43605,15 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Restore One Snapshot of One Cluster + summary: Create One Restore Job of One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createGroupClusterBackupRestoreJob + x-xgen-operation-id-override: createBackupRestoreJob /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/restoreJobs/{restoreJobId}: delete: description: Cancels one cloud backup restore job of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: cancelBackupRestoreJob + operationId: cancelGroupClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43378,13 +43653,14 @@ paths: summary: Cancel One Restore Job for One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/cancelBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/cancelGroupClusterBackupRestoreJob x-xgen-method-verb-override: customMethod: "True" verb: cancel + x-xgen-operation-id-override: cancelBackupRestoreJob get: description: Returns one cloud backup restore job for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: getBackupRestoreJob + operationId: getGroupClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43422,11 +43698,12 @@ paths: summary: Return One Restore Job for One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupRestoreJob + x-xgen-operation-id-override: getBackupRestoreJob /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/schedule: delete: description: Removes all cloud backup schedules for the specified cluster. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. - operationId: deleteAllBackupSchedules + operationId: deleteGroupClusterBackupSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43463,10 +43740,11 @@ paths: summary: Remove All Cloud Backup Schedules tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteAllBackupSchedules + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteGroupClusterBackupSchedule + x-xgen-operation-id-override: deleteClusterBackupSchedule get: description: Returns the cloud backup schedule for the specified cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getBackupSchedule + operationId: getGroupClusterBackupSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43502,13 +43780,14 @@ paths: summary: Return One Cloud Backup Schedule tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getBackupSchedule + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupSchedule x-xgen-method-verb-override: customMethod: "False" verb: get + x-xgen-operation-id-override: getBackupSchedule patch: description: Updates the cloud backup schedule for one cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateBackupSchedule + operationId: updateGroupClusterBackupSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43559,11 +43838,12 @@ paths: summary: Update Cloud Backup Schedule for One Cluster tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateBackupSchedule + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateGroupClusterBackupSchedule + x-xgen-operation-id-override: updateBackupSchedule /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots: get: description: Returns all snapshots of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - operationId: listReplicaSetBackups + operationId: listGroupClusterBackupSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43599,13 +43879,14 @@ paths: summary: Return All Replica Set Cloud Backups tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listReplicaSetBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupClusterBackupSnapshots + x-xgen-operation-id-override: listBackupSnapshots post: description: |- Takes one on-demand snapshot for the specified cluster. 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 Service Account or API Key must have the Project Backup Manager role. - operationId: takeSnapshot + operationId: takeGroupClusterBackupSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -43645,14 +43926,15 @@ paths: summary: Take One On-Demand Snapshot tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/takeSnapshot + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/takeGroupClusterBackupSnapshots x-xgen-method-verb-override: customMethod: "True" verb: take + x-xgen-operation-id-override: takeSnapshots /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/{snapshotId}: delete: description: Removes the specified snapshot. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: deleteReplicaSetBackup + operationId: deleteGroupClusterBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43690,10 +43972,11 @@ paths: summary: Remove One Replica Set Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteReplicaSetBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteGroupClusterBackupSnapshot + x-xgen-operation-id-override: deleteClusterBackupSnapshot get: description: Returns one snapshot from the specified cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - operationId: getReplicaSetBackup + operationId: getGroupClusterBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43719,7 +44002,7 @@ paths: schema: $ref: '#/components/schemas/DiskBackupReplicaSet' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -43735,10 +44018,11 @@ paths: summary: Return One Replica Set Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getReplicaSetBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupSnapshot + x-xgen-operation-id-override: getClusterBackupSnapshot patch: description: Changes the expiration date for one cloud backup snapshot for one cluster in the specified project, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: updateSnapshotRetention + operationId: updateGroupClusterBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43785,11 +44069,12 @@ paths: summary: Update Expiration Date for One Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateSnapshotRetention + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/updateGroupClusterBackupSnapshot + x-xgen-operation-id-override: updateBackupSnapshot /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedCluster/{snapshotId}: delete: description: Removes one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. - operationId: deleteShardedClusterBackup + operationId: deleteGroupClusterBackupSnapshotShardedCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43825,10 +44110,11 @@ paths: summary: Remove One Sharded Cluster Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteShardedClusterBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/deleteGroupClusterBackupSnapshotShardedCluster + x-xgen-operation-id-override: deleteBackupShardedCluster get: description: Returns one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - operationId: getShardedClusterBackup + operationId: getGroupClusterBackupSnapshotShardedCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43854,7 +44140,7 @@ paths: schema: $ref: '#/components/schemas/DiskBackupShardedClusterSnapshot' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -43870,11 +44156,12 @@ paths: summary: Return One Sharded Cluster Cloud Backup tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getShardedClusterBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupClusterBackupSnapshotShardedCluster + x-xgen-operation-id-override: getBackupShardedCluster /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/snapshots/shardedClusters: get: description: Returns all snapshots of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. - operationId: listShardedClusterBackups + operationId: listGroupClusterBackupSnapshotShardedClusters parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -43907,7 +44194,8 @@ paths: summary: Return All Sharded Cluster Cloud Backups tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listShardedClusterBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupClusterBackupSnapshotShardedClusters + x-xgen-operation-id-override: listBackupShardedClusters /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/download: post: deprecated: true @@ -43918,7 +44206,7 @@ paths: externalDocs: description: downloadFlexBackup url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/downloadFlexBackup - operationId: downloadSharedClusterBackup + operationId: downloadGroupClusterBackupTenant parameters: - description: Human-readable label that identifies the cluster. in: path @@ -43961,9 +44249,10 @@ paths: summary: Download One M2 or M5 Cluster Snapshot tags: - Shared-Tier Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/downloadSharedClusterBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/downloadGroupClusterBackupTenant x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: downloadClusterBackupTenant /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restore: post: deprecated: true @@ -43974,7 +44263,7 @@ paths: externalDocs: description: createFlexBackupRestoreJob url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/createFlexBackupRestoreJob - operationId: createSharedClusterBackupRestoreJob + operationId: createGroupClusterBackupTenantRestore parameters: - description: Human-readable label that identifies the cluster. in: path @@ -44017,7 +44306,8 @@ paths: summary: Create One Restore Job for One M2 or M5 Cluster tags: - Shared-Tier Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/createSharedClusterBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/createGroupClusterBackupTenantRestore + x-xgen-operation-id-override: createBackupTenantRestore /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restores: get: deprecated: true @@ -44028,7 +44318,7 @@ paths: externalDocs: description: listFlexBackupRestoreJobs url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/listFlexBackupRestoreJobs - operationId: listSharedClusterBackupRestoreJobs + operationId: listGroupClusterBackupTenantRestores parameters: - description: Human-readable label that identifies the cluster. in: path @@ -44062,7 +44352,8 @@ paths: summary: Return All Restore Jobs for One M2 or M5 Cluster tags: - Shared-Tier Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/listSharedClusterBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/listGroupClusterBackupTenantRestores + x-xgen-operation-id-override: listBackupTenantRestores /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/restores/{restoreId}: get: deprecated: true @@ -44073,7 +44364,7 @@ paths: externalDocs: description: getFlexBackupRestoreJob url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/getFlexBackupRestoreJob - operationId: getSharedClusterBackupRestoreJob + operationId: getGroupClusterBackupTenantRestore parameters: - description: Human-readable label that identifies the cluster. in: path @@ -44114,7 +44405,8 @@ paths: summary: Return One Restore Job for One M2 or M5 Cluster tags: - Shared-Tier Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/getSharedClusterBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Restore-Jobs/operation/getGroupClusterBackupTenantRestore + x-xgen-operation-id-override: getBackupTenantRestore /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/snapshots: get: deprecated: true @@ -44125,7 +44417,7 @@ paths: externalDocs: description: listFlexBackups url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/listFlexBackups - operationId: listSharedClusterBackups + operationId: listGroupClusterBackupTenantSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44159,7 +44451,8 @@ paths: summary: Return All Snapshots for One M2 or M5 Cluster tags: - Shared-Tier Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/listSharedClusterBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/listGroupClusterBackupTenantSnapshots + x-xgen-operation-id-override: listClusterBackupSnapshots /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backup/tenant/snapshots/{snapshotId}: get: deprecated: true @@ -44170,7 +44463,7 @@ paths: externalDocs: description: getFlexBackup url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/getFlexBackup - operationId: getSharedClusterBackup + operationId: getGroupClusterBackupTenantSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44211,12 +44504,13 @@ paths: summary: Return One Snapshot of One M2 or M5 Cluster tags: - Shared-Tier Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/getSharedClusterBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Shared-Tier-Snapshots/operation/getGroupClusterBackupTenantSnapshot + x-xgen-operation-id-override: getBackupTenantSnapshot /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backupCheckpoints: get: deprecated: true description: Returns all legacy backup checkpoints for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listLegacyBackupCheckpoints + operationId: listGroupClusterBackupCheckpoints parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44250,12 +44544,13 @@ paths: summary: Return All Legacy Backup Checkpoints tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listLegacyBackupCheckpoints + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listGroupClusterBackupCheckpoints + x-xgen-operation-id-override: listClusterBackupCheckpoints /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/backupCheckpoints/{checkpointId}: get: deprecated: true description: Returns one legacy backup checkpoint for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getLegacyBackupCheckpoint + operationId: getGroupClusterBackupCheckpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44281,7 +44576,7 @@ paths: schema: $ref: '#/components/schemas/ApiAtlasCheckpointView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -44297,11 +44592,12 @@ paths: summary: Return One Legacy Backup Checkpoint tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getLegacyBackupCheckpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getGroupClusterBackupCheckpoint + x-xgen-operation-id-override: getClusterBackupCheckpoint /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/pinned: get: description: Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. - operationId: getPinnedNamespaces + operationId: listGroupClusterCollStatPinnedNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -44333,13 +44629,14 @@ paths: summary: Return Pinned Namespaces tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getPinnedNamespaces + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/listGroupClusterCollStatPinnedNamespaces x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: listNamespaces + x-xgen-operation-id-override: listPinnedNamespaces patch: description: Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. - operationId: pinNamespacesPatch + operationId: updateGroupClusterCollStatPinnedNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -44385,13 +44682,14 @@ paths: summary: Add Pinned Namespaces tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/pinNamespacesPatch + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/updateGroupClusterCollStatPinnedNamespaces x-xgen-method-verb-override: customMethod: "True" verb: updateNamespaces + x-xgen-operation-id-override: updatePinnedNamespaces put: description: Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. This initializes a pinned namespaces list or replaces any existing pinned namespaces list for the Group and Cluster. - operationId: pinNamespacesPut + operationId: pinGroupClusterCollStatPinnedNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -44437,14 +44735,15 @@ paths: summary: Pin Namespaces tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/pinNamespacesPut + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/pinGroupClusterCollStatPinnedNamespaces x-xgen-method-verb-override: customMethod: "True" verb: pinNamespaces + x-xgen-operation-id-override: pinNamespaces /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/collStats/unpin: patch: description: Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. - operationId: unpinNamespaces + operationId: unpinGroupClusterCollStatUnpinNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -44480,13 +44779,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Unpin namespaces + summary: Unpin Namespaces tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/unpinNamespaces + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/unpinGroupClusterCollStatUnpinNamespaces x-xgen-method-verb-override: customMethod: "True" verb: unpinNamespaces + x-xgen-operation-id-override: unpinNamespaces /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes: post: deprecated: true @@ -44494,7 +44794,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: createAtlasSearchIndexDeprecated + operationId: createGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44537,7 +44837,8 @@ paths: summary: Create One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createAtlasSearchIndexDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createGroupClusterFtsIndex + x-xgen-operation-id-override: createClusterFtsIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{databaseName}/{collectionName}: get: deprecated: true @@ -44545,7 +44846,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: listAtlasSearchIndexesDeprecated + operationId: listGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44578,7 +44879,7 @@ paths: $ref: '#/components/schemas/ClusterSearchIndex' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-sunset: "2026-11-30" x-xgen-version: "2023-01-01" description: OK @@ -44593,7 +44894,11 @@ paths: summary: Return All Atlas Search Indexes for One Collection tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listAtlasSearchIndexesDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listGroupClusterFtsIndex + x-xgen-method-verb-override: + customMethod: false + verb: list + x-xgen-operation-id-override: listClusterFtsIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}: delete: deprecated: true @@ -44601,7 +44906,7 @@ paths: externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: deleteAtlasSearchIndexDeprecated + operationId: deleteGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44642,14 +44947,15 @@ paths: summary: Remove One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteAtlasSearchIndexDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteGroupClusterFtsIndex + x-xgen-operation-id-override: deleteClusterFtsIndex get: deprecated: true description: Returns one Atlas Search index in the specified project. You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: getAtlasSearchIndexDeprecated + operationId: getGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44690,14 +44996,15 @@ paths: summary: Return One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getAtlasSearchIndexDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getGroupClusterFtsIndex + x-xgen-operation-id-override: getClusterFtsIndex patch: deprecated: true description: Updates one Atlas Search index that you identified with its unique ID. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: updateAtlasSearchIndexDeprecated + operationId: updateGroupClusterFtsIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -44749,14 +45056,15 @@ paths: summary: Update One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateAtlasSearchIndexDeprecated + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateGroupClusterFtsIndex + x-xgen-operation-id-override: updateClusterFtsIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites: get: description: Returns one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: getManagedNamespace + operationId: getGroupClusterGlobalWrites parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -44776,20 +45084,20 @@ paths: $ref: '#/components/schemas/GeoSharding' x-sunset: "2026-11-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2023-02-01+json: schema: $ref: '#/components/schemas/GeoSharding' x-sunset: "2026-03-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-02-01" application/vnd.atlas.2024-08-05+json: schema: $ref: '#/components/schemas/GeoSharding20240805' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -44803,14 +45111,15 @@ paths: summary: Return One Managed Namespace in One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/getManagedNamespace + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/getGroupClusterGlobalWrites + x-xgen-operation-id-override: getClusterGlobalWrites /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites/customZoneMapping: delete: description: Removes all custom zone mappings for the specified global cluster. A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. Removing the custom zone mappings restores the default mapping. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: deleteAllCustomZoneMappings + operationId: deleteGroupClusterGlobalWriteCustomZoneMapping parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -44851,13 +45160,14 @@ paths: summary: Remove All Custom Zone Mappings from One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/deleteAllCustomZoneMappings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/deleteGroupClusterGlobalWriteCustomZoneMapping + x-xgen-operation-id-override: deleteCustomZoneMapping post: description: Creates one custom zone mapping for the specified global cluster. A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: createCustomZoneMapping + operationId: createGroupClusterGlobalWriteCustomZoneMapping parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -44914,14 +45224,15 @@ paths: summary: Add One Custom Zone Mapping to One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/createCustomZoneMapping + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/createGroupClusterGlobalWriteCustomZoneMapping + x-xgen-operation-id-override: createCustomZoneMapping /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/globalWrites/managedNamespaces: delete: description: Removes one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. Deleting a managed namespace does not remove the associated collection or data. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: deleteManagedNamespace + operationId: deleteGroupClusterGlobalWriteManagedNamespaces parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -44974,13 +45285,14 @@ paths: summary: Remove One Managed Namespace from One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/deleteManagedNamespace + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/deleteGroupClusterGlobalWriteManagedNamespaces + x-xgen-operation-id-override: deleteManagedNamespaces post: description: Creates one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: createManagedNamespace + operationId: createGroupClusterGlobalWriteManagedNamespace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45039,14 +45351,15 @@ paths: summary: Create One Managed Namespace in One Global Cluster tags: - Global Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/createManagedNamespace + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Global-Clusters/operation/createGroupClusterGlobalWriteManagedNamespace + x-xgen-operation-id-override: createManagedNamespace /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/index: post: description: Creates an index on the cluster identified by its name in a rolling manner. Creating the index in this way allows index builds on one replica set member as a standalone at a time, starting with the secondary members. Creating indexes in this way requires at least one replica set election. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Rolling Index Builds on Replica Sets url: https://docs.mongodb.com/manual/tutorial/build-indexes-on-replica-sets/ - operationId: createRollingIndex + operationId: createGroupClusterIndexRollingIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45151,14 +45464,18 @@ paths: summary: Create One Rolling Index tags: - Rolling Index - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Rolling-Index/operation/createRollingIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Rolling-Index/operation/createGroupClusterIndexRollingIndex + x-xgen-method-verb-override: + customMethod: false + verb: createRollingIndex + x-xgen-operation-id-override: createRollingIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives: get: description: Returns details of all online archives. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: listOnlineArchives + operationId: listGroupClusterOnlineArchives parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45192,13 +45509,14 @@ paths: summary: Return All Online Archives for One Cluster tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/listOnlineArchives + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/listGroupClusterOnlineArchives + x-xgen-operation-id-override: listOnlineArchives post: description: Creates one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: createOnlineArchive + operationId: createGroupClusterOnlineArchive parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45242,14 +45560,15 @@ paths: - Online Archive x-xgen-changelog: "2023-08-02": If 'criteria':'DATE' is specified, then you must specify 'DATE' values in partition fields - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/createOnlineArchive + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/createGroupClusterOnlineArchive + x-xgen-operation-id-override: createOnlineArchive /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}: delete: description: Removes one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: deleteOnlineArchive + operationId: deleteGroupClusterOnlineArchive parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -45285,13 +45604,14 @@ paths: summary: Remove One Online Archive tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/deleteOnlineArchive + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/deleteGroupClusterOnlineArchive + x-xgen-operation-id-override: deleteOnlineArchive get: description: Returns one online archive for one cluster. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: getOnlineArchive + operationId: getGroupClusterOnlineArchive parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45317,7 +45637,7 @@ paths: schema: $ref: '#/components/schemas/BackupOnlineArchive' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -45333,13 +45653,14 @@ paths: summary: Return One Online Archive tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/getOnlineArchive + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/getGroupClusterOnlineArchive + x-xgen-operation-id-override: getOnlineArchive patch: description: Updates, pauses, or resumes one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: updateOnlineArchive + operationId: updateGroupClusterOnlineArchive parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45388,14 +45709,15 @@ paths: summary: Update One Online Archive tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/updateOnlineArchive + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/updateGroupClusterOnlineArchive + x-xgen-operation-id-override: updateOnlineArchive /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/queryLogs.gz: get: description: 'Downloads query logs for the specified online archive. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip".' externalDocs: description: Online Archive url: https://docs.atlas.mongodb.com/online-archive/manage-online-archive/#std-label-manage-online-archive - operationId: downloadOnlineArchiveQueryLogs + operationId: downloadGroupClusterOnlineArchiveQueryLogs parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -45455,17 +45777,18 @@ paths: summary: Download Online Archive Query Logs tags: - Online Archive - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/downloadOnlineArchiveQueryLogs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Online-Archive/operation/downloadGroupClusterOnlineArchiveQueryLogs x-xgen-method-verb-override: customMethod: "True" verb: download + x-xgen-operation-id-override: downloadQueryLogs /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/outageSimulation: delete: description: Ends a cluster outage simulation. externalDocs: description: Cluster Outage Simulation url: https://dochub.mongodb.org/core/test-regional-outage - operationId: endOutageSimulation + operationId: endGroupClusterOutageSimulation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45498,16 +45821,17 @@ paths: summary: End One Outage Simulation tags: - Cluster Outage Simulation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/endOutageSimulation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/endGroupClusterOutageSimulation x-xgen-method-verb-override: customMethod: "True" verb: end + x-xgen-operation-id-override: endOutageSimulation get: description: Returns one outage simulation for one cluster. externalDocs: description: Cluster Outage Simulation url: https://dochub.mongodb.org/core/test-regional-outage - operationId: getOutageSimulation + operationId: getGroupClusterOutageSimulation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45544,16 +45868,17 @@ paths: summary: Return One Outage Simulation tags: - Cluster Outage Simulation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/getOutageSimulation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/getGroupClusterOutageSimulation x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getOutageSimulation post: description: Starts a cluster outage simulation. externalDocs: description: Cluster Outage Simulation url: https://dochub.mongodb.org/core/test-regional-outage - operationId: startOutageSimulation + operationId: startGroupClusterOutageSimulation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -45593,14 +45918,15 @@ paths: summary: Start One Outage Simulation tags: - Cluster Outage Simulation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/startOutageSimulation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cluster-Outage-Simulation/operation/startGroupClusterOutageSimulation x-xgen-method-verb-override: customMethod: "True" verb: start + x-xgen-operation-id-override: startOutageSimulation /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/dropIndexSuggestions: get: description: Returns the indexes that the Performance Advisor suggests to drop. The Performance Advisor suggests dropping unused, redundant, and hidden indexes to improve write performance and increase storage space. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDropIndexes + operationId: listGroupClusterPerformanceAdvisorDropIndexSuggestions parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -45633,11 +45959,12 @@ paths: summary: Return All Suggested Indexes to Drop tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listDropIndexes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupClusterPerformanceAdvisorDropIndexSuggestions + x-xgen-operation-id-override: listDropIndexSuggestions /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/schemaAdvice: get: description: Returns the schema suggestions that the Performance Advisor detects. The Performance Advisor provides holistic schema recommendations for your cluster by sampling documents in your most active collections and collections with slow-running queries. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listSchemaAdvice + operationId: listGroupClusterPerformanceAdvisorSchemaAdvice parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -45670,11 +45997,12 @@ paths: summary: Return Schema Advice tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listSchemaAdvice + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupClusterPerformanceAdvisorSchemaAdvice + x-xgen-operation-id-override: listSchemaAdvice /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/performanceAdvisor/suggestedIndexes: get: description: Returns the indexes that the Performance Advisor suggests. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listClusterSuggestedIndexes + operationId: listGroupClusterPerformanceAdvisorSuggestedIndexes parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -45750,14 +46078,15 @@ paths: summary: Return All Suggested Indexes tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listClusterSuggestedIndexes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupClusterPerformanceAdvisorSuggestedIndexes + x-xgen-operation-id-override: listClusterSuggestedIndexes /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/processArgs: get: description: Returns the advanced configuration details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. This feature isn't available for `M0` free clusters, `M2` and `M5` shared-tier clusters, flex clusters, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: getClusterAdvancedConfiguration + operationId: getGroupClusterProcessArgs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45777,13 +46106,13 @@ paths: $ref: '#/components/schemas/ClusterDescriptionProcessArgs' x-sunset: "2026-03-01" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" application/vnd.atlas.2024-08-05+json: schema: $ref: '#/components/schemas/ClusterDescriptionProcessArgs20240805' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "400": @@ -45799,13 +46128,14 @@ paths: summary: Return Advanced Configuration Options for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getClusterAdvancedConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getGroupClusterProcessArgs + x-xgen-operation-id-override: getProcessArgs patch: description: Updates the advanced configuration details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. This feature isn't available for `M0` free clusters, `M2` and `M5` shared-tier clusters, flex clusters, or serverless clusters. externalDocs: description: Global Clusters url: https://www.mongodb.com/docs/atlas/global-clusters/ - operationId: updateClusterAdvancedConfiguration + operationId: updateGroupClusterProcessArgs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -45855,7 +46185,8 @@ paths: summary: Update Advanced Configuration Options for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/updateClusterAdvancedConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/updateGroupClusterProcessArgs + x-xgen-operation-id-override: updateProcessArgs /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/queryShapeInsights/{queryShapeHash}/details: get: description: Returns the metadata and statistics summary for a given query shape hash. @@ -45938,10 +46269,11 @@ paths: tags: - Query Shape Insights x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Query-Shape-Insights/operation/getGroupClusterQueryShapeInsightDetails + x-xgen-operation-id-override: getQueryShapeDetails /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/queryShapeInsights/summaries: get: description: Returns a list of query shape statistics summaries for a given cluster. Query shape statistics provide performance insights about MongoDB queries, helping users identify problematic query patterns and potential optimizations. - operationId: getGroupClusterQueryShapeInsightSummaries + operationId: listGroupClusterQueryShapeInsightSummaries parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -46081,11 +46413,12 @@ paths: summary: Return Query Statistic Summaries tags: - Query Shape Insights - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Query-Shape-Insights/operation/getGroupClusterQueryShapeInsightSummaries + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Query-Shape-Insights/operation/listGroupClusterQueryShapeInsightSummaries + x-xgen-operation-id-override: listQueryShapeSummaries /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restartPrimaries: post: description: Starts a failover test for the specified cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. A failover test checks how MongoDB Cloud handles the failure of the cluster's primary node. During the test, MongoDB Cloud shuts down the primary node and elects a new primary. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. - operationId: testFailover + operationId: restartGroupClusterPrimaries parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46117,9 +46450,10 @@ paths: summary: Test Failover for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/testFailover + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/restartGroupClusterPrimaries x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: restartPrimaries /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restoreJobs: get: deprecated: true @@ -46130,7 +46464,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: listLegacyBackupRestoreJobs + operationId: listGroupClusterRestoreJobs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46172,14 +46506,15 @@ paths: summary: Return All Legacy Backup Restore Jobs tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listLegacyBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listGroupClusterRestoreJobs + x-xgen-operation-id-override: listClusterRestoreJobs post: deprecated: true description: Restores one legacy backup for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This endpoint doesn't support creating checkpoint restore jobs for sharded clusters, or creating restore jobs for queryable backup snapshots. If you create an automated restore job by specifying `delivery.methodName` of `AUTOMATED_RESTORE` in your request body, MongoDB Cloud removes all existing data on the target cluster prior to the restore. externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: createLegacyBackupRestoreJob + operationId: createGroupClusterRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46219,7 +46554,8 @@ paths: summary: Create One Legacy Backup Restore Job tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/createLegacyBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/createGroupClusterRestoreJob + x-xgen-operation-id-override: createClusterRestoreJob /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/restoreJobs/{jobId}: get: deprecated: true @@ -46230,7 +46566,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: getLegacyBackupRestoreJob + operationId: getGroupClusterRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46256,8 +46592,8 @@ paths: schema: $ref: '#/components/schemas/BackupRestoreJob' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: API predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-response-has-no-input-fields: API predates IPA validation. + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -46273,11 +46609,12 @@ paths: summary: Return One Legacy Backup Restore Job tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getLegacyBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getGroupClusterRestoreJob + x-xgen-operation-id-override: getClusterRestoreJob /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/deployment: delete: description: Deletes the Search Nodes for the specified cluster. - operationId: deleteAtlasSearchDeployment + operationId: deleteGroupClusterSearchDeployment parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -46316,10 +46653,11 @@ paths: summary: Delete Search Nodes tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteAtlasSearchDeployment + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteGroupClusterSearchDeployment + x-xgen-operation-id-override: deleteClusterSearchDeployment get: description: Returns the Search Nodes for the specified cluster. - operationId: getAtlasSearchDeployment + operationId: getGroupClusterSearchDeployment parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -46364,13 +46702,14 @@ paths: - Atlas Search x-xgen-changelog: "2025-03-12": Updates the return of the API when no nodes exist, the endpoint returns 200 with an empty JSON ({}) instead of 400. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getAtlasSearchDeployment + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getGroupClusterSearchDeployment x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getClusterSearchDeployment patch: description: Updates the Search Nodes for the specified cluster. - operationId: updateAtlasSearchDeployment + operationId: updateGroupClusterSearchDeployment parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -46420,10 +46759,11 @@ paths: summary: Update Search Nodes tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateAtlasSearchDeployment + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateGroupClusterSearchDeployment + x-xgen-operation-id-override: updateClusterSearchDeployment post: description: Creates Search Nodes for the specified cluster. - operationId: createAtlasSearchDeployment + operationId: createGroupClusterSearchDeployment parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -46476,14 +46816,15 @@ paths: summary: Create Search Nodes tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createAtlasSearchDeployment + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createGroupClusterSearchDeployment + x-xgen-operation-id-override: createClusterSearchDeployment /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes: get: description: Returns all Atlas Search indexes on the specified cluster. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: listAtlasSearchIndexesCluster + operationId: listGroupClusterSearchIndexes parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46504,7 +46845,7 @@ paths: $ref: '#/components/schemas/SearchIndexResponse' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2024-05-30" description: OK "400": @@ -46526,13 +46867,14 @@ paths: summary: Return All Atlas Search Indexes for One Cluster tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listAtlasSearchIndexesCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listGroupClusterSearchIndexes + x-xgen-operation-id-override: listClusterSearchIndexes post: description: Creates one Atlas Search index on the specified collection. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: createAtlasSearchIndex + operationId: createGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46574,14 +46916,15 @@ paths: summary: Create One Atlas Search Index tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createAtlasSearchIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/createGroupClusterSearchIndex + x-xgen-operation-id-override: createClusterSearchIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}: get: description: Returns all Atlas Search indexes on the specified collection. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: listAtlasSearchIndexes + operationId: listGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46614,7 +46957,7 @@ paths: $ref: '#/components/schemas/SearchIndexResponse' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2024-05-30" description: OK "400": @@ -46636,14 +46979,18 @@ paths: summary: Return All Atlas Search Indexes for One Collection tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listAtlasSearchIndexes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/listGroupClusterSearchIndex + x-xgen-method-verb-override: + customMethod: false + verb: list + x-xgen-operation-id-override: listSearchIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{databaseName}/{collectionName}/{indexName}: delete: description: Removes one Atlas Search index that you identified with its database, collection, and name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: deleteAtlasSearchIndexByName + operationId: deleteGroupClusterSearchIndexByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46692,13 +47039,17 @@ paths: summary: Remove One Atlas Search Index by Name tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteAtlasSearchIndexByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteGroupClusterSearchIndexByName + x-xgen-method-verb-override: + customMethod: true + verb: deleteByName + x-xgen-operation-id-override: deleteIndexByName get: description: Returns one Atlas Search index in the specified project. You identify this index using its database, collection and name. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: getAtlasSearchIndexByName + operationId: getGroupClusterSearchIndexByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46749,16 +47100,17 @@ paths: summary: Return One Atlas Search Index by Name tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getAtlasSearchIndexByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getGroupClusterSearchIndexByName x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: getByName + x-xgen-operation-id-override: getIndexByName patch: description: Updates one Atlas Search index that you identified with its database, collection name, and index name. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: updateAtlasSearchIndexByName + operationId: updateGroupClusterSearchIndexByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46818,17 +47170,18 @@ paths: summary: Update One Atlas Search Index by Name tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateAtlasSearchIndexByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateGroupClusterSearchIndexByName x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: updateByName + x-xgen-operation-id-override: updateIndexByName /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/search/indexes/{indexId}: delete: description: Removes one Atlas Search index that you identified with its unique ID. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: deleteAtlasSearchIndex + operationId: deleteGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46868,13 +47221,14 @@ paths: summary: Remove One Atlas Search Index by ID tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteAtlasSearchIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/deleteGroupClusterSearchIndex + x-xgen-operation-id-override: deleteClusterSearchIndex get: description: Returns one Atlas Search index in the specified project. You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: getAtlasSearchIndex + operationId: getGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46922,13 +47276,14 @@ paths: summary: Return One Atlas Search Index by ID tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getAtlasSearchIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/getGroupClusterSearchIndex + x-xgen-operation-id-override: getClusterSearchIndex patch: description: Updates one Atlas Search index that you identified with its unique ID. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. externalDocs: description: Atlas Search Indexes url: https://dochub.mongodb.org/core/index-definitions-fts - operationId: updateAtlasSearchIndex + operationId: updateGroupClusterSearchIndex parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -46979,7 +47334,8 @@ paths: summary: Update One Atlas Search Index by ID tags: - Atlas Search - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateAtlasSearchIndex + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Atlas-Search/operation/updateGroupClusterSearchIndex + x-xgen-operation-id-override: updateClusterSearchIndex /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshotSchedule: get: deprecated: true @@ -46990,7 +47346,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: getLegacySnapshotSchedule + operationId: getGroupClusterSnapshotSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47009,7 +47365,7 @@ paths: schema: $ref: '#/components/schemas/ApiAtlasSnapshotScheduleView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -47023,7 +47379,8 @@ paths: summary: Return One Snapshot Schedule tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getLegacySnapshotSchedule + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getGroupClusterSnapshotSchedule + x-xgen-operation-id-override: getClusterSnapshotSchedule patch: deprecated: true description: |- @@ -47033,7 +47390,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: updateLegacySnapshotSchedule + operationId: updateGroupClusterSnapshotSchedule parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -47073,7 +47430,8 @@ paths: summary: Update Snapshot Schedule for One Cluster tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/updateLegacySnapshotSchedule + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/updateGroupClusterSnapshotSchedule + x-xgen-operation-id-override: updateClusterSnapshotSchedule /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshots: get: deprecated: true @@ -47081,7 +47439,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: listLegacySnapshots + operationId: listGroupClusterSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47125,7 +47483,8 @@ paths: summary: Return All Legacy Backup Snapshots tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listLegacySnapshots + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/listGroupClusterSnapshots + x-xgen-operation-id-override: listClusterSnapshots /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/snapshots/{snapshotId}: delete: deprecated: true @@ -47133,7 +47492,7 @@ paths: externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: deleteLegacySnapshot + operationId: deleteGroupClusterSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47171,14 +47530,15 @@ paths: summary: Remove One Legacy Backup Snapshot tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/deleteLegacySnapshot + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/deleteGroupClusterSnapshot + x-xgen-operation-id-override: deleteClusterSnapshot get: deprecated: true description: Returns one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: getLegacySnapshot + operationId: getGroupClusterSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47204,7 +47564,7 @@ paths: schema: $ref: '#/components/schemas/BackupSnapshot' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -47218,14 +47578,15 @@ paths: summary: Return One Legacy Backup Snapshot tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getLegacySnapshot + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/getGroupClusterSnapshot + x-xgen-operation-id-override: getClusterSnapshot patch: deprecated: true description: Changes the expiration date for one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. externalDocs: description: Cloud Backup Documentation url: https://www.mongodb.com/docs/atlas/backup/cloud-backup/scheduling/#std-label-cloud-provider-backup-schedule - operationId: updateLegacySnapshotRetention + operationId: updateGroupClusterSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47270,11 +47631,12 @@ paths: summary: Update Expiration Date for One Legacy Backup Snapshot tags: - Legacy Backup - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/updateLegacySnapshotRetention + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Legacy-Backup/operation/updateGroupClusterSnapshot + x-xgen-operation-id-override: updateClusterSnapshot /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/status: get: description: Returns the status of all changes that you made to the specified cluster in the specified project. Use this resource to check the progress MongoDB Cloud has made in processing your changes. The response does not include the deployment of new dedicated clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getClusterStatus + operationId: getGroupClusterStatus parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47293,7 +47655,7 @@ paths: schema: $ref: '#/components/schemas/ClusterStatus' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -47307,11 +47669,12 @@ paths: summary: Return Status of All Cluster Operations tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getClusterStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getGroupClusterStatus + x-xgen-operation-id-override: getClusterStatus /api/atlas/v2/groups/{groupId}/clusters/{clusterName}:grantMongoDBEmployeeAccess: post: description: Grants MongoDB employee cluster access for the given duration and at the specified level for one cluster. - operationId: grantMongoDbEmployeeAccess + operationId: grantGroupClusterMongoDbEmployeeAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -47352,11 +47715,12 @@ paths: summary: Grant MongoDB Employee Cluster Access for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/grantMongoDbEmployeeAccess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/grantGroupClusterMongoDbEmployeeAccess + x-xgen-operation-id-override: grantMongoEmployeeAccess /api/atlas/v2/groups/{groupId}/clusters/{clusterName}:pinFeatureCompatibilityVersion: post: description: Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. If an FCV pin already exists for the cluster, calling this method will only update the expiration date of the existing pin and will not repin the FCV. - operationId: pinFeatureCompatibilityVersion + operationId: pinGroupClusterFeatureCompatibilityVersion parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -47396,11 +47760,12 @@ paths: summary: Pin Feature Compatibility Version for One Cluster in One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/pinFeatureCompatibilityVersion + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/pinGroupClusterFeatureCompatibilityVersion + x-xgen-operation-id-override: pinFeatureCompatibilityVersion /api/atlas/v2/groups/{groupId}/clusters/{clusterName}:revokeMongoDBEmployeeAccess: post: description: Revokes a previously granted MongoDB employee cluster access. - operationId: revokeMongoDbEmployeeAccess + operationId: revokeGroupClusterMongoDbEmployeeAccess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -47433,11 +47798,12 @@ paths: summary: Revoke MongoDB Employee Cluster Access for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/revokeMongoDbEmployeeAccess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/revokeGroupClusterMongoDbEmployeeAccess + x-xgen-operation-id-override: revokeMongoEmployeeAccess /api/atlas/v2/groups/{groupId}/clusters/{clusterName}:unpinFeatureCompatibilityVersion: post: description: Unpins the current fixed Feature Compatibility Version (FCV). This feature is not available for clusters on rapid release. - operationId: unpinFeatureCompatibilityVersion + operationId: unpinGroupClusterFeatureCompatibilityVersion parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47472,11 +47838,12 @@ paths: summary: Unpin Feature Compatibility Version for One Cluster in One Project tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/unpinFeatureCompatibilityVersion + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/unpinGroupClusterFeatureCompatibilityVersion + x-xgen-operation-id-override: unpinFeatureCompatibilityVersion /api/atlas/v2/groups/{groupId}/clusters/{hostName}/logs/{logName}.gz: get: description: 'Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. MongoDB updates process and audit logs from the cluster backend infrastructure every five minutes. Logs are stored in chunks approximately five minutes in length, but this duration may vary. If you poll the API for log files, we recommend polling every five minutes even though consecutive polls could contain some overlapping logs. This feature isn''t available for `M0` free clusters, `M2`, `M5`, flex, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip".' - operationId: getHostLogs + operationId: downloadGroupClusterLog parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47547,14 +47914,15 @@ paths: summary: Download Logs for One Cluster Host in One Project tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getHostLogs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/downloadGroupClusterLog x-xgen-method-verb-override: customMethod: "True" verb: download + x-xgen-operation-id-override: downloadClusterLog /api/atlas/v2/groups/{groupId}/clusters/provider/regions: get: description: Returns the list of regions available for the specified cloud provider at the specified tier. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listCloudProviderRegions + operationId: listGroupClusterProviderRegions parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47593,14 +47961,15 @@ paths: summary: Return All Cloud Provider Regions tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listCloudProviderRegions + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/listGroupClusterProviderRegions + x-xgen-operation-id-override: listClusterProviderRegions /api/atlas/v2/groups/{groupId}/clusters/tenantUpgrade: post: description: "Upgrades a shared-tier cluster to a Flex or Dedicated (M10+) cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. Each project supports up to 25 clusters. \n\nThis endpoint can also be used to upgrade Flex clusters that were created using the [createCluster](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/createCluster) API or former M2/M5 clusters that have been migrated to Flex clusters, using instanceSizeName to “M2” or “M5” until January 2026. This functionality will be available until January 2026, after which it will only be available for M0 clusters. Please use the upgradeFlexCluster endpoint instead." externalDocs: description: upgradeFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/upgradeFlexCluster - operationId: upgradeSharedCluster + operationId: upgradeGroupClusterTenantUpgrade parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47637,10 +48006,11 @@ paths: summary: Upgrade One Shared-Tier Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/upgradeSharedCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/upgradeGroupClusterTenantUpgrade x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: upgrade + x-xgen-operation-id-override: upgradeTenantUpgrade /api/atlas/v2/groups/{groupId}/clusters/tenantUpgradeToServerless: post: deprecated: true @@ -47651,7 +48021,7 @@ paths: externalDocs: description: upgradeFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/upgradeFlexCluster - operationId: upgradeSharedClusterToServerless + operationId: upgradeGroupClusterTenantUpgradeToServerless parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47689,14 +48059,15 @@ paths: summary: Upgrade One Shared-Tier Cluster to One Serverless Instance tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/upgradeSharedClusterToServerless + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/upgradeGroupClusterTenantUpgradeToServerless x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: upgrade + x-xgen-operation-id-override: upgradeClusterToServerless /api/atlas/v2/groups/{groupId}/collStats/metrics: get: description: Returns all available Coll Stats Latency metric names and their respective units for the specified project at the time of request. - operationId: getCollStatsLatencyNamespaceMetrics + operationId: listGroupCollStatMetrics parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -47716,14 +48087,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return all metric names + summary: Return All Metric Names tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespaceMetrics + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/listGroupCollStatMetrics + x-xgen-operation-id-override: listCollStatMetrics /api/atlas/v2/groups/{groupId}/containers: get: description: Returns details about all network peering containers in the specified project for the specified cloud provider. If you do not specify the cloud provider, MongoDB Cloud returns details about all network peering containers in the project for Amazon Web Services (AWS). To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPeeringContainerByCloudProvider + operationId: listGroupContainers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47743,7 +48115,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. responses: "200": content: @@ -47763,10 +48135,10 @@ paths: summary: Return All Network Peering Containers in One Project for One Cloud Provider tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listPeeringContainerByCloudProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listGroupContainers post: description: Creates one new network peering container in the specified project. MongoDB Cloud can deploy Network Peering connections in a network peering container. GCP can have one container per project. AWS and Azure can have one container per cloud provider region. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createPeeringContainer + operationId: createGroupContainer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47801,11 +48173,11 @@ paths: summary: Create One Network Peering Container tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/createPeeringContainer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/createGroupContainer /api/atlas/v2/groups/{groupId}/containers/{containerId}: delete: description: Removes one network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deletePeeringContainer + operationId: deleteGroupContainer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47839,10 +48211,10 @@ paths: summary: Remove One Network Peering Container tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/deletePeeringContainer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/deleteGroupContainer get: description: Returns details about one network peering container in one specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPeeringContainer + operationId: getGroupContainer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47862,7 +48234,7 @@ paths: schema: $ref: '#/components/schemas/CloudProviderContainer' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -47876,10 +48248,10 @@ paths: summary: Return One Network Peering Container tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/getPeeringContainer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/getGroupContainer patch: description: Updates the network details and labels of one specified network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updatePeeringContainer + operationId: updateGroupContainer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47922,11 +48294,11 @@ paths: summary: Update One Network Peering Container tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/updatePeeringContainer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/updateGroupContainer /api/atlas/v2/groups/{groupId}/containers/all: get: description: Returns details about all network peering containers in the specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPeeringContainers + operationId: listGroupContainerAll parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47953,14 +48325,14 @@ paths: summary: Return All Network Peering Containers in One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listPeeringContainers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listGroupContainerAll x-xgen-method-verb-override: customMethod: "False" verb: list /api/atlas/v2/groups/{groupId}/customDBRoles/roles: get: description: Returns all custom roles for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listCustomDatabaseRoles + operationId: listGroupCustomDbRoleRoles parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -47974,7 +48346,7 @@ paths: $ref: '#/components/schemas/UserCustomDBRole' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -47988,10 +48360,11 @@ paths: summary: Return All Custom Roles in One Project tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/listCustomDatabaseRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/listGroupCustomDbRoleRoles + x-xgen-operation-id-override: listCustomDbRoles post: description: Creates one custom role in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: createCustomDatabaseRole + operationId: createGroupCustomDbRoleRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48026,11 +48399,12 @@ paths: summary: Create One Custom Role tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/createCustomDatabaseRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/createGroupCustomDbRoleRole + x-xgen-operation-id-override: createCustomDbRole /api/atlas/v2/groups/{groupId}/customDBRoles/roles/{roleName}: delete: description: Removes one custom role from the specified project. You can't remove a custom role that would leave one or more child roles with no parent roles or actions. You also can't remove a custom role that would leave one or more database users without roles. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: deleteCustomDatabaseRole + operationId: deleteGroupCustomDbRoleRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48062,10 +48436,11 @@ paths: summary: Remove One Custom Role from One Project tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/deleteCustomDatabaseRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/deleteGroupCustomDbRoleRole + x-xgen-operation-id-override: deleteCustomDbRole get: description: Returns one custom role for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getCustomDatabaseRole + operationId: getGroupCustomDbRoleRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48095,10 +48470,11 @@ paths: summary: Return One Custom Role in One Project tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/getCustomDatabaseRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/getGroupCustomDbRoleRole + x-xgen-operation-id-override: getCustomDbRole patch: description: Updates one custom role in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: updateCustomDatabaseRole + operationId: updateGroupCustomDbRoleRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48139,11 +48515,12 @@ paths: summary: Update One Custom Role in One Project tags: - Custom Database Roles - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/updateCustomDatabaseRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Custom-Database-Roles/operation/updateGroupCustomDbRoleRole + x-xgen-operation-id-override: updateCustomDbRole /api/atlas/v2/groups/{groupId}/dataFederation: get: description: Returns the details of all federated database instances in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or higher role. - operationId: listFederatedDatabases + operationId: listGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48166,11 +48543,11 @@ paths: $ref: '#/components/schemas/DataLakeTenant' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -48184,10 +48561,11 @@ paths: summary: Return All Federated Database Instances in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listFederatedDatabases + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listGroupDataFederation + x-xgen-operation-id-override: listDataFederation post: description: Creates one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - operationId: createFederatedDatabase + operationId: createGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48226,11 +48604,12 @@ paths: summary: Create One Federated Database Instance in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createFederatedDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createGroupDataFederation + x-xgen-operation-id-override: createDataFederation /api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}: delete: description: Removes one federated database instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - operationId: deleteFederatedDatabase + operationId: deleteGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48258,10 +48637,11 @@ paths: summary: Remove One Federated Database Instance from One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteFederatedDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteGroupDataFederation + x-xgen-operation-id-override: deleteDataFederation get: description: Returns the details of one federated database instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - operationId: getFederatedDatabase + operationId: getGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48278,8 +48658,8 @@ paths: schema: $ref: '#/components/schemas/DataLakeTenant' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation. + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -48295,10 +48675,11 @@ paths: summary: Return One Federated Database Instance in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getFederatedDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getGroupDataFederation + x-xgen-operation-id-override: getDataFederation patch: description: Updates the details of one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or higher role. - operationId: updateFederatedDatabase + operationId: updateGroupDataFederation parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48343,11 +48724,12 @@ paths: summary: Update One Federated Database Instance in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/updateFederatedDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/updateGroupDataFederation + x-xgen-operation-id-override: updateDataFederation /api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits: get: description: Returns query limits for a federated databases instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: returnFederatedDatabaseQueryLimits + operationId: listGroupDataFederationLimits parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48367,11 +48749,11 @@ paths: $ref: '#/components/schemas/DataFederationTenantQueryLimit' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -48385,11 +48767,12 @@ paths: summary: Return All Query Limits for One Federated Database Instance tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/returnFederatedDatabaseQueryLimits + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listGroupDataFederationLimits + x-xgen-operation-id-override: listDataFederationLimits /api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/limits/{limitName}: delete: description: Deletes one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteOneDataFederationInstanceQueryLimit + operationId: deleteGroupDataFederationLimit parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48437,10 +48820,11 @@ paths: summary: Delete One Query Limit for One Federated Database Instance tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteOneDataFederationInstanceQueryLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteGroupDataFederationLimit + x-xgen-operation-id-override: deleteDataFederationLimit get: description: Returns the details of one query limit for the specified federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: returnFederatedDatabaseQueryLimit + operationId: getGroupDataFederationLimit parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -48477,7 +48861,7 @@ paths: schema: $ref: '#/components/schemas/DataFederationTenantQueryLimit' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -48491,10 +48875,11 @@ paths: summary: Return One Federated Database Instance Query Limit for One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/returnFederatedDatabaseQueryLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getGroupDataFederationLimit + x-xgen-operation-id-override: getDataFederationLimit patch: description: Creates or updates one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createOneDataFederationQueryLimit + operationId: setGroupDataFederationLimit parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48551,14 +48936,15 @@ paths: summary: Configure One Query Limit for One Federated Database Instance tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createOneDataFederationQueryLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/setGroupDataFederationLimit x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: set + x-xgen-operation-id-override: setDataFederationLimit /api/atlas/v2/groups/{groupId}/dataFederation/{tenantName}/queryLogs.gz: get: description: 'Downloads the query logs for the specified federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Data Access Read Write roles. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip".' - operationId: downloadFederatedDatabaseQueryLogs + operationId: downloadGroupDataFederationQueryLogs parameters: - $ref: '#/components/parameters/groupId' - description: Timestamp that specifies the end point for the range of log messages to download. MongoDB Cloud expresses this timestamp in the number of seconds that have elapsed since the UNIX epoch. @@ -48608,14 +48994,15 @@ paths: summary: Download Query Logs for One Federated Database Instance tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/downloadFederatedDatabaseQueryLogs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/downloadGroupDataFederationQueryLogs x-xgen-method-verb-override: customMethod: "True" verb: download + x-xgen-operation-id-override: downloadFederationQueryLogs /api/atlas/v2/groups/{groupId}/databaseUsers: get: description: Returns all database users that belong to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDatabaseUsers + operationId: listGroupDatabaseUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48642,13 +49029,14 @@ paths: summary: Return All Database Users in One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/listDatabaseUsers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/listGroupDatabaseUsers + x-xgen-operation-id-override: listDatabaseUsers post: description: Creates one database user in the specified project. This MongoDB Cloud supports a maximum of 100 database users per project. If you require more than 100 database users on a project, contact Support. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. externalDocs: description: Contact MongoDB Support url: https://cloud.mongodb.com/support - operationId: createDatabaseUser + operationId: createGroupDatabaseUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48774,11 +49162,12 @@ paths: summary: Create One Database User in One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/createDatabaseUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/createGroupDatabaseUser + x-xgen-operation-id-override: createDatabaseUser /api/atlas/v2/groups/{groupId}/databaseUsers/{databaseName}/{username}: delete: description: Removes one database user from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: deleteDatabaseUser + operationId: deleteGroupDatabaseUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48810,9 +49199,9 @@ paths: example: 'SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName' type: string x-xgen-IPA-exception: - xgen-IPA-117-description-must-not-use-html: Description predates IPA validation + xgen-IPA-117-description-must-not-use-html: Description predates IPA validation. xgen-IPA-117-description-should-not-use-inline-links: Parameters don't support externalDocs - xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation + xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation. responses: "204": content: @@ -48830,10 +49219,11 @@ paths: summary: Remove One Database User from One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/deleteDatabaseUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/deleteGroupDatabaseUser + x-xgen-operation-id-override: deleteDatabaseUser get: description: Returns one database user that belong to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getDatabaseUser + operationId: getGroupDatabaseUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48865,9 +49255,9 @@ paths: example: 'SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName' type: string x-xgen-IPA-exception: - xgen-IPA-117-description-must-not-use-html: Description predates IPA validation + xgen-IPA-117-description-must-not-use-html: Description predates IPA validation. xgen-IPA-117-description-should-not-use-inline-links: Parameters don't support externalDocs - xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation + xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation. responses: "200": content: @@ -48887,10 +49277,11 @@ paths: summary: Return One Database User from One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/getDatabaseUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/getGroupDatabaseUser + x-xgen-operation-id-override: getDatabaseUser patch: description: Updates one database user that belongs to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. - operationId: updateDatabaseUser + operationId: updateGroupDatabaseUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48922,9 +49313,9 @@ paths: example: 'SCRAM-SHA: dylan or AWS IAM: arn:aws:iam::123456789012:user/sales/enterprise/DylanBloggs or x.509/LDAP: CN=Dylan Bloggs,OU=Enterprise,OU=Sales,DC=Example,DC=COM or OIDC: IdPIdentifier/IdPGroupName' type: string x-xgen-IPA-exception: - xgen-IPA-117-description-must-not-use-html: Description predates IPA validation + xgen-IPA-117-description-must-not-use-html: Description predates IPA validation. xgen-IPA-117-description-should-not-use-inline-links: Parameters don't support externalDocs - xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation + xgen-IPA-117-description-should-not-use-inline-tables: Description predates IPA validation. requestBody: content: application/vnd.atlas.2023-01-01+json: @@ -48955,11 +49346,12 @@ paths: summary: Update One Database User in One Project tags: - Database Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/updateDatabaseUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Database-Users/operation/updateGroupDatabaseUser + x-xgen-operation-id-override: updateDatabaseUser /api/atlas/v2/groups/{groupId}/databaseUsers/{username}/certs: get: description: Returns all unexpired X.509 certificates for the specified MongoDB user. This MongoDB user belongs to one project. Atlas manages these certificates and the MongoDB user. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDatabaseUserCertificates + operationId: listGroupDatabaseUserCerts parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -48994,7 +49386,8 @@ paths: summary: Return All X.509 Certificates Assigned to One Database User tags: - X.509 Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/listDatabaseUserCertificates + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/listGroupDatabaseUserCerts + x-xgen-operation-id-override: listDatabaseUserCerts post: description: |- Generates one X.509 certificate for the specified MongoDB user. Atlas manages the certificate and MongoDB user that belong to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -49005,7 +49398,7 @@ paths: externalDocs: description: Self-Managed X.509 url: https://www.mongodb.com/docs/atlas/security-self-managed-x509/#std-label-self-managed-x509 - operationId: createDatabaseUserCertificate + operationId: createGroupDatabaseUserCert parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49047,14 +49440,15 @@ paths: summary: Create One X.509 Certificate for One Database User tags: - X.509 Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/createDatabaseUserCertificate + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/createGroupDatabaseUserCert + x-xgen-operation-id-override: createDatabaseUserCert /api/atlas/v2/groups/{groupId}/dbAccessHistory/clusters/{clusterName}: get: description: 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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. externalDocs: description: Database Access History url: https://docs.atlas.mongodb.com/access-tracking/ - operationId: listAccessLogsByClusterName + operationId: getGroupDbAccessHistoryCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49121,14 +49515,15 @@ paths: summary: Return Database Access History for One Cluster by Cluster Name tags: - Access Tracking - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/listAccessLogsByClusterName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/getGroupDbAccessHistoryCluster + x-xgen-operation-id-override: getAccessHistoryCluster /api/atlas/v2/groups/{groupId}/dbAccessHistory/processes/{hostname}: get: description: 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 Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. externalDocs: description: Database Access History url: https://docs.atlas.mongodb.com/access-tracking/ - operationId: listAccessLogsByHostname + operationId: getGroupDbAccessHistoryProcess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49192,14 +49587,15 @@ paths: summary: Return Database Access History for One Cluster by Hostname tags: - Access Tracking - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/listAccessLogsByHostname + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Access-Tracking/operation/getGroupDbAccessHistoryProcess + x-xgen-operation-id-override: getAccessHistoryProcess /api/atlas/v2/groups/{groupId}/encryptionAtRest: get: description: |- Returns the configuration for encryption at rest using the keys you manage through your cloud provider. MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. **LIMITED TO M10 OR GREATER:** MongoDB Cloud limits this feature to dedicated cluster tiers of M10 and greater. - operationId: getEncryptionAtRest + operationId: getGroupEncryptionAtRest parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49211,8 +49607,8 @@ paths: schema: $ref: '#/components/schemas/EncryptionAtRest' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation. + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -49223,16 +49619,17 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Configuration for Encryption at Rest using Customer-Managed Keys for One Project + summary: Return One Configuration for Encryption at Rest Using Customer-Managed Keys for One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getEncryptionAtRest + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getGroupEncryptionAtRest + x-xgen-operation-id-override: getEncryptionAtRest patch: description: |- Updates the configuration for encryption at rest using the keys you manage through your cloud provider. MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. This feature isn't available for `M0` free clusters, `M2`, `M5`, or serverless clusters. After you configure at least one Encryption at Rest using a Customer Key Management provider for the MongoDB Cloud project, Project Owners can enable Encryption at Rest using Customer Key Management for each MongoDB Cloud cluster for which they require encryption. The Encryption at Rest using Customer Key Management provider doesn't have to match the cluster cloud service provider. MongoDB Cloud doesn't automatically rotate user-managed encryption keys. Defer to your preferred Encryption at Rest using Customer Key Management provider's documentation and guidance for best practices on key rotation. MongoDB Cloud automatically creates a 90-day key rotation alert when you configure Encryption at Rest using Customer Key Management using your Key Management in an MongoDB Cloud project. MongoDB Cloud encrypts all storage whether or not you use your own key management. - operationId: updateEncryptionAtRest + operationId: updateGroupEncryptionAtRest parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49249,7 +49646,7 @@ paths: - To use AWS Key Management Service (KMS), MongoDB Cloud requires all the fields in the **awsKms** object. - To use Azure Key Vault, MongoDB Cloud requires all the fields in the **azureKeyVault** object. - - To use Google Cloud Key Management Service (KMS), MongoDB Cloud requires all the fields in the **googleCloudKms** object. + - To use Google Cloud Key Management Service (KMS), MongoDB Cloud requires all the fields in the **googleCloudKms** object For authentication, you must provide either serviceAccountKey (static credentials) or roleId (service-account–based authentication) Once roleId is configured, serviceAccountKey is no longer supported. If you enabled Encryption at Rest using Customer Key Management, administrators can pass only the changed fields for the **awsKms**, **azureKeyVault**, or **googleCloudKms** object to update the configuration to this endpoint. required: true @@ -49273,14 +49670,15 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Update Encryption at Rest Configuration for One Project + summary: Update Encryption at Rest Configuration in One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/updateEncryptionAtRest + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/updateGroupEncryptionAtRest + x-xgen-operation-id-override: updateEncryptionAtRest /api/atlas/v2/groups/{groupId}/encryptionAtRest/{cloudProvider}/privateEndpoints: get: description: Returns the private endpoints of the specified cloud provider for encryption at rest using customer key management. - operationId: getEncryptionAtRestPrivateEndpointsForCloudProvider + operationId: listGroupEncryptionAtRestPrivateEndpoints parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49313,13 +49711,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return Private Endpoints of a Cloud Provider for Encryption at Rest Using Customer Key Management for One Project + summary: Return Private Endpoints for Encryption at Rest Using Customer Key Management for One Cloud Provider in One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getEncryptionAtRestPrivateEndpointsForCloudProvider + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/listGroupEncryptionAtRestPrivateEndpoints + x-xgen-operation-id-override: listRestPrivateEndpoints post: description: Creates a private endpoint in the specified region for encryption at rest using customer key management. - operationId: createEncryptionAtRestPrivateEndpoint + operationId: createGroupEncryptionAtRestPrivateEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49356,14 +49755,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Create One Private Endpoint in a Specified Region for Encryption at Rest Using Customer Key Management + summary: Create One Private Endpoint for Encryption at Rest Using Customer Key Management for One Cloud Provider in One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/createEncryptionAtRestPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/createGroupEncryptionAtRestPrivateEndpoint + x-xgen-operation-id-override: createRestPrivateEndpoint /api/atlas/v2/groups/{groupId}/encryptionAtRest/{cloudProvider}/privateEndpoints/{endpointId}: delete: description: Deletes one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. - operationId: requestEncryptionAtRestPrivateEndpointDeletion + operationId: requestGroupEncryptionAtRestPrivateEndpointDeletion parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49398,16 +49798,17 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Delete One Private Endpoint for Encryption at Rest Using Customer Key Management + summary: Delete One Private Endpoint for Encryption at Rest Using Customer Key Management for One Cloud Provider from One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/requestEncryptionAtRestPrivateEndpointDeletion + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/requestGroupEncryptionAtRestPrivateEndpointDeletion x-xgen-method-verb-override: customMethod: "True" verb: requestDeletion + x-xgen-operation-id-override: requestPrivateEndpointDeletion get: description: Returns one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. - operationId: getEncryptionAtRestPrivateEndpoint + operationId: getGroupEncryptionAtRestPrivateEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49435,7 +49836,7 @@ paths: schema: $ref: '#/components/schemas/EARPrivateEndpoint' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -49446,17 +49847,18 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Private Endpoint for Encryption at Rest Using Customer Key Management + summary: Return One Private Endpoint for Encryption at Rest Using Customer Key Management for One Cloud Provider in One Project tags: - Encryption at Rest using Customer Key Management - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getEncryptionAtRestPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Encryption-at-Rest-using-Customer-Key-Management/operation/getGroupEncryptionAtRestPrivateEndpoint + x-xgen-operation-id-override: getRestPrivateEndpoint /api/atlas/v2/groups/{groupId}/events: get: description: |- Returns events for the specified project. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This resource remains under revision and may change. - operationId: listProjectEvents + operationId: listGroupEvents parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49524,7 +49926,7 @@ paths: schema: $ref: '#/components/schemas/GroupPaginatedEventView' x-xgen-IPA-exception: - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -49542,7 +49944,7 @@ paths: summary: Return Events from One Project tags: - Events - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listProjectEvents + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listGroupEvents /api/atlas/v2/groups/{groupId}/events/{eventId}: get: description: |- @@ -49552,7 +49954,7 @@ paths: externalDocs: description: Return Events from One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listProjectEvents - operationId: getProjectEvent + operationId: getGroupEvent parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49577,7 +49979,7 @@ paths: schema: $ref: '#/components/schemas/EventViewForNdsGroup' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -49591,11 +49993,11 @@ paths: summary: Return One Event from One Project tags: - Events - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/getProjectEvent + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/getGroupEvent /api/atlas/v2/groups/{groupId}/flexClusters: get: description: Returns details for all flex clusters in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listFlexClusters + operationId: listGroupFlexClusters parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49624,10 +50026,11 @@ paths: summary: Return All Flex Clusters from One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/listFlexClusters + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/listGroupFlexClusters + x-xgen-operation-id-override: listFlexClusters post: description: Creates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createFlexCluster + operationId: createGroupFlexCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49664,11 +50067,12 @@ paths: summary: Create One Flex Cluster in One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/createFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/createGroupFlexCluster + x-xgen-operation-id-override: createFlexCluster /api/atlas/v2/groups/{groupId}/flexClusters/{name}: delete: description: Removes one flex cluster from the specified project. The flex cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteFlexCluster + operationId: deleteGroupFlexCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -49701,10 +50105,11 @@ paths: summary: Remove One Flex Cluster from One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/deleteFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/deleteGroupFlexCluster + x-xgen-operation-id-override: deleteFlexCluster get: description: Returns details for one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getFlexCluster + operationId: getGroupFlexCluster parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -49723,7 +50128,7 @@ paths: schema: $ref: '#/components/schemas/FlexClusterDescription20241113' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-11-13" description: OK "400": @@ -49741,10 +50146,11 @@ paths: summary: Return One Flex Cluster from One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/getFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/getGroupFlexCluster + x-xgen-operation-id-override: getFlexCluster patch: description: Updates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateFlexCluster + operationId: updateGroupFlexCluster parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49786,11 +50192,12 @@ paths: summary: Update One Flex Cluster in One Project tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/updateFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/updateGroupFlexCluster + x-xgen-operation-id-override: updateFlexCluster /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/download: post: description: Requests one snapshot for the specified flex cluster. This resource returns a `snapshotURL` that you can use to download the snapshot. This `snapshotURL` remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: downloadFlexBackup + operationId: downloadGroupFlexClusterBackup parameters: - description: Human-readable label that identifies the flex cluster. in: path @@ -49832,13 +50239,14 @@ paths: summary: Download One Flex Cluster Snapshot tags: - Flex Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/downloadFlexBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/downloadGroupFlexClusterBackup x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: downloadFlexBackup /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/restoreJobs: get: description: Returns all restore jobs for one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: listFlexBackupRestoreJobs + operationId: listGroupFlexClusterBackupRestoreJobs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49874,10 +50282,11 @@ paths: summary: Return All Restore Jobs for One Flex Cluster tags: - Flex Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/listFlexBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/listGroupFlexClusterBackupRestoreJobs + x-xgen-operation-id-override: listFlexRestoreJobs post: description: Restores one snapshot of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createFlexBackupRestoreJob + operationId: createGroupFlexClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49916,14 +50325,15 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Restore One Snapshot of One Flex Cluster + summary: Create One Restore Job for One Flex Cluster tags: - Flex Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/createFlexBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/createGroupFlexClusterBackupRestoreJob + x-xgen-operation-id-override: createFlexRestoreJob /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/restoreJobs/{restoreJobId}: get: description: Returns one restore job for one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getFlexBackupRestoreJob + operationId: getGroupFlexClusterBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -49963,11 +50373,12 @@ paths: summary: Return One Restore Job for One Flex Cluster tags: - Flex Restore Jobs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/getFlexBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/getGroupFlexClusterBackupRestoreJob + x-xgen-operation-id-override: getFlexRestoreJob /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/snapshots: get: description: Returns all snapshots of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listFlexBackups + operationId: listGroupFlexClusterBackupSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50000,14 +50411,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return All Snapshots of One Flex Cluster + summary: Return All Snapshots for One Flex Cluster tags: - Flex Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/listFlexBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/listGroupFlexClusterBackupSnapshots + x-xgen-operation-id-override: listFlexBackupSnapshots /api/atlas/v2/groups/{groupId}/flexClusters/{name}/backup/snapshots/{snapshotId}: get: description: Returns one snapshot of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getFlexBackup + operationId: getGroupFlexClusterBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50044,14 +50456,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Snapshot of One Flex Cluster + summary: Return One Snapshot for One Flex Cluster tags: - Flex Snapshots - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/getFlexBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/getGroupFlexClusterBackupSnapshot + x-xgen-operation-id-override: getFlexBackupSnapshot /api/atlas/v2/groups/{groupId}/flexClusters:tenantUpgrade: post: description: Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. - operationId: upgradeFlexCluster + operationId: tenantGroupFlexClusterUpgrade parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50088,11 +50501,12 @@ paths: summary: Upgrade One Flex Cluster tags: - Flex Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/upgradeFlexCluster + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/tenantGroupFlexClusterUpgrade + x-xgen-operation-id-override: tenantUpgrade /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics: get: description: Returns all Atlas Search metric types available for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. - operationId: listMetricTypes + operationId: listGroupHostFtsMetrics parameters: - $ref: '#/components/parameters/processId' - $ref: '#/components/parameters/groupId' @@ -50120,11 +50534,12 @@ paths: summary: Return All Atlas Search Metric Types for One Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listMetricTypes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupHostFtsMetrics + x-xgen-operation-id-override: listHostFtsMetrics /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/{indexName}/measurements: get: description: Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. You must have the Project Read Only or higher role to view the Atlas Search metric types. - operationId: getIndexMetrics + operationId: getGroupHostFtsMetricIndexMeasurements parameters: - $ref: '#/components/parameters/processId' - $ref: '#/components/parameters/indexName' @@ -50166,7 +50581,7 @@ paths: schema: $ref: '#/components/schemas/MeasurementsIndexes' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50184,11 +50599,12 @@ paths: summary: Return Atlas Search Metrics for One Index in One Namespace tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getIndexMetrics + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupHostFtsMetricIndexMeasurements + x-xgen-operation-id-override: getIndexMeasurements /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/indexes/{databaseName}/{collectionName}/measurements: get: description: Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. - operationId: listIndexMetrics + operationId: listGroupHostFtsMetricIndexMeasurements parameters: - $ref: '#/components/parameters/processId' - $ref: '#/components/parameters/databaseName' @@ -50229,7 +50645,7 @@ paths: schema: $ref: '#/components/schemas/MeasurementsIndexes' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50247,11 +50663,15 @@ paths: summary: Return All Atlas Search Index Metrics for One Namespace tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listIndexMetrics + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupHostFtsMetricIndexMeasurements + x-xgen-method-verb-override: + customMethod: false + verb: list + x-xgen-operation-id-override: listIndexMeasurements /api/atlas/v2/groups/{groupId}/hosts/{processId}/fts/metrics/measurements: get: description: Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. - operationId: getMeasurements + operationId: listGroupHostFtsMetricMeasurements parameters: - $ref: '#/components/parameters/processId' - $ref: '#/components/parameters/groupId' @@ -50307,11 +50727,12 @@ paths: summary: Return Atlas Search Hardware and Status Metrics tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupHostFtsMetricMeasurements + x-xgen-operation-id-override: listMeasurements /api/atlas/v2/groups/{groupId}/integrations: get: description: Returns the settings that permit integrations with all configured third-party services. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: listThirdPartyIntegrations + operationId: listGroupIntegrations parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50340,11 +50761,11 @@ paths: summary: Return All Active Third-Party Service Integrations tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/listThirdPartyIntegrations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/listGroupIntegrations /api/atlas/v2/groups/{groupId}/integrations/{integrationType}: delete: description: Removes the settings that permit configuring one third-party service integration. These settings apply to all databases managed in one MongoDB Cloud project. If you delete an integration from a project, you remove that integration configuration only for that project. This action doesn't affect any other project or organization's configured `{INTEGRATION-TYPE}` integrations. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: deleteThirdPartyIntegration + operationId: deleteGroupIntegration parameters: - description: Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. in: path @@ -50386,10 +50807,10 @@ paths: summary: Remove One Third-Party Service Integration tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/deleteThirdPartyIntegration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/deleteGroupIntegration get: description: Returns the settings for configuring integration with one third-party service. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: getThirdPartyIntegration + operationId: getGroupIntegration parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50419,7 +50840,7 @@ paths: schema: $ref: '#/components/schemas/ThirdPartyIntegration' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50435,10 +50856,10 @@ paths: summary: Return One Third-Party Service Integration tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/getThirdPartyIntegration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/getGroupIntegration post: description: Adds the settings for configuring one third-party service integration. These settings apply to all databases managed in the specified MongoDB Cloud project. Each project can have only one configuration per `{INTEGRATION-TYPE}`. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: createThirdPartyIntegration + operationId: createGroupIntegration parameters: - description: Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. in: path @@ -50491,13 +50912,13 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Configure One Third-Party Service Integration + summary: Create One Third-Party Service Integration tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/createThirdPartyIntegration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/createGroupIntegration put: description: Updates the settings for configuring integration with one third-party service. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. - operationId: updateThirdPartyIntegration + operationId: updateGroupIntegration parameters: - description: Human-readable label that identifies the service which you want to integrate with MongoDB Cloud. in: path @@ -50537,7 +50958,7 @@ paths: schema: $ref: '#/components/schemas/PaginatedIntegrationView' x-xgen-IPA-exception: - xgen-IPA-107-update-method-response-is-get-method-response: Content predates IPA validation + xgen-IPA-107-update-method-response-is-get-method-response: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50553,12 +50974,12 @@ paths: summary: Update One Third-Party Service Integration tags: - Third-Party Integrations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/updateThirdPartyIntegration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Third-Party-Integrations/operation/updateGroupIntegration /api/atlas/v2/groups/{groupId}/invites: get: deprecated: true description: Returns all pending invitations to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: listProjectInvitations + operationId: listGroupInvites parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -50578,12 +50999,12 @@ paths: $ref: '#/components/schemas/GroupInvitation' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-sunset: "2026-07-31" x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -50594,14 +51015,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return All Project Invitations + summary: Return All Invitations in One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listProjectInvitations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listGroupInvites patch: deprecated: true description: Updates the details of one pending invitation to the specified project. To specify which invitation to update, provide the username of the invited user. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateProjectInvitation + operationId: updateGroupInvites parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -50632,14 +51053,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update One Project Invitation + summary: Update One Invitation in One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroupInvites post: deprecated: true description: Invites one MongoDB Cloud user to join the specified project. The MongoDB Cloud user must accept the invitation to access information within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: createProjectInvitation + operationId: createGroupInvite parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/pretty' @@ -50668,15 +51089,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Invite One MongoDB Cloud User to One Project + summary: Create Invitation for One MongoDB Cloud User in One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createGroupInvite /api/atlas/v2/groups/{groupId}/invites/{invitationId}: delete: deprecated: true description: Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteProjectInvitation + operationId: deleteGroupInvite parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -50702,14 +51123,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Remove One Project Invitation + summary: Remove One Invitation from One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteProjectInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteGroupInvite get: deprecated: true description: Returns the details of one pending invitation to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getProjectInvitation + operationId: getGroupInvite parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -50729,7 +51150,7 @@ paths: $ref: '#/components/schemas/GroupInvitation' x-sunset: "2026-07-31" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -50740,14 +51161,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Project Invitation + summary: Return One Invitation in One Project by Invitation ID tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupInvite patch: deprecated: true description: Updates the details of one pending invitation to the specified project. To specify which invitation to update, provide the unique identification string for that invitation. Use the Return All Project Invitations endpoint to retrieve IDs for all pending project invitations. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateProjectInvitationById + operationId: updateGroupInviteById parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -50784,14 +51205,18 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update One Project Invitation by Invitation ID + summary: Update One Invitation in One Project by Invitation ID tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectInvitationById + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroupInviteById + x-xgen-method-verb-override: + customMethod: false + verb: updateById + x-xgen-operation-id-override: updateInviteById /api/atlas/v2/groups/{groupId}/ipAddresses: get: description: Returns all IP addresses for this project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: returnAllIpAddresses + operationId: getGroupIpAddresses parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -50803,7 +51228,7 @@ paths: schema: $ref: '#/components/schemas/GroupIPAddresses' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -50817,11 +51242,11 @@ paths: summary: Return All IP Addresses for One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/returnAllIpAddresses + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupIpAddresses /api/atlas/v2/groups/{groupId}/limits: get: description: Returns all the limits for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listProjectLimits + operationId: listGroupLimits parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50835,11 +51260,11 @@ paths: $ref: '#/components/schemas/DataFederationLimit' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50857,21 +51282,21 @@ paths: summary: Return All Limits for One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listProjectLimits + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/listGroupLimits /api/atlas/v2/groups/{groupId}/limits/{limitName}: delete: description: Removes the specified project limit. Depending on the limit, Atlas either resets the limit to its default value or removes the limit entirely. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteProjectLimit + operationId: deleteGroupLimit parameters: - description: | Human-readable label that identifies this project limit. | Limit Name | Description | Default | API Override Limit | | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | @@ -50880,7 +51305,6 @@ paths: | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | in: path name: limitName required: true @@ -50899,7 +51323,6 @@ paths: - dataFederation.bytesProcessed.monthly - atlas.project.deployment.privateServiceConnectionsPerRegionGroup - atlas.project.deployment.privateServiceConnectionsSubnetMask - - atlas.project.deployment.salesSoldM0s type: string - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50925,20 +51348,20 @@ paths: summary: Remove One Project Limit tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteProjectLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/deleteGroupLimit get: description: Returns the specified limit for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProjectLimit + operationId: getGroupLimit parameters: - description: | Human-readable label that identifies this project limit. | Limit Name | Description | Default | API Override Limit | | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | @@ -50947,7 +51370,6 @@ paths: | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | in: path name: limitName required: true @@ -50966,7 +51388,6 @@ paths: - dataFederation.bytesProcessed.monthly - atlas.project.deployment.privateServiceConnectionsPerRegionGroup - atlas.project.deployment.privateServiceConnectionsSubnetMask - - atlas.project.deployment.salesSoldM0s type: string - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -50978,7 +51399,7 @@ paths: schema: $ref: '#/components/schemas/DataFederationLimit' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -50996,23 +51417,23 @@ paths: summary: Return One Limit for One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupLimit patch: description: |- Sets the specified project limit. To use this resource, the requesting Service Account or API Key must have the Project Owner role. **NOTE**: Increasing the following configuration limits might lead to slower response times in the MongoDB Cloud UI or increased user management overhead leading to authentication or authorization re-architecture. If possible, we recommend that you create additional projects to gain access to more of these resources for a more sustainable growth pattern. - operationId: setProjectLimit + operationId: setGroupLimit parameters: - description: | Human-readable label that identifies this project limit. | Limit Name | Description | Default | API Override Limit | | --- | --- | --- | --- | - | atlas.project.deployment.clusters | Limit on the number of clusters in this project if the org is not sales-sold (If org is sales-sold, the limit is 100) | 25 | 90 | + | atlas.project.deployment.clusters | Limit on the number of clusters in this project | 25 | 100 | | atlas.project.deployment.nodesPerPrivateLinkRegion | Limit on the number of nodes per Private Link region in this project | 50 | 90 | | atlas.project.security.databaseAccess.customRoles | Limit on the number of custom roles in this project | 100 | 1400 | - | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 900 | + | atlas.project.security.databaseAccess.users | Limit on the number of database users in this project | 100 | 100 | | atlas.project.security.networkAccess.crossRegionEntries | Limit on the number of cross-region network access entries in this project | 40 | 220 | | atlas.project.security.networkAccess.entries | Limit on the number of network access entries in this project | 200 | 20 | | dataFederation.bytesProcessed.query | Limit on the number of bytes processed during a single Data Federation query | N/A | N/A | @@ -51021,7 +51442,6 @@ paths: | dataFederation.bytesProcessed.monthly | Limit on the number of bytes processed across all Data Federation tenants for the current month | N/A | N/A | | atlas.project.deployment.privateServiceConnectionsPerRegionGroup | Number of Private Service Connections per Region Group | 50 | 100| | atlas.project.deployment.privateServiceConnectionsSubnetMask | Subnet mask for GCP PSC Networks. Has lower limit of 20. | 27 | 27| - | atlas.project.deployment.salesSoldM0s | Limit on the number of M0 clusters in this project if the org is sales-sold | 100 | 100 | in: path name: limitName required: true @@ -51040,7 +51460,6 @@ paths: - dataFederation.bytesProcessed.monthly - atlas.project.deployment.privateServiceConnectionsPerRegionGroup - atlas.project.deployment.privateServiceConnectionsSubnetMask - - atlas.project.deployment.salesSoldM0s type: string - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51075,7 +51494,7 @@ paths: summary: Set One Project Limit tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/setProjectLimit + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/setGroupLimit x-xgen-method-verb-override: customMethod: "True" verb: set @@ -51092,7 +51511,7 @@ paths: externalDocs: description: Validate Migration url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/validateMigration - operationId: createPushMigration + operationId: createGroupLiveMigration parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51132,14 +51551,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Migrate One Local Managed Cluster to MongoDB Atlas + summary: Create One Migration for One Local Managed Cluster to MongoDB Atlas tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/createPushMigration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/createGroupLiveMigration /api/atlas/v2/groups/{groupId}/liveMigrations/{liveMigrationId}: get: description: Return details of one cluster migration job. Each push live migration job uses one migration host. Your API Key must have the Organization Member role to successfully call this resource. - operationId: getPushMigration + operationId: getGroupLiveMigration parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/liveMigrationId' @@ -51164,11 +51583,11 @@ paths: summary: Return One Migration Job tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/getPushMigration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/getGroupLiveMigration /api/atlas/v2/groups/{groupId}/liveMigrations/{liveMigrationId}/cutover: put: description: Cut over the migrated cluster to MongoDB Atlas. Confirm when the cut over completes. When the cut over completes, MongoDB Atlas completes the live migration process and stops synchronizing with the source cluster. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: cutoverMigration + operationId: cutoverGroupLiveMigration parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/liveMigrationId' @@ -51193,13 +51612,14 @@ paths: summary: Cut Over One Migrated Cluster tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/cutoverMigration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/cutoverGroupLiveMigration x-xgen-method-verb-override: - customMethod: "True" + customMethod: true + x-xgen-operation-id-override: cutoverMigration /api/atlas/v2/groups/{groupId}/liveMigrations/validate: post: description: Verifies whether the provided credentials, available disk space, MongoDB versions, and so on meet the requirements of the migration request. If the check passes, the migration can proceed. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: validateMigration + operationId: validateGroupLiveMigrations parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -51242,13 +51662,14 @@ paths: summary: Validate One Migration Request tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/validateMigration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/validateGroupLiveMigrations x-xgen-method-verb-override: - customMethod: "True" + customMethod: true + x-xgen-operation-id-override: validateLiveMigrations /api/atlas/v2/groups/{groupId}/liveMigrations/validate/{validationId}: get: description: Return the status of one migration validation job. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: getValidationStatus + operationId: getGroupLiveMigrationValidateStatus parameters: - $ref: '#/components/parameters/groupId' - description: Unique 24-hexadecimal digit string that identifies the validation job. @@ -51281,14 +51702,15 @@ paths: summary: Return One Migration Validation Job tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/getValidationStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/getGroupLiveMigrationValidateStatus x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: getStatus + x-xgen-operation-id-override: getMigrationValidateStatus /api/atlas/v2/groups/{groupId}/maintenanceWindow: delete: description: Resets the maintenance window for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: resetMaintenanceWindow + operationId: resetGroupMaintenanceWindow parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51311,13 +51733,14 @@ paths: summary: Reset One Maintenance Window for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/resetMaintenanceWindow + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/resetGroupMaintenanceWindow x-xgen-method-verb-override: customMethod: "True" verb: reset + x-xgen-operation-id-override: resetMaintenanceWindow get: description: Returns the maintenance window for the specified project. MongoDB Cloud starts those maintenance activities when needed. You can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getMaintenanceWindow + operationId: getGroupMaintenanceWindow parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51329,7 +51752,7 @@ paths: schema: $ref: '#/components/schemas/GroupMaintenanceWindow' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -51343,10 +51766,11 @@ paths: summary: Return One Maintenance Window for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/getMaintenanceWindow + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/getGroupMaintenanceWindow + x-xgen-operation-id-override: getMaintenanceWindow patch: description: Updates the maintenance window for the specified project. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. Updating the maintenance window will reset any maintenance deferrals for this project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateMaintenanceWindow + operationId: updateGroupMaintenanceWindow parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51376,11 +51800,12 @@ paths: summary: Update One Maintenance Window for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/updateMaintenanceWindow + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/updateGroupMaintenanceWindow + x-xgen-operation-id-override: updateMaintenanceWindow /api/atlas/v2/groups/{groupId}/maintenanceWindow/autoDefer: post: description: Toggles automatic deferral of the maintenance window for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: toggleMaintenanceAutoDefer + operationId: toggleGroupMaintenanceWindowAutoDefer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51403,14 +51828,15 @@ paths: summary: Toggle Automatic Deferral of Maintenance for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/toggleMaintenanceAutoDefer + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/toggleGroupMaintenanceWindowAutoDefer x-xgen-method-verb-override: customMethod: "True" verb: toggle + x-xgen-operation-id-override: toggleMaintenanceAutoDefer /api/atlas/v2/groups/{groupId}/maintenanceWindow/defer: post: description: Defers the maintenance window for the specified project. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deferMaintenanceWindow + operationId: deferGroupMaintenanceWindow parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51433,13 +51859,14 @@ paths: summary: Defer One Maintenance Window for One Project tags: - Maintenance Windows - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/deferMaintenanceWindow + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Maintenance-Windows/operation/deferGroupMaintenanceWindow x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: deferMaintenanceWindow /api/atlas/v2/groups/{groupId}/managedSlowMs: get: description: Get whether the Managed Slow MS feature is enabled. - operationId: getManagedSlowMs + operationId: getGroupManagedSlowMs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51451,7 +51878,7 @@ paths: schema: type: boolean x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -51467,11 +51894,12 @@ paths: summary: Return Managed Slow Operation Threshold Status tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/getManagedSlowMs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/getGroupManagedSlowMs + x-xgen-operation-id-override: getManagedSlowMs /api/atlas/v2/groups/{groupId}/managedSlowMs/disable: delete: description: Disables the slow operation threshold that MongoDB Cloud calculated for the specified project. The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: disableSlowOperationThresholding + operationId: disableGroupManagedSlowMs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51495,13 +51923,14 @@ paths: summary: Disable Managed Slow Operation Threshold tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/disableSlowOperationThresholding + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/disableGroupManagedSlowMs x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: disableManagedSlowMs /api/atlas/v2/groups/{groupId}/managedSlowMs/enable: post: description: Enables MongoDB Cloud to use its slow operation threshold for the specified project. The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: enableSlowOperationThresholding + operationId: enableGroupManagedSlowMs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51525,13 +51954,14 @@ paths: summary: Enable Managed Slow Operation Threshold tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/enableSlowOperationThresholding + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/enableGroupManagedSlowMs x-xgen-method-verb-override: - customMethod: "True" + customMethod: true + x-xgen-operation-id-override: enableManagedSlowMs /api/atlas/v2/groups/{groupId}/mongoDBVersions: get: description: Returns the MongoDB Long Term Support Major Versions available to new clusters in this project. - operationId: getProjectLtsVersions + operationId: getGroupMongoDbVersions parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -51576,8 +52006,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedAvailableVersionView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -51595,11 +52025,12 @@ paths: summary: Return All Available MongoDB LTS Versions for Clusters in One Project tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectLtsVersions + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupMongoDbVersions + x-xgen-operation-id-override: getMongoDbVersions /api/atlas/v2/groups/{groupId}/peers: get: description: Returns details about all network peering connections in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPeeringConnections + operationId: listGroupPeers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51618,7 +52049,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. responses: "200": content: @@ -51640,13 +52071,13 @@ paths: summary: Return All Network Peering Connections in One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listPeeringConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/listGroupPeers post: description: Creates one new network peering connection in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations and prerequisites, see the Network Peering Documentation. externalDocs: description: Azure Network Peering Prerequisites url: https://docs.atlas.mongodb.com/reference/api/vpc-create-peering-connection/#prerequisites - operationId: createPeeringConnection + operationId: createGroupPeer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51681,11 +52112,11 @@ paths: summary: Create One Network Peering Connection tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/createPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/createGroupPeer /api/atlas/v2/groups/{groupId}/peers/{peerId}: delete: description: Removes one network peering connection in the specified project. If you Removes the last network peering connection associated with a project, MongoDB Cloud also removes any AWS security groups from the project IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deletePeeringConnection + operationId: deleteGroupPeer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51718,10 +52149,10 @@ paths: summary: Remove One Network Peering Connection tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/deletePeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/deleteGroupPeer get: description: Returns details about one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPeeringConnection + operationId: getGroupPeer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51740,7 +52171,7 @@ paths: schema: $ref: '#/components/schemas/BaseNetworkPeeringConnectionSettings' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -51756,10 +52187,10 @@ paths: summary: Return One Network Peering Connection in One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/getPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/getGroupPeer patch: description: Updates one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updatePeeringConnection + operationId: updateGroupPeer parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51801,12 +52232,12 @@ paths: summary: Update One Network Peering Connection tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/updatePeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/updateGroupPeer /api/atlas/v2/groups/{groupId}/pipelines: get: deprecated: true description: Returns a list of Data Lake Pipelines. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPipelines + operationId: listGroupPipelines parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51819,12 +52250,12 @@ paths: $ref: '#/components/schemas/DataLakeIngestionPipeline' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation - x-sunset: "2025-09-09" + xgen-IPA-124-array-max-items: Schema predates IPA validation. + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -51840,14 +52271,15 @@ paths: summary: Return All Data Lake Pipelines in One Project tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listPipelines + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listGroupPipelines + x-xgen-operation-id-override: listPipelines post: deprecated: true description: Creates one Data Lake Pipeline. externalDocs: description: Data Lake Pipelines are deprecated. Please see Data Lake Deprecation Guide. url: https://dochub.mongodb.org/core/data-lake-deprecation - operationId: createPipeline + operationId: createGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51864,7 +52296,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -51880,12 +52312,13 @@ paths: summary: Create One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/createPipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/createGroupPipeline + x-xgen-operation-id-override: createPipeline /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}: delete: deprecated: true description: Removes one Data Lake Pipeline. - operationId: deletePipeline + operationId: deleteGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51900,7 +52333,7 @@ paths: "200": content: application/vnd.atlas.2023-01-01+json: - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "401": @@ -51914,11 +52347,12 @@ paths: summary: Remove One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/deletePipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/deleteGroupPipeline + x-xgen-operation-id-override: deletePipeline get: deprecated: true description: Returns the details of one Data Lake Pipeline within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPipeline + operationId: getGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51936,9 +52370,9 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -51954,11 +52388,12 @@ paths: summary: Return One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getPipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getGroupPipeline + x-xgen-operation-id-override: getPipeline patch: deprecated: true description: Updates one Data Lake Pipeline. - operationId: updatePipeline + operationId: updateGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -51982,7 +52417,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52000,12 +52435,13 @@ paths: summary: Update One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/updatePipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/updateGroupPipeline + x-xgen-operation-id-override: updatePipeline /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/availableSchedules: get: deprecated: true description: Returns a list of backup schedule policy items that you can use as a Data Lake Pipeline source. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPipelineSchedules + operationId: getGroupPipelineAvailableSchedules parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52026,11 +52462,11 @@ paths: $ref: '#/components/schemas/DiskBackupApiPolicyItem' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation - x-sunset: "2025-09-09" + xgen-IPA-124-array-max-items: Schema predates IPA validation. + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52046,12 +52482,13 @@ paths: summary: Return All Ingestion Schedules for One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listPipelineSchedules + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getGroupPipelineAvailableSchedules + x-xgen-operation-id-override: getAvailablePipelineSchedules /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/availableSnapshots: get: deprecated: true description: Returns a list of backup snapshots that you can use to trigger an on demand pipeline run. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPipelineSnapshots + operationId: getGroupPipelineAvailableSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52078,10 +52515,10 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/PaginatedBackupSnapshotView' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52097,12 +52534,13 @@ paths: summary: Return All Backup Snapshots for One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listPipelineSnapshots + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getGroupPipelineAvailableSnapshots + x-xgen-operation-id-override: getAvailablePipelineSnapshots /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/pause: post: deprecated: true description: Pauses ingestion for a Data Lake Pipeline within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: pausePipeline + operationId: pauseGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52120,7 +52558,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52136,14 +52574,15 @@ paths: summary: Pause One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/pausePipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/pauseGroupPipeline x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: pausePipeline /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/resume: post: deprecated: true description: Resumes ingestion for a Data Lake Pipeline within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: resumePipeline + operationId: resumeGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52161,7 +52600,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/DataLakeIngestionPipeline' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52177,14 +52616,15 @@ paths: summary: Resume One Data Lake Pipeline tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/resumePipeline + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/resumeGroupPipeline x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: resumePipeline /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/runs: get: deprecated: true description: Returns a list of past Data Lake Pipeline runs. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPipelineRuns + operationId: listGroupPipelineRuns parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52199,7 +52639,7 @@ paths: format: date-time type: string x-xgen-IPA-exception: - xgen-IPA-121-date-time-fields-mention-iso-8601: Schema predates IPA validation + xgen-IPA-121-date-time-fields-mention-iso-8601: Schema predates IPA validation. - description: Human-readable label that identifies the Data Lake Pipeline. in: path name: pipelineName @@ -52213,7 +52653,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/PaginatedPipelineRunView' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52229,12 +52669,13 @@ paths: summary: Return All Data Lake Pipeline Runs in One Project tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listPipelineRuns + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/listGroupPipelineRuns + x-xgen-operation-id-override: listPipelineRuns /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/runs/{pipelineRunId}: delete: deprecated: true description: Deletes dataset that Atlas generated during the specified pipeline run. - operationId: deletePipelineRunDataset + operationId: deleteGroupPipelineRun parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52260,7 +52701,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/RequestAccepted' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: Accepted "400": @@ -52276,11 +52717,12 @@ paths: summary: Delete One Pipeline Run Dataset tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/deletePipelineRunDataset + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/deleteGroupPipelineRun + x-xgen-operation-id-override: deletePipelineRun get: deprecated: true description: Returns the details of one Data Lake Pipeline run within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPipelineRun + operationId: getGroupPipelineRun parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52306,9 +52748,9 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/IngestionPipelineRun' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52324,12 +52766,13 @@ paths: summary: Return One Data Lake Pipeline Run tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getPipelineRun + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/getGroupPipelineRun + x-xgen-operation-id-override: getPipelineRun /api/atlas/v2/groups/{groupId}/pipelines/{pipelineName}/trigger: post: deprecated: true description: Triggers a Data Lake Pipeline ingestion of a specified snapshot. - operationId: triggerSnapshotIngestion + operationId: triggerGroupPipeline parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52354,7 +52797,7 @@ paths: application/vnd.atlas.2023-01-01+json: schema: $ref: '#/components/schemas/IngestionPipelineRun' - x-sunset: "2025-09-09" + x-sunset: "2025-09-30" x-xgen-version: "2023-01-01" description: OK "400": @@ -52370,13 +52813,14 @@ paths: summary: Trigger On-Demand Snapshot Ingestion tags: - Data Lake Pipelines - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/triggerSnapshotIngestion + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Lake-Pipelines/operation/triggerGroupPipeline x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: triggerPipeline /api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService: get: description: Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listPrivateEndpointServices + operationId: listGroupPrivateEndpointEndpointService parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52393,7 +52837,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. responses: "200": content: @@ -52403,11 +52847,11 @@ paths: $ref: '#/components/schemas/EndpointService' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52423,11 +52867,12 @@ paths: summary: Return All Private Endpoint Services for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/listPrivateEndpointServices + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/listGroupPrivateEndpointEndpointService + x-xgen-operation-id-override: listPrivateEndpointService /api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}: delete: description: Removes one private endpoint service from the specified project. This cloud service provider manages the private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deletePrivateEndpointService + operationId: deleteGroupPrivateEndpointEndpointService parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52444,7 +52889,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to delete. in: path name: endpointServiceId @@ -52471,10 +52916,11 @@ paths: summary: Remove One Private Endpoint Service for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/deletePrivateEndpointService + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/deleteGroupPrivateEndpointEndpointService + x-xgen-operation-id-override: deletePrivateEndpointService get: description: Returns the name, interfaces, and state of the specified private endpoint service from one project. The cloud service provider hosted this private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPrivateEndpointService + operationId: getGroupPrivateEndpointEndpointService parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52491,7 +52937,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique 24-hexadecimal digit string that identifies the private endpoint service that you want to return. in: path name: endpointServiceId @@ -52506,7 +52952,7 @@ paths: schema: $ref: '#/components/schemas/EndpointService' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52522,11 +52968,12 @@ paths: summary: Return One Private Endpoint Service for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getPrivateEndpointService + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getGroupPrivateEndpointEndpointService + x-xgen-operation-id-override: getPrivateEndpointService /api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}/endpoint: post: description: Creates one private endpoint for the specified cloud service provider. This cloud service provider manages the private endpoint service, which in turn manages the private endpoints for the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations, limitations, and prerequisites, see the MongoDB documentation for setting up a private endpoint. - operationId: createPrivateEndpoint + operationId: createGroupPrivateEndpointEndpointServiceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52543,7 +52990,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique 24-hexadecimal digit string that identifies the private endpoint service for which you want to create a private endpoint. in: path name: endpointServiceId @@ -52583,11 +53030,12 @@ paths: summary: Create One Private Endpoint for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/createPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/createGroupPrivateEndpointEndpointServiceEndpoint + x-xgen-operation-id-override: createPrivateEndpoint /api/atlas/v2/groups/{groupId}/privateEndpoint/{cloudProvider}/endpointService/{endpointServiceId}/endpoint/{endpointId}: delete: description: Removes one private endpoint from the specified project and private endpoint service, as managed by the specified cloud service provider. When the last private endpoint is removed from a given private endpoint service, that private endpoint service is also removed. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deletePrivateEndpoint + operationId: deleteGroupPrivateEndpointEndpointServiceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52604,7 +53052,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique string that identifies the private endpoint you want to delete. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints. in: path name: endpointId @@ -52638,10 +53086,11 @@ paths: summary: Remove One Private Endpoint for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/deletePrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/deleteGroupPrivateEndpointEndpointServiceEndpoint + x-xgen-operation-id-override: deletePrivateEndpoint get: description: Returns the connection state of the specified private endpoint. The private endpoint service manages this private endpoint which belongs to one project hosted from one cloud service provider. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPrivateEndpoint + operationId: getGroupPrivateEndpointEndpointServiceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52658,7 +53107,7 @@ paths: - GCP type: string x-xgen-IPA-exception: - xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation + xgen-IPA-119-no-default-for-cloud-providers: Schema predates IPA validation. - description: Unique string that identifies the private endpoint you want to return. The format of the **endpointId** parameter differs for AWS and Azure. You must URL encode the **endpointId** for Azure private endpoints. in: path name: endpointId @@ -52680,7 +53129,7 @@ paths: schema: $ref: '#/components/schemas/PrivateLinkEndpoint' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52696,14 +53145,15 @@ paths: summary: Return One Private Endpoint for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getGroupPrivateEndpointEndpointServiceEndpoint + x-xgen-operation-id-override: getPrivateEndpoint /api/atlas/v2/groups/{groupId}/privateEndpoint/endpointService: post: description: Creates one private endpoint service for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. When you create a private endpoint service, MongoDB Cloud creates a network container in the project for the cloud provider for which you create the private endpoint service if one doesn't already exist. To learn more about private endpoint terminology in MongoDB Cloud, see Private Endpoint Concepts. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Private Endpoint Concepts url: https://dochub.mongodb.org/core/private-endpoint-concepts - operationId: createPrivateEndpointService + operationId: createGroupPrivateEndpointEndpointService parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52736,11 +53186,12 @@ paths: summary: Create One Private Endpoint Service for One Provider tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/createPrivateEndpointService + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/createGroupPrivateEndpointEndpointService + x-xgen-operation-id-override: createPrivateEndpointService /api/atlas/v2/groups/{groupId}/privateEndpoint/regionalMode: get: description: Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. The cloud service provider manages the private endpoint for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getRegionalizedPrivateEndpointSetting + operationId: getGroupPrivateEndpointRegionalMode parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52764,13 +53215,14 @@ paths: summary: Return Regionalized Private Endpoint Status tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getRegionalizedPrivateEndpointSetting + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/getGroupPrivateEndpointRegionalMode x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getRegionalEndpointMode patch: description: Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. The cloud service provider manages the private endpoints for the project. Connection strings to existing multi-region and global sharded clusters change when you enable this setting. You must update your applications to use the new connection strings. This might cause downtime. To use this resource, the requesting Service Account or API Key must have the Project Owner role and all clusters in the deployment must be sharded clusters. Once enabled, you cannot create replica sets. - operationId: toggleRegionalizedPrivateEndpointSetting + operationId: toggleGroupPrivateEndpointRegionalMode parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52803,17 +53255,18 @@ paths: summary: Toggle Regionalized Private Endpoint Status tags: - Private Endpoint Services - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/toggleRegionalizedPrivateEndpointSetting + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Private-Endpoint-Services/operation/toggleGroupPrivateEndpointRegionalMode x-xgen-method-verb-override: customMethod: "True" verb: toggle + x-xgen-operation-id-override: toggleRegionalEndpointMode /api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint: get: description: |- Returns all private endpoints for one serverless instance. You must have at least the Project Read Only role for the project to successfully call this resource. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - operationId: listServerlessPrivateEndpoints + operationId: listGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52833,11 +53286,11 @@ paths: $ref: '#/components/schemas/ServerlessTenantEndpoint' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52853,7 +53306,8 @@ paths: summary: Return All Private Endpoints for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/listServerlessPrivateEndpoints + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/listGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: listServerlessPrivateEndpoint post: description: |- Creates one private endpoint for one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -52864,7 +53318,7 @@ paths: externalDocs: description: Set Up a Private Endpoint for a Serverless Instance Tutorial url: https://dochub.mongodb.org/core/serverless-private-endpoint - operationId: createServerlessPrivateEndpoint + operationId: createGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52903,14 +53357,15 @@ paths: summary: Create One Private Endpoint for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/createServerlessPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/createGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: createServerlessPrivateEndpoint /api/atlas/v2/groups/{groupId}/privateEndpoint/serverless/instance/{instanceName}/endpoint/{endpointId}: delete: description: |- Remove one private endpoint from one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - operationId: deleteServerlessPrivateEndpoint + operationId: deleteGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52947,13 +53402,14 @@ paths: summary: Remove One Private Endpoint for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/deleteServerlessPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/deleteGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: deleteServerlessPrivateEndpoint get: description: |- Return one private endpoint for one serverless instance. Identify this endpoint using its unique ID. You must have at least the Project Read Only role for the project to successfully call this resource. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - operationId: getServerlessPrivateEndpoint + operationId: getGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -52978,7 +53434,7 @@ paths: schema: $ref: '#/components/schemas/ServerlessTenantEndpoint' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -52994,13 +53450,14 @@ paths: summary: Return One Private Endpoint for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/getServerlessPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/getGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: getServerlessPrivateEndpoint patch: description: |- Updates one private endpoint for one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature does not work for Flex clusters. To continue using Private Endpoints once Serverless is replaced by Flex, please use a Dedicated cluster instead. - operationId: updateServerlessPrivateEndpoint + operationId: updateGroupPrivateEndpointServerlessInstanceEndpoint parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53046,7 +53503,8 @@ paths: summary: Update One Private Endpoint for One Serverless Instance tags: - Serverless Private Endpoints - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/updateServerlessPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Private-Endpoints/operation/updateGroupPrivateEndpointServerlessInstanceEndpoint + x-xgen-operation-id-override: updateServerlessPrivateEndpoint /api/atlas/v2/groups/{groupId}/privateIpMode: get: deprecated: true @@ -53054,7 +53512,7 @@ paths: externalDocs: description: Changes to Connection Strings url: https://docs.atlas.mongodb.com/reference/faq/connection-changes/ - operationId: verifyConnectViaPeeringOnlyModeForOneProject + operationId: verifyGroupPrivateIpMode parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53066,7 +53524,7 @@ paths: schema: $ref: '#/components/schemas/PrivateIPModeView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53080,17 +53538,18 @@ paths: summary: Verify Connect via Peering-Only Mode for One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/verifyConnectViaPeeringOnlyModeForOneProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/verifyGroupPrivateIpMode x-xgen-method-verb-override: customMethod: "True" verb: verify + x-xgen-operation-id-override: verifyPrivateIpMode patch: deprecated: true description: Disables Connect via Peering Only mode for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Changes to Connection Strings url: https://docs.atlas.mongodb.com/reference/faq/connection-changes/ - operationId: disablePeering + operationId: disableGroupPrivateIpModePeering parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53123,14 +53582,15 @@ paths: summary: Disable Connect via Peering-Only Mode for One Project tags: - Network Peering - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/disablePeering + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Network-Peering/operation/disableGroupPrivateIpModePeering x-xgen-method-verb-override: customMethod: "True" verb: disablePeering + x-xgen-operation-id-override: disablePeering /api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds: get: description: Returns all private endpoints for Federated Database Instances and Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - operationId: listDataFederationPrivateEndpoints + operationId: listGroupPrivateNetworkSettingEndpointIds parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53159,7 +53619,8 @@ paths: summary: Return All Federated Database Instance and Online Archive Private Endpoints in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listDataFederationPrivateEndpoints + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/listGroupPrivateNetworkSettingEndpointIds + x-xgen-operation-id-override: listPrivateEndpointIds post: description: |- Adds one private endpoint for Federated Database Instances and Online Archives to the specified projects. If the endpoint ID already exists and the associated comment is unchanged, Atlas Data Federation makes no change to the endpoint ID list. If the endpoint ID already exists and the associated comment is changed, Atlas Data Federation updates the comment value only in the endpoint ID list. If the endpoint ID doesn't exist, Atlas Data Federation appends the new endpoint to the list of endpoints in the endpoint ID list. Each region has an associated service name for the various endpoints in each region. @@ -53181,7 +53642,7 @@ paths: `ap-south-1` is `com.amazonaws.vpce.ap-south-1.vpce-svc-03eb8a541f96d356d`. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. - operationId: createDataFederationPrivateEndpoint + operationId: createGroupPrivateNetworkSettingEndpointId parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53214,11 +53675,12 @@ paths: summary: Create One Federated Database Instance and Online Archive Private Endpoint for One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createDataFederationPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/createGroupPrivateNetworkSettingEndpointId + x-xgen-operation-id-override: createPrivateEndpointId /api/atlas/v2/groups/{groupId}/privateNetworkSettings/endpointIds/{endpointId}: delete: description: Removes one private endpoint for Federated Database Instances and Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteDataFederationPrivateEndpoint + operationId: deleteGroupPrivateNetworkSettingEndpointId parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53247,10 +53709,11 @@ paths: summary: Remove One Federated Database Instance and Online Archive Private Endpoint from One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteDataFederationPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/deleteGroupPrivateNetworkSettingEndpointId + x-xgen-operation-id-override: deletePrivateEndpointId get: description: Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. - operationId: getDataFederationPrivateEndpoint + operationId: getGroupPrivateNetworkSettingEndpointId parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53283,11 +53746,12 @@ paths: summary: Return One Federated Database Instance and Online Archive Private Endpoint in One Project tags: - Data Federation - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getDataFederationPrivateEndpoint + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Data-Federation/operation/getGroupPrivateNetworkSettingEndpointId + x-xgen-operation-id-override: getPrivateEndpointId /api/atlas/v2/groups/{groupId}/processes: get: description: Returns details of all processes for the specified project. A MongoDB process can be either a `mongod` or `mongos`. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listAtlasProcesses + operationId: listGroupProcesses parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53314,11 +53778,11 @@ paths: summary: Return All MongoDB Processes in One Project tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listAtlasProcesses + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupProcesses /api/atlas/v2/groups/{groupId}/processes/{processId}: get: description: Returns the processes for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getAtlasProcess + operationId: getGroupProcess parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53338,7 +53802,7 @@ paths: schema: $ref: '#/components/schemas/ApiHostView_Atlas' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53352,11 +53816,11 @@ paths: summary: Return One MongoDB Process by ID tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getAtlasProcess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcess /api/atlas/v2/groups/{groupId}/processes/{processId}/{databaseName}/{collectionName}/collStats/measurements: get: description: Get a list of the Coll Stats Latency process-level measurements for the given namespace. - operationId: getCollStatsLatencyNamespaceHostMeasurements + operationId: listGroupProcessCollStatMeasurements parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/processId' @@ -53421,11 +53885,12 @@ paths: summary: Return Host-Level Query Latency tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespaceHostMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/listGroupProcessCollStatMeasurements + x-xgen-operation-id-override: listProcessMeasurements /api/atlas/v2/groups/{groupId}/processes/{processId}/collStats/namespaces: get: description: Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. - operationId: getCollStatsLatencyNamespacesForHost + operationId: getGroupProcessCollStatNamespaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/processId' @@ -53449,20 +53914,21 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return Ranked Namespaces from a Host + summary: Return Ranked Namespaces from One Host tags: - Collection Level Metrics - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getCollStatsLatencyNamespacesForHost + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Collection-Level-Metrics/operation/getGroupProcessCollStatNamespaces x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getProcessNamespaces /api/atlas/v2/groups/{groupId}/processes/{processId}/databases: get: description: Returns the list of databases running on the specified host for the specified project. `M0` free clusters, `M2`, `M5`, serverless, and Flex clusters have some operational limits. The MongoDB Cloud process must be a `mongod`. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. externalDocs: description: Operational Limits url: https://www.mongodb.com/docs/atlas/reference/limitations/ - operationId: listDatabases + operationId: listGroupProcessDatabases parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53497,11 +53963,12 @@ paths: summary: Return Available Databases for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listDatabases + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupProcessDatabases + x-xgen-operation-id-override: listDatabases /api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}: get: description: Returns one database running on the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getDatabase + operationId: getGroupProcessDatabase parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53527,7 +53994,7 @@ paths: schema: $ref: '#/components/schemas/MesurementsDatabase' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53541,11 +54008,12 @@ paths: summary: Return One Database for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getDatabase + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessDatabase + x-xgen-operation-id-override: getDatabase /api/atlas/v2/groups/{groupId}/processes/{processId}/databases/{databaseName}/measurements: get: description: Returns the measurements of one database for the specified host for the specified project. Returns the database's on-disk storage space based on the MongoDB `dbStats` command output. To calculate some metric series, Atlas takes the rate between every two adjacent points. For these metric series, the first data point has a null value because Atlas can't calculate a rate for the first data point given the query time range. Atlas retrieves database metrics every 20 minutes but reduces frequency when necessary to optimize database performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getDatabaseMeasurements + operationId: getGroupProcessDatabaseMeasurements parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53597,7 +54065,7 @@ paths: schema: $ref: '#/components/schemas/ApiMeasurementsGeneralView_Atlas' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53611,11 +54079,12 @@ paths: summary: Return Measurements for One Database in One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getDatabaseMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessDatabaseMeasurements + x-xgen-operation-id-override: getDatabaseMeasurements /api/atlas/v2/groups/{groupId}/processes/{processId}/disks: get: description: Returns the list of disks or partitions for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDiskPartitions + operationId: listGroupProcessDisks parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53650,11 +54119,12 @@ paths: summary: Return Available Disks for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listDiskPartitions + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listGroupProcessDisks + x-xgen-operation-id-override: listProcessDisks /api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}: get: description: Returns measurement details for one disk or partition for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listDiskMeasurements + operationId: getGroupProcessDisk parameters: - $ref: '#/components/parameters/envelope' - description: Human-readable label of the disk or partition to which the measurements apply. @@ -53679,7 +54149,7 @@ paths: schema: $ref: '#/components/schemas/MeasurementDiskPartition' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53693,7 +54163,8 @@ paths: summary: Return Measurements for One Disk tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/listDiskMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessDisk + x-xgen-operation-id-override: getProcessDisk /api/atlas/v2/groups/{groupId}/processes/{processId}/disks/{partitionName}/measurements: get: description: |- @@ -53704,7 +54175,7 @@ paths: - Amount of free and used disk space on the disk partition used for the MongoDB process To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getDiskMeasurements + operationId: getGroupProcessDiskMeasurements parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53768,7 +54239,7 @@ paths: schema: $ref: '#/components/schemas/ApiMeasurementsGeneralView_Atlas' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53782,7 +54253,8 @@ paths: summary: Return Measurements of One Disk for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getDiskMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessDiskMeasurements + x-xgen-operation-id-override: getProcessDiskMeasurements /api/atlas/v2/groups/{groupId}/processes/{processId}/measurements: get: description: |- @@ -53794,7 +54266,7 @@ paths: - Measurements for the host, such as CPU usage or number of I/O operations To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getHostMeasurements + operationId: getGroupProcessMeasurements parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -53970,7 +54442,7 @@ paths: schema: $ref: '#/components/schemas/ApiMeasurementsGeneralView_Atlas' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -53984,11 +54456,12 @@ paths: summary: Return Measurements for One MongoDB Process tags: - Monitoring and Logs - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getHostMeasurements + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs/operation/getGroupProcessMeasurements + x-xgen-operation-id-override: getProcessMeasurements /api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/namespaces: get: description: Returns up to 20 namespaces for collections experiencing slow queries on the specified host. If you specify a secondary member of a replica set that hasn't received any database read operations, the endpoint doesn't return any namespaces. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listSlowQueryNamespaces + operationId: listGroupProcessPerformanceAdvisorNamespaces parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54044,11 +54517,12 @@ paths: summary: Return All Namespaces for One Host tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listSlowQueryNamespaces + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupProcessPerformanceAdvisorNamespaces + x-xgen-operation-id-override: listPerformanceAdvisorNamespaces /api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/slowQueryLogs: get: description: Returns log lines for slow queries that the Performance Advisor and Query Profiler identified. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. MongoDB Cloud bases the threshold for slow queries on the average time of operations on your cluster. This enables workload-relevant recommendations. To use this resource, the requesting Service Account or API Key must have any Project Data Access role or the Project Observability Viewer role. - operationId: listSlowQueries + operationId: listGroupProcessPerformanceAdvisorSlowQueryLogs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54139,11 +54613,12 @@ paths: summary: Return Slow Queries tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listSlowQueries + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupProcessPerformanceAdvisorSlowQueryLogs + x-xgen-operation-id-override: listSlowQueryLogs /api/atlas/v2/groups/{groupId}/processes/{processId}/performanceAdvisor/suggestedIndexes: get: description: Returns the indexes that the Performance Advisor suggests. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listSuggestedIndexes + operationId: listGroupProcessPerformanceAdvisorSuggestedIndexes parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54223,11 +54698,12 @@ paths: summary: Return All Suggested Indexes tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listSuggestedIndexes + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/listGroupProcessPerformanceAdvisorSuggestedIndexes + x-xgen-operation-id-override: listSuggestedIndexes /api/atlas/v2/groups/{groupId}/pushBasedLogExport: delete: description: Disables the push-based log export feature by resetting the project level settings to its default configuration. - operationId: deletePushBasedLogConfiguration + operationId: deleteGroupPushBasedLogExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54251,10 +54727,11 @@ paths: summary: Disable Push-Based Log Export for One Project tags: - Push-Based Log Export - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/deletePushBasedLogConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/deleteGroupPushBasedLogExport + x-xgen-operation-id-override: deleteLogExport get: description: Fetches the current project level settings for the push-based log export feature. - operationId: getPushBasedLogConfiguration + operationId: getGroupPushBasedLogExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54278,16 +54755,17 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return Push-Based Log Export Configuration for One Project + summary: Return One Push-Based Log Export Configuration in One Project tags: - Push-Based Log Export - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/getPushBasedLogConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/getGroupPushBasedLogExport x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getLogExport patch: description: Updates the project level settings for the push-based log export feature. - operationId: updatePushBasedLogConfiguration + operationId: updateGroupPushBasedLogExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54316,13 +54794,14 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update Push-Based Log Export for One Project + summary: Update One Push-Based Log Export Configuration in One Project tags: - Push-Based Log Export - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/updatePushBasedLogConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/updateGroupPushBasedLogExport + x-xgen-operation-id-override: updateLogExport post: description: Configures the project level settings for the push-based log export feature. - operationId: createPushBasedLogConfiguration + operationId: createGroupPushBasedLogExport parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54351,14 +54830,15 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Enable Push-Based Log Export for One Project + summary: Create One Push-Based Log Export Configuration in One Project tags: - Push-Based Log Export - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/createPushBasedLogConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Push-Based-Log-Export/operation/createGroupPushBasedLogExport + x-xgen-operation-id-override: createLogExport /api/atlas/v2/groups/{groupId}/sampleDatasetLoad/{name}: post: description: Requests loading the MongoDB sample dataset into the specified cluster. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: loadSampleDataset + operationId: requestGroupSampleDatasetLoad parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54392,14 +54872,15 @@ paths: summary: Load Sample Dataset into One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/loadSampleDataset + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/requestGroupSampleDatasetLoad x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: request + x-xgen-operation-id-override: requestSampleDatasetLoad /api/atlas/v2/groups/{groupId}/sampleDatasetLoad/{sampleDatasetId}: get: description: Checks the progress of loading the sample dataset into one cluster. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getSampleDatasetLoadStatus + operationId: getGroupSampleDatasetLoad parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54417,7 +54898,7 @@ paths: schema: $ref: '#/components/schemas/SampleDatasetStatus' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -54431,7 +54912,8 @@ paths: summary: Return Status of Sample Dataset Load for One Cluster tags: - Clusters - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getSampleDatasetLoadStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Clusters/operation/getGroupSampleDatasetLoad + x-xgen-operation-id-override: getSampleDatasetLoad /api/atlas/v2/groups/{groupId}/serverless: get: description: |- @@ -54441,7 +54923,7 @@ paths: externalDocs: description: listFlexClusters url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/listFlexClusters - operationId: listServerlessInstances + operationId: listGroupServerlessInstances parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54470,7 +54952,11 @@ paths: summary: Return All Serverless Instances in One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/listServerlessInstances + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/listGroupServerlessInstances + x-xgen-method-verb-override: + customMethod: false + verb: listInstances + x-xgen-operation-id-override: listServerlessInstances post: description: |- Update as of Feb 2025: This endpoint now creates a Flex cluster instead. This endpoint will no longer be supported starting January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect. Please use the createFlexCluster endpoint instead. @@ -54479,7 +54965,7 @@ paths: externalDocs: description: createFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/createFlexCluster - operationId: createServerlessInstance + operationId: createGroupServerlessInstance parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54516,7 +55002,11 @@ paths: summary: Create One Serverless Instance in One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/createServerlessInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/createGroupServerlessInstance + x-xgen-method-verb-override: + customMethod: false + verb: createInstance + x-xgen-operation-id-override: createServerlessInstance /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/restoreJobs: get: description: |- @@ -54526,7 +55016,7 @@ paths: externalDocs: description: listFlexBackupRestoreJobs url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/listFlexBackupRestoreJobs - operationId: listServerlessBackupRestoreJobs + operationId: listGroupServerlessBackupRestoreJobs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54562,7 +55052,8 @@ paths: summary: Return All Restore Jobs for One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listServerlessBackupRestoreJobs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupServerlessBackupRestoreJobs + x-xgen-operation-id-override: listServerlessRestoreJobs post: description: |- Restores one snapshot of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -54571,7 +55062,7 @@ paths: externalDocs: description: createFlexBackupRestoreJob url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/createFlexBackupRestoreJob - operationId: createServerlessBackupRestoreJob + operationId: createGroupServerlessBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54610,10 +55101,11 @@ paths: $ref: '#/components/responses/conflict' "500": $ref: '#/components/responses/internalServerError' - summary: Restore One Snapshot of One Serverless Instance + summary: Create One Restore Job for One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createServerlessBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/createGroupServerlessBackupRestoreJob + x-xgen-operation-id-override: createServerlessRestoreJob /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/restoreJobs/{restoreJobId}: get: description: |- @@ -54623,7 +55115,7 @@ paths: externalDocs: description: getFlexBackupRestoreJob url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Restore-Jobs/operation/getFlexBackupRestoreJob - operationId: getServerlessBackupRestoreJob + operationId: getGroupServerlessBackupRestoreJob parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54649,7 +55141,7 @@ paths: schema: $ref: '#/components/schemas/ServerlessBackupRestoreJob' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -54665,7 +55157,8 @@ paths: summary: Return One Restore Job for One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getServerlessBackupRestoreJob + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupServerlessBackupRestoreJob + x-xgen-operation-id-override: getServerlessRestoreJob /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/snapshots: get: description: |- @@ -54675,7 +55168,7 @@ paths: externalDocs: description: listFlexBackups url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/listFlexBackups - operationId: listServerlessBackups + operationId: listGroupServerlessBackupSnapshots parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54711,7 +55204,8 @@ paths: summary: Return All Snapshots of One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listServerlessBackups + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/listGroupServerlessBackupSnapshots + x-xgen-operation-id-override: listServerlessBackupSnapshots /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/backup/snapshots/{snapshotId}: get: description: |- @@ -54721,7 +55215,7 @@ paths: externalDocs: description: getFlexBackup url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Snapshots/operation/getFlexBackup - operationId: getServerlessBackup + operationId: getGroupServerlessBackupSnapshot parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54747,7 +55241,7 @@ paths: schema: $ref: '#/components/schemas/ServerlessBackupSnapshot' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -54763,14 +55257,15 @@ paths: summary: Return One Snapshot of One Serverless Instance tags: - Cloud Backups - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getServerlessBackup + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Backups/operation/getGroupServerlessBackupSnapshot + x-xgen-operation-id-override: getServerlessBackupSnapshot /api/atlas/v2/groups/{groupId}/serverless/{clusterName}/performanceAdvisor/autoIndexing: get: description: Get whether the Serverless Auto Indexing feature is enabled. This endpoint returns a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. externalDocs: description: createServerlessInstance url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/createServerlessInstance - operationId: getServerlessAutoIndexing + operationId: getGroupServerlessPerformanceAdvisorAutoIndexing parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -54803,16 +55298,17 @@ paths: summary: Return Serverless Auto-Indexing Status tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/getServerlessAutoIndexing + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/getGroupServerlessPerformanceAdvisorAutoIndexing x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getServerlessAutoIndexing post: description: Set whether the Serverless Auto Indexing feature is enabled. This endpoint sets a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. externalDocs: description: createServerlessInstance url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/createServerlessInstance - operationId: setServerlessAutoIndexing + operationId: setGroupServerlessPerformanceAdvisorAutoIndexing parameters: - $ref: '#/components/parameters/groupId' - description: Human-readable label that identifies the cluster. @@ -54848,10 +55344,11 @@ paths: summary: Set Serverless Auto-Indexing Status tags: - Performance Advisor - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/setServerlessAutoIndexing + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Performance-Advisor/operation/setGroupServerlessPerformanceAdvisorAutoIndexing x-xgen-method-verb-override: customMethod: "True" verb: set + x-xgen-operation-id-override: setServerlessAutoIndexing /api/atlas/v2/groups/{groupId}/serverless/{name}: delete: description: |- @@ -54861,7 +55358,7 @@ paths: externalDocs: description: deleteFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/deleteFlexCluster - operationId: deleteServerlessInstance + operationId: deleteGroupServerlessInstance parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -54896,7 +55393,11 @@ paths: summary: Remove One Serverless Instance from One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/deleteServerlessInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/deleteGroupServerlessInstance + x-xgen-method-verb-override: + customMethod: false + verb: deleteInstance + x-xgen-operation-id-override: deleteServerlessInstance get: description: |- Returns details for one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -54905,7 +55406,7 @@ paths: externalDocs: description: getFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/getFlexCluster - operationId: getServerlessInstance + operationId: getGroupServerlessInstance parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -54924,7 +55425,7 @@ paths: schema: $ref: '#/components/schemas/ServerlessInstanceDescription' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -54942,7 +55443,11 @@ paths: summary: Return One Serverless Instance from One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/getServerlessInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/getGroupServerlessInstance + x-xgen-method-verb-override: + customMethod: false + verb: getInstance + x-xgen-operation-id-override: getServerlessInstance patch: description: |- Updates one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -54951,7 +55456,7 @@ paths: externalDocs: description: updateFlexCluster url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Flex-Clusters/operation/updateFlexCluster - operationId: updateServerlessInstance + operationId: updateGroupServerlessInstance parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -54993,11 +55498,15 @@ paths: summary: Update One Serverless Instance in One Project tags: - Serverless Instances - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/updateServerlessInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Serverless-Instances/operation/updateGroupServerlessInstance + x-xgen-method-verb-override: + customMethod: false + verb: updateInstance + x-xgen-operation-id-override: updateServerlessInstance /api/atlas/v2/groups/{groupId}/serviceAccounts: get: description: Returns all Service Accounts for the specified Project. - operationId: listProjectServiceAccounts + operationId: listGroupServiceAccounts parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/itemsPerPage' @@ -55023,10 +55532,10 @@ paths: summary: Return All Project Service Accounts tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listProjectServiceAccounts + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listGroupServiceAccounts post: description: Creates one Service Account for the specified Project. The Service Account will automatically be added as an Organization Member to the Organization that the specified Project is a part of. - operationId: createProjectServiceAccount + operationId: createGroupServiceAccount parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -55060,11 +55569,11 @@ paths: summary: Create One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createGroupServiceAccount /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}: delete: description: Removes the specified Service Account from the specified project. The Service Account will still be a part of the Organization it was created in, and the credentials will remain active until expired or manually revoked. - operationId: deleteProjectServiceAccount + operationId: deleteGroupServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -55095,10 +55604,10 @@ paths: summary: Remove One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteGroupServiceAccount get: description: Returns one Service Account in the specified Project. - operationId: getProjectServiceAccount + operationId: getGroupServiceAccount parameters: - $ref: '#/components/parameters/groupId' - description: The Client ID of the Service Account. @@ -55118,7 +55627,7 @@ paths: schema: $ref: '#/components/schemas/GroupServiceAccount' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -55132,10 +55641,10 @@ paths: summary: Return One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getGroupServiceAccount patch: description: Updates one Service Account in the specified Project. - operationId: updateProjectServiceAccount + operationId: updateGroupServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -55176,11 +55685,11 @@ paths: summary: Update One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/updateProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/updateGroupServiceAccount /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/accessList: get: description: Returns all access list entries that you configured for the specified Service Account for the project. - operationId: listProjectServiceAccountAccessList + operationId: listGroupServiceAccountAccessList parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -55215,10 +55724,11 @@ paths: summary: Return All Access List Entries for One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listProjectServiceAccountAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listGroupServiceAccountAccessList + x-xgen-operation-id-override: listAccessList post: description: Add Access List Entries for the specified Service Account for the project. Resources require all API requests to originate from IP addresses on the API access list. - operationId: createProjectServiceAccountAccessList + operationId: createGroupServiceAccountAccessList parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -55268,11 +55778,12 @@ paths: summary: Add Access List Entries for One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createProjectServiceAccountAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createGroupServiceAccountAccessList + x-xgen-operation-id-override: createAccessList /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/accessList/{ipAddress}: delete: description: Removes the specified access list entry from the specified Service Account for the project. You can't remove the requesting IP address from the access list. - operationId: deleteProjectServiceAccountAccessListEntry + operationId: deleteGroupServiceAccountAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55312,11 +55823,15 @@ paths: summary: Remove One Access List Entry from One Project Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteProjectServiceAccountAccessListEntry + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteGroupServiceAccountAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: deleteEntry + x-xgen-operation-id-override: deleteGroupAccessEntry /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/secrets: post: description: Create a secret for the specified Service Account in the specified Project. - operationId: createProjectServiceAccountSecret + operationId: createGroupServiceAccountSecret parameters: - $ref: '#/components/parameters/groupId' - description: The Client ID of the Service Account. @@ -55357,11 +55872,12 @@ paths: summary: Create One Project Service Account Secret tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createProjectServiceAccountSecret + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createGroupServiceAccountSecret + x-xgen-operation-id-override: createGroupSecret /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}/secrets/{secretId}: delete: description: Deletes the specified Service Account secret. - operationId: deleteProjectServiceAccountSecret + operationId: deleteGroupServiceAccountSecret parameters: - description: The Client ID of the Service Account. in: path @@ -55397,11 +55913,12 @@ paths: summary: Delete One Project Service Account Secret tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteProjectServiceAccountSecret + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteGroupServiceAccountSecret + x-xgen-operation-id-override: deleteGroupSecret /api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}:invite: post: description: Assigns the specified Service Account to the specified Project. - operationId: addProjectServiceAccount + operationId: inviteGroupServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -55441,11 +55958,11 @@ paths: summary: Assign One Service Account to One Project tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/addProjectServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/inviteGroupServiceAccount /api/atlas/v2/groups/{groupId}/settings: get: description: Returns details about the specified project's settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProjectSettings + operationId: getGroupSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55457,7 +55974,7 @@ paths: schema: $ref: '#/components/schemas/GroupSettings' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -55471,10 +55988,10 @@ paths: summary: Return Project Settings tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupSettings patch: description: Updates the settings of the specified project. You can update any of the options available. MongoDB cloud only updates the options provided in the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: updateProjectSettings + operationId: updateGroupSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55505,11 +56022,11 @@ paths: summary: Update Project Settings tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroupSettings /api/atlas/v2/groups/{groupId}/streams: get: description: Returns all stream instances for the specified project. - operationId: listStreamInstances + operationId: listGroupStreamWorkspaces parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -55537,10 +56054,14 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listStreamInstances + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamWorkspaces + x-xgen-method-verb-override: + customMethod: false + verb: listWorkspaces + x-xgen-operation-id-override: listStreamWorkspaces post: description: Creates one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - operationId: createStreamInstance + operationId: createGroupStreamWorkspace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -55575,11 +56096,15 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createStreamInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createGroupStreamWorkspace + x-xgen-method-verb-override: + customMethod: false + verb: createWorkspace + x-xgen-operation-id-override: createStreamWorkspace /api/atlas/v2/groups/{groupId}/streams/{tenantName}: delete: description: Delete one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - operationId: deleteStreamInstance + operationId: deleteGroupStreamWorkspace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -55609,10 +56134,14 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteStreamInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamWorkspace + x-xgen-method-verb-override: + customMethod: false + verb: deleteWorkspace + x-xgen-operation-id-override: deleteStreamWorkspace get: description: Returns the details of one stream instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - operationId: getStreamInstance + operationId: getGroupStreamWorkspace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55634,7 +56163,7 @@ paths: schema: $ref: '#/components/schemas/StreamsTenant' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-02-01" description: OK "400": @@ -55652,10 +56181,14 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getStreamInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamWorkspace + x-xgen-method-verb-override: + customMethod: false + verb: getWorkspace + x-xgen-operation-id-override: getStreamWorkspace patch: description: Update one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - operationId: updateStreamInstance + operationId: updateGroupStreamWorkspace parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -55696,11 +56229,15 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateStreamInstance + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateGroupStreamWorkspace + x-xgen-method-verb-override: + customMethod: false + verb: updateWorkspace + x-xgen-operation-id-override: updateStreamWorkspace /api/atlas/v2/groups/{groupId}/streams/{tenantName}/auditLogs: get: description: 'Downloads the audit logs for the specified Atlas Streams Processing instance. By default, logs cover periods of 30 days. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip".' - operationId: downloadStreamTenantAuditLogs + operationId: downloadGroupStreamAuditLogs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55751,14 +56288,15 @@ paths: summary: Download Audit Logs for One Atlas Stream Processing Instance tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/downloadStreamTenantAuditLogs + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/downloadGroupStreamAuditLogs x-xgen-method-verb-override: customMethod: "True" verb: download + x-xgen-operation-id-override: downloadAuditLogs /api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections: get: description: Returns all connections of the stream instance for the specified project.To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - operationId: listStreamConnections + operationId: listGroupStreamConnections parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -55792,10 +56330,11 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listStreamConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamConnections + x-xgen-operation-id-override: listStreamConnections post: description: Creates one connection for a stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - operationId: createStreamConnection + operationId: createGroupStreamConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -55838,11 +56377,12 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createStreamConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createGroupStreamConnection + x-xgen-operation-id-override: createStreamConnection /api/atlas/v2/groups/{groupId}/streams/{tenantName}/connections/{connectionName}: delete: description: Delete one connection of the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: deleteStreamConnection + operationId: deleteGroupStreamConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -55880,10 +56420,11 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteStreamConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamConnection + x-xgen-operation-id-override: deleteStreamConnection get: description: Returns the details of one stream connection within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getStreamConnection + operationId: getGroupStreamConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -55906,7 +56447,7 @@ paths: schema: $ref: '#/components/schemas/StreamsConnection' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-02-01" description: OK "401": @@ -55922,10 +56463,11 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getStreamConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamConnection + x-xgen-operation-id-override: getStreamConnection patch: description: Update one connection for the specified stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: updateStreamConnection + operationId: updateGroupStreamConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -55974,11 +56516,12 @@ paths: - Streams x-xgen-changelog: "2023-09-11": The MongoDB Atlas Streams Processing API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateStreamConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateGroupStreamConnection + x-xgen-operation-id-override: updateStreamConnection /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor: post: description: Create one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: createStreamProcessor + operationId: createGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56019,11 +56562,12 @@ paths: summary: Create One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createGroupStreamProcessor + x-xgen-operation-id-override: createStreamProcessor /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}: delete: description: Delete a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: deleteStreamProcessor + operationId: deleteGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56057,10 +56601,11 @@ paths: summary: Delete One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamProcessor + x-xgen-operation-id-override: deleteStreamProcessor get: description: Get one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: getStreamProcessor + operationId: getGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56084,7 +56629,7 @@ paths: schema: $ref: '#/components/schemas/StreamsProcessorWithStats' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-05-30" description: OK "400": @@ -56100,10 +56645,11 @@ paths: summary: Return One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamProcessor + x-xgen-operation-id-override: getStreamProcessor patch: description: Modify one existing Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: modifyStreamProcessor + operationId: updateGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56148,11 +56694,12 @@ paths: summary: Update One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/modifyStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/updateGroupStreamProcessor + x-xgen-operation-id-override: updateStreamProcessor /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:start: post: description: Start a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: startStreamProcessor + operationId: startGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56186,11 +56733,12 @@ paths: summary: Start One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/startStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/startGroupStreamProcessor + x-xgen-operation-id-override: startStreamProcessor /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:startWith: post: description: Start a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: startStreamProcessorWith + operationId: startGroupStreamProcessorWith parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56231,11 +56779,12 @@ paths: summary: Start One Stream Processor With Options tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/startStreamProcessorWith + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/startGroupStreamProcessorWith + x-xgen-operation-id-override: startStreamProcessorWith /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processor/{processorName}:stop: post: description: Stop a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: stopStreamProcessor + operationId: stopGroupStreamProcessor parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56269,11 +56818,12 @@ paths: summary: Stop One Stream Processor tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/stopStreamProcessor + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/stopGroupStreamProcessor + x-xgen-operation-id-override: stopStreamProcessor /api/atlas/v2/groups/{groupId}/streams/{tenantName}/processors: get: description: Returns all Stream Processors within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. - operationId: listStreamProcessors + operationId: getGroupStreamProcessors parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56294,8 +56844,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedApiStreamsStreamProcessorWithStatsView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2024-05-30" description: OK "400": @@ -56311,11 +56861,12 @@ paths: summary: Return All Stream Processors in One Stream Instance tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listStreamProcessors + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamProcessors + x-xgen-operation-id-override: getStreamProcessors /api/atlas/v2/groups/{groupId}/streams/accountDetails: get: description: Returns the Account ID, and the VPC ID for the group and region specified. - operationId: getAccountDetails + operationId: getGroupStreamAccountDetails parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -56350,14 +56901,15 @@ paths: summary: Return Account ID and VPC ID for One Project and Region tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getAccountDetails + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamAccountDetails x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getAccountDetails /api/atlas/v2/groups/{groupId}/streams/activeVpcPeeringConnections: get: description: Returns a list of active incoming VPC Peering Connections. - operationId: getActiveVpcPeeringConnections + operationId: listGroupStreamActiveVpcPeeringConnections parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -56381,11 +56933,12 @@ paths: summary: Return All Active Incoming VPC Peering Connections tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getActiveVpcPeeringConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamActiveVpcPeeringConnections + x-xgen-operation-id-override: listActivePeeringConnections /api/atlas/v2/groups/{groupId}/streams/privateLinkConnections: get: description: Returns all Private Link connections for the specified project.To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. - operationId: listPrivateLinkConnections + operationId: listGroupStreamPrivateLinkConnections parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -56413,10 +56966,11 @@ paths: - Streams x-xgen-changelog: "2024-10-02": The MongoDB Atlas Streams Processing Private Link API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listPrivateLinkConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamPrivateLinkConnections + x-xgen-operation-id-override: listPrivateLinkConnections post: description: Creates one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - operationId: createPrivateLinkConnection + operationId: createGroupStreamPrivateLinkConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56453,11 +57007,12 @@ paths: - Streams x-xgen-changelog: "2024-10-02": The MongoDB Atlas Streams Processing Private Link API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createPrivateLinkConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createGroupStreamPrivateLinkConnection + x-xgen-operation-id-override: createPrivateLinkConnection /api/atlas/v2/groups/{groupId}/streams/privateLinkConnections/{connectionId}: delete: description: Deletes one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. - operationId: deletePrivateLinkConnection + operationId: deleteGroupStreamPrivateLinkConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56487,10 +57042,11 @@ paths: - Streams x-xgen-changelog: "2024-10-02": The MongoDB Atlas Streams Processing Private Link API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deletePrivateLinkConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamPrivateLinkConnection + x-xgen-operation-id-override: deletePrivateLinkConnection get: description: Returns the details of one Private Link connection within the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getPrivateLinkConnection + operationId: getGroupStreamPrivateLinkConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56521,11 +57077,12 @@ paths: - Streams x-xgen-changelog: "2024-10-02": The MongoDB Atlas Streams Processing Private Link API is now exposed as part of private preview, but is subject to change until GA. - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getPrivateLinkConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getGroupStreamPrivateLinkConnection + x-xgen-operation-id-override: getPrivateLinkConnection /api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections: get: description: Returns a list of incoming VPC Peering Connections. - operationId: getVpcPeeringConnections + operationId: listGroupStreamVpcPeeringConnections parameters: - description: The Account ID of the VPC Peering connection/s. in: query @@ -56555,11 +57112,12 @@ paths: summary: Return All VPC Peering Connections tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/getVpcPeeringConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/listGroupStreamVpcPeeringConnections + x-xgen-operation-id-override: listVpcPeeringConnections /api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}: delete: description: Deletes an incoming VPC Peering connection. - operationId: deleteVpcPeeringConnection + operationId: deleteGroupStreamVpcPeeringConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56586,11 +57144,12 @@ paths: summary: Delete One VPC Peering Connection tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteVpcPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/deleteGroupStreamVpcPeeringConnection + x-xgen-operation-id-override: deleteVpcPeeringConnection /api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}:accept: post: description: Requests the acceptance of an incoming VPC Peering connection. - operationId: acceptVpcPeeringConnection + operationId: acceptGroupStreamVpcPeeringConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56624,11 +57183,12 @@ paths: summary: Accept One Incoming VPC Peering Connection tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/acceptVpcPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/acceptGroupStreamVpcPeeringConnection + x-xgen-operation-id-override: acceptVpcPeeringConnection /api/atlas/v2/groups/{groupId}/streams/vpcPeeringConnections/{id}:reject: post: description: Requests the rejection of an incoming VPC Peering connection. - operationId: rejectVpcPeeringConnection + operationId: rejectGroupStreamVpcPeeringConnection parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56655,11 +57215,12 @@ paths: summary: Reject One Incoming VPC Peering Connection tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/rejectVpcPeeringConnection + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/rejectGroupStreamVpcPeeringConnection + x-xgen-operation-id-override: rejectVpcPeeringConnection /api/atlas/v2/groups/{groupId}/streams:withSampleConnections: post: description: Creates one stream instance in the specified project with sample connections. To use this resource the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. - operationId: createStreamInstanceWithSampleConnections + operationId: withGroupStreamSampleConnections parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56692,11 +57253,12 @@ paths: summary: Create One Stream Instance with Sample Connections tags: - Streams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/createStreamInstanceWithSampleConnections + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Streams/operation/withGroupStreamSampleConnections + x-xgen-operation-id-override: withStreamSampleConnections /api/atlas/v2/groups/{groupId}/teams: get: description: Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: listProjectTeams + operationId: listGroupTeams parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56725,13 +57287,13 @@ paths: summary: Return All Teams in One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/listProjectTeams + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/listGroupTeams post: description: Adds one team to the specified project. All members of the team share the same project access. MongoDB Cloud limits the number of users to a maximum of 100 teams per project and a maximum of 250 teams per organization. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: addAllTeamsToProject + operationId: addGroupTeams parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -56766,7 +57328,7 @@ paths: summary: Add One Team to One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/addAllTeamsToProject + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/addGroupTeams x-xgen-method-verb-override: customMethod: "True" verb: add @@ -56776,7 +57338,7 @@ paths: externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: removeProjectTeam + operationId: removeGroupTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56806,13 +57368,13 @@ paths: summary: Remove One Team from One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/removeProjectTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/removeGroupTeam x-xgen-method-verb-override: customMethod: "True" verb: remove get: description: Returns one team to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProjectTeam + operationId: getGroupTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56831,7 +57393,7 @@ paths: schema: $ref: '#/components/schemas/TeamRole' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: Content predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -56847,13 +57409,13 @@ paths: summary: Return One Team in One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getProjectTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getGroupTeam patch: description: Updates the project roles assigned to the specified team. You can grant team roles for specific projects and grant project access roles to users in the team. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: updateTeamRoles + operationId: updateGroupTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56879,7 +57441,7 @@ paths: schema: $ref: '#/components/schemas/PaginatedTeamRoleView' x-xgen-IPA-exception: - xgen-IPA-107-update-method-response-is-get-method-response: Content predates IPA validation + xgen-IPA-107-update-method-response-is-get-method-response: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -56895,11 +57457,11 @@ paths: summary: Update Team Roles in One Project tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/updateTeamRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/updateGroupTeam /api/atlas/v2/groups/{groupId}/userSecurity: get: description: Returns the current LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getLdapConfiguration + operationId: getGroupUserSecurity parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56911,8 +57473,8 @@ paths: schema: $ref: '#/components/schemas/UserSecurity' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation. + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -56926,13 +57488,14 @@ paths: summary: Return LDAP or X.509 Configuration tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/getLdapConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/getGroupUserSecurity + x-xgen-operation-id-override: getUserSecurity patch: description: |- Edits the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Updating this configuration triggers a rolling restart of the database. - operationId: saveLdapConfiguration + operationId: updateGroupUserSecurity parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56965,14 +57528,15 @@ paths: summary: Update LDAP or X.509 Configuration tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/saveLdapConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/updateGroupUserSecurity + x-xgen-operation-id-override: updateUserSecurity /api/atlas/v2/groups/{groupId}/userSecurity/customerX509: delete: description: |- Clears the customer-managed X.509 settings on a project, including the uploaded Certificate Authority, which disables self-managed X.509. Updating this configuration triggers a rolling restart of the database. You must have the Project Owner role to use this endpoint. - operationId: disableCustomerManagedX509 + operationId: disableGroupUserSecurityCustomerX509 parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -56995,14 +57559,15 @@ paths: summary: Disable Customer-Managed X.509 tags: - X.509 Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/disableCustomerManagedX509 + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/X.509-Authentication/operation/disableGroupUserSecurityCustomerX509 x-xgen-method-verb-override: customMethod: "True" verb: disable + x-xgen-operation-id-override: disableSecurityCustomerX509 /api/atlas/v2/groups/{groupId}/userSecurity/ldap/userToDNMapping: delete: description: Removes the current LDAP Distinguished Name mapping captured in the ``userToDNMapping`` document from the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: deleteLdapConfiguration + operationId: deleteGroupUserSecurityLdapUserToDnMapping parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57026,11 +57591,12 @@ paths: summary: Remove LDAP User to DN Mapping tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/deleteLdapConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/deleteGroupUserSecurityLdapUserToDnMapping + x-xgen-operation-id-override: deleteLdapUserMapping /api/atlas/v2/groups/{groupId}/userSecurity/ldap/verify: post: description: Verifies the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: verifyLdapConfiguration + operationId: verifyGroupUserSecurityLdap parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57063,13 +57629,14 @@ paths: summary: Verify LDAP Configuration in One Project tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/verifyLdapConfiguration + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/verifyGroupUserSecurityLdap x-xgen-method-verb-override: customMethod: "True" + x-xgen-operation-id-override: verifyUserSecurityLdap /api/atlas/v2/groups/{groupId}/userSecurity/ldap/verify/{requestId}: get: description: Returns the status of one request to verify one LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. - operationId: getLdapConfigurationStatus + operationId: getGroupUserSecurityLdapVerify parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57100,10 +57667,11 @@ paths: summary: Return Status of LDAP Configuration Verification in One Project tags: - LDAP Configuration - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/getLdapConfigurationStatus + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/LDAP-Configuration/operation/getGroupUserSecurityLdapVerify x-xgen-method-verb-override: - customMethod: "False" + customMethod: false verb: get + x-xgen-operation-id-override: getUserSecurityVerify /api/atlas/v2/groups/{groupId}/users: get: description: |- @@ -57115,7 +57683,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: listProjectUsers + operationId: listGroupUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57171,10 +57739,10 @@ paths: summary: Return All MongoDB Cloud Users in One Project tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listProjectUsers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listGroupUsers post: description: "Adds one MongoDB Cloud user to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. \n- If the user has a pending invitation to join the project's organization, MongoDB Cloud modifies it and grants project access. \n- If the user doesn't have an invitation to join the organization, MongoDB Cloud sends a new invitation that grants the user organization and project access. \n- If the user is already active in the project's organization, MongoDB Cloud grants access to the project. \n" - operationId: addProjectUser + operationId: addGroupUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57209,7 +57777,7 @@ paths: summary: Add One MongoDB Cloud User to One Project tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addProjectUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addGroupUsers x-xgen-method-verb-override: customMethod: "True" verb: add @@ -57224,7 +57792,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeProjectUser + operationId: removeGroupUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57260,7 +57828,7 @@ paths: summary: Remove One MongoDB Cloud User from One Project tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeProjectUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeGroupUser x-xgen-method-verb-override: customMethod: "True" verb: remove @@ -57271,7 +57839,7 @@ paths: **Note**: You can only use this resource to fetch information about MongoDB Cloud human users. To return information about an API Key, use the [Return One Organization API Key](#tag/Programmatic-API-Keys/operation/getApiKey) endpoint. **Note**: This resource does not return information about pending users invited via the deprecated [Invite One MongoDB Cloud User to Join One Project](#tag/Projects/operation/createProjectInvitation) endpoint. - operationId: getProjectUser + operationId: getGroupUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57304,12 +57872,12 @@ paths: summary: Return One MongoDB Cloud User in One Project tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getProjectUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getGroupUser /api/atlas/v2/groups/{groupId}/users/{userId}/roles: put: deprecated: true description: Updates the roles of the specified user in the specified project. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified project. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. - operationId: updateProjectRoles + operationId: updateGroupUserRoles parameters: - $ref: '#/components/parameters/groupId' - description: Unique 24-hexadecimal digit string that identifies the user to modify. @@ -57348,7 +57916,7 @@ paths: summary: Update Project Roles for One MongoDB Cloud User tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateGroupUserRoles /api/atlas/v2/groups/{groupId}/users/{userId}:addRole: post: description: |- @@ -57358,7 +57926,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: addProjectRole + operationId: addGroupUserRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57400,7 +57968,7 @@ paths: summary: Add One Project Role to One MongoDB Cloud User tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addProjectRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addGroupUserRole /api/atlas/v2/groups/{groupId}/users/{userId}:removeRole: post: description: |- @@ -57410,7 +57978,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeProjectRole + operationId: removeGroupUserRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/groupId' @@ -57452,11 +58020,11 @@ paths: summary: Remove One Project Role from One MongoDB Cloud User tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeProjectRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeGroupUserRole /api/atlas/v2/groups/{groupId}:migrate: post: description: Migrates a project from its current organization to another organization. All project users and their roles will be copied to the same project in the destination organization. You must include an organization API key with the Organization Owner role for the destination organization to verify access to the destination organization when you authenticate with Programmatic API Keys. Otherwise, the requesting user must have the Organization Owner role in both organizations. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: migrateProjectToAnotherOrg + operationId: migrateGroup parameters: - $ref: '#/components/parameters/groupId' - $ref: '#/components/parameters/envelope' @@ -57486,11 +58054,11 @@ paths: summary: Migrate One Project to Another Organization tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/migrateProjectToAnotherOrg + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/migrateGroup /api/atlas/v2/groups/byName/{groupName}: get: description: Returns details about the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. - operationId: getProjectByName + operationId: getGroupByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -57525,11 +58093,11 @@ paths: summary: Return One Project by Name tags: - Projects - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getProjectByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/getGroupByName /api/atlas/v2/orgs: get: description: Returns all organizations to which the requesting Service Account or API Key has access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - operationId: listOrganizations + operationId: listOrgs parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -57564,13 +58132,13 @@ paths: summary: Return All Organizations tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrganizations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrgs post: description: Creates one organization in MongoDB Cloud and links it to the requesting Service Account's or API Key's organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. The requesting Service Account's or API Key's organization must be a paying organization. To learn more, see Configure a Paying Organization in the MongoDB Atlas documentation. externalDocs: description: Configure a Paying Organization url: https://www.mongodb.com/docs/atlas/billing/#configure-a-paying-organization - operationId: createOrganization + operationId: createOrg parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -57588,7 +58156,7 @@ paths: schema: $ref: '#/components/schemas/CreateOrganizationResponse' x-xgen-IPA-exception: - xgen-IPA-106-create-method-response-is-get-method-response: Content predates IPA validation + xgen-IPA-106-create-method-response-is-get-method-response: Content predates IPA validation. x-xgen-version: "2023-01-01" description: Created "400": @@ -57606,7 +58174,7 @@ paths: summary: Create One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/createOrganization + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/createOrg /api/atlas/v2/orgs/{orgId}: delete: description: |- @@ -57615,7 +58183,7 @@ paths: - Organizations with active projects cannot be removed. - All projects in the organization must be removed before you can remove the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: deleteOrganization + operationId: deleteOrg parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -57642,10 +58210,10 @@ paths: summary: Remove One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/deleteOrganization + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/deleteOrg get: description: Returns one organization to which the requesting Service Account or API Key has access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - operationId: getOrganization + operationId: getOrg parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -57657,7 +58225,7 @@ paths: schema: $ref: '#/components/schemas/AtlasOrganization' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -57675,10 +58243,10 @@ paths: summary: Return One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrganization + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrg patch: description: Updates one organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: updateOrganization + operationId: updateOrg parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -57713,14 +58281,14 @@ paths: summary: Update One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganization + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrg /api/atlas/v2/orgs/{orgId}/apiKeys: get: description: Returns all organization API keys for the specified organization. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the console. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: listApiKeys + operationId: listOrgApiKeys parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -57747,13 +58315,13 @@ paths: summary: Return All Organization API Keys tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listApiKeys + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listOrgApiKeys post: description: Creates one API key for the specified organization. An organization API key grants programmatic access to an organization. You can't use the API key to log into the console. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: createApiKey + operationId: createOrgApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -57784,14 +58352,14 @@ paths: summary: Create One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createOrgApiKey /api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}: delete: description: Removes one organization API key from the specified organization. When you remove an API key from an organization, MongoDB Cloud also removes that key from any projects that use that key. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Configure Atlas API Access url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-enable-api-access-list - operationId: deleteApiKey + operationId: deleteOrgApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -57820,13 +58388,13 @@ paths: summary: Remove One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/deleteApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/deleteOrgApiKey get: description: Returns one organization API key. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the user interface. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: getApiKey + operationId: getOrgApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -57845,7 +58413,7 @@ paths: schema: $ref: '#/components/schemas/ApiKeyUserDetails' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -57859,13 +58427,13 @@ paths: summary: Return One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getOrgApiKey patch: description: Updates one organization API key in the specified organization. The organization API keys grant programmatic access to an organization. To use this resource, the requesting API Key must have the Organization Owner role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-atlas-prog-api-key - operationId: updateApiKey + operationId: updateOrgApiKey parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -57905,14 +58473,14 @@ paths: summary: Update One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateApiKey + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/updateOrgApiKey /api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList: get: description: Returns all access list entries that you configured for the specified organization API key. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Programmatic API Keys url: https://docs.atlas.mongodb.com/configure-api-access/#view-the-details-of-one-api-key-in-one-organization - operationId: listApiKeyAccessListsEntries + operationId: listOrgApiKeyAccessListEntries parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -57946,10 +58514,14 @@ paths: summary: Return All Access List Entries for One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listApiKeyAccessListsEntries + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/listOrgApiKeyAccessListEntries + x-xgen-method-verb-override: + customMethod: false + verb: listEntries + x-xgen-operation-id-override: listOrgAccessEntries post: description: Creates the access list entries for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. - operationId: createApiKeyAccessList + operationId: createOrgApiKeyAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -57996,14 +58568,18 @@ paths: summary: Create One Access List Entry for One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createApiKeyAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/createOrgApiKeyAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: createEntry + x-xgen-operation-id-override: createOrgAccessEntry /api/atlas/v2/orgs/{orgId}/apiKeys/{apiUserId}/accessList/{ipAddress}: delete: description: Removes the specified access list entry from the specified organization API key. Resources require all API requests originate from the IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. In addition, you cannot remove the requesting IP address from the requesting organization API key. externalDocs: description: Configure Atlas API Access url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-enable-api-access-list - operationId: deleteApiKeyAccessListEntry + operationId: deleteOrgApiKeyAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58042,16 +58618,17 @@ paths: summary: Remove One Access List Entry for One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/deleteApiKeyAccessListEntry + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/deleteOrgApiKeyAccessListEntry x-xgen-method-verb-override: customMethod: "True" verb: deleteEntry + x-xgen-operation-id-override: deleteAccessEntry get: description: Returns one access list entry for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Configure Atlas API Access url: https://docs.atlas.mongodb.com/configure-api-access/#std-label-enable-api-access-list - operationId: getApiKeyAccessList + operationId: getOrgApiKeyAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58090,11 +58667,15 @@ paths: summary: Return One Access List Entry for One Organization API Key tags: - Programmatic API Keys - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getApiKeyAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getOrgApiKeyAccessListEntry + x-xgen-method-verb-override: + customMethod: false + verb: getEntry + x-xgen-operation-id-override: getOrgAccessEntry /api/atlas/v2/orgs/{orgId}/billing/costExplorer/usage: post: description: Creates a query process within the Cost Explorer for the given parameters. A token is returned that can be used to poll the status of the query and eventually retrieve the results. - operationId: createCostExplorerQueryProcess + operationId: createOrgBillingCostExplorerUsageProcess parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -58126,11 +58707,15 @@ paths: summary: Create One Cost Explorer Query Process tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/createCostExplorerQueryProcess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/createOrgBillingCostExplorerUsageProcess + x-xgen-method-verb-override: + customMethod: false + verb: createProcess + x-xgen-operation-id-override: createCostExplorerProcess /api/atlas/v2/orgs/{orgId}/billing/costExplorer/usage/{token}: get: description: Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. If the data is not ready, a 'processing' response willindicate that another request should be sent later to view the data. - operationId: getCostExplorerQueryProcess + operationId: getOrgBillingCostExplorerUsage parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -58177,17 +58762,18 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return results from a given Cost Explorer query, or notify that the results are not ready yet. + summary: Return Usage Details for One Cost Explorer Query tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getCostExplorerQueryProcess + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getOrgBillingCostExplorerUsage + x-xgen-operation-id-override: getCostExplorerUsage /api/atlas/v2/orgs/{orgId}/events: get: description: |- Returns events for the specified organization. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This resource remains under revision and may change. - operationId: listOrganizationEvents + operationId: listOrgEvents parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -58236,7 +58822,7 @@ paths: schema: $ref: '#/components/schemas/OrgPaginatedEventView' x-xgen-IPA-exception: - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58252,7 +58838,7 @@ paths: summary: Return Events from One Organization tags: - Events - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listOrganizationEvents + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listOrgEvents /api/atlas/v2/orgs/{orgId}/events/{eventId}: get: description: |- @@ -58262,7 +58848,7 @@ paths: externalDocs: description: Return Events from One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/listOrganizationEvents - operationId: getOrganizationEvent + operationId: getOrgEvent parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58287,7 +58873,7 @@ paths: schema: $ref: '#/components/schemas/EventViewForOrg' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -58301,11 +58887,11 @@ paths: summary: Return One Event from One Organization tags: - Events - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/getOrganizationEvent + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Events/operation/getOrgEvent /api/atlas/v2/orgs/{orgId}/federationSettings: get: description: Returns information about the federation settings for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. - operationId: getFederationSettings + operationId: getOrgFederationSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58317,7 +58903,7 @@ paths: schema: $ref: '#/components/schemas/OrgFederationSettings' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58333,7 +58919,8 @@ paths: summary: Return Federation Settings for One Organization tags: - Federated Authentication - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getFederationSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Federated-Authentication/operation/getOrgFederationSettings + x-xgen-operation-id-override: getFederationSettings /api/atlas/v2/orgs/{orgId}/groups: get: description: |- @@ -58345,7 +58932,7 @@ paths: - Create different alert settings. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - operationId: listOrganizationProjects + operationId: getOrgGroups parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -58365,9 +58952,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedAtlasGroupView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-response-has-no-input-fields: Content predates IPA validation - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58383,7 +58969,7 @@ paths: summary: Return All Projects in One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrganizationProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrgGroups /api/atlas/v2/orgs/{orgId}/invites: get: deprecated: true @@ -58394,7 +58980,7 @@ paths: externalDocs: description: Return All MongoDB Cloud Users in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listOrganizationUsers - operationId: listOrganizationInvitations + operationId: listOrgInvites parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58414,12 +59000,12 @@ paths: $ref: '#/components/schemas/OrganizationInvitation' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-sunset: "2026-07-31" x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58432,10 +59018,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return All Organization Invitations + summary: Return All Invitations in One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrganizationInvitations + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/listOrgInvites patch: deprecated: true description: |- @@ -58445,7 +59031,7 @@ paths: externalDocs: description: Update One MongoDB Cloud User in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/updateOrganizationUser - operationId: updateOrganizationInvitation + operationId: updateOrgInvites parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58476,10 +59062,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update One Organization Invitation + summary: Update One Invitation in One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganizationInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrgInvites post: deprecated: true description: |- @@ -58489,7 +59075,7 @@ paths: externalDocs: description: Add One MongoDB Cloud User to One url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/createOrganizationUser - operationId: createOrganizationInvitation + operationId: createOrgInvite parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58520,10 +59106,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Invite One MongoDB Cloud User to One Atlas Organization + summary: Create Invitation for One MongoDB Cloud User in One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/createOrganizationInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/createOrgInvite /api/atlas/v2/orgs/{orgId}/invites/{invitationId}: delete: deprecated: true @@ -58534,7 +59120,7 @@ paths: externalDocs: description: Remove One MongoDB Cloud User in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrganizationUser - operationId: deleteOrganizationInvitation + operationId: deleteOrgInvite parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58562,10 +59148,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Remove One Organization Invitation + summary: Remove One Invitation from One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/deleteOrganizationInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/deleteOrgInvite get: deprecated: true description: |- @@ -58575,7 +59161,7 @@ paths: externalDocs: description: Return One MongoDB Cloud User in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getOrganizationUser - operationId: getOrganizationInvitation + operationId: getOrgInvite parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58594,7 +59180,7 @@ paths: $ref: '#/components/schemas/OrganizationInvitation' x-sunset: "2026-07-31" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58607,10 +59193,10 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Return One Organization Invitation + summary: Return One Invitation in One Organization by Invitation ID tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrganizationInvitation + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrgInvite patch: deprecated: true description: |- @@ -58620,7 +59206,7 @@ paths: externalDocs: description: Update One MongoDB Cloud User in One Organization url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/updateOrganizationUser - operationId: updateOrganizationInvitationById + operationId: updateOrgInviteById parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58658,16 +59244,19 @@ paths: $ref: '#/components/responses/notFound' "500": $ref: '#/components/responses/internalServerError' - summary: Update One Organization Invitation by Invitation ID + summary: Update One Invitation in One Organization by Invitation ID tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganizationInvitationById + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrgInviteById + x-xgen-method-verb-override: + customMethod: false + verb: updateById /api/atlas/v2/orgs/{orgId}/invoices: get: description: |- Returns all invoices that MongoDB issued to the specified organization. This list includes all invoices regardless of invoice status. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner role. To compute the total owed amount of the invoices - sum up total owed of each invoice. It could be computed as a sum of owed amount of each payment included into the invoice. To compute payment's owed amount - use formula *totalBilledCents* * *unitPrice* + *salesTax* - *startingBalanceCents*. - operationId: listInvoices + operationId: listOrgInvoices parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -58738,7 +59327,7 @@ paths: schema: $ref: '#/components/schemas/PaginatedApiInvoiceMetadataView' x-xgen-IPA-exception: - xgen-IPA-105-list-method-response-is-get-method-response: API predates IPA validation + xgen-IPA-105-list-method-response-is-get-method-response: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -58752,13 +59341,14 @@ paths: summary: Return All Invoices for One Organization tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/listInvoices + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/listOrgInvoices + x-xgen-operation-id-override: listInvoices /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}: get: description: |- Returns one invoice that MongoDB issued to the specified organization. A unique 24-hexadecimal digit string identifies the invoice. You can choose to receive this invoice in JSON or CSV format. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner role. To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula *totalBilledCents* * *unitPrice* + *salesTax* - *startingBalanceCents*. - operationId: getInvoice + operationId: getOrgInvoice parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58788,7 +59378,7 @@ paths: schema: $ref: '#/components/schemas/BillingInvoice' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -58802,13 +59392,14 @@ paths: summary: Return One Invoice for One Organization tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getInvoice + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getOrgInvoice + x-xgen-operation-id-override: getInvoice /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/csv: get: description: |- Returns one invoice that MongoDB issued to the specified organization in CSV format. A unique 24-hexadecimal digit string identifies the invoice. To use this resource, the requesting Service Account or API Key have at least the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner Role. To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula *totalBilledCents* * *unitPrice* + *salesTax* - *startingBalanceCents*. - operationId: downloadInvoiceCsv + operationId: getOrgInvoiceCsv parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58846,11 +59437,12 @@ paths: summary: Return One Invoice as CSV for One Organization tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/downloadInvoiceCsv + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/getOrgInvoiceCsv + x-xgen-operation-id-override: getInvoiceCsv /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}/lineItems:search: get: description: Query the lineItems of the specified invoice and return the result JSON. A unique 24-hexadecimal digit string identifies the invoice. - operationId: queryLineItemsFromSingleInvoice + operationId: searchOrgInvoiceLineItems parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/itemsPerPage' @@ -58891,11 +59483,12 @@ paths: summary: Return All Line Items for One Invoice by Invoice ID tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/queryLineItemsFromSingleInvoice + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/searchOrgInvoiceLineItems + x-xgen-operation-id-override: searchInvoiceLineItems /api/atlas/v2/orgs/{orgId}/invoices/pending: get: description: Returns all invoices accruing charges for the current billing cycle for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner Role. - operationId: listPendingInvoices + operationId: listOrgInvoicePending parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -58919,11 +59512,12 @@ paths: summary: Return All Pending Invoices for One Organization tags: - Invoices - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/listPendingInvoices + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Invoices/operation/listOrgInvoicePending + x-xgen-operation-id-override: listInvoicePending /api/atlas/v2/orgs/{orgId}/liveMigrations/availableProjects: get: description: Return all projects that you can migrate to the specified organization. - operationId: listSourceProjects + operationId: listOrgLiveMigrationAvailableProjects parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -58937,7 +59531,7 @@ paths: $ref: '#/components/schemas/LiveImportAvailableProject' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-version: "2023-01-01" description: OK "400": @@ -58953,11 +59547,12 @@ paths: summary: Return All Projects Available for Migration tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/listSourceProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/listOrgLiveMigrationAvailableProjects + x-xgen-operation-id-override: listAvailableProjects /api/atlas/v2/orgs/{orgId}/liveMigrations/linkTokens: delete: description: Remove one organization link and its associated public API key. MongoDB Atlas uses the link-token for push live migrations only. Live migrations (push) let you securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: deleteLinkToken + operationId: deleteOrgLiveMigrationLinkTokens parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -58980,10 +59575,11 @@ paths: summary: Remove One Link-Token tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/deleteLinkToken + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/deleteOrgLiveMigrationLinkTokens + x-xgen-operation-id-override: deleteLinkTokens post: description: Create one link-token that contains all the information required to complete the link. MongoDB Atlas uses the link-token for push live migrations only. Live migration (push) allows you to securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. - operationId: createLinkToken + operationId: createOrgLiveMigrationLinkToken parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -59016,14 +59612,15 @@ paths: summary: Create One Link-Token tags: - Cloud Migration Service - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/createLinkToken + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Cloud-Migration-Service/operation/createOrgLiveMigrationLinkToken + x-xgen-operation-id-override: createLinkToken /api/atlas/v2/orgs/{orgId}/nonCompliantResources: get: description: Return all non-compliant resources for an org. externalDocs: description: Atlas Resource Policies url: https://dochub.mongodb.org/core/atlas-resource-policies - operationId: getResourcesNonCompliant + operationId: getOrgNonCompliantResources parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -59037,10 +59634,10 @@ paths: $ref: '#/components/schemas/ApiAtlasNonCompliantResourceView' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "400": @@ -59056,7 +59653,8 @@ paths: summary: Return All Non-Compliant Resources tags: - Resource Policies - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies/operation/getResourcesNonCompliant + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies/operation/getOrgNonCompliantResources + x-xgen-operation-id-override: getNonCompliantResources /api/atlas/v2/orgs/{orgId}/resourcePolicies: get: description: Return all Atlas Resource Policies for the org. @@ -59077,11 +59675,11 @@ paths: $ref: '#/components/schemas/ApiAtlasResourcePolicyView' type: array x-xgen-IPA-exception: - xgen-IPA-124-array-max-items: Schema predates IPA validation + xgen-IPA-124-array-max-items: Schema predates IPA validation. x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2024-08-05" description: OK "400": @@ -59211,7 +59809,7 @@ paths: schema: $ref: '#/components/schemas/ApiAtlasResourcePolicyView' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "400": @@ -59289,7 +59887,7 @@ paths: externalDocs: description: Atlas Resource Policies url: https://dochub.mongodb.org/core/atlas-resource-policies - operationId: validateAtlasResourcePolicy + operationId: validateOrgResourcePolicies parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -59328,11 +59926,12 @@ paths: summary: Validate One Atlas Resource Policy tags: - Resource Policies - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies/operation/validateAtlasResourcePolicy + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies/operation/validateOrgResourcePolicies + x-xgen-operation-id-override: validateResourcePolicies /api/atlas/v2/orgs/{orgId}/serviceAccounts: get: description: Returns all Service Accounts for the specified Organization. - operationId: listServiceAccounts + operationId: listOrgServiceAccounts parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/itemsPerPage' @@ -59358,10 +59957,10 @@ paths: summary: Return All Organization Service Accounts tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listServiceAccounts + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listOrgServiceAccounts post: description: Creates one Service Account for the specified Organization. - operationId: createServiceAccount + operationId: createOrgServiceAccount parameters: - $ref: '#/components/parameters/orgId' - $ref: '#/components/parameters/envelope' @@ -59394,11 +59993,11 @@ paths: summary: Create One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createOrgServiceAccount /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}: delete: description: Deletes the specified Service Account. - operationId: deleteServiceAccount + operationId: deleteOrgServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -59428,10 +60027,10 @@ paths: summary: Delete One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteOrgServiceAccount get: description: Returns the specified Service Account. - operationId: getServiceAccount + operationId: getOrgServiceAccount parameters: - $ref: '#/components/parameters/orgId' - description: The Client ID of the Service Account. @@ -59451,7 +60050,7 @@ paths: schema: $ref: '#/components/schemas/OrgServiceAccount' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -59465,10 +60064,10 @@ paths: summary: Return One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getOrgServiceAccount patch: description: Updates the specified Service Account in the specified Organization. - operationId: updateServiceAccount + operationId: updateOrgServiceAccount parameters: - description: The Client ID of the Service Account. in: path @@ -59509,11 +60108,11 @@ paths: summary: Update One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/updateServiceAccount + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/updateOrgServiceAccount /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/accessList: get: description: Returns all access list entries that you configured for the specified Service Account for the organization. - operationId: listServiceAccountAccessList + operationId: listOrgServiceAccountAccessList parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -59548,10 +60147,11 @@ paths: summary: Return All Access List Entries for One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listServiceAccountAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listOrgServiceAccountAccessList + x-xgen-operation-id-override: listOrgAccessList post: description: Add Access List Entries for the specified Service Account for the organization. Resources require all API requests to originate from IP addresses on the API access list. - operationId: createServiceAccountAccessList + operationId: createOrgServiceAccountAccessList parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/includeCount' @@ -59601,11 +60201,12 @@ paths: summary: Add Access List Entries for One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createServiceAccountAccessList + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createOrgServiceAccountAccessList + x-xgen-operation-id-override: createOrgAccessList /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/accessList/{ipAddress}: delete: description: Removes the specified access list entry from the specified Service Account for the organization. You can't remove the requesting IP address from the access list. - operationId: deleteServiceAccountAccessListEntry + operationId: deleteOrgServiceAccountAccessListEntry parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59645,14 +60246,15 @@ paths: summary: Remove One Access List Entry from One Organization Service Account tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteServiceAccountAccessListEntry + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteOrgServiceAccountAccessListEntry x-xgen-method-verb-override: - customMethod: "True" + customMethod: true verb: deleteEntry + x-xgen-operation-id-override: deleteOrgAccessEntry /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/groups: get: description: Returns a list of all projects the specified Service Account is a part of. - operationId: listServiceAccountProjects + operationId: getOrgServiceAccountGroups parameters: - $ref: '#/components/parameters/orgId' - description: The Client ID of the Service Account. @@ -59674,8 +60276,8 @@ paths: schema: $ref: '#/components/schemas/PaginatedServiceAccountGroup' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation - xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. + xgen-IPA-104-get-method-returns-single-resource: API predates IPA validation. x-xgen-version: "2024-08-05" description: OK "401": @@ -59689,11 +60291,12 @@ paths: summary: Return All Service Account Project Assignments tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/listServiceAccountProjects + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/getOrgServiceAccountGroups + x-xgen-operation-id-override: getServiceAccountGroups /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/secrets: post: description: Create a secret for the specified Service Account. - operationId: createServiceAccountSecret + operationId: createOrgServiceAccountSecret parameters: - $ref: '#/components/parameters/orgId' - description: The Client ID of the Service Account. @@ -59734,11 +60337,12 @@ paths: summary: Create One Organization Service Account Secret tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createServiceAccountSecret + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/createOrgServiceAccountSecret + x-xgen-operation-id-override: createOrgSecret /api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}/secrets/{secretId}: delete: description: Deletes the specified Service Account secret. - operationId: deleteServiceAccountSecret + operationId: deleteOrgServiceAccountSecret parameters: - description: The Client ID of the Service Account. in: path @@ -59774,11 +60378,12 @@ paths: summary: Delete One Organization Service Account Secret tags: - Service Accounts - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteServiceAccountSecret + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Service-Accounts/operation/deleteOrgServiceAccountSecret + x-xgen-operation-id-override: deleteOrgSecret /api/atlas/v2/orgs/{orgId}/settings: get: description: Returns details about the specified organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Member role. - operationId: getOrganizationSettings + operationId: getOrgSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59790,7 +60395,7 @@ paths: schema: $ref: '#/components/schemas/OrganizationSettings' x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -59804,10 +60409,10 @@ paths: summary: Return Settings for One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrganizationSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/getOrgSettings patch: description: Updates the organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. - operationId: updateOrganizationSettings + operationId: updateOrgSettings parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59842,14 +60447,14 @@ paths: summary: Update Settings for One Organization tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganizationSettings + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrgSettings /api/atlas/v2/orgs/{orgId}/teams: get: description: Returns all teams that belong to the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud only returns teams for which you have access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: listOrganizationTeams + operationId: listOrgTeams parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/itemsPerPage' @@ -59878,13 +60483,13 @@ paths: summary: Return All Teams in One Organization tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/listOrganizationTeams + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/listOrgTeams post: description: Creates one team in the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud limits the number of teams to a maximum of 250 teams per organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: createTeam + operationId: createOrgTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59919,14 +60524,14 @@ paths: summary: Create One Team in One Organization tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/createTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/createOrgTeam /api/atlas/v2/orgs/{orgId}/teams/{teamId}: delete: description: Removes one team specified using its unique 24-hexadecimal digit identifier from the organization specified using its unique 24-hexadecimal digit identifier. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: deleteTeam + operationId: deleteOrgTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59957,13 +60562,13 @@ paths: summary: Remove One Team from One Organization tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/deleteTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/deleteOrgTeam get: description: Returns one team that you identified using its unique 24-hexadecimal digit ID. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: getTeamById + operationId: getOrgTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -59996,13 +60601,13 @@ paths: summary: Return One Team by ID tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getTeamById + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getOrgTeam patch: description: Renames one team in the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: renameTeam + operationId: renameOrgTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60044,7 +60649,7 @@ paths: summary: Rename One Team tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/renameTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/renameOrgTeam x-xgen-method-verb-override: customMethod: "True" verb: rename @@ -60059,7 +60664,7 @@ paths: externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: listTeamUsers + operationId: listOrgTeamUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/itemsPerPage' @@ -60119,7 +60724,8 @@ paths: summary: Return All MongoDB Cloud Users Assigned to One Team tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listTeamUsers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listOrgTeamUsers + x-xgen-operation-id-override: listTeamUsers post: deprecated: true description: |- @@ -60129,7 +60735,7 @@ paths: externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: addTeamUser + operationId: addOrgTeamUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60174,10 +60780,11 @@ paths: summary: Assign MongoDB Cloud Users in One Organization to One Team tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/addTeamUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/addOrgTeamUsers x-xgen-method-verb-override: customMethod: "True" verb: add + x-xgen-operation-id-override: addTeamUsers /api/atlas/v2/orgs/{orgId}/teams/{teamId}/users/{userId}: delete: deprecated: true @@ -60188,7 +60795,7 @@ paths: externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: removeTeamUser + operationId: removeOrgTeamUserFromTeam parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60227,10 +60834,11 @@ paths: summary: Remove One MongoDB Cloud User from One Team tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/removeTeamUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/removeOrgTeamUserFromTeam x-xgen-method-verb-override: customMethod: "True" - verb: remove + verb: removeFromTeam + x-xgen-operation-id-override: removeUserFromTeam /api/atlas/v2/orgs/{orgId}/teams/{teamId}:addUser: post: description: |- @@ -60240,7 +60848,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project endpoint' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/updateProjectInvitation - operationId: addUserToTeam + operationId: addOrgTeamUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60280,7 +60888,7 @@ paths: summary: Add One MongoDB Cloud User to One Team tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addUserToTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addOrgTeamUser /api/atlas/v2/orgs/{orgId}/teams/{teamId}:removeUser: post: description: |- @@ -60290,7 +60898,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeUserFromTeam + operationId: removeOrgTeamUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60330,14 +60938,14 @@ paths: summary: Remove One MongoDB Cloud User from One Team tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeUserFromTeam + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrgTeamUser /api/atlas/v2/orgs/{orgId}/teams/byName/{teamName}: get: description: Returns one team that you identified using its human-readable name. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. externalDocs: description: Manage Organization Teams url: https://docs.atlas.mongodb.com/access/manage-teams-in-orgs/#std-label-manage-teams - operationId: getTeamByName + operationId: getOrgTeamByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60369,7 +60977,8 @@ paths: summary: Return One Team by Name tags: - Teams - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getTeamByName + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Teams/operation/getOrgTeamByName + x-xgen-operation-id-override: getTeamByName /api/atlas/v2/orgs/{orgId}/users: get: description: |- @@ -60381,7 +60990,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: listOrganizationUsers + operationId: listOrgUsers parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60427,13 +61036,13 @@ paths: summary: Return All MongoDB Cloud Users in One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listOrganizationUsers + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/listOrgUsers post: description: |- Invites one new or existing MongoDB Cloud user to join the organization. The invitation to join the organization will be sent to the username provided and must be accepted within 30 days. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. **Note**: If the user does not have an existing MongoDB Cloud account, they will be prompted to finish setting up an account upon accepting the invitation. If the user already has an account, they will still receive an invitation to access the organization. - operationId: createOrganizationUser + operationId: createOrgUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60468,7 +61077,7 @@ paths: summary: Add One MongoDB Cloud User to One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/createOrganizationUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/createOrgUser /api/atlas/v2/orgs/{orgId}/users/{userId}: delete: description: |- @@ -60480,7 +61089,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeOrganizationUser + operationId: removeOrgUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60516,7 +61125,7 @@ paths: summary: Remove One MongoDB Cloud User from One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrganizationUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrgUser x-xgen-method-verb-override: customMethod: "True" verb: remove @@ -60527,7 +61136,7 @@ paths: **Note**: This resource can only be used to fetch information about MongoDB Cloud human users. To return information about an API Key, use the [Return One Organization API Key](#tag/Programmatic-API-Keys/operation/getApiKey) endpoint. **Note**: This resource does not return information about pending users invited via the deprecated [Invite One MongoDB Cloud User to Join One Project](#tag/Projects/operation/createProjectInvitation) endpoint. - operationId: getOrganizationUser + operationId: getOrgUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60560,7 +61169,7 @@ paths: summary: Return One MongoDB Cloud User in One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getOrganizationUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getOrgUser patch: description: |- Updates one MongoDB Cloud user in the specified organization. You can update an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -60571,7 +61180,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: updateOrganizationUser + operationId: updateOrgUser parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60611,12 +61220,12 @@ paths: summary: Update One MongoDB Cloud User in One Organization tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/updateOrganizationUser + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/updateOrgUser /api/atlas/v2/orgs/{orgId}/users/{userId}/roles: put: deprecated: true description: Updates the roles of the specified user in the specified organization. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization User Admin role. - operationId: updateOrganizationRoles + operationId: updateOrgUserRoles parameters: - $ref: '#/components/parameters/orgId' - description: Unique 24-hexadecimal digit string that identifies the user to modify. @@ -60655,7 +61264,7 @@ paths: summary: Update Organization Roles for One MongoDB Cloud User tags: - Organizations - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrganizationRoles + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Organizations/operation/updateOrgUserRoles /api/atlas/v2/orgs/{orgId}/users/{userId}:addRole: post: description: |- @@ -60667,7 +61276,7 @@ paths: externalDocs: description: 'Deprecated: Invite One MongoDB Cloud User to Join One Project' url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: addOrganizationRole + operationId: addOrgUserRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60709,7 +61318,8 @@ paths: summary: Add One Organization Role to One MongoDB Cloud User tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addOrganizationRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/addOrgUserRole + x-xgen-operation-id-override: addOrgRole /api/atlas/v2/orgs/{orgId}/users/{userId}:removeRole: post: description: |- @@ -60721,7 +61331,7 @@ paths: externalDocs: description: Invite One MongoDB Cloud User to Join One Project url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Projects/operation/createProjectInvitation - operationId: removeOrganizationRole + operationId: removeOrgUserRole parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/orgId' @@ -60761,11 +61371,12 @@ paths: summary: Remove One Organization Role from One MongoDB Cloud User tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrganizationRole + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/removeOrgUserRole + x-xgen-operation-id-override: removeOrgRole /api/atlas/v2/unauth/controlPlaneIPAddresses: get: description: Returns all control plane IP addresses. - operationId: returnAllControlPlaneIpAddresses + operationId: listControlPlaneIpAddresses parameters: - $ref: '#/components/parameters/envelope' responses: @@ -60775,9 +61386,9 @@ paths: schema: $ref: '#/components/schemas/ControlPlaneIPAddresses' x-xgen-IPA-exception: - xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation - xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation - xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation + xgen-IPA-110-collections-response-define-links-array: Content predates IPA validation. + xgen-IPA-110-collections-response-define-results-array: Content predates IPA validation. + xgen-IPA-110-collections-use-paginated-prefix: Content predates IPA validation. x-xgen-version: "2023-11-15" description: OK "500": @@ -60786,7 +61397,8 @@ paths: summary: Return All Control Plane IP Addresses tags: - Root - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Root/operation/returnAllControlPlaneIpAddresses + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Root/operation/listControlPlaneIpAddresses + x-xgen-operation-id-override: listControlPlaneAddresses /api/atlas/v2/users: post: deprecated: true @@ -60854,7 +61466,7 @@ paths: $ref: '#/components/schemas/CloudAppUser' x-sunset: "9999-12-31" x-xgen-IPA-exception: - xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation + xgen-IPA-104-get-method-returns-response-suffixed-object: API predates IPA validation. x-xgen-version: "2023-01-01" description: OK "401": @@ -60876,7 +61488,7 @@ paths: externalDocs: description: Return One Organization API Key url: https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Programmatic-API-Keys/operation/getApiKey - operationId: getUserByUsername + operationId: getUserByName parameters: - $ref: '#/components/parameters/envelope' - $ref: '#/components/parameters/pretty' @@ -60907,7 +61519,7 @@ paths: summary: Return One MongoDB Cloud User by Username tags: - MongoDB Cloud Users - x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getUserByUsername + x-xgen-docs-url: https://mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/MongoDB-Cloud-Users/operation/getUserByName security: - ServiceAccounts: [] - DigestAuth: []