/ /

Recursos

Políticas de control de funcionalidades

Docs Home

Gestión

Gerente de Operaciones

API

Recursos

Políticas de control de funcionalidades

Recuperar políticas de funcionalidades para un proyecto

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

Roles necesarios

Este recurso requiere el Project Owner.

Resource

GET /groups/{PROJECT-ID}/controlledFeature

Parámetros de la 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(a) pretty-print formato.

false

envelope

booleano

Indica si se debe o no envolver la respuesta en un sobre.

Algunos Los clientes de laAPI 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:

Nombre	Descripción
`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

Este endpoint no utiliza parámetros de cuerpo de solicitud HTTP.

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 ISO 8601 formato de fecha y hora en UTC cuando se creó esta política de control de funcionalidad.

updated

string

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

externalManagementSystem

Objeto

Identificar parámetros para el sistema externo que administra 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 administra 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:

Valor	Propósito
`EXTERNALLY_MANAGED_LOCK`	Los usuarios no pueden utilizar Ops Manager para gestionar otros ajustes proporcionados en el arreglo `policies.policy[n]`. Estos mismos usuarios pueden utilizar un sistema externo configurado, como el Kubernetes operador, para gestionar estos ajustes.
`DISABLE_USER_MANAGEMENT`	Los usuarios no pueden gestionar 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 de las `mongod` opciones listadas en el arreglo `policies[n].disabledParams`.
`DISABLE_SET_MONGOD_` `VERSION`	Los usuarios no pueden cambiar la versión de ningún `mongod` ni `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 gestión de registros.
`DISABLE_IMPORT_TO_` `AUTOMATION`	Los usuarios no pueden gestionar implementaciones utilizando automatización.
`DISABLE_AGENT_API_KEY_` `MANAGEMENT`	Los usuarios no pueden crear ni actualizar las claves API de los Agents.
`DISABLE_MONGOD_HOST_` `MANAGEMENT`	Los usuarios no pueden cambiar el tipo de servidor de los hosts.

policies[n]

.disabledParams

arreglo

Lista de configuraciones que se deshabilitan si se aplica mongod la DISABLE_SET_MONGOD_CONFIG política. Automation no es compatible con todas las opciones de MongoDB, lo que puede provocar intentos de importación fallidos. Para obtener más información, consulte Configuración de MongoDB y compatibilidad con Automation.

Solicitud de ejemplo

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/json" \
     --include \
     --request GET "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/groups/{PROJECT-ID}/controlledFeature?pretty=true"

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

{
  "_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"]
    }
  ]
}

Volver

Políticas de control de funcionalidades

Update