/ /

/ /

Obtener agentes por tipo para un proyecto

Cloud Manager dejará de admitir la Automatización, la Copia de seguridad y la Supervisión para MongoDB 3.6 y 4.0 después del 30de agosto de 2024. Por favor actualiza tu implementación de MongoDB o migra a Atlas.

Obtener todos los agentes de un tipo especificado (es decir, Supervisión, copia de seguridad o automatización) para un proyecto.

Nota

Grupos y proyectos son términos sinónimos. Tu {PROJECT-ID} es el mismo que tu id. de proyecto. Para los grupos existentes, su ID de grupo/ID del grupo seguirá siendo el mismo. Esta página utiliza el término más familiar grupo al referirse a descripciones. El endpoint se mantiene tal como se indica en el documento.

URL base: https://cloud.mongodb.com/api/public/v1.0

Resource

GET /groups/{PROJECT-ID}/agents/{TYPE}

Parámetros de la ruta de solicitud

Nombre	Tipo	Descripción
PROJECT-ID	string	Identificador único del proyecto que posee la clave API del agente.
Tipo	string	El tipo de agente a recuperar. TYPE puede ser uno de los siguientes valores: `MONITORING` `BACKUP` `AUTOMATION`

Parámetros de Solicitud Query

Los siguientes parámetros de query son opcionales:

Nombre	Tipo	Necesidad	Descripción	predeterminado
Num. de pág.	Número	Opcional	Entero basado en uno que devuelve una subsección de resultados.	`1`
elementosPorPágina	Número	Opcional	Número de elementos a devolver por página, hasta un máximo de 500.	`100`
bonito	booleano	Opcional	Bandera que indica si el cuerpo de la respuesta debe estar en formato prettyprint formato.	`false`
envelope	booleano	Opcional	Bandera que indica si se debe o no envolver la respuesta en un sobre. Algunos Los clientes de laAPI no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure `envelope : true` en la consulta. Para los endpoints que devuelven una lista de resultados, el objeto `content` es un sobre. Cloud Manager añade el campo `status` al cuerpo de la respuesta.	`false`
backupJobsEnabledOnly	booleano	Opcional	Indicador que indica si se deben excluir de la respuesta los daemons no habilitados para realizar copias de seguridad de bases de datos. Establezca este valor en `false` para incluir las configuraciones de daemon con el indicador `backupJobsEnabled` establecido en `false`.	`true`

Parámetros del cuerpo de la solicitud

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

Respuesta

Nombre	Tipo	Descripción
`typeName`	string	El tipo de agente: `MONITORING`, `BACKUP` o `AUTOMATION`.
`hostname`	string	Nombre del host principal. Un host normalmente puede tener alias, por lo que el primario es el mejor nombre disponible según lo decida el Cloud Manager.
`confCount`	Número	Número de llamadas de configuración.
`lastConf`	fecha y hora	Fecha y hora de la última llamada de configuración.
`stateName`	string	El estado actual del agente. `stateName` puede devolver los siguientes valores: `ACTIVE`: el agente está activo y funcionando `STANDBY`:el agente está en espera `NO_PROCESSES`:el agente no administra, supervisa ni realiza copias de seguridad de ningún proceso.
`pingCount`	Número	Solo aplicable a agentes de monitorización. Número de pings que el agente de monitorización ha enviado a la `hostname` URL.
`isManaged`	Booleano	Solo aplicable a agentes de monitorización y backup. Especifica si Cloud Manager administra el agente.
`lastPing`	fecha y hora	Solo aplicable a agentes de monitoreo. Hora del ping más reciente.
`tag`	string	Solo aplicable a los agentes de copias de seguridad. La etiqueta del agente, si hay alguna.

Solicitud de ejemplo

Obtener todos los agentes de supervisión para un Proyecto.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/agents/MONITORING"

Respuesta de ejemplo

Encabezado de respuesta

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

Respuesta del cuerpo

{
  "links" : [],
  "results": [
    {
      "confCount": 59,
      "hostname": "example",
      "isManaged": true,
      "lastConf": "2015-06-18T14:21:42Z",
      "lastPing": "2015-06-18T14:21:42Z",
      "pingCount": 6,
      "stateName": "ACTIVE",
      "typeName": "MONITORING"
    }
  ],
  "totalCount": 1
}

Volver

Obtener vínculos

Crear clave de API