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 recuperar todas as tarefas de reeleição para um conjunto de réplicas específico.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
Resource
GET /groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobsFunçõ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 cujas tarefas de reeleição você deseja listar. |
Solicitar parâmetros de query
Nome | Tipo | Descrição | Default |
|---|---|---|---|
pageNum | inteiro | Número da página (com base em índice 1). |
|
itemsPerPage | inteiro | Número de itens a serem devolvidos por página, até um máximo de 500. |
|
pretty | booleano | Indica se o corpo da resposta deve estar em formato prettyprint. |
|
envelope | booleano | Indica se deseja ou não 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, configure Para endpoints que retornam um resultado, o corpo da resposta inclui:
Para endpoints que retornam uma lista de resultados, o objeto | none |
Parâmetros do corpo da solicitação
Este endpoint não usa parâmetros do corpo da solicitação HTTP.
Resposta
A resposta inclui uma array de objetos de tarefa de reeleição e o número total de objetos de tarefa recuperados.
Nome | Tipo | Descrição |
|---|---|---|
Resultados | array | Array de tarefas de reeleição, ordenadas da mais recentemente criada para a menos recentemente criada. Veja o documento incorporado |
contagem total | número | Número total de itens no conjunto de resultados. Isso pode exceder o número de itens em |
results documento incorporado
Cada elemento de results representa uma tarefa de reeleição.
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 um dos seguintes valores: |
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 um no-op. |
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" \ --include \ --request GET "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{GROUP-ID}/replicaSets/{RS-ID}/reElectionJobs?pretty=true"Exemplo de resposta
Cabeçalho de resposta
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}Corpo de resposta
{ "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 resposta
HTTP Status | Código de erro | Descrição |
|---|---|---|
200 | -- | Retorna o array de tarefas de reeleição. |
401 | USER_UNAUTHORIZED | A chave de API não tem a função |