Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

API de gestión del ciclo de vida de procesos

Puedes usar la API de Ops Manager para cerrar, iniciar, reiniciar y resincronizar un proceso de MongoDB. Cada solicitud actualiza el proceso en la configuración de automatización y publica el cambio de inmediato. El Agente de Automatización del host de destino aplica el cambio en su siguiente check-in. Si el proceso es el principal actual, el agente primero lo reduce para que otro miembro pueda hacerse cargo y luego lo detiene o reinicia.

Cada operación es asíncrona. Una respuesta 200 OK significa que Ops Manager publicó el cambio, no que el proceso se haya detenido, iniciado, reiniciado o resincronizado. La respuesta no incluye ID de trabajo. Para seguir el cambio hasta su finalización, consulta el recurso de estado de automatización . Si el agente no puede aplicar el cambio, el plan aparece como fallido allí y el agente sigue intentándolo de nuevo.

Cada endpoint acepta un parámetro opcional de consulta dryRun=true . Úsalo para previsualizar un cambio antes de aplicarlo. Ops Manager ejecuta todas las mismas comprobaciones y devuelve el documento de proceso tal como sería tras el cambio, pero no envía nada al agente y no cambia nada en tu implementación. Por ejemplo, tras un apagado, el documento devuelto contiene "disabled": true. Revísalo y luego envía la misma solicitud sin dryRun=true aplicar el cambio.

Antes de utilizar los recursos del ciclo de vida del proceso, revise los siguientes requisitos.

Nota

Grupos y proyectos son términos sinónimos. Su {PROJECT-ID} es el mismo que su ID del grupo. Para los grupos existentes, el ID del grupo se mantiene igual. Esta página utiliza el término más familiar grupo cuando se refiere a descripciones. El endpoint permanece tal como se indica en el documento.

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

Para utilizar los recursos del ciclo de vida del proceso, debes ser usuario de Ops Manager con el rol Project Automation Admin.

Tu despliegue debe ejecutar Ops Manager 8.0.28 o 9.0.2 o posterior. La automatización debe estar habilitada para el proyecto y el Agente de Automatización del host objetivo debe estar en ejecución.

Si tienes un borrador de configuración de automatización no publicado en el proyecto, Ops Manager rechaza todas las solicitudes, incluida una prueba en seco, con un error de 409 AUTOMATION_CONFIG_DRAFT_ALREADY_EXISTS . Publique o descarte el borrador antes de continuar.

Toda validación también se aplica a pruebas en seco, por lo que una prueba exitosa predice que la petición real pasa las mismas comprobaciones. Una petición real puede fallar en un cambio simultáneo o en validación en modo manual.

Importante

Las operaciones del ciclo de vida del proceso no están soportadas para proyectos gestionados externamente ni para despliegues de Kubernetes Operator (MCK).

Advertencia

Estos endpoints no proporcionan protección de quórum. Apagar demasiados miembros de un conjunto réplica lo deja sin un elemento principal. Apaga los miembros uno a uno y espera a que cada uno se detenga antes de continuar.

La siguiente tabla enumera los puntos finales disponibles para el recurso Ciclo de Vida del Proceso.

Método
Endpoint
Descripción

POST

Detiene con elegancia un proceso en marcha.

POST

Inicia un proceso que antes estaba cerrado.

POST

Reinicia con gracia un proceso en marcha.

POST

Desencadena una sincronización inicial en un miembro de un conjunto de réplica.

Cada solicitud exitosa que no sea un ensayo en seco añade un evento al feed de actividad del proyecto, junto con el evento publicado habitual de configuración de automatización. El feed de actividad atribuye las solicitudes realizadas con la API a la API Pública.

Operación
Tipo de evento
Lo que te dice

AUTOMATION_PROCESS_SHUTDOWN_REQUESTED

Se realizó una solicitud de cierre para este proceso. Compruebe este evento si un miembro se desconectó inesperadamente.

AUTOMATION_PROCESS_STARTUP_REQUESTED

Se solicitó iniciar un proceso detenido.

AUTOMATION_PROCESS_RESTART_REQUESTED

Se realizó una solicitud de reinicio para este proceso. Compruebe este evento si un miembro se retiró brevemente o se produjo una elección.

AUTOMATION_PROCESS_RESYNC_REQUESTED

Se realizó una solicitud de resincronización para este proceso. Compruebe este evento si un miembro entró en STARTUP2 o RECOVERING y está recopiando datos.