DOCSP-11137 doc for datalake create command (#144)

Author: kanchana-mongodb

source/reference/atlas.txt

@@ -15,6 +15,10 @@ Atlas ``mongocli`` Commands
 :ref:`cluster <mcli-reference-atlas-cluster>`
   Manage your |service| cluster configurations.
 
+:ref:`datalake <mcli-reference-atlas-datalake>`
+  Manage `Data Lakes <https://docs.mongodb.com/datalake/>`__ associated 
+  with an |service| project.
+
 :ref:`dbuser <mcli-reference-atlas-dbuser>`
   Manage MongoDB database users.
 
@@ -34,11 +38,6 @@ Atlas ``mongocli`` Commands
 :ref:`whitelist <mcli-reference-atlas-whitelist>`
   Manage :atlas:`whitelist </security-whitelist/>` entries.
 
-:ref:`datalake <mcli-reference-atlas-datalake>`
-  Retrieve information about `Data Lakes
-  <https://docs.mongodb.com/datalake/>`__ associated with an |service|
-  project.
-
 .. class:: hidden
 
    .. toctree::

source/reference/atlas/datalake-commands.txt

@@ -10,4 +10,5 @@ Atlas ``datalake`` Commands
    :titlesonly:
 
    List Data Lakes </reference/atlas/datalake-list>
-   Describe a Data Lake </reference/atlas/datalake-describe>
+   Describe a Data Lake </reference/atlas/datalake-describe>
+   Create a Data Lake </reference/atlas/datalake-create>

source/reference/atlas/datalake-create.txt

@@ -0,0 +1,163 @@
+.. _mcli-atlas-datalake-create-command:
+
+==============================
+mongocli atlas datalake create
+==============================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The ``datalake create`` command creates a MongoDB {+data-lake+}. You can also 
+create a {+data-lake-short+} through the |service| 
+`UI <https://docs.mongodb.com/datalake/tutorial/getting-started>`_ or `API 
+<https://docs.mongodb.com/datalake/reference/api/dataLakes-create-one-tenant>`_.
+
+.. _mcli-atlas-datalake-create-syntax:
+
+Syntax 
+------
+
+.. code-block:: text 
+
+   mongocli atlas datalake create <datalake-name>    
+        [ --profile|-P <profile-name> ]
+        [ --projectId <project-ID> ]
+
+.. _mcli-atlas-datalake-create-options: 
+
+Options 
+-------
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 10 60 10
+
+   * - Option
+     - Type
+     - Description
+     - Required?
+
+   * - ``<datalake-name>``
+     - string
+     - Name of the {+data-lake-short+}. 
+     - yes
+
+   * - ``--profile``, ``-P``
+     - string
+     - Name of the profile where the public and private 
+       keys for the project are set. 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 where you want to
+       create the cluster. If omitted, uses the project ID in
+       the profile or :ref:`environment variable <mcli-env-var>`.
+     - no
+
+.. _mcli-atlas-datalake-create-output:
+
+Output 
+------
+
+.. include:: /includes/command-output-intro.rst
+
+.. list-table::
+   :header-rows: 1
+   :widths: 10 10 80
+
+   * - Name
+     - Type
+     - Description
+
+   * - ``cloudProviderConfig``
+     - object
+     - Configuration information related to the cloud service where 
+       {+data-lake-short+} source data is stored.
+
+   * - ``cloudProviderConfig.aws``
+     - object
+     - Name of the provider of the cloud service where {+data-lake-short+} 
+       can access the S3 Bucket data stores.
+
+   * - ``dataProcessRegion``
+     - object
+     - Cloud provider region to which Atlas Data Lake routes client connections 
+       for data processing. If ``null``, {+data-lake-short+} routes client 
+       connections to the region nearest to the client based on DNS resolution.
+
+   * - ``groupId``
+     - string
+     - Unique identifier for the project.
+
+   * - ``hostnames``
+     - array
+     - The list of hostnames assigned to the {+data-lake-short+}. Each string in 
+       the array is a hostname assigned to the {+data-lake-short+}.
+
+   * - ``name``
+     - string
+     - Name of the {+data-lake-short+}.
+
+   * - ``state``
+     - string
+     - Current state of the {+data-lake-short+}:
+
+       - ``ACTIVE`` - The {+data-lake-short+} is active and verified. You can 
+         query the {+data-lake-stores+} associated to the {+data-lake-short+}.
+
+       - ``UNVERIFIED`` - The {+data-lake-short+} has an incomplete 
+         configuration *or* the provided credentials do not grant the access 
+         to the {+data-lake-stores+}. 
+         
+
+         For |aws| specifically, the provided 
+         ``cloudProviderConfig.aws.iamAssumedRoleARN`` must grant access to 
+         the |aws| S3 buckets associated with any {+data-lake-stores+}.
+   
+   * - ``storage``
+     - object
+     - Configuration details for each {+data-lake-store+} and its
+       mapping to MongoDB database(s) and collection(s). An empty object indicates that the Data Lake has no mapping configuration for any data store.
+
+.. _mcli-atlas-datalake-create-egs:
+
+Examples 
+--------
+
+The following example uses the ``mongocli atlas datalake create`` command to 
+create a {+data-lake-short+} named ``myDL`` in the specified project. It uses 
+the {+default-profile+} to access the project.
+
+.. code-block:: sh
+   :copyable: false 
+
+   mongocli atlas datalake create myDL
+
+The previous command prints the following fields in |json| format to the 
+terminal. To learn more about these fields, see 
+:ref:`mcli-atlas-datalake-create-output`.
+
+.. code-block:: json 
+   :copyable: false 
+
+   {
+	 "cloudProviderConfig": {
+		"aws": {}
+   },
+	 "dataProcessRegion": {},
+	 "groupId": "5e2211c17a3e5a48f5497de3",
+	 "hostnames": [
+		"mydl-7hgjn.a.query.mongodb-dev.net"
+	 ],
+	 "name": "myDL",
+	 "state": "UNVERIFIED",
+	 "storage": {}
+   }