Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/ /

Actualizar la configuración de automatización (se ignora información confidencial)

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

Una configuración de automatización podría contener información confidencial, como contraseñas y valores de claves. Este recurso te permite actualizar la configuración de automatización de un proyecto sin actualizar ningún campo que contenga información confidencial.

PUT solicitudes al /groups/{PROJECT-ID}/automationConfig/noSecrets endpoint ignoran cualquier campo en la configuración de automatización en tu cuerpo de solicitud que contenga información sensible, dejando sus valores actuales sin cambios y actualizando todos los demás campos. Para actualizar la configuración completa de automatización, incluida cualquier información sensible, use el /groups/{ID del grupo}/automationConfig endpoint.

Para actualizar la configuración:

  1. Recuperar la configuración actual.

    Puedes usar el endpoint /groups/{ID del grupo}/automationConfig para obtener la configuración completa o el endpoint /groups/{ID del grupo}/automationConfig/noSecrets para obtener la configuración con información confidencial redactada, como contraseñas o valores clave.

  2. Haz cambios en una copia de la configuración actual, cambiando solo aquellos elementos que deseas modificar.

  3. Reemplace toda la configuración usando PUT, con la configuración actualizada en el cuerpo de la solicitud. Debe utilizar PUT. No utilizar PATCH.

    Cuando envías actualizaciones, Ops Manager realiza modificaciones internas en los datos y luego guarda la nueva versión de tu configuración.

Nota

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

Para realizar actualizaciones en el MongoDB Agent que no sean hostname, debes hacerlo a través de un endpoint 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":

Este recurso requiere el rol de Project Automation Admin.

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

PUT /groups/{PROJECT-ID}/automationConfig/noSecrets
Nombre
Tipo
Necesidad
Descripción

PROJECT-ID

string

Requerido

Identificador único de la grupo que posee la configuración de automatización.

Los siguientes parámetros de query son opcionales:

Nombre
Tipo
Necesidad
Descripción
predeterminado

bonito

booleano

Opcional

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

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

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

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://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/noSecrets?pretty=true" \
--data-binary "@/Users/admin/updated-conf.json"
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}

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

Volver

Actualiza la configuración de automatización

En esta página