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 desencadenar una sincronización inicial en un miembro de un conjunto de réplica. Ops Manager establece lastResync para el proceso en la configuración de automatización y publica el cambio. Use resync para recuperar un miembro atascado en RECOVERING porque quedó por detrás de la ventana de oplog.
Para garantizar una ejecución exitosa, restringe las solicitudes de resincronización a los miembros secundarios de un conjunto de réplicas. Cada conjunto de réplica está limitado a una resincronización concurrente, que se considera activa hasta que el despliegue alcance el estado objetivo. Evita solicitar una resincronización en el miembro principal: el Agente de Automatización no la ejecuta y la solicitud requiere intervención manual.
La solicitud es asíncrona: 200 OK significa que Ops Manager publicó el cambio, no que la resincronización haya finalizado. Consulta el recurso de estado de automatización hasta que el plan se complete, luego consulta v2.0 Obtén One Host por ID hasta que replicaStateName esté SECONDARY. Una sincronización inicial puede llevar mucho tiempo en conjuntos de datos grandes.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
POST /groups/{GROUP-ID}/process/{HOST-PORT}:resyncRoles 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. lastResync 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 desencadena una sincronización inicial en 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:resync?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, "lastResync": "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_RESYNC_NOT_SUPPORTED | El objetivo es un |
409 | PROCESS_RESYNC_IN_PROGRESS | Otra resincronización ya está pendiente para el conjunto de réplicas del objetivo. |
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.