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 todos los trabajos de re-elección del 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 cada tarea de reelección para un set de réplicas específico.

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

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

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 cuyas tareas de re-elección desea enumerar.

Nombre
Tipo
Descripción
predeterminado

Num. de pág.

entero

Número de página (basado en índice a partir de 1).

1

elementosPorPágina

entero

Número de elementos a devolver por página, hasta un máximo de 500.

100

bonito

booleano

Indica si el cuerpo de la respuesta debe estar en un formato prettyprint.

false

envelope

booleano

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 corregir esto, establezca "envelope" : true en la query.

Para los endpoints que devuelven un resultado, el cuerpo de respuesta incluye:

  • status: Código de respuesta HTTP

  • content: Cuerpo de respuesta esperado

Para los endpoints que devuelven una lista de resultados, el objeto results es un sobre. Ops Manager agrega el campo status al cuerpo de la respuesta.

Ninguno

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

La respuesta incluye un arreglo de objetos de tarea de reelección y el número total de objetos de tarea recuperados.

Nombre
Tipo
Descripción

Resultados

arreglo

Arreglo de tareas de reelección, ordenado por fecha de creación, de la más reciente a la menos reciente. Consulte el documento incrustado results.

totalCount

Número

Número total de elementos en el conjunto de resultados. Esto puede superar el número de elementos en results cuando la respuesta está paginada.

Cada elemento de results representa una 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.

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?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}
{ "results": [ { "id": "665a1234567890abcdef5678", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_UP", "replicaSetName": "rs0", "hostname": "node2.example.com", "port": 27017, "status": "COMPLETED", "noOp": false, "message": null, "created": "2026-08-11T05:40:00Z", "lastUpdated": "2026-08-11T05:41:15Z", "expires": "2026-08-11T05:45:00Z" }, { "id": "665a1234567890abcdef1234", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_DOWN", "replicaSetName": "rs0", "hostname": "node1.example.com", "port": 27017, "status": "COMPLETED", "noOp": false, "message": null, "created": "2026-08-11T05:37:59Z", "lastUpdated": "2026-08-11T05:38:30Z", "expires": "2026-08-11T05:42:59Z" } ], "totalCount": 2}
HTTP Status
Código de error
Descripción

200

--

Devuelve el arreglo de tareas de reelección.

401

USUARIO_NO_AUTORIZADO

La clave API no tiene el rol Project Automation Admin.