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.
Utilice este endpoint para reiniciar un proceso en ejecución de forma ordenada. Ops Manager establece lastRestart para el proceso en la configuración de automatización y publica el cambio. Si el proceso es el principal actual, el Agente de Automatización lo retira antes de reiniciarlo.
La solicitud es asíncrona: 200 OK significa que Ops Manager publicó el cambio, no que el proceso se haya reiniciado. Consulta el recurso de estado de automatización hasta que el plan se complete.
El endpoint de reinicio devuelve 400 PROCESS_DISABLED_CANNOT_RESTART para un proceso que está cerrado. Para iniciarlo, utilice Iniciar un proceso en su lugar.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
POST /groups/{GROUP-ID}/process/{HOST-PORT}:restartRoles necesarios
La clave API que realiza esta solicitud debe tener el rol Project Automation Admin.
Parámetros de ruta de solicitud
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
ID del grupo | string | Requerido | string única de 24 dígitos hexadecimales que identifica tu proyecto. |
host-puerto | string | Requerido | Proceso objetivo, como |
Parámetros de Solicitud Query
Nombre | Tipo | Necesidad | Descripción | predeterminado |
|---|---|---|---|---|
dryRun (Ejecutar en seco) | booleano | Opcional | Si |
|
Los siguientes parámetros de query son opcionales:
Nombre | Tipo | Necesidad | Descripción | predeterminado |
|---|---|---|---|---|
bonito | booleano | Opcional | Indicador que muestra si el cuerpo de la respuesta está en formato pretty-print. |
|
envelope | booleano | Opcional | Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos clientes API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, ajusta envelope=true en la query. Para los endpoints que devuelven un resultado, el cuerpo de la respuesta incluye:
|
|
Parámetros del cuerpo de la solicitud
Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.
Respuesta
Ops Manager devuelve 200 OK y el proceso objetivo tal como aparece en la configuración de automatización, con el cambio aplicado. lastRestart está configurado. El cuerpo es el mismo tanto si configuras dryRun como si no.
Nombre | Tipo | Descripción |
|---|---|---|
Nombre | string | Nombre del proceso en la configuración de automatización. |
Nombre del host | string | Nombre de host del proceso. |
processType | string | Tipo de proceso, por ejemplo |
Versión | string | Versión MongoDB del proceso. |
inhabilitado | booleano |
|
lastRestart | string | Marca de tiempo, en formato ISO 8601 UTC, del último reinicio solicitado. |
lastResync | string | Marca de tiempo, en formato ISO 8601 UTC, de la última resincronización solicitada. |
El documento también contiene el resto de la configuración de automatización del proceso, como args2_6, featureCompatibilityVersiony authSchemaVersion. Consulte la referencia de Configuración de Automatización .
Solicitud de ejemplo
El siguiente ejemplo reinicia el proceso que se ejecuta en node1.example.com:27017.
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/process/node1.example.com:27017:restart?pretty=true"Respuesta de ejemplo
Encabezado de respuesta
HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-aliveHTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}Respuesta del cuerpo
{ "name": "rs0_1", "processType": "mongod", "version": "8.0.4", "hostname": "node1.example.com", "disabled": false, "lastRestart": "2026-10-06T09:15:20Z", "authSchemaVersion": 5, "featureCompatibilityVersion": "8.0", "args2_6": { "net": { "port": 27017 }, "replication": { "replSetName": "rs0" }, "storage": { "dbPath": "/data/rs0_1" }, "systemLog": { "destination": "file", "path": "/data/rs0_1/mongodb.log" } }}Códigos de respuesta
HTTP Status | Código de error | Descripción |
|---|---|---|
200 | -- | El cambio fue publicado o calculado con |
400 | PROCESS_DISABLED_CANNOT_RESTART | El proceso está cerrado. Empieza a empezar en su lugar. |
409 | PROCESS_AGENT_NOT_REPORTING | El Agente de Automatización del host objetivo nunca ha reportado al Administrador de Operaciones. |
409 | GROUP_IN_RESTORATION_MODE | El proyecto se está reconciliando tras una restauración. |
403 | PROCESS_EXTERNALLY_MANAGED | Los procesos del proyecto son gestionados por un sistema externo. |
409 | AUTOMATION_CONFIG_DRAFT_ALREADY_EXISTS | Tienes un borrador de configuración de automatización no publicado en el proyecto. |
404 | PROCESS_NOT_FOUND |
|
400 | INVALID_QUERY_PARAMETER |
|
409 | AUTOMATION_CONFIG_CONCURRENT_MODIFICATION | Alguien publicó un cambio mientras esta solicitud estaba en curso. Ops Manager devuelve este código solo para una solicitud real. |
Ops Manager comprueba los errores compartidos en el orden indicado. Consulte Ciclo de vida del proceso para requisitos previos y limitaciones.