/ /

Recursos

Implementaciones de importación

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Implementaciones de importación

Crear solicitud de implementación de importación

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} Es el mismo que el ID de tu proyecto. Para los grupos existentes, el ID de tu grupo/proyecto permanece igual. Esta página utiliza el término "grupo" para las descripciones. El punto final se mantiene como se indica en el documento.

Cree una nueva solicitud de implementación de importación para agregar procesos MongoDB existentes a la automatización de Ops Manager. Este punto final inicia el proceso de importación de múltiples procesos MongoDB a la gestión de monitorización y automatización.

Importante

Esta funcionalidad está disponible desde Ops Manager 8.0.13.

Las implementaciones importadas se añaden a la configuración de automatización del proyecto. El Agente de MongoDB comenzará a supervisar los procesos y a gestionarlos según la configuración de automatización.

Roles necesarios

Este punto final requiere el Project Automation Admin role.

Endpoint

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

POST /automation/importDeployment/{PROJECT-ID}

Solicitud

Parámetros de ruta

Nombre	Tipo	Necesidad	Descripción
PROJECT-ID	string	Requerido	Identificador único de la proyecto que será propietario de las implementaciones importadas.

Parámetros de consulta

Los siguientes parámetros de consulta son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonita

booleano

Opcional

Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint formato.

false

envolvente

booleano

Opcional

Bandera que indica si se debe o no envolver la respuesta en un sobre.

Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta.

Para los puntos finales que devuelven un resultado, el cuerpo de la respuesta incluye:

Nombre	Descripción
`status`	Código de respuestaHTTP
`content`	Cuerpo de respuesta esperado

false

Parámetros corporales

Nombre	Tipo	Necesidad	Descripción
seedHostport	string	Requerido	Nombre de host y puerto del proceso MongoDB semilla al que conectarse para el descubrimiento (por ejemplo, `mongodb1.example.com:27017`).
Procesos requeridos	arreglo	Requerido	Matriz de cadenas de nombre de host:puerto que representan procesos de MongoDB que deben descubrirse antes de que pueda continuar la importación.
tiempos de espera	Objeto	Opcional	Configuración de tiempo de espera para varias fases de importación.
tiempos de espera.seedHostConnectionSec	Número	Opcional	Tiempo de espera en segundos para conectar con el host semilla. Rango: 60-86400 segundos. La opción por defecto utiliza la configuración del sistema.
tiempos de espera.procesosDiscoverySec	Número	Opcional	Tiempo de espera en segundos para detectar todos los procesos necesarios. Rango: 60-86400 segundos. El valor predeterminado utiliza la configuración del sistema.
tiempos de espera.automationImported	Número	Opcional	Tiempo de espera en segundos para completar la importación de la automatización. Rango: 60-86400 segundos. El valor predeterminado utiliza la configuración del sistema.
tiempos de espera.goalStateSec	Número	Opcional	Tiempo de espera en segundos para alcanzar el objetivo de automatización. Rango: 60-86400 segundos. El valor predeterminado utiliza la configuración del sistema.
mecanismo de autenticación	string	Opcional	Mecanismo de autenticación para conectarse a los procesos de MongoDB. Los valores posibles son: `MONGODB_CR` (Esto cubre SCRAM-SHA-1, SCRAM-SHA-256 y MONGODB-CR). `GSSAPI` `PLAIN` `MONGODB_X509` `NONE`
Nombre de usuario	string	Condicional	Nombre de usuario para autenticarse en los procesos de MongoDB. Obligatorio si se especifica `authMechanism`.
contraseña	string	Condicional	Contraseña para autenticarse en los procesos de MongoDB. Obligatoria si `authMechanism` es `MONGODB_CR`. Ops Manager no incluye este parámetro en los documentos de respuesta.
adminDb	string	Opcional	Base de datos para autenticarse. Valor predeterminado: `admin`.
pemKeyFilePath	string	Opcional	Ruta al archivo de clave PEM para la autenticación del cliente TLS.
pemKeyFilePassword	string	Opcional	Contraseña para el archivo de clave PEM. Ops Manager no incluye este parámetro en los documentos de respuesta.
adminKerberosKeytab	string	Opcional	Ruta al archivo de claves Kerberos para la autenticación GSSAPI.
adminLdapGroupDn	string	Opcional	Nombre distinguido del grupo LDAP para autenticación PLAIN.
saslServiceName	string	Opcional	Nombre del servicio SASL para la autenticación GSSAPI.
RutaDeArchivoCa	string	Opcional	Ruta al archivo de autoridad de certificación para conexiones TLS.
rutaArchivoCaCluster	string	Opcional	Ruta al archivo de autoridad de certificación del clúster para conexiones TLS.
modoCertificadoCliente	string	Opcional	Modo de certificado de cliente para conexiones TLS.

Respuesta

Devuelve una respuesta de éxito vacía con el estado HTTP 200 si la solicitud de importación se envía correctamente.

Nota

Este punto final no devuelve el ID de la solicitud de importación creada. Para rastrear el estado de su solicitud de importación, utilice el punto final "Obtener solicitudes de implementación de importación" para listar todas las solicitudes del proyecto e identificar su solicitud por fecha de creación u otras propiedades.

Ejemplo de solicitud

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/automation/importDeployment/{PROJECT-ID}?pretty=true" \
     --data '{
       "seedHostport": "mongodb1.example.com:27017",
       "requiredProcesses": [
         "mongodb1.example.com:27017",
         "mongodb2.example.com:27017",
         "mongodb3.example.com:27018"
       ],
       "timeouts": {
         "seedHostConnectionSec": 300,
         "processesDiscoverySec": 600,
         "automationImported": 600,
         "goalStateSec": 1200
       },
       "authMechanism": "MONGODB_CR",
       "username": "admin",
       "password": "password123",
       "adminDb": "admin"
     }'

Ejemplo de respuesta

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 200 OK
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}

Cuerpo de respuesta

{}

Volver

Implementaciones de importación

Obtener solicitudes de implementación de importación