Consigue un trabajo de reelección con un 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 un único trabajo de reelección mediante su identificador único. Consulte este punto final periódicamente hasta que el trabajo alcance un estado final.

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.
ID RS	string	Requerido	Nombre del conjunto de réplicas que contiene el trabajo de reelección.
ID DE TRABAJO DE REELECCIÓN	string	Requerido	Cadena única de dígitos hexadecimales 24 que identifica el trabajo de reelección, tal como lo devuelve el punto final de descenso o ascenso.

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre	Tipo	Necesidad	Descripción	predeterminado
bonito	booleano	Opcional	Indicador que especifica si el cuerpo de la respuesta está en formato legible.	`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`

Parámetros del cuerpo de la solicitud

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

Respuesta

La respuesta devuelve un único 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.

Valores de estado laboral

Estado	terminal	Significado
EN COLA	No	Ops Manager creó la tarea. Está esperando a que el Agente de automatización del host de destino la procese.
FUNCIONAMIENTO	No	El agente está ejecutando el trabajo.
COMPLETADO	Sí	La operación ha finalizado. Compruebe `noOp` para determinar si la operación ha producido algún cambio.
Fallido	Sí	La operación no pudo completarse. Consulte `message` para conocer el motivo.
VENCIDO	Sí	Ningún agente aceptó el trabajo antes de que transcurriera `expiresAfterSeconds`.

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/{REELECTION-JOB-ID}?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   "id": "665a1234567890abcdef1234",
3   "groupId": "5c8100bcf2a30b12ff88258f",
4   "action": "STEP_UP",
5   "replicaSetName": "rs0",
6   "hostname": "node2.example.com",
7   "port": 27017,
8   "status": "COMPLETED",
9   "noOp": false,
10   "message": null,
11   "created": "2026-08-11T05:37:59Z",
12   "lastUpdated": "2026-08-11T05:38:45Z",
13   "expires": "2026-08-11T05:39:59Z"
14 }

Códigos de respuesta

HTTP Status	Código de error	Descripción
200	--	Devuelve el documento de trabajo para la reelección.
401	USUARIO NO AUTORIZADO	La clave API no tiene el rol `Project Automation Admin`.
404	REELECCIÓN_NO_ENCONTRADA	`REELECTION-JOB-ID` es desconocido o está mal formado, o el trabajo no pertenece al conjunto de réplicas nombrado en `RS-ID`.

Volver

Mejora tu rendimiento en la secundaria

Obtener todo

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/{REELECTION-JOB-ID}?pretty=true"

1	{
2	"id": "665a1234567890abcdef1234",
3	"groupId": "5c8100bcf2a30b12ff88258f",
4	"action": "STEP_UP",
5	"replicaSetName": "rs0",
6	"hostname": "node2.example.com",
7	"port": 27017,
8	"status": "COMPLETED",
9	"noOp": false,
10	"message": null,
11	"created": "2026-08-11T05:37:59Z",
12	"lastUpdated": "2026-08-11T05:38:45Z",
13	"expires": "2026-08-11T05:39:59Z"
14	}