DOCSP-14136 doc for atlas cluster connectionString describe cmd (#493)

* DOCSP-14136 doc for atlas cluster connectionString describe cmd

* DOCSP-14136 updates for copy review feedback

* DOCSP-14136 updates for feedback

Author: kanchana-mongodb

source/reference/atlas/cluster-commands.txt

@@ -17,6 +17,7 @@ Atlas ``cluster`` Commands
    Pause a Cluster </reference/atlas/cluster-pause>
    Resume a Cluster </reference/atlas/cluster-start>
    Watch a Cluster </reference/atlas/cluster-watch>
+   Retrieve the Connection String for a Cluster </reference/atlas/cluster-connectionstring-describe>
    Atlas Search </reference/atlas/search-commands>
    Online Archives </reference/atlas/onlinearchive-commands>
    Create a Rolling Index </reference/atlas/clusters-indexes-create>

source/reference/atlas/cluster-connectionstring-describe.txt

@@ -0,0 +1,192 @@
+.. _mcli-atlas-cluster-cs-describe-cmd:
+
+================================================
+mongocli atlas cluster connectionString describe  
+================================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The ``cluster connectionString describe`` command retrieves the unique 
+connection string specific to the specified |service| cluster. You 
+can also retrieve the connection string using the |service| 
+:atlas:`UI </tutorial/connect-to-your-cluster/>` and :atlas:`API 
+</reference/api/clusters-get-one/>`.
+
+.. _mcli-atlas-cluster-cs-describe-syntax:
+
+Syntax 
+------
+
+.. code-block:: shell 
+
+   mongocli atlas cluster connectionString|cs describe|get <cluster-name>
+        [ --output|-o <output-format> ]
+        [ --type <connection-string-type> ]
+        [ --profile|-P <profile-name> ]
+        [ --projectId <project-ID> ]
+
+.. include:: /includes/fact-command-line-help.rst
+
+.. _mcli-atlas-cluster-cs-describe-args:
+
+Arguments 
+---------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 10 60 10
+
+   * - Option
+     - Type
+     - Description  
+     - Required?
+
+   * - ``<cluster-name>``
+     - string
+     - Name of the cluster.
+     - yes
+
+.. _mcli-atlas-cluster-cs-describe-options:
+
+Options 
+-------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 10 60 10
+
+   * - Option
+     - Type
+     - Description  
+     - Required?
+
+   * - ``--output``, ``-o``
+     - string 
+     - .. include:: /includes/extracts/fact-basic-options-output.rst
+     - no
+
+   * - ``--profile``, ``-P``
+     - string
+     - Name of the profile where the public and private 
+       keys for the project are saved. If omitted, uses the 
+       {+default-profile+}. To learn more about creating a 
+       profile, see :ref:`mcli-configure`.
+     - no
+
+   * - ``--projectId``
+     - string
+     - .. include:: /includes/extracts/fact-basic-options-project-id.rst
+     - no
+
+   * - ``--type``
+     - string 
+     - Type of connection string to retrieve. You can specify one of 
+       the following:
+
+       - ``standard`` - for public :manual:`connection string 
+         </reference/connection-string/>` (default)
+       - ``private`` - for :atlas:`private-endpoint-aware 
+         </security-private-endpoint/#std-label-private-endpoint-connection-strings>` 
+         :manual:`connection string </reference/connection-string/>`.
+
+       If omitted, defaults to ``standard``.
+
+     - no
+
+.. _mcli-atlas-cluster-cs-describe-output:
+
+Output 
+------
+
+If the command succeeds, the command prints the following to the terminal in the default format. 
+
+.. code-block:: shell 
+   :copyable: false 
+
+   STANDARD CONNECTION STRING
+   <connection-string>
+
+If the command succeeds, the command prints the following fields if you 
+requested output in |json| format.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 10 70
+
+   * - Option
+     - Type
+     - Description
+
+   * - ``standard`` 
+     - string 
+     - Public ``mongodb://`` :manual:`connection string 
+       </reference/connection-string/>` for the cluster.
+
+   * - ``standardSrv`` 
+     - string 
+     - Public ``mongodb+srv://`` :manual:`connection string 
+       </reference/connection-string/>` for the cluster. The 
+       ``mongodb+srv`` protocol tells the driver to look up the 
+       :manual:`seed List </reference/connection-string/#dns-seed-list-connection-format>` 
+       of hosts in |dns|. |service| synchronizes this list with the 
+       nodes in a cluster. If the connection string uses this URI 
+       format, you don't need to:
+
+       - Append the seed list or
+       - Change the |URI if the nodes change.
+
+       You can use this URI format if your driver supports it. 
+
+If the command returns errors, see :ref:`Troubleshooting 
+<mcli-troubleshooting>` for recommended solutions. 
+
+.. _mcli-atlas-cluster-cs-describe-egs:
+
+Examples 
+--------
+
+The following examples use the ``mongocli atlas cluster cs describe`` 
+command to retrieve the standard connection string for a cluster named 
+``myCluster`` in the default format and |json| format. It uses the 
+{+default-profile+} to access the project.
+
+.. tabs:: 
+
+   .. tab:: Default 
+      :tabid: default
+
+      .. code-block:: text
+
+         mongocli atlas cluster cs describe myCluster
+
+      The previous command prints the following output to the terminal: 
+
+      .. code-block:: shell 
+         :copyable: false
+
+         STANDARD CONNECTION STRING
+         mongodb+srv://myCluster.7hgjn.mongodb.net
+
+   .. tab:: JSON 
+      :tabid: json
+
+      .. code-block:: text
+         :copyable: false
+
+         mongocli atlas cluster cs describe myCluster --output json 
+
+      The previous command prints the following output to the terminal: 
+
+      .. code-block:: shell 
+         :copyable: false
+
+         {
+           "standard": "mongodb://myCluster-shard-00-00.7hgjn.mongodb.net:27017,myCluster-shard-00-01.7hgjn.mongodb.net:27017,myCluster-shard-00-02.7hgjn.mongodb.net:27017/?ssl=true\u0026authSource=admin\u0026replicaSet=atlas-y1l294-shard-0",
+           "standardSrv": "mongodb+srv://myCluster.7hgjn.mongodb.net"
+         }