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 punto final para recuperar una sola tarea de reelección mediante su identificador único. Sondee este punto final hasta que la tarea alcance un estado terminal.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}Roles 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. |
RS-ID | string | Requerido | Nombre del set de réplicas que contiene la tarea de elección. |
reelección-tarea-ID | string | Requerido | String única de 24dígitos hexadecimales que identifica la tarea de reelección, devuelta por el punto de conexión de reducción o aumento. |
Parámetros de Solicitud Query
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
La respuesta devuelve una única tarea de reelección.
Nombre | Tipo | Descripción |
|---|---|---|
ID | string | String única de 24dígitos hexadecimales que identifica la tarea de reelección. |
ID del grupo | string | string única de 24 dígitos hexadecimales que identifica el Proyecto. |
acción | string | Acción que realiza esta tarea. Devuelve uno de los siguientes valores: |
replicaSetName | string | Nombre del set de réplicas de destino. |
Nombre del host | string | Nombre de host del proceso de destino. |
Puerto | entero | Puerto del proceso de destino. |
Estado | string | Estado de la tarea. Devuelve uno de los siguientes valores: |
noop | booleano | Indicador que indica si la operación se completó como una operación nula. |
mensaje | string | Detalle legible por humanos sobre la tarea. MongoDB Ops Manager rellena este campo después de que el agente informa un resultado. |
creado | string | Marca de tiempo, en formato ISO 8601 UTC, cuando Ops Manager creó la tarea. |
últimaActualización | string | Marca de tiempo, en formato ISO 8601 UTC, cuando MongoDB Ops Manager actualizó por última vez la tarea. |
expira | string | Marca de tiempo, en formato ISO 8601 UTC, después de la cual un agente de automatización ya no procesa esta tarea. |
Valores de estado de tarea
Estado | terminal | Significado |
|---|---|---|
EN COLA | No | MongoDB Ops Manager creó la tarea. Está esperando a que el agente de automatización del host de destino lo recoja. |
EN EJECUCIÓN | No | El agente está ejecutando la tarea. |
COMPLETADO | Sí | La operación terminó. Compruebe |
Fallido | Sí | La operación no se pudo completar. Consulte |
CADUCADO | Sí | Ningún agente aceptó la tarea antes de que transcurriera |
Solicitud de ejemplo
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}?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
{ "id": "665a1234567890abcdef1234", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_UP", "replicaSetName": "rs0", "hostname": "node2.example.com", "port": 27017, "status": "COMPLETED", "noOp": false, "message": null, "created": "2026-08-11T05:37:59Z", "lastUpdated": "2026-08-11T05:38:45Z", "expires": "2026-08-11T05:39:59Z"}Códigos de respuesta
HTTP Status | Código de error | Descripción |
|---|---|---|
200 | -- | Devuelve el documento de la tarea de reelección. |
401 | USUARIO_NO_AUTORIZADO | La clave API no tiene el rol |
404 | REELECTION_JOB_NOT_FOUND |
|