Actualizar las políticas de funcionalidades de un Proyecto

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

Roles necesarios

Este recurso requiere el Project Owner.

Resource

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.

Parámetros de ruta de solicitud

Nombre	Tipo	Necesidad	Descripción
`PROJECT-ID`	string	Requerido	Identificador único del proyecto que tiene las funcionalidades controladas.

Parámetros de Solicitud Query

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 o no envolver la respuesta en un sobre. Algunos clientes de API 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 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. Ops Manager agrega el campo `status` al cuerpo de la respuesta.	Ninguno

Parámetros del cuerpo de la solicitud

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[n]` `.policy`	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: `ExternallyManagedLock`Los usuarios no pueden usar Ops Manager para administrar otras configuraciones especificadas en el array `policies[n].policy`. Estos mismos usuarios pueden usar un sistema externo configurado, como el Operador de Kubernetes, para administrar dichas configuraciones. `DisableUserManagement`Los usuarios no pueden administrar usuarios ni roles. `DisableAuthenticationMechanisms`Los usuarios no pueden cambiar la configuración de autenticación. `DisableSetMongodConfig`: Los usuarios no pueden cambiar ninguna configuración `mongod` que aparezca en la matriz `policies[n].disabledParams`. `DisableSetMongodVersion`: Los usuarios no pueden cambiar la versión de ningún `mongod` o `mongos`. `DisableBackupAgent`Los usuarios no pueden habilitar ni deshabilitar el agente de copia de seguridad. `DisableMongodLogManagement`Los usuarios no pueden cambiar la configuración de administración de registros. `DisableImportToAutomation`Los usuarios no pueden gestionar las implementaciones mediante la automatización. `DisableAgentApiKeyManagement`Los usuarios no pueden crear ni actualizar claves API de agente. `DisableMongodHostManagement`: Los usuarios no pueden cambiar el tipo de servidor de los hosts.
`policies[n]` `.disabledParams`	arreglo	Lista de `mongod` configuraciones para deshabilitar al aplicar la política `DISABLE_SET_MONGOD_CONFIG`. La automatización no admite todas las opciones de MongoDB, lo que puede provocar intentos fallidos de importación. Para obtener más información, consulte Configuraciones de MongoDB y Soporte de Automatización.

Respuesta

Nombre	Tipo	Descripción
`_id`	string	Identificador único del Proyecto para el que estás configurando 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 características.
`updated`	string	Marca de tiempo en formato de fecha y hora ISO 8601 en UTC cuando se actualizó esta política de control de características.
`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 posibles son: `EXTERNALLY_MANAGED_LOCK`Los usuarios no pueden usar Ops Manager para administrar otras configuraciones especificadas en el array `policies.policy[n]`. Estos mismos usuarios pueden usar un sistema externo configurado, como el Operador de Kubernetes, para administrar dichas configuraciones. `DISABLE_USER_MANAGEMENT`Los usuarios no pueden administrar usuarios ni 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 configuración `mongod` que aparezca en la matriz `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 copia de seguridad. `DISABLE_MONGOD_LOG_MANAGEMENT`Los usuarios no pueden cambiar la configuración de administración de registros. `DISABLE_IMPORT_TO_AUTOMATION`Los usuarios no pueden gestionar las implementaciones mediante la automatización. `DISABLE_AGENT_API_KEY_MANAGEMENT`Los usuarios no pueden crear ni actualizar claves API de agente. `DISABLE_MONGOD_HOST_MANAGEMENT`: Los usuarios no pueden cambiar el tipo de servidor de los hosts.
`policies[n]` `.disabledParams`	arreglo	Lista de `mongod` de configuraciones para desactivar si aplicas la política `DISABLE_SET_MONGOD_CONFIG`. La automatización no es compatible con todas las opciones de MongoDB, lo que puede resultar en intentos fallidos de importación. Para obtener más información, consulta Configuración de MongoDB y soporte de automatización.

Solicitud de ejemplo

1 curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2      --header "Accept: application/json" \
3      --header "Content-Type: application/json" \
4      --include \
5      --request PUT "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/controlledFeature?pretty=true" \
6      --data '{
7        "externalManagementSystem":
8        {
9          "name": "Operator",
10          "systemId": "6d6c139ae5528707b6e8e3b2",
11          "version": "0.2.1"
12        },
13        "policies": [
14          {"policy": "ExternallyManagedLock"},
15          {"policy": "DisableUserManagement"},
16          {"policy": "DisableAuthenticationMechanisms"},
17          {"policy": "DisableSetMongodVersion"},
18          {
19            "policy": "DisableSetMongodConfig",
20            "disabledParams": ["net.tls.CAFile"]
21          }
22        ]
23      }'

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   "_id": "{PROJECT-ID}",
3   "created": "2019-08-29T15:03:24Z",
4   "updated": "2019-08-29T15:03:24Z",
5   "externalManagementSystem":
6   {
7     "name": "Operator",
8     "systemId": "6d6c139ae5528707b6e8e3b2",
9     "version": "0.2.1"
10   },
11   "policies": [
12     {"policy": "ExternallyManagedLock"},
13     {"policy": "DisableUserManagement"},
14     {"policy": "DisableAuthenticationMechanisms"},
15     {"policy": "DisableSetMongodVersion"},
16     {
17       "policy": "DisableSetMongodConfig",
18       "disabledParams": ["net.tls.CAFile"]
19     }
20   ]
21 }

Volver

Recuperar para un proyecto

Retrieve All

1	curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2	--header "Accept: application/json" \
3	--header "Content-Type: application/json" \
4	--include \
5	--request PUT "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/controlledFeature?pretty=true" \
6	--data '{
7	"externalManagementSystem":
8	{
9	"name": "Operator",
10	"systemId": "6d6c139ae5528707b6e8e3b2",
11	"version": "0.2.1"
12	},
13	"policies": [
14	{"policy": "ExternallyManagedLock"},
15	{"policy": "DisableUserManagement"},
16	{"policy": "DisableAuthenticationMechanisms"},
17	{"policy": "DisableSetMongodVersion"},
18	{
19	"policy": "DisableSetMongodConfig",
20	"disabledParams": ["net.tls.CAFile"]
21	}
22	]
23	}'

1	{
2	"_id": "{PROJECT-ID}",
3	"created": "2019-08-29T15:03:24Z",
4	"updated": "2019-08-29T15:03:24Z",
5	"externalManagementSystem":
6	{
7	"name": "Operator",
8	"systemId": "6d6c139ae5528707b6e8e3b2",
9	"version": "0.2.1"
10	},
11	"policies": [
12	{"policy": "ExternallyManagedLock"},
13	{"policy": "DisableUserManagement"},
14	{"policy": "DisableAuthenticationMechanisms"},
15	{"policy": "DisableSetMongodVersion"},
16	{
17	"policy": "DisableSetMongodConfig",
18	"disabledParams": ["net.tls.CAFile"]
19	}
20	]
21	}