Solicitar un conjunto de réplicas Paso secundario

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 solicitar que un proceso secundario específico de un conjunto de réplicas ascienda a primario. Ops Manager congela los demás procesos secundarios elegibles para que el proceso de destino, y no otro miembro, gane la elección. El Agente de automatización del host de destino ejecuta el procedimiento de congelación y descenso en su siguiente comprobación de conexión.

Si el proceso de destino no es un proceso secundario elegible cuando el agente ejecuta la tarea, por ejemplo porque ya es primario, o porque es un árbitro, un miembro oculto o sin derecho a voto, la tarea falla con un mensaje descriptivo.

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

Resource

POST /groups/{GROUP-ID}/replicaSets/{RS-ID}/process/{HOST-PORT}:stepUp

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 proceso de destino.
PUERTO DEL HOST	string	Requerido	Proceso objetivo, como `hostname:port`. Este proceso debe ser actualmente un proceso secundario activo y elegible.

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

El cuerpo de la solicitud acepta los siguientes parámetros configurables opcionales. Si envía un cuerpo vacío, utilice {}.

Nombre	Tipo	Descripción	predeterminado
stepDownSecs	entero	Número de segundos que el candidato saliente permanece inelegible para la reelección. Debe ser mayor que `0`.	`60`
período de recuperación secundaria en segundos	entero	Número de segundos que debe esperar un nodo secundario rezagado para ponerse al día antes de que el nodo primario baje. Debe ser mayor o igual que `0`. Si omite este campo, `mongod` aplicará su valor predeterminado.	Ninguno
congelarSegundos	entero	Número de segundos que Ops Manager congela a los demás candidatos secundarios electivos para que el objetivo gane la elección. Debe ser mayor que `0` y mayor o igual que `stepDownSecs`.	El mayor de `120` y `stepDownSecs`
expiraDespuésDeSegundos	entero	Número de segundos que la solicitud permanece en cola para que un agente de automatización la procese antes de que expire la tarea. Debe ser mayor que `0`.	El mayor de `300` y `freezeSecs`

Importante

Durante el período de congelación, todos los demás nodos secundarios elegibles se congelan y no pueden ser elegidos. Mantenga freezeSecs lo más corto posible, según lo permita su entorno. Si el host de destino deja de estar disponible durante la congelación, el conjunto de réplicas puede quedar sin un nodo primario hasta que finalice el período de congelación.

Respuesta

Ops Manager devuelve 202 Accepted con un encabezado Location que apunta al punto final del trabajo de reelección get one y al documento del trabajo de reelección en el cuerpo de la respuesta.

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 `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      --header "Content-Type: application/json" \
4      --include \
5      --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/process/{HOST-PORT}:stepUp?pretty=true" \
6      --data '{
7        "stepDownSecs": 60,
8        "freezeSecs": 120
9      }'

Respuesta de ejemplo

Encabezado de respuesta

HTTP/1.1 202 Accepted
Vary: Accept-Encoding
Content-Type: application/json
Location: https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}
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": "QUEUED",
9   "noOp": false,
10   "message": null,
11   "created": "2026-08-11T05:37:59Z",
12   "lastUpdated": "2026-08-11T05:37:59Z",
13   "expires": "2026-08-11T05:39:59Z"
14 }

Códigos de respuesta

HTTP Status	Código de error	Descripción
202	--	Solicitud aceptada. Se devuelve el documento de solicitud de reelección.
400	INVALID_PARAMETER	Un valor sintonizable está fuera de rango, o `freezeSecs` es menor que `stepDownSecs`.
400	AUTOMATION_AGENT_VERSION_NOT_SUPPORTED	El agente de automatización del host de destino es anterior a `109.0.0.9226-1`.
401	USUARIO NO AUTORIZADO	La clave API no tiene el rol `Project Automation Admin`.
401	EL USUARIO NO PUEDE ACCEDER A LA ORGANIZACIÓN	La persona que llama no pertenece a la organización del proyecto.
404	CONFIGURACIÓN DE AUTOMATIZACIÓN NO ENCONTRADA	El proyecto no tiene una configuración de automatización publicada.
404	CLÚSTER_NO_ENCONTRADO	`RS-ID` No coincide con ningún conjunto de réplicas en la implementación del proyecto.
404	PROCESO_NO_EN_CLÚSTER	`HOST-PORT` no pertenece al conjunto de réplicas mencionado.
409	AGENTE DE REELECCIÓN NO RESPONDE	El agente de automatización del host de destino no ha enviado ninguna señal al administrador de operaciones recientemente.
409	REELECCIÓN YA EN CURSO	Ya hay una tarea de reelección en cola o en ejecución para este conjunto de réplicas.

Volver

Reducir una primaria

Obtenga uno

1	curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2	--header "Accept: application/json" \
3	--header "Content-Type: application/json" \
4	--include \
5	--request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/process/{HOST-PORT}:stepUp?pretty=true" \
6	--data '{
7	"stepDownSecs": 60,
8	"freezeSecs": 120
9	}'

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