(DOCSP-13963): Added page and navigation for the privateendpoint <provider> create command. (#460)

* (DOCSP-13963): Added page and navigation for the privateendpoint <provider> create command.

* (DOCSP-13963): Updated link.

* (DOCSP-13963): Incorporated Chris's feedback.

Author: corryroot

source/includes/extracts-basic-options.yaml

@@ -5,7 +5,7 @@ content: |
   - ``json`` for output in |json| format 
   - ``go-template`` for custom output using the :ref:`Go template 
     <go-template-output>`
-  - ``go-template-file`` for custom output specified using :ref:`Go 
+  - ``go-template-file`` for custom output specified using the :ref:`Go 
     template <go-template-output>` file
   
   If omitted, the command returns output in the default format.

source/reference/atlas/private-endpoint-commands-new.txt

@@ -10,3 +10,5 @@ Atlas ``privateEndpoint`` Commands
    :titlesonly:
 
    Get One Private Endpoint Service for One Provider </reference/atlas/private-endpoint-provider-describe>
+
+   Create One Private Endpoint Service for One Provider </reference/atlas/private-endpoint-provider-create>

source/reference/atlas/private-endpoint-provider-create.txt

@@ -0,0 +1,152 @@
+.. _mcli-atlas-private-endpoint-provider-create-cmd:
+
+================================================
+mongocli atlas privateendpoint <provider> create
+================================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The ``privateendpoint <provider> create`` command creates one private 
+endpoint connection for |aws| or Azure in an |service| project. You can 
+also create a private endpoint connections through the |service| 
+:atlas:`UI </security-private-endpoint/>` or :atlas:`API 
+</reference/api/private-endpoints-service-create-one/>`.
+
+Syntax 
+------
+
+.. code-block:: text 
+
+   mongocli atlas privateendpoint(s)|privateEndpoint(s) aws|azure create
+        --region <cloud-provider-region>
+        [ --output|-o <output-format> ]
+        [ --profile|-P <profile-name> ]
+        [ --projectId <project-ID> ]
+
+.. include:: /includes/fact-command-line-help.rst
+
+.. _atlas-private-endpoint-provider-create-options:
+
+Options 
+-------
+
+.. list-table::
+   :widths: 20 10 60 10
+   :header-rows: 1
+
+   * - Option 
+     - Type
+     - Description
+     - Required?
+
+   * - ``--region``
+     - string
+     - Cloud provider region in which you want to create the private
+       endpoint connection.
+
+       .. note::
+
+          |service| supports private endpoint connections only for
+          |aws|.
+
+          See the :atlas:`Atlas documentation
+          </security-private-endpoint/#limitations>` for limitations on
+          the number of private endpoints you can create in different
+          regions.
+
+       See the supported region values for the following providers:
+
+       - :atlas:`AWS </reference/amazon-aws>`
+       - :atlas:`Azure </reference/microsoft-azure>`
+
+     - yes
+
+   * - ``--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
+
+.. _atlas-private-endpoint-provider-create-output:
+
+Output
+------
+
+If the command succeeds, it returns the following output in the default
+format. If the command returns errors, see
+:ref:`Troubleshooting <troubleshooting>` for recommended solutions.
+
+.. code-block:: sh
+   :copyable: false
+
+   Private endpoint '<private-endpoint-id>' created.
+
+.. include:: /includes/fact-default-output.rst
+
+- :atlas:`Atlas API </reference/api/private-endpoints-service-create-one/#response-elements>`
+
+Example
+-------
+
+.. tabs::
+
+   .. tab:: Default Output
+      :tabid: default-output
+
+      The following command creates one private endpoint connection
+      for |aws| in a project using the {+default-profile+}, which 
+      contains credentials and the project ID. The output is returned 
+      in the default format.
+
+      .. code-block:: sh
+
+         mongocli atlas privateendpoint aws create --region us-east-1
+
+      The previous command prints the following to the terminal.
+
+      .. code-block:: sh
+         :copyable: false
+
+         Private endpoint '5f4fc829a2b47835a58c6d04' created.
+
+   .. tab:: JSON Output
+      :tabid: json-output
+
+      The following command creates one private endpoint connection
+      for |aws| in a project using the {+default-profile+}, which 
+      contains credentials and the project ID. The output is returned 
+      in |json| format.
+
+      .. code-block:: sh
+
+         mongocli atlas privateendpoint aws create --region us-east-1 --output json
+
+      The previous command prints the following to the terminal in
+      |json| format.
+
+      .. code-block:: json
+         :copyable: false
+
+         {
+           "id": "5f4fc81c1f03a835c2728ff7",
+           "status": "INITIATING"
+         }
+

source/reference/atlas/privateendpoint-create.txt

@@ -12,6 +12,12 @@ mongocli atlas privateendpoint create
    :depth: 1
    :class: singlecol
 
+.. important:: Deprecated
+
+   This command is deprecated. Use
+   :doc:`Create One Private Endpoint Service for One Provider
+   </reference/atlas/private-endpoint-provider-create>` instead.
+
 The ``privateendpoint create`` command creates one private endpoint
 connection for a given |service| project.