Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Listar servidores do Ops Manager ativos

Retorna uma lista de todos os servidores ativos do Ops Manager. O Ops Manager considera um servidor ativo se tiver enviado uma pulsação para o banco de dados de aplicativos nos últimos 20 segundos. Use esse endpoint para descobrir valores válidos de serverId antes de enviar uma solicitação de coleção de registro.

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

GET /admin/servers

Exige que a API Key chamando este ponto de extremidade tenha o Global Read Only função.

Este endpoint não usa parâmetros de caminho de solicitação HTTP.

Nome
Tipo
necessidade
Descrição
Default

pageNum

número

Opcional

Um inteiro baseado que retorna uma subseção de resultados.

1

itemsPerPage

número

Opcional

Número de itens a serem devolvidos por página, até um máximo de 500.

100

type

string

Opcional

Tipo de servidor para filtrar. Passe este parâmetro várias vezes para incluir vários tipos (?type=VALUE_1&type=VALUE_2). Os valores válidos são:

  • MMS_SERVER: o servidor de aplicativos do MongoDB Ops Manager

  • BACKUP_DAEMON: um Backup Daemon

Se você omitir este parâmetro, o MongoDB Ops Manager retornará todos os tipos de servidor.

todos os tipos

status

string

Opcional

Status do servidor pelo qual filtrar. Atualmente, o único valor válido é active. Qualquer outro valor retorna 400 INVALID_SERVER_STATUS. Se você omitir este parâmetro, o Ops Manager retornará servidores ativos.

active

pretty

booleano

Opcional

Indica se o corpo da resposta usa um formato prettyprint.

false

envelope

booleano

Opcional

Indica se deseja 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 envelope=true na query.

false

Este endpoint não usa parâmetros do corpo da solicitação HTTP.

A resposta inclui uma array de objetos de servidor , uma array de objetos de link e o número total de objetos de servidor recuperados.

Nome
Tipo
Descrição

results

array

Array de servidores ativos do MongoDB Ops Manager. Consulte documento incorporado de resultados.

links

array

Array de um ou mais links para sub-recursos ou recursos relacionados. As relações entre URLs seguem a Especificação de Link da Web (RFC 5988).

totalCount

número

Número total de itens no conjunto de resultados. Pode exceder o tamanho de results quando paginado.

Cada elemento results representa um servidor Ops Manager ativo.

Nome
Tipo
Descrição

results[n].serverId

string

Identificador do servidor ativo do Ops Manager.

results[n].serverType

string

Tipo de servidor. Retorna um dos seguintes valores: MMS_SERVER, BACKUP_DAEMON.

results[n].lastPing

string

Carimbo de data/hora, no formato ISO 8601 UTC, quando o servidor enviou pela última vez um heartbeat.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --include \ --request GET \ "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/servers?pretty=true"
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-alive
HTTP/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}
{ "links": [ { "href": "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/servers?pageNum=1&itemsPerPage=100", "rel": "self" } ], "results": [ { "serverId": "om-server-1.example.com", "serverType": "MMS_SERVER", "lastPing": "2026-04-13T10:00:15Z" }, { "serverId": "om-server-2.example.com", "serverType": "MMS_SERVER", "lastPing": "2026-04-13T10:00:12Z" }, { "serverId": "daemon-host-1.example.com", "serverType": "BACKUP_DAEMON", "lastPing": "2026-04-13T10:00:10Z" }, { "serverId": "daemon-host-2.example.com", "serverType": "BACKUP_DAEMON", "lastPing": "2026-04-13T10:00:08Z" } ], "totalCount": 4}