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
Resource
GET /groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobsRoles 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 cuyas tareas de re-elección desea enumerar. |
Parámetros de Solicitud Query
Nombre | Tipo | Descripción | predeterminado |
|---|---|---|---|
Num. de pág. | entero | Número de página (basado en índice a partir de 1). |
|
elementosPorPágina | entero | Número de elementos a devolver por página, hasta un máximo de 500. |
|
bonito | booleano | Indica si el cuerpo de la respuesta debe estar en un formato prettyprint. |
|
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 Para los endpoints que devuelven un resultado, el cuerpo de respuesta incluye:
Para los endpoints que devuelven una lista de resultados, el objeto | Ninguno |
Parámetros del cuerpo de la solicitud
Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.
Respuesta
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 |
totalCount | Número | Número total de elementos en el conjunto de resultados. Esto puede superar el número de elementos en |
results embeddedDocument
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: |
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. |
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?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
{ "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}Códigos de respuesta
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 |