Docs Home

/ /

Recurso de configuración

Docs Home

/ /

Automatización

Recurso de configuración

Recurso de configuración

Actualizar versiones de agentes

Esta endpoint actualiza el MongoDB Agent y las herramientas a las versiones más recientes disponibles al momento de la solicitud:

Después de completar esta solicitud, Cloud Manager modifica la configuración del agente y guarda la versión actualizada.

Roles necesarios

Este recurso requiere el rol de Project Automation Admin.

Resource

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

POST /groups/{PROJECT-ID}/automationConfig/updateAgentVersions

Solicitud

Parámetros de ruta

Nombre	Tipo	Necesidad	Descripción
PROJECT-ID	string	Requerido	Identificador único del grupo que posee la configuración de automatización.

Parámetros de query

Los siguientes parámetros de query son opcionales:

Nombre

Tipo

Necesidad

Descripción

predeterminado

bonito

booleano

Opcional

Indicador que muestra si el cuerpo de la respuesta debe estar en formato prettyprint.

false

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:

Nombre	Descripción
`status`	Código de respuesta HTTP
`content`	Cuerpo de respuesta esperado

false

Parámetros del cuerpo

Nombre	Tipo	Necesidad	Descripción
automationAgentVersion	string	Opcional	Versión a la que se desea actualizar el MongoDB Agent.
biConnectorVersión	string	Opcional	Versión a la que quieres actualizar el BI Connector.
mongoDbToolsVersion	string	Opcional	Versión a la que deseas actualizar las MongoDB Database Tools

Respuesta

Parameter	Tipo	Descripción
automationAgentVersion	string	Versión del agente de MongoDB en el proyecto especificado.
backupAgentVersion	string	Versión del agente de copias de seguridad en el proyecto especificado. Cloud Manager eliminó el agente de copia de seguridad, por lo que este parámetro debe devolver null.
biConnectorVersión	string	Versión del MongoDB Connector para BI en el proyecto especificado.
mongoDbToolsVersion	string	Versión de las Herramientas de Base de Datos MongoDB en el proyecto especificado.
monitoringAgentVersion	string	Versión del agente de supervisión en el Proyecto especificado. Cloud Manager ha eliminado el agente de supervisión, por lo que este parámetro debería devolver null.

Solicitud de ejemplo

1 curl --user "{publicApiKey}:{privateApiKey}" --digest \
2      --header "Accept: application/json" \
3      --header "Content-Type: application/json" \
4      --include \
5      --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/updateAgentVersions?pretty=true" \
6      --data '{
7        "automationAgentVersion": "11.11.0.7355"
8      }'

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

1 {
2   "automationAgentVersion": "11.11.0.7355",
3   "backupAgentVersion" : null,
4   "biConnectorVersion" : "2.14.0",
5   "mongoDbToolsVersion" : null,
6   "monitoringAgentVersion" : null
7 }

Volver

Ejemplo de configuración de automatización

Obtener configuraciones de copia de seguridad

1	curl --user "{publicApiKey}:{privateApiKey}" --digest \
2	--header "Accept: application/json" \
3	--header "Content-Type: application/json" \
4	--include \
5	--request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/updateAgentVersions?pretty=true" \
6	--data '{
7	"automationAgentVersion": "11.11.0.7355"
8	}'

1	{
2	"automationAgentVersion": "11.11.0.7355",
3	"backupAgentVersion" : null,
4	"biConnectorVersion" : "2.14.0",
5	"mongoDbToolsVersion" : null,
6	"monitoringAgentVersion" : null
7	}