/ /

Implementaciones

Empleos para la reelección

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Implementaciones

Empleos para la reelección

Obtenga todos los trabajos de reelección del conjunto 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 todos los trabajos de reelección para un conjunto de réplicas específico.

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

Resource

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

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.
ID RS	string	Requerido	Nombre del conjunto de réplicas cuyos trabajos de reelección desea listar.

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).	`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 de API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure `"envelope" : true` en la consulta. 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

Parámetros del cuerpo de la solicitud

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

Respuesta

La respuesta incluye una matriz de objetos de trabajo de reelección y el número total de objetos de trabajo recuperados.

Nombre	Tipo	Descripción
Resultados	arreglo	Listado de solicitudes de reelección, ordenado de la más reciente a la más antigua. Véase el documento adjunto `results`.
totalCount	Número	Número total de elementos en el conjunto de resultados. Este valor puede exceder el número de elementos en `results` cuando la respuesta está paginada.

`results` embeddedDocument

Cada elemento de results representa un puesto de reelección.

Nombre	Tipo	Descripción
ID	string	Cadena única de dígitos hexadecimales 24 que identifica el trabajo 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 este trabajo. Devuelve uno de los siguientes valores: `STEP_DOWN` o `STEP_UP`.
replicaSetName	string	Nombre del conjunto de réplicas de destino.
Nombre del host	string	Nombre de host del proceso de destino.
Puerto	entero	Puerto del proceso objetivo.
Estado	string	Estado del trabajo. Devuelve uno de los siguientes valores: `QUEUED`, `RUNNING`, `COMPLETED`, `FAILED` o `EXPIRED`.
noOp	booleano	Indicador que señala si la operación finalizó sin efecto.
mensaje	string	Información detallada sobre el trabajo, legible para el usuario. El administrador de operaciones completa 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.
última actualización	string	Marca de tiempo, en formato ISO 8601 UTC, de la última vez que Ops Manager actualizó el trabajo.
expira	string	Marca de tiempo, en formato ISO 8601 UTC, después de la cual un agente de automatización deja de aceptar este trabajo.

Solicitud de ejemplo

1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2      --header "Accept: application/json" \
3      --include \
4      --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 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Respuesta del cuerpo

1 {
2   "results": [
3     {
4       "id": "665a1234567890abcdef5678",
5       "groupId": "5c8100bcf2a30b12ff88258f",
6       "action": "STEP_UP",
7       "replicaSetName": "rs0",
8       "hostname": "node2.example.com",
9       "port": 27017,
10       "status": "COMPLETED",
11       "noOp": false,
12       "message": null,
13       "created": "2026-08-11T05:40:00Z",
14       "lastUpdated": "2026-08-11T05:41:15Z",
15       "expires": "2026-08-11T05:45:00Z"
16     },
17     {
18       "id": "665a1234567890abcdef1234",
19       "groupId": "5c8100bcf2a30b12ff88258f",
20       "action": "STEP_DOWN",
21       "replicaSetName": "rs0",
22       "hostname": "node1.example.com",
23       "port": 27017,
24       "status": "COMPLETED",
25       "noOp": false,
26       "message": null,
27       "created": "2026-08-11T05:37:59Z",
28       "lastUpdated": "2026-08-11T05:38:30Z",
29       "expires": "2026-08-11T05:42:59Z"
30     }
31   ],
32   "totalCount": 2
33 }

Códigos de respuesta

HTTP Status	Código de error	Descripción
200	--	Devuelve la lista de puestos de reelección.
401	USUARIO NO AUTORIZADO	La clave API no tiene el rol `Project Automation Admin`.

Volver

Obtenga uno

agentes

1	curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2	--header "Accept: application/json" \
3	--include \
4	--request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs?pretty=true"

1	{
2	"results": [
3	{
4	"id": "665a1234567890abcdef5678",
5	"groupId": "5c8100bcf2a30b12ff88258f",
6	"action": "STEP_UP",
7	"replicaSetName": "rs0",
8	"hostname": "node2.example.com",
9	"port": 27017,
10	"status": "COMPLETED",
11	"noOp": false,
12	"message": null,
13	"created": "2026-08-11T05:40:00Z",
14	"lastUpdated": "2026-08-11T05:41:15Z",
15	"expires": "2026-08-11T05:45:00Z"
16	},
17	{
18	"id": "665a1234567890abcdef1234",
19	"groupId": "5c8100bcf2a30b12ff88258f",
20	"action": "STEP_DOWN",
21	"replicaSetName": "rs0",
22	"hostname": "node1.example.com",
23	"port": 27017,
24	"status": "COMPLETED",
25	"noOp": false,
26	"message": null,
27	"created": "2026-08-11T05:37:59Z",
28	"lastUpdated": "2026-08-11T05:38:30Z",
29	"expires": "2026-08-11T05:42:59Z"
30	}
31	],
32	"totalCount": 2
33	}