/ /

Gerente de Operaciones

Crea el primer usuario

Cree el primer usuario de Ops Manager. Puede llamar a este endpoint sin tener un Clave API.

Importante

Excepciones

Este endpoint no se puede usar si Ops Manager utiliza LDAP para autenticación.
Este endpoint puede crear el primer usuario sólo si Ops Manager se ejecuta en Invitation Only Mode.

Ops Manager otorga a la primera clave API programática de Ops Manager creada a través de este endpoint el rol de GLOBAL_OWNER. El documento devuelto JSON incluye la primera clave API programática, que puedes usar para hacer llamadas adicionales a la API.

Este endpoint no crea proyectos ni organizaciones. Con la nueva clave API programática que se creó, puedes llamar al endpoint Crear un Proyecto. Ese endpoint puede crear un proyecto y una organización en una sola llamada API. No puedes iniciar sesión en Ops Manager hasta que hayas creado un proyecto.

Puede usar este endpoint para crear usuarios adicionales con las siguientes salvedades:

Ops Manager no concede el rol de GLOBAL_OWNER a esos usuarios posteriores a menos que agregue el rol a la solicitud API.
Ops Manager no crea una clave de API programática para los usuarios posteriores.

URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

POST /unauth/users

Parámetros de la ruta de solicitud

Este endpoint no utiliza parámetros de ruta de solicitud HTTP.

Parámetros de Solicitud Query

Nombre	Tipo	Descripción
accessList	string	Dirección IP que desea agregar a la lista de acceso para el primer usuario de Ops Manager. Puede agregar más de un `accessList` parámetro y valor.

Parámetros del cuerpo de la solicitud

Nombre

Tipo

Necesidad

Descripción

username

string

Requerido

Nombre de usuario del primer usuario de Ops Manager. Se validó según el valor de la mms.email.validation propiedad:

Valor	Descripción
`false`	(Por defecto) el nombre de usuario no necesita ser una dirección de correo electrónico.
`loose`	El nombre de usuario debe contener un símbolo `@` seguido de un punto.
`strict`	El nombre de usuario debe cumplir con una estricta expresión regular de validación de dirección de correo electrónico.

Consulta mms.email.validation para obtener más detalles.

El username suele ser una dirección de correo electrónico. Si establece este valor como una dirección de correo electrónico, no necesita establecer el valor emailAddress explícitamente.

password

string

Requerido

Contraseña del primer usuario de Ops Manager. Este campo no está incluido en el cuerpo de la respuesta HTTP. Ops Manager envía esto en la solicitud HTTP sólo al crear el primer usuario de Ops Manager.

emailAddress

string

Opcional

Dirección de correo electrónico del primer usuario de Ops Manager.

firstName

string

Requerido

Primer nombre del primer usuario de Ops Manager.

lastName

string

Requerido

Apellido del primer usuario de Ops Manager.

Respuesta

Nombre	Tipo	Descripción
`programmaticApiKey`	Objeto	Detalles del primer API key programático creado en Ops Manager.
`programmaticApiKey` `.desc`	string	Descripción de la primera clave API programática.
`programmaticApiKey` `.id`	string	Identificador único de la primera clave API programática.
`programmaticApiKey` `.links`	Arreglo de objetos	One or more links to sub-resources or related resources. All `links` arrays in responses include at least one link called `self`. The relationships between URLs are explained in the Especificación de vinculación web.
`programmaticApiKey` `.privateKey`	string	Treinta y un caracteres alfanuméricos y guiones que sirven como la contraseña de la primera clave API programática.
`programmaticApiKey` `.publicKey`	string	Seis caracteres alfanuméricos que sirven como nombre de usuario de la primera clave de API programática.
`programmaticApiKey` `.roles`	Arreglo de objetos	Roles asignados a la primera clave API programática.
`programmaticApiKey` `.roles.roleName`	string	Nombre del rol asignado. Ops Manager otorga a la primera clave de API programática el `Global Owner` rol`GLOBAL_OWNER` ().
`user`	Objeto	Detalles del primer usuario de Ops Manager.
`user` `.emailAddress`	string	Dirección de correo electrónico del primer usuario de Ops Manager.
`user` `.firstName`	string	Primer nombre del primer usuario de Ops Manager.
`user` `.id`	string	Identificador único del primer usuario de Ops Manager.
`user` `.lastName`	string	Apellido del primer usuario de Ops Manager.
`user` `.links`	Arreglo de objetos	Uno o más enlaces a subrecursos o recursos relacionados. Todas las `links` matrices en las respuestas incluyen al menos un enlace `self` llamado. Las relaciones entre las URLse explican en la Especificación de Enlaces Web.
`user` `.mobileNumber`	string	Número de teléfono móvil del primer usuario de Ops Manager.
`user` `.roles`	Arreglo de objetos	Roles asignados al primer usuario de Ops Manager.
`user` `.roles.roleName`	string	Nombre del rol asignado. Ops Manager otorga al primer usuario de Ops Manager el rol de `Global Owner` (`GLOBAL_OWNER`).
`user` `.teamIds`	Arreglo de cadenas	Lista de identificadores únicos para los equipos a los que pertenece el primer usuario de Ops Manager.
`user` `.username`	string	Nombre de usuario del primer usuario de Ops Manager.

Solicitud de ejemplo

curl --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/unauth/users?pretty=true&accessList=1.2.3.4&accessList=2.3.4.5" \
     --data '
       {
         "username": "jane.doe@example.com",
         "password": "Passw0rd.",
         "firstName": "Jane",
         "lastName": "Doe"
       }'

Respuesta de ejemplo

Encabezado de respuesta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 201 Created
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Respuesta del cuerpo

{
  "programmaticApiKey": {
    "desc": "Automatically generated Global API key",
    "id": "{API-KEY}",
    "links": [{
      "href": "http://<OpsManagerHost>:<Port>/api/public/v1.0/orgs/null/apiKeys/{API-KEY}",
      "rel": "self"
    }],
    "privateKey": "private key string",
    "publicKey": "public key string",
    "roles": [{
      "roleName": "GLOBAL_OWNER"
    }]
  },
  "user": {
    "emailAddress": "jane.doe@example.com",
    "firstName": "Jane",
    "id": "{USER-ID}",
    "lastName": "Doe",
    "links": [
      {
       "href" : "https://<OpsManagerHost>:<Port>/api/public/v1.0/users/{USER-ID}",
       "rel" : "self"
      }
    ],
    "roles": [
      {
        "roleName": "GLOBAL_OWNER"
      }
    ],
    "username": "jane.doe@example.com"
  }
}

Volver

Actualizar roles

Borrar