Roles necesarios
Puede llamar a este endpoint con éxito con cualquiera de los siguientes roles asignados:
Solicitud
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0
GET /groups/{PROJECT-ID}/agents/versionsParámetros de ruta de solicitud
Nombre | Tipo | Necesidad | Descripción |
|---|---|---|---|
| string | Requerido | Identificador único del proyecto. |
Parámetros de Solicitud Query
Nombre | Tipo | Necesidad | Descripción | predeterminado |
|---|---|---|---|---|
bonito | booleano | Opcional | Indicador que muestra si el cuerpo de la respuesta está en formato pretty-print. |
|
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:
|
|
Parámetros del cuerpo de la solicitud
Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.
Respuesta
Nombre | Tipo | Descripción |
|---|---|---|
| entero | Número de agentes que tu aplicación Ops Manager ha encontrado. |
| Arreglo de objetos | Detalles de cada agente en cada host que esta aplicación de Ops Manager gestiona. |
| string | Dirección IPv6 para el host que ejecuta este agente. |
| string | FQDN del host que ejecuta este agente. |
| string | Nombre del host que ejecuta este agente. |
| string | Versión de este Agente que ejecuta este host. |
| entero | Conteo de pings recibidos de este agente. |
| entero | Conteo de llamadas de configuración recibidas de este Agente. |
| string | Etiqueta para este agente si la copia de seguridad está habilitada. |
| Número | Marca de tiempo en la cantidad de milisegundos que han transcurrido desde la Unix epoch cuando Ops Manager recibió el último ping de este Agente. se aplica a los agentes de supervisión y agentes de MongoDB con supervisión habilitada. |
| Número | Timestamp en el número de milisegundos transcurridos desde la época UNIX cuando Ops Manager recibió la última llamada de configuración de este agente. |
| Número | Número de milisegundos que han pasado desde la última llamada de configuración. |
| booleano | Indicador que muestra si el host en el que se ejecuta este agente es el primario. |
| booleano | Indicador que señala si Ops Manager gestiona este agente. Se aplica solo a los agentes de supervisión y agentes de copias de seguridad. |
| entero | Número de procesos de MongoDB que se ejecutan en este host. |
| booleano | Bandera que indica que el agente instalado está desactualizado. La versión actual liberada de este agente excede la versión del agente instalado. |
| booleano | Indicador que indica que este agente está obsoleto. La versión mÃnima compatible con este agente supera la versión del agente instalado. |
| string | Estado actual de este Agente.
|
| booleano | Bandera que indica que esta entrada es un módulo del MongoDB Agent. |
| booleano | Indicador de si algún Agente se ejecuta en un host en un estado no administrado. |
| booleano | Indicador que señala si algún agente en cualquier implementación ejecuta una versión en desuso de ese Agente. |
| booleano | Indicador si algún agente en cualquier implementación ejecuta una versión no actualizada de ese agente. |
| string | La versión más reciente de este tipo de Agente. |
| Arreglo de objetos | Uno o más enlaces a subrecursos o recursos relacionados. Todos los arreglos |
| string | Versión mÃnima compatible de este Agente instalada en este host. |
| string | Versión mÃnima compatible de este agente que funciona con tu instalación de Ops Manager. |
Solicitud de ejemplo
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --request GET "http://{opsManagerHost}:{port}/api/public/v1.0/groups/{PROJECT-ID}/agents/versions?pretty=true"Respuesta de ejemplo
Encabezado de respuesta
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}Respuesta del cuerpo
{ "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"}