Funções obrigatórias
Você pode chamar esse endpoint com sucesso com qualquer um dos seguintes roles atribuídos:
Solicitar
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
GET /groups/{PROJECT-ID}/agents/versionsParâmetros do caminho da solicitação
Nome | Tipo | necessidade | Descrição |
|---|---|---|---|
| string | Obrigatório | Identificador único do projeto. |
Solicitar parâmetros de query
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
Este endpoint não usa parâmetros do corpo da solicitação HTTP.
Resposta
Nome | Tipo | Descrição |
|---|---|---|
| inteiro | Número de agentes que seu aplicativo de Ops Manager encontrou. |
| Array de objetos | Detalhes de cada agente em cada host que esta aplicação de Ops Manager managed. |
| string | Endereço IPv6 para o host que executa este agente. |
| string | FQDN do host que executa este agente. |
| string | Nome do host que executa este agente. |
| string | Versão deste agente que este host executa. |
| inteiro | Contagem de ping recebidos deste agente. |
| inteiro | Contagem de chamadas de configuração recebidas deste agente. |
| string | Etiqueta para este agente se o backup estiver habilitado. |
| número | Registro de data/hora no número de milissegundos decorridos desde a época do UNIX em que o Ops Manager recebeu o último ping desse agente. Aplica-se a agentes de monitoramento e agentes MongoDB com o monitoramento habilitado. |
| número | Registro de data/hora no número de milissegundos decorridos desde a época do UNIX em que o Ops Manager recebeu a última chamada de configuração desse agente. |
| número | Número de milissegundos que se passaram desde a última chamada de configuração. |
| booleano | Sinalizador que indica se o host no qual este Agente é executado é o primary. |
| booleano | Sinalizador que indica se o Ops Manager managed este agente. Aplica-se apenas ao agente de monitoramento e agente de backup. |
| inteiro | Número de processos MongoDB executados neste host. |
| booleano | Sinalizador que indica que o agente instalado está desatualizado. A versão lançada atual deste agente excede a versão do agente instalado. |
| booleano | O sinalizador que indica que este agente está obsoleto. A versão mínima suportada desse agente excede a versão do agente instalado. |
| string | Estado atual deste agente.
|
| booleano | O sinalizador que indica que esta entrada é um módulo do MongoDB Agent. |
| booleano | Sinalizador que indica se algum agente é executado em um host em um estado não gerenciado. |
| booleano | Sinalizador que indica se algum agente em qualquer sistema executa uma versão obsoleta desse agente. |
| booleano | Sinalizador que indica se algum agente em qualquer sistema executa uma versão não atual desse agente. |
| string | Versão mais recente deste tipo de agente. |
| Array de objetos | Um ou mais links para sub-recursos ou recursos relacionados. Todas as arrays |
| string | Versão mínima suportada deste agente instalado neste host. |
| string | Versão mínima suportada desse agente que funciona com a instalação do Ops Manager. |
Exemplo de solicitação
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --request GET "http://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}/agents/versions?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
{ "count": 0, "entries": [], "isAnyAgentNotManaged": false, "isAnyAgentVersionDeprecated": false, "isAnyAgentVersionOld": false, "latestVersion": "10.14.0.6304", "links": [{ "href": "http://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}/agents/current", "rel": "self" }, { "href": "http://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}", "rel": "http://mms.mongodb.com/group" } ], "minimumAgentVersionDetected": "10.14.0.6304", "minimumVersion": "5.0.0.309"}