DOCSP-11156: [mongocli] mongocli atlas clusters onlinearchive describe (#161)

Author: steveren

source/reference/atlas/onlinearchive-commands.txt

@@ -13,8 +13,9 @@ Atlas Online Archive Commands
    :titlesonly:
 
    List Online Archives </reference/atlas/onlinearchive-list>
+   Describe an Online Archive </reference/atlas/onlinearchive-describe>
    Create an Online Archive </reference/atlas/onlinearchive-create>
    Modify an Online Archive </reference/atlas/onlinearchive-update>
    Start an Online Archive </reference/atlas/onlinearchive-start>
    Pause an Active Online Archive </reference/atlas/onlinearchive-pause>
-   
+      

source/reference/atlas/onlinearchive-describe.txt

@@ -0,0 +1,133 @@
+.. _mcli-atlas-cluster-onlinearchive-describe-command:
+
+=============================================
+mongocli atlas cluster onlinearchive describe
+=============================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+.. include:: /includes/fact-online-archive-beta.rst
+
+The ``onlinearchive describe`` command retrieves the configuration of one
+:atlas:`online archive </online-archive/manage-online-archive/>` for the
+specified cluster. You can also view the configuration of an online archive
+through the |service| :atlas:`UI </online-archive/view-online-archives/>` or :atlas:`API 
+</reference/api/online-archive-get-one/>`.
+
+.. _mcli-atlas-cluster-online-archive-describe-syntax:
+
+Syntax 
+------
+
+.. code-block:: text 
+
+   mongocli atlas cluster onlinearchive describe <online-archive-id> 
+        --clusterName <cluster-name>
+        [ --profile|-P <profile-name> ]
+        [ --projectId <project-ID> ]
+
+.. _mcli-atlas-cluster-onlinearchive-describe-options: 
+
+Options 
+-------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 10 60 10
+
+   * - Option
+     - Type
+     - Description
+     - Required?
+
+   * - ``<online-archive-id>``
+     - string 
+     - Unique identifier of the online archive to describe.
+     - yes
+
+   * - ``--clusterName``
+     - string
+     - Name of the cluster. 
+     - yes
+
+   * - ``--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
+     - Unique identifier of the project that contains the 
+       cluster. If omitted, uses the project ID in the profile or 
+       :ref:`environment variable <mcli-env-var>`.
+     - no
+
+.. _mcli-atlas-cluster-onlinearchive-describe-output: 
+
+Output 
+------
+
+.. include:: /includes/command-output-intro.rst
+
+.. include:: /includes/atlas-online-archive-output.rst
+
+.. _mcli-atlas-cluster-onlinearchive-describe-egs:
+
+Example 
+-------
+
+The following example uses the ``mongocli atlas cluster onlinearchive describe``
+command to retrieve the online archives configured for the cluster named 
+``myTestCluster``. The command uses the {+default-profile+} to access the 
+project.
+
+.. code-block:: sh 
+   
+   mongocli atlas cluster onlinearchive describe 5f189832e26ec075e10c32d3 --clusterName myTestCluster
+
+The previous command prints the following fields in |json| format to 
+the terminal. To learn more about these fields, see 
+:ref:`mcli-atlas-cluster-onlinearchive-describe-output`.
+
+.. code-block:: json 
+   :copyable: false 
+
+	 {
+		"_id": "5f189832e26ec075e10c32d3",
+		"clusterName": "myTestCluster",
+		"collName": "movies",
+		"criteria": {
+			"dateField": "released",
+			"expireAfterDays": 2
+		},
+		"dbName": "sample_mflix",
+		"groupId": "5e2211c17a3e5a48f5497de3",
+		"partitionFields": [
+			{
+				"fieldName": "title",
+				"fieldType": "string",
+				"order": 0
+			},
+			{
+				"fieldName": "year",
+				"fieldType": "int",
+				"order": 1
+			},
+			{
+				"fieldName": "released",
+				"fieldType": "date",
+				"order": 2
+			}
+		],
+		"paused": false,
+		"state": "ACTIVE"
+	 }