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.

Obtener una tarea de elección de set de réplicas

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

GET /groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}

La clave API que realiza esta solicitud debe tener el rol Project Automation Admin.

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.

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.

false

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:

  • status: Código de respuesta HTTP

  • content: Cuerpo de respuesta esperado

false

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

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: STEP_DOWN o STEP_UP.

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: QUEUED, RUNNING, COMPLETED, FAILED o EXPIRED.

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.

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 noOp para determinar si la operación realizó un cambio.

Fallido

Sí

La operación no se pudo completar. Consulte message para conocer el motivo.

CADUCADO

Sí

Ningún agente aceptó la tarea antes de que transcurriera expiresAfterSeconds.

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"
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-alive
HTTP/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}
{ "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"}
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 Project Automation Admin.

404

REELECTION_JOB_NOT_FOUND

REELECTION-JOB-ID es desconocido o tiene un formato incorrecto, o la tarea no pertenece al set de réplicas denominado en RS-ID.