Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
.. _atlas-api-sandbox-generateSandboxClusterDescription:

===================================================
atlas api sandbox generateSandboxClusterDescription
===================================================

.. default-domain:: mongodb

.. contents:: On this page
:local:
:backlinks: none
:depth: 1
:class: singlecol

Return cluster description from sandbox template configuration.

The atlas api sub-command is automatically generated from the MongoDB Atlas Admin API and offers full coverage of the Admin API.
Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link.
Admin API capabilities have their own release lifecycle, which you can check using the provided API endpoint documentation link.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updated


This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-generategroupsandboxclusterdescription.

For more information and examples, see the referenced API documentation linked above.

Syntax
------

.. code-block::
:caption: Command Syntax

atlas api sandbox generateSandboxClusterDescription [options]

.. Code end marker, please don't delete this comment

Options
-------

.. list-table::
:header-rows: 1
:widths: 20 10 10 60

* - Name
- Type
- Required
- Description
* - --envelope
-
- false
- flag that indicates whether Application wraps the response in an envelope JSON object
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- flag that indicates whether Application wraps the response in an envelope JSON object
- Flag that indicates whether Application wraps the response in an envelope JSON object.

* - --groupId
- string
- true
- unique 24-hexadecimal digit string that identifies your project
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- unique 24-hexadecimal digit string that identifies your project
- Unique 24-hexadecimal digit string that identifies your project.

* - -h, --help
-
- false
- help for generateSandboxClusterDescription
* - -o, --output
- string
- false
- preferred api format, can be ["json", go-template] This value defaults to "json".
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- preferred api format, can be ["json", go-template] This value defaults to "json".
- Preferred api format. Value can be ["json", go-template]. If omitted, defaults to "json".

* - --outputFile
- string
- false
- file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- file to write the api output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip)
- File to write the API output to. This flag is required when the output of an endpoint is binary (ex: gzip) and the command is not piped (ex: atlas command > out.zip).

* - --pretty
-
- false
- flag that indicates whether the response body should be in the prettyprint format
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- flag that indicates whether the response body should be in the prettyprint format
- Flag that indicates whether the response body should be in the prettyprint format.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

updating this one since it's our own flag

* - --sandboxConfigId
- string
- true
- unique 24-hexadecimal digit string that identifies the sandbox configuration
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- unique 24-hexadecimal digit string that identifies the sandbox configuration
- Unique 24-hexadecimal digit string that identifies the sandbox configuration.

* - --version
- string
- false
- api version to use when calling the api call [options: "preview"], defaults to the latest version or the profiles api_version config value if set This value defaults to "preview".

Inherited Options
-----------------

.. list-table::
:header-rows: 1
:widths: 20 10 10 60

* - Name
- Type
- Required
- Description
* - -P, --profile
- string
- false
- Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.

64 changes: 64 additions & 0 deletions docs/command/atlas-api-sandbox.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
.. _atlas-api-sandbox:

=================
atlas api sandbox
=================

.. default-domain:: mongodb

.. contents:: On this page
:local:
:backlinks: none
:depth: 1
:class: singlecol

Returns, adds, edits, and removes sandbox templates.

The atlas api sub-command is automatically generated from the MongoDB Atlas Admin API and offers full coverage of the Admin API.
Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Admin API capabilities have their own release lifecycle, which you can check via the provided API endpoint documentation link.
Admin API capabilities have their own release lifecycle, which you can check using the provided API endpoint documentation link.


Also enables/disables sandbox for an organization.

Options
-------

.. list-table::
:header-rows: 1
:widths: 20 10 10 60

* - Name
- Type
- Required
- Description
* - -h, --help
-
- false
- help for sandbox

Inherited Options
-----------------

.. list-table::
:header-rows: 1
:widths: 20 10 10 60

* - Name
- Type
- Required
- Description
* - -P, --profile
- string
- false
- Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.

Related Commands
----------------

* :ref:`atlas-api-sandbox-generateSandboxClusterDescription` - Return cluster description from sandbox template configuration.


.. toctree::
:titlesonly:

generateSandboxClusterDescription </command/atlas-api-sandbox-generateSandboxClusterDescription>

2 changes: 2 additions & 0 deletions docs/command/atlas-api.txt
Original file line number Diff line number Diff line change
Expand Up @@ -215,6 +215,7 @@ Related Commands
* :ref:`atlas-api-resourcePolicies` - Configure and manage Atlas Resource Policies within your organization.
* :ref:`atlas-api-rollingIndex` - Creates one index to a database deployment in a rolling manner.
* :ref:`atlas-api-root` - Returns details that describe the MongoDB Cloud build and the access token that requests this resource.
* :ref:`atlas-api-sandbox` - Returns, adds, edits, and removes sandbox templates.
* :ref:`atlas-api-serverlessInstances` - Returns, adds, edits, and removes serverless instances.
* :ref:`atlas-api-serverlessPrivateEndpoints` - Returns, adds, edits, and removes private endpoints for serverless instances.
* :ref:`atlas-api-serviceAccounts` - Endpoints for managing Service Accounts and secrets.
Expand Down Expand Up @@ -270,6 +271,7 @@ Related Commands
resourcePolicies </command/atlas-api-resourcePolicies>
rollingIndex </command/atlas-api-rollingIndex>
root </command/atlas-api-root>
sandbox </command/atlas-api-sandbox>
serverlessInstances </command/atlas-api-serverlessInstances>
serverlessPrivateEndpoints </command/atlas-api-serverlessPrivateEndpoints>
serviceAccounts </command/atlas-api-serviceAccounts>
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
deleteOrgSandboxConfig --version preview --orgId 4888442a3354817a7320eb61 --sandboxConfigId 507f1f77bcf86cd799439011
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
getOrgSandboxConfig --version preview --orgId 4888442a3354817a7320eb61 --sandboxConfigId 507f1f77bcf86cd799439011
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
listOrgSandboxConfig --version preview --orgId 4888442a3354817a7320eb61
Loading
Loading