(DOCSP-11497)(DOCSP-11421): add programmatic api key to owner create … (#187)

* (DOCSP-11497)(DOCSP-11421): add programmatic api key to owner create and add agent api key to project create

* (DOCSP-11497): copy review feedback

* (DOCSP-11497): tech review feedback

Author: jwilliams-mongo

source/reference/iam-project-create.txt

@@ -78,7 +78,11 @@ solutions.
    :widths: 30 70 
 
    * - Field 
-     - Description 
+     - Description
+
+   * - ``agentApiKey``
+     - :opsmgr:`Agent API key </tutorial/manage-agent-api-key/>` for the
+       project. |onprem| only.
 
    * - ``hostcounts``
      - Number of primary, secondary, slave, arbiter, config, master,
@@ -188,6 +192,7 @@ the terminal. For more information on these fields, see
    :copyable: false 
 
    {
+    "agentApiKey": "7f36b2fbc702201990297cff5bbcc5688b98199a43467d421f05c6cb",
     "hostCounts": {
      "arbiter": 0,
      "config": 0,

source/reference/ops-manager/owner-create.txt

@@ -109,10 +109,22 @@ if the command succeeds. If the command prints errors, see
      - The :opsmgr:`personal API key </reference/api/api-key/index.html>` 
        for the user. Save the key in a secure file.
 
+   * - ``programmaticApiKey``
+     - object
+     - An object describing the :opsmgr:`programmatic API key
+       </tutorial/manage-programmatic-api-keys/>` for the user. For a
+       detailed description of the object, see
+       :ref:`om-org-owner-key-attrs`.
+
+       .. note::
+
+          The response contains a ``programmaticApiKey`` object only for
+          |onprem| 4.4 and later.
+
    * - ``user``
      - object
-     - The user attributes that are set in |mms|. See 
-       :ref:`om-org-owner-user-attrs` for more information.
+     - The user attributes that are set in |mms|. For a detailed
+       description of the object, see :ref:`om-org-owner-user-attrs`.
 
 .. _om-org-owner-user-attrs:
 
@@ -147,6 +159,55 @@ User Attributes
        and/or related resources. The relations between |url|\s are 
        explained in the :rfc:`Web Linking Specification <5988>`.
 
+.. _om-org-owner-key-attrs:
+
+Programmatic API Key Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. list-table::
+   :widths: 15 10 75
+   :header-rows: 1
+   :stub-columns: 1
+
+   * - Name
+     - Type
+     - Description
+
+   * - ``desc``
+     - string
+     - Description of the programmatic |api| key.
+
+   * - ``id``
+     - string
+     - Unique identifier of the programmatic |api| key.
+
+   * - ``links``
+     - array of objects
+     - Array of objects with one or more links to sub-resources 
+       and/or related resources. The relations between |url|\s are 
+       explained in the :rfc:`Web Linking Specification <5988>`.
+
+   * - ``privateKey``
+     - string
+     - A series of alphanumeric characters and dashes that serve as the
+       password of the programmatic |api| key.
+
+   * - ``publicKey``
+     - string
+     - A series of alphanumeric characters that serve as the username of
+       the programmatic |api| key.
+
+   * - | ``roles``
+     - array of objects
+     - :opsmgr:`Roles </reference/user-roles>` assigned to the
+       programmatic |api| key.
+
+   * - | ``roles``
+       | ``.roleName``
+     - string
+     - Name of the assigned role. |mms| grants the programmatic
+       |api| key the :authrole:`Global Owner` role (``GLOBAL_OWNER``).
+
 .. _om-owner-create-examples:
 
 Examples 
@@ -219,29 +280,41 @@ Output
 ~~~~~~
 
 The :ref:`om-owner-create-example1` and :ref:`om-owner-create-example2` 
-commands print the following fileds in the specified format to the terminal. To
+commands print the following fields in the specified format to the terminal. To
 learn more about these fields, see :ref:`om-owner-create-output`.
 
 .. code-block:: json 
    :copyable: false
 
    {
-	  "apiKey": "34a93114-ec2b-4125-992e-1dd87c4148e4",
-	  "user": {
-		"username": "[email protected]",
-		"firstName": "Jane",
-		"lastName": "Doe",
-		"emailAddress": "[email protected]",
-		"id": "5e39bd5c31cd7c0078867c03",
-		"links": [
-			{
-				"rel": "self",
-				"href": "http://om-svc.mongodb.svc.cluster.local:8080/api/public/v1.0/users/5e39bd5c31cd7c0078867c03"
-			},
-			{
-				"rel": "http://mms.mongodb.com/whitelist",
-				"href": "http://om-svc.mongodb.svc.cluster.local:8080/api/public/v1.0/users/5e39bd5c31cd7c0078867c03/whitelist"
-			}
-		]
-	  }
+   	"apiKey": "34a93174-ec7b-4725-972e-1dd77c4178e4",
+   	"programmaticApiKey": {
+   		"desc": "Automatically generated Global API key",
+   		"id": "{API-KEY}",
+   		"links": [{
+   			"href": "http://om-svc.mongodb.svc.cluster.local:8080/api/public/v1.0/orgs/null/apiKeys/{API-KEY}",
+   			"rel": "self"
+   		}],
+   		"privateKey": "private key string",
+   		"publicKey": "public key string",
+   		"roles": [{
+   			"roleName": "GLOBAL_OWNER"
+   		}]
+   	},
+   	"user": {
+   		"username": "[email protected]",
+   		"firstName": "Jane",
+   		"lastName": "Doe",
+   		"emailAddress": "[email protected]",
+   		"id": "5e39bd5c31cd7c0078867c03",
+   		"links": [{
+   				"rel": "self",
+   				"href": "http://om-svc.mongodb.svc.cluster.local:8080/api/public/v1.0/users/5e39bd5c31cd7c0078867c03"
+   			},
+   			{
+   				"rel": "http://mms.mongodb.com/whitelist",
+   				"href": "http://om-svc.mongodb.svc.cluster.local:8080/api/public/v1.0/users/5e39bd5c31cd7c0078867c03/whitelist"
+   			}
+   		]
+   	}
    }