Observação
Grupos e projetos são termos sinônimos. Seu {PROJECT-ID} é igual ao ID do seu projeto. Para grupos existentes, o ID do grupo/projeto permanece o mesmo. Esta página usa o termo grupo, que é mais familiar, ao se referir a descrições. O ponto de extremidade permanece conforme indicado no documento.
Use este ponto de extremidade para solicitar que o primário atual de um conjunto de réplicas renuncie, acionando uma nova eleição. O MongoDB Ops Manager enfileira uma tarefa em segundo plano para o agente de automação do hospedar de destino executar em sua próxima verificação.
Se o processo de destino não for o primário gravável quando o agente executar a tarefa, a tarefa será concluída como uma no-op em vez de falhar. Depois que o primário se afasta, ele permanece inelegível para reeleição pelo período especificado por stepDownSecs.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
POST /groups/{GROUP-ID}/replicaSets/{RS-ID}/process/{HOST-PORT}:stepDownFunções obrigatórias
A chave de API que faz esta solicitação deve ter a função Project Automation Admin.
Parâmetros do caminho da solicitação
Nome | Tipo | necessidade | Descrição |
|---|---|---|---|
ID do grupo | string | Obrigatório | String única de 24 dígitos hexadecimais que identifica seu projeto. |
RS-ID | string | Obrigatório | Nome do conjunto de réplicas que contém o processo de destino. |
hospedar-PORTA | string | Obrigatório | Processo de destino, como |
Solicitar parâmetros de query
Os seguintes parâmetros de query são opcionais:
Nome | Tipo | necessidade | Descrição | Default |
|---|---|---|---|---|
pretty | booleano | Opcional | Sinalizador que indica se o corpo da resposta está em um formato pretty-print. |
|
envelope | booleano | Opcional | Sinalizador que indica se deve envolver a resposta em um envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na query. Para endpoints que retornam um resultado, o corpo da resposta inclui:
|
|
Parâmetros do corpo da solicitação
O corpo da solicitação aceita os seguintes ajustes opcionais. Se você enviar um corpo vazio, use {}.
Nome | Tipo | Descrição | Default |
|---|---|---|---|
stepDownSecs | inteiro | Número de segundos que o primário rebaixado permanece inelegível para reeleição. Deve ser maior que |
|
secondaryCatchUpPeriodSecs | inteiro | Número de segundos a aguardar por um secundário com atraso para recuperar antes que o primário seja rebaixado. Deve ser maior ou igual a | none |
expiresAfterSeconds | inteiro | Número de segundos que a solicitação permanece na fila para um agente de automação coletar antes que a tarefa expire. Deve ser maior que |
|
Resposta
O MongoDB Ops Manager retorna 202 Accepted com um cabeçalho Location que aponta para o ponto de extremidade obter uma tarefa de reeleição e o documento da tarefa de reeleição no corpo da resposta.
Nome | Tipo | Descrição |
|---|---|---|
id | string | String única de 24dígitos hexadecimais que identifica a tarefa de reeleição. |
groupId | string | String única de 24 dígitos hexadecimais que identifica o projeto. |
ação | string | Ação que esta tarefa executa. Retorna |
ReplicaSetName | string | Nome do conjunto de réplicas de destino. |
nome do host | string | Nome de host do processo de destino. |
Porta | inteiro | Porta do processo de destino. |
Status | string | Status da tarefa. Retorna um dos seguintes valores: |
noop | booleano | Sinalizador que indica se a operação foi concluída como uma operação sem efeito (no-op). Retorna |
mensagem | string | Detalhes legíveis por humanos sobre a tarefa. O MongoDB Ops Manager preenche este campo após o agente relatar um resultado. |
Criado | string | Timestamp, no formato ISO 8601 UTC, quando o Ops Manager criou o tarefa. |
lastUpdated | string | Carimbo de data/hora, no formato ISO 8601 UTC, quando o MongoDB Ops Manager atualizou a tarefa pela última vez. |
expira | string | Carimbo de data/hora, no formato ISO 8601 UTC, após o qual um agente de automação não seleciona mais esta tarefa. |
Exemplo de solicitação
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/process/{HOST-PORT}:stepDown?pretty=true" \ --data '{ "stepDownSecs": 60, "secondaryCatchUpPeriodSecs": 10 }'Exemplo de resposta
Cabeçalho de resposta
HTTP/1.1 202 AcceptedVary: Accept-EncodingContent-Type: application/jsonLocation: https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs/{REELECTION-JOB-ID}Strict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}Corpo de resposta
{ "id": "665a1234567890abcdef1234", "groupId": "5c8100bcf2a30b12ff88258f", "action": "STEP_DOWN", "replicaSetName": "rs0", "hostname": "node1.example.com", "port": 27017, "status": "QUEUED", "noOp": false, "message": null, "created": "2026-08-11T05:37:59Z", "lastUpdated": "2026-08-11T05:37:59Z", "expires": "2026-08-11T05:42:59Z"}Códigos de resposta
HTTP Status | Código de erro | Descrição |
|---|---|---|
202 | -- | Solicitação aceita. Retorna o documento da tarefa de reeleição. |
400 | INVALID_PARAMETER | Um ajustável está fora da faixa ou o corpo da solicitação inclui |
400 | AUTOMATION_AGENT_VERSION_NOT_SUPPORTED | O agente de automação do hospedar de destino é mais antigo que |
401 | USER_UNAUTHORIZED | A chave de API não tem a função |
401 | USUÁRIO_NÃO_PODE_ACESSAR_ORGANIZAÇÃO | O chamador está fora da organização do projeto. |
404 | AUTOMAÇÃO_CONFIGURAÇÃO_NÃO_ENCONTRADA | O projeto não tem nenhuma configuração de automação publicada. |
404 | CLUSTER_NOT_FOUND |
|
404 | PROCESS_NOT_IN_CLUSTER |
|
409 | REELECTION_AGENT_NOT_RESPONDING | O agente de automação do host de destino não enviou um ping ao MongoDB Ops Manager recentemente. |
409 | REELECTION_ALREADY_IN_PROGRESS | Uma tarefa de reeleição já está na fila ou em execução para este conjunto de réplicas. |