DOCSP-12043 doc for iam projects users delete command (#250)

* DOCSP-12043 doc for iam projects users delete command

DOCSP-12043 self-review

* DOCSP-12043 updates for copy review feedback

Author: kanchana-mongodb

source/reference/iam/iam-project-user-delete.txt

@@ -0,0 +1,150 @@
+.. _iam-project-user-delete:
+
+==================================
+mongocli iam projects users delete
+==================================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: singlecol
+
+The ``mongocli iam projects users delete`` command deletes a user 
+in the MongoDB service project. You can also delete users in your 
+MongoDB service project using the: 
+
+- |service| :atlas:`UI 
+  </access/manage-project-access/#remove-users-or-teams-from-a-project>` and 
+  :atlas:`API </reference/api/project-remove-user/>`
+- |cloud-short| :cloudmgr:`UI 
+  </tutorial/manage-users/#remove-users-or-teams-from-a-project>` and :cloudmgr:`API </reference/api/groups/remove-one-user-from-one-group/>`
+- |onprem| :opsmgr:`UI 
+  </tutorial/manage-users/#remove-users-or-teams-from-a-project>` and 
+  :opsmgr:`API </reference/api/groups/remove-one-user-from-one-group/>`
+
+.. _iam-project-user-delete-cmd-permissions:
+
+Permissions Required 
+--------------------
+
+The following table shows the role you must have to delete a user from 
+the MongoDB service project.
+
+.. list-table::
+   :header-rows: 1 
+   :widths: 40 60
+
+   * - MongoDB Service
+     - Role
+
+   * - |service|
+     - :atlas:`Project Owner </reference/user-roles/#Project-Owner>`
+
+   * - |cloud-short|
+     - :cloudmgr:`Project Owner </reference/user-roles/#Project-Owner>`
+
+   * - |onprem|
+     - :opsmgr:`Project Owner </reference/user-roles/#Project-Owner>`
+
+.. _mcli-iam-project-user-delete-syntax:
+
+Syntax 
+------
+
+.. code-block:: text 
+
+   mongocli iam projects users delete <user-id>
+        [ --force ]
+        [ --profile|-P <profile-name> ]
+        [ --projectId <project-ID> ]
+
+.. include:: /includes/fact-command-line-help.rst
+
+.. _mcli-iam-project-user-delete-args:
+
+Arguments
+---------
+
+.. list-table:: 
+   :header-rows: 1
+   :widths: 20 10 60 10
+
+   * - Argument
+     - Type 
+     - Description 
+     - Required? 
+
+   * - ``<user-id>``
+     - string
+     - Unique identifier of the user you want to delete from the project. 
+       You can run the :ref:`iam-project-user-list` command to retrieve 
+       the user's ID.
+     - yes
+
+.. _mcli-iam-project-user-delete-options:
+
+Options 
+-------
+
+.. list-table:: 
+   :header-rows: 1
+   :widths: 20 10 60 10
+
+   * - Option 
+     - Type 
+     - Description 
+     - Required? 
+
+   * - ``--force``
+     - 
+     - Flag that indicates that the project-user can be deleted without
+       requiring confirmation. 
+     - no
+
+   * - ``--profile``, ``-P`` 
+     - string 
+     - Name of the profile that contains the access information. If
+       omitted, uses the {+default-profile+}. 
+     - no 
+
+   * - ``--projectId`` 
+     - string 
+     - Unique identifier of the project. If omitted, uses the specified 
+       profile for accessing the MongoDB service.
+     - no
+
+.. _mcli-iam-project-user-delete-output:
+
+Output 
+------
+
+The command prints the following output to the terminal if the command succeeds.
+If the command returns errors, see :ref:`Troubleshooting <troubleshooting>`
+for recommended solutions.
+
+.. code-block:: none
+
+   User '<user-id>' deleted from the project
+
+.. _mcli-iam-project-user-delete-examples:
+
+Example
+-------
+
+The following command deletes a user with ID ``5e44445ef10fab20b49c0f31``
+in an |service| project. It uses the {+default-profile+} for accessing
+|service|. 
+
+.. code-block:: text 
+
+   mongocli iam projects users delete 5e44445ef10fab20b49c0f31 --force
+
+The previous command prints the following to the terminal. 
+
+.. code-block:: none
+   :copyable: false 
+
+   User '5e44445ef10fab20b49c0f31' deleted from the project

source/reference/iam/user-commands.txt

@@ -20,3 +20,4 @@ User Commands
    List Project Users <iam-project-user-list>
    Describe a User <iam-user-describe>
    Delete One Ops Manager User <iam-user-delete>
+   Delete Project Users <iam-project-user-delete>