(DOCSP-10973): Add pagination to iam organization list (#121)

* (DOCSP-10973): Add pagination to iam organization list

* Copy review

* Copy review 2

Author: melissamahoney-mongodb

source/reference/iam-organization-list.txt

@@ -37,6 +37,8 @@ Syntax
 .. code-block:: text 
 
    mongocli iam organization|organizations|org|orgs list|ls
+        [ --limit <number-of-orgs> ]
+        [ --page <number-of-pages> ]
         [ --profile|-P <profile-name> ]
 
 .. include:: /includes/fact-command-line-help.rst
@@ -55,6 +57,30 @@ Options
      - Description 
      - Required? 
 
+   * - ``--limit``
+     - integer
+     - Number of organizations to return per page. 
+     
+       - If this value exceeds the number of organizations, 
+         ``mongocli`` returns all organizations. Maximum value is
+         ``500``.
+       - If omitted, defaults to ``100``.
+
+       For example usage, see :ref:`mcli-organization-list-examples-pagination`.
+     - no
+
+   * - ``--page``
+     - integer
+     - Page number (1-based) to return from the 
+       result set. 
+       
+       - The ``--limit`` flag sets the number of
+         organizations per page.
+       - If omitted, returns the first page.
+       
+       For example usage, see :ref:`mcli-organization-list-examples-pagination`.
+     - no
+
    * - ``--profile``, ``-P`` 
      - string 
      - Name of the profile where your credentials are saved.
@@ -215,3 +241,86 @@ The command returns the following |json| document:
     "totalCount": 2
    }
 
+.. _mcli-organization-list-examples-pagination:
+
+List the Sixth through Tenth Organizations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following ``mongocli iam org list`` command lists the sixth through
+tenth organizations in an |onprem| deployment that has 20 organizations.
+The command uses the ``om-personalkey`` profile, which contains a
+:opsmgr:`Personal API Key
+</tutorial/configure-public-api-access/#personal-api-keys-deprecated>`.
+
+.. code-block:: sh
+
+   mongocli iam org list -P om-personalkey --limit 5 --page 2
+
+This command returns the following list in |json| format to
+the terminal. To learn more about these fields, see
+:ref:`Output <mcli-iam-organization-list-output>`.
+
+.. code-block:: json
+   :copyable: false
+
+   {
+    "links": [
+     {
+      "rel": "self",
+      "href": "http://www.example.com:8080/api/public/v1.0/orgs?pageNum=1\u0026itemsPerPage=5"
+     }
+    ],
+    "results": [
+     {
+      "id": "5e332f3e1234de007b387a9f",
+      "links": [
+       {
+        "rel": "self",
+        "href": "http://www.example.com:8080/api/public/v1.0/orgs/5e332f3e1234de007b387a9f"
+       }
+      ],
+      "name": "Org6"
+     },
+     {
+      "id": "5e38efd83b60f567896baf4d",
+      "links": [
+       {
+        "rel": "self",
+        "href": "http://www.example.com:8080/api/public/v1.0/orgs/5e38efd83b60f567896baf4d"
+       }
+      ],
+      "name": "Org7"
+     },
+     {
+      "id": "27a91237ba9cb28a15ed3f51",
+      "links": [
+       {
+        "rel": "self",
+        "href": "http://www.example.com:8080/api/public/v1.0/orgs/27a91237ba9cb28a15ed3f51"
+       }
+      ],
+      "name": "Org8"
+     },
+     {
+      "id": "959bd41f6c65d5a31077f78a",
+      "links": [
+       {
+        "rel": "self",
+        "href": "http://www.example.com:8080/api/public/v1.0/orgs/959bd41f6c65d5a31077f78a"
+       }
+      ],
+      "name": "Org9"
+     },
+     {
+      "id": "f459b51a9a6e4eba907b47ad",
+      "links": [
+       {
+        "rel": "self",
+        "href": "http://www.example.com:8080/api/public/v1.0/orgs/f459b51a9a6e4eba907b47ad"
+       }
+      ],
+      "name": "Org10"
+     }
+    ],
+    "totalCount": 20
+   }