(DOCSP-10374) mongocli iam organization create (#111)

* (DOCSP-10374) mongocli iam organization create

Author: zach-carr

source/includes/atlas-snapshots-list-output-fields.rst

@@ -142,4 +142,4 @@
      - The type of server that the part represents:
 
        - ``REPLICA_SET``
-       - ``CONFIG_SERVER_REPLICA_SET``
+       - ``CONFIG_SERVER_REPLICA_SET``

source/reference/access.txt

@@ -13,11 +13,12 @@
    :class: singlecol
 
 ``iam``
-----------
+-------
 
-The mongocli ``iam`` command allows you to list, create, and delete projects
-in a specified organization.
+The mongocli ``iam`` command allows you to create organizations and 
+list, create, and delete projects in a specified organization.
 
+- :ref:`Create an organization <mcli-iam-organization-create>`
 - :ref:`List projects <mcli-iam-project-list>`
 - :ref:`Create a project <mcli-iam-project-create>`
 - :ref:`Delete a project <mcli-iam-project-delete>`
@@ -27,6 +28,7 @@ in a specified organization.
    .. toctree::
       :titlesonly:
 
+      Create an Organization </reference/iam-organization-create>
       List Projects </reference/iam-project-list>
       Create a Project </reference/iam-project-create>
       Delete a Project </reference/iam-project-delete>

source/reference/iam-organization-create.txt

@@ -0,0 +1,155 @@
+.. _mcli-iam-organization-create:
+
+================================
+mongocli iam organization create
+================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The ``mongocli iam organization create`` command creates a new 
+|cloud-short| or |onprem| organization.
+
+You must have the ``Global Owner`` role to create an organization.
+
+.. _mcli-iam-organization-create-syntax:
+
+Syntax 
+------
+
+.. code-block:: text 
+
+   mongocli iam organizations|organization create <organization-name>
+        [ --profile|-P <profile-name> ]
+
+.. important::
+   
+   The service for which the organization is created is determined by 
+   your profile.
+
+.. include:: /includes/fact-command-line-help.rst
+
+.. _mcli-iam-organization-create-options:
+
+Options 
+-------
+
+.. list-table:: 
+   :header-rows: 1
+   :widths: 20 10 60 10
+
+   * - Option
+     - Type 
+     - Description 
+     - Required? 
+
+   * - ``--profile``, ``-P`` 
+     - string 
+     - Name of the profile where your credentials are saved.
+       
+       You must have credentials with the ``Global Owner`` role to 
+       create an organization. You can use either a 
+       *Global API key pair* or a *Personal API key*:
+
+       .. list-table::
+          :header-rows: 1
+          :widths: 50 40 40
+
+          * - Credential Type
+            - ``public_api_key`` Value
+            - ``private_api_key`` Value
+
+          * - Global API Keys
+            - Public Global API key
+            - Private Global API key
+
+          * - Personal API Key
+            - |cloud-short| or |onprem| username
+            - Personal API key
+
+       The profile must include a ``service`` value of either:
+
+       - ``"ops-manager"`` for an |onprem| organization, or
+       - ``"cloud-manager"`` for a |cloud-short| organization.
+
+       If omitted, uses the ``default`` profile. To learn more about 
+       creating a profile, see :ref:`mcli-configure`.
+
+     - no
+
+.. _mcli-iam-organization-create-output:
+
+Output
+------
+
+The command prints following fields in |json| format to the 
+terminal if the command succeeds. If the command returns errors, 
+see :ref:`Troubleshooting <troubleshooting>` for recommended 
+solutions.
+
+.. list-table::
+   :header-rows: 1
+   :widths: 30 70
+
+   * - Field 
+     - Description 
+
+   * - ``id``
+     - Unique identifier of the organization.
+
+   * - ``links``
+     - One or more links to sub-resources and/or related resources.
+       The relations between URLs are explained in the `Web Linking
+       Specification <http://tools.ietf.org/html/rfc5988>`_.
+
+   * - ``name``
+     - Name of the organization.
+
+.. _mcli-iam-organization-create-examples:
+
+Examples
+--------
+
+The following command creates an |onprem| organization called 
+``myOrg`` using the default profile, which contains the 
+``Global Owner`` credentials and specifies the |onprem| service:
+
+.. code-block:: text
+
+   mongocli iam organization create myOrg
+
+The previous command creates the |onprem| organization ``myOrg`` and 
+prints the following in |json| format to the terminal. For more 
+information on these fields, see 
+:ref:`Output <mcli-iam-organization-create-output>`.
+
+.. code-block:: json 
+   :copyable: false
+
+   {
+     "id": "abcdefghi123456789",
+     "links": [
+       {
+         "rel": "self",
+         "href": "www.example.com:8080/api/public/v1.0/orgs/abcdefghi123456789"
+       },
+       {
+         "rel": "http://mms.mongodb.com/groups",
+         "href": "www.example.com:8080/api/public/v1.0/orgs/abcdefghi123456789/groups"
+       },
+       {
+         "rel": "http://mms.mongodb.com/teams",
+         "href": "www.example.com:8080/api/public/v1.0/orgs/abcdefghi123456789/teams"
+       },
+       {
+         "rel": "http://mms.mongodb.com/users",
+         "href": "www.example.com:8080/api/public/v1.0/orgs/abcdefghi123456789/users"
+       }
+     ],
+     "name": "myOrg"
+   }