/ /

Gerente de Operaciones

Actualizar la configuración de automatización

Un proyecto La configuración de automatización determina el estado objetivo de sus procesos y agentes MongoDB. El agente MongoDB crea la implementación según los objetivos especificados.

Para actualizar la configuración:

Recuperar la configuración actual.
Puede usar el punto final /groups/{PROJECT-ID}/automationConfig para obtener la configuración completa, o usar el punto final /groups/{PROJECT-ID}/automationConfig/noSecrets para obtener la configuración con información confidencial redactada, como contraseñas o valores de clave.
Haz cambios en una copia de la configuración actual, cambiando solo aquellos elementos que deseas modificar.
Reemplace toda la configuración utilizando PUTcon la configuración actualizada en el cuerpo de la solicitud. Se debe utilizar PUT. No usar PATCH.
Cuando envías actualizaciones, Ops Manager realiza modificaciones internas en los datos y luego guarda la nueva versión de tu configuración.

Importante

Una configuración de automatización podría contener información confidencial, incluidas contraseñas o valores clave. Para actualizar la configuración de automatización de un proyecto sin actualizar ningún campo que contenga información confidencial, utiliza el endpoint /groups/{ID del proyecto}/automationConfig/noSecrets.

Nota

Algunos parámetros no pueden actualizarse a través del endpoint automationConfig. Para obtener más información, consulte:

Para realizar actualizaciones al Agente MongoDB que no hostnamesean, debe hacerlo a través de un punto final diferente.

Para ver un tutorial sobre cómo actualizar una configuración de automatización, consulte Actualizar la configuración de automatización del proyecto.

Los agentes de MongoDB consultan continuamente de forma periódica a Ops Manager en busca de cambios en la configuración y obtienen actualizaciones de la configuración cuando estas ocurren. Luego, los agentes ajustan los estados de sus procesos en vivo para que coincidan.

Advertencia

Realizar cambios en la configuración de automatización con una solicitud PUT puede provocar tiempo de inactividad del clúster. Prueba los cambios en entornos inferiores antes de aplicarlos a entornos de producción.

Advertencia

No existe protección en la API de Administración de Ops Manager para prevenir modificaciones simultáneas. Si dos administradores comienzan con una configuración basada en la versión actual, realizan sus propias modificaciones y después envían sus cambios, la última modificación enviada prevalece.

Advertencia

Actualizar el nombre de usuario del agente antes de habilitar la autenticación

La configuración de automatización proporciona el único medio para habilitar la autenticación en tus clústeres usando el API. Para habilitar la autenticación, primero llama a los siguientes endpoints con "nombre de usuario": "mms-automation":

Roles necesarios

Este recurso requiere el Project Automation Admin rol.

Resource

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

PUT /groups/{PROJECT-ID}/automationConfig

Solicitud

Parámetros de ruta

Nombre	Tipo	Necesidad	Descripción
PROJECT-ID	string	Requerido	Identificador único de la 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 señala si el cuerpo de respuesta debe estar en un prettyprint formato.

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 corporales

Para revisar estos parámetros, consulta los Parámetros de Configuración de Automatización.

Respuesta

Para revisar estos parámetros, consulta los Parámetros de Configuración de Automatización.

Solicitud de ejemplo

Lo siguiente reemplaza la configuración de automatización con la configuración actualizada guardada en /Users/admin/updated-conf.json. Para ver un ejemplo de un documento de configuración actualizado, consulte Ejemplo de configuración de automatización.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --include \
  --request PUT "https://<OpsManagerHost>:<Port>/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
  --data-binary "@/Users/admin/updated-conf.json"

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

Para revisar un ejemplo de esta configuración, consulte Ejemplo de configuración de automatización.

Volver

Obtén la configuración de la automatización (sin secretos)

Actualizar la configuración de automatización (sin secretos)