Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Actualizar las políticas de funcionalidades de un Proyecto

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

Este recurso requiere el Project Owner.

PUT /groups/{PROJECT-ID}/controlledFeature

Importante

Debes incluir todas las políticas que quieras incluir y mantener. Este recurso sobrescribe cualquier política existente. Si se omite una política al usar este recurso, esa política no se aplicará después de la actualización. Esa política se ha eliminado.

Nombre
Tipo
Necesidad
Descripción

PROJECT-ID

string

Requerido

Identificador único del proyecto que tiene las funcionalidades controladas.

Los siguientes parámetros de query son opcionales:

Nombre
Tipo
Descripción
predeterminado

Num. de pág.

entero

Número de página (basado en índice a partir de 1).

1

elementosPorPágina

entero

Número de elementos a devolver por página, hasta un máximo de 500.

100

bonito

booleano

Indica si el cuerpo de la respuesta debe estar en un formato prettyprint.

false

envelope

booleano

Indica si se debe 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 corregir esto, establezca "envelope" : true en la query.

Para los endpoints que devuelven un resultado, el cuerpo de respuesta incluye:

  • status: Código de respuesta HTTP

  • content: Cuerpo de respuesta esperado

Para los endpoints que devuelven una lista de resultados, el objeto results es un sobre. Cloud Manager añade el campo status al cuerpo de la respuesta.

Ninguno

Nombre
Tipo
Descripción

externalManagementSystem

Objeto

Identificar los parámetros para el sistema externo que gestiona este proyecto de Ops Manager.

externalManagementSystem
.name

string

Etiqueta identificadora para el sistema externo que gestiona este Proyecto de Ops Manager.

externalManagementSystem
.systemId

string

Identificador único del sistema externo que gestiona este proyecto de Ops Manager.

externalManagementSystem
.version

string

Versión activa del sistema externo que gestiona este proyecto de Ops Manager.

policies

arreglo

Lista de políticas que el sistema externo aplica a este proyecto de Ops Manager.

policies
.policy[n]

Objeto

Conjunto único de políticas para este proyecto de Ops Manager. Este parámetro se puede configurar una o varias veces en el arreglo policies.

Los valores aceptados son:

  • EXTERNALLY_MANAGED_LOCK: Los usuarios no pueden usar MongoDB Ops Manager para gestionar otras configuraciones enumeradas en el arreglo policies.policy[n]. Estos mismos usuarios pueden usar un sistema externo configurado, como el operador de Kubernetes, para gestionar esta configuración.

  • DISABLE_USER_MANAGEMENT: Los usuarios no pueden gestionar usuarios o roles.

  • DISABLE_AUTHENTICATION_MECHANISMS: Los usuarios no pueden cambiar la configuración de autenticación.

  • DISABLE_SET_MONGOD_CONFIG: Los usuarios no pueden cambiar ninguna de las mongod configuraciones enumeradas en el arreglo policies[n].disabledParams.

  • DISABLE_SET_MONGOD_VERSION: Los usuarios no pueden cambiar la versión de ningún mongod o mongos.

  • DISABLE_BACKUP_AGENT: Los usuarios no pueden habilitar ni deshabilitar el agente de copias de seguridad.

  • DISABLE_MONGOD_LOG_MANAGEMENT: Los usuarios no pueden cambiar la configuración de gestión de registros.

  • DISABLE_IMPORT_TO_AUTOMATION: Los usuarios no pueden gestionar implementaciones mediante la automatización.

  • DISABLE_AGENT_API_KEY_MANAGEMENT: Los usuarios no pueden crear o actualizar claves API del agente.

  • DISABLE_MONGOD_HOST_MANAGEMENT: Los usuarios no pueden cambiar el tipo de servidor de los hosts.

policies[n]
.disabledParams

arreglo

Lista de configuraciones de mongod para deshabilitar al aplicar la política DISABLE_SET_MONGOD_CONFIG. No todas las opciones de MongoDB están disponibles en la automatización, lo que puede provocar intentos de importación fallidos. Para aprender más, consulta Configuración de MongoDB y soporte de automatización.

Nombre
Tipo
Descripción

_id

string

Identificador único del Proyecto al que se aplica esta política.

created

string

Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se creó esta política de control de funcionalidades.

updated

string

Marca de tiempo en ISO 8601 formato de fecha y hora en UTC cuando se actualizó esta política de control de funcionalidades.

externalManagementSystem

Objeto

Identificación de parámetros para el sistema externo que gestiona este Proyecto Cloud Manager.

externalManagementSystem
.name

string

Etiqueta identificativa para el sistema externo que gestiona este Proyecto de Cloud Manager.

externalManagementSystem
.systemId

string

Identificador único del sistema externo que gestiona este Proyecto de Cloud Manager.

externalManagementSystem
.version

string

Liberación activa del sistema externo que gestiona este Proyecto de Cloud Manager.

policies

arreglo

Lista de políticas que el sistema externo aplica a este proyecto de Cloud Manager.

policies
.policy[n]

Objeto

Conjunto único de políticas para este proyecto de Cloud Manager. Este parámetro se puede configurar una o más veces en el arreglo policies.

Los valores posibles son:

  • EXTERNALLY_MANAGED_LOCK: Los usuarios no pueden usar Cloud Manager para gestionar otras configuraciones enumeradas en el arreglo policies.policy[n]. Estos mismos usuarios pueden usar un sistema externo configurado, como el operador de Kubernetes, para gestionar esta configuración.

  • DISABLE_USER_MANAGEMENT: Los usuarios no pueden gestionar usuarios o roles.

  • DISABLE_AUTHENTICATION_MECHANISMS: Los usuarios no pueden cambiar la configuración de autenticación.

  • DISABLE_SET_MONGOD_CONFIG: Los usuarios no pueden cambiar ninguna de las mongod configuraciones enumeradas en el arreglo policies[n].disabledParams.

  • DISABLE_SET_MONGOD_VERSION: Los usuarios no pueden cambiar la versión de ningún mongod o mongos.

  • DISABLE_BACKUP_AGENT: Los usuarios no pueden habilitar ni deshabilitar el agente de copias de seguridad.

  • DISABLE_MONGOD_LOG_MANAGEMENT: Los usuarios no pueden cambiar la configuración de gestión de registros.

  • DISABLE_IMPORT_TO_AUTOMATION: Los usuarios no pueden gestionar implementaciones mediante la automatización.

  • DISABLE_AGENT_API_KEY_MANAGEMENT: Los usuarios no pueden crear o actualizar claves API del agente.

  • DISABLE_MONGOD_HOST_MANAGEMENT: Los usuarios no pueden cambiar el tipo de servidor de los hosts.

policies[n]
.disabledParams

arreglo

Lista de configuraciones mongod que se deben deshabilitar si aplica la política DISABLE_SET_MONGOD_CONFIG. No todas las opciones de MongoDB están disponibles en la automatización, lo que puede provocar intentos de importación fallidos. Para aprender más, consulta Configuración de MongoDB y soporte de automatización.

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request PUT "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/controlledFeature?pretty=true" \ --data '{ "externalManagementSystem": { "name": "Operator", "systemId": "6d6c139ae5528707b6e8e3b2", "version": "0.2.1" }, "policies": [ {"policy": "ExternallyManagedLock"}, {"policy": "DisableUserManagement"}, {"policy": "DisableAuthenticationMechanisms"}, {"policy": "DisableSetMongodVersion"}, { "policy": "DisableSetMongodConfig", "disabledParams": ["net.tls.CAFile"] } ] }'
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-alive
HTTP/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}
{ "_id": "{PROJECT-ID}", "created": "2019-08-29T15:03:24Z", "updated": "2019-08-29T15:03:24Z", "externalManagementSystem": { "name": "Operator", "systemId": "6d6c139ae5528707b6e8e3b2", "version": "0.2.1" }, "policies": [ {"policy": "ExternallyManagedLock"}, {"policy": "DisableUserManagement"}, {"policy": "DisableAuthenticationMechanisms"}, {"policy": "DisableSetMongodVersion"}, { "policy": "DisableSetMongodConfig", "disabledParams": ["net.tls.CAFile"] } ]}