Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Atualizar políticas de recursos para um projeto

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

Este recurso exige o Project Owner.

PUT /groups/{PROJECT-ID}/controlledFeature

Importante

Você deve incluir todas as políticas que deseja incluir e manter. Este recurso substitui qualquer política existente. Se você omitir uma política ao usar esse recurso, essa política não será aplicada após a atualização. Essa política foi removida.

Nome
Tipo
necessidade
Descrição

PROJECT-ID

string

Obrigatório

Identificador único do projeto que possui as funcionalidades controladas.

Os seguintes parâmetros de query são opcionais:

Nome
Tipo
Descrição
Default

pageNum

inteiro

Número da página (com base em índice 1).

1

itemsPerPage

inteiro

Número de itens a serem devolvidos por página, até um máximo de 500.

100

pretty

booleano

Indica se o corpo da resposta deve ser retornado em um formato prettyprint.

false

envelope

booleano

Indica se deve envolver a resposta em um envelope.

Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, configure "envelope" : true na query.

Para endpoints que retornam um resultado, o corpo da resposta inclui:

  • status: Código de resposta HTTP

  • content: Corpo de resposta esperado

Para endpoints que retornam uma lista de resultados, o objeto results é um envelope. O Cloud Manager adiciona o campo status ao corpo da resposta.

none

Nome
Tipo
Descrição

externalManagementSystem

objeto

Identificar parâmetros para o sistema externo que managed esse projeto do Ops Manager.

externalManagementSystem
.name

string

Identificar etiqueta para o sistema externo que managed este projeto do Ops Manager.

externalManagementSystem
.systemId

string

Identificador único do sistema externo que managed este projeto do Ops Manager.

externalManagementSystem
.version

string

Versão ativa do sistema externo que managed este projeto do Ops Manager.

policies

array

Lista de políticas que o sistema externo aplica a este projeto do Ops Manager.

policies
.policy[n]

objeto

Política única definida para este projeto do Ops Manager. Este parâmetro pode ser definido uma ou mais vezes na array policies .

Os valores aceitos são:

  • EXTERNALLY_MANAGED_LOCK: Os usuários não podem usar o MongoDB Ops Manager para gerenciar outras configurações listadas no array policies.policy[n]. Esses mesmos usuários podem usar um sistema externo configurado, como o operador do Kubernetes, para gerenciar essas configurações.

  • DISABLE_USER_MANAGEMENT: Usuários não podem gerenciar usuários ou funções.

  • DISABLE_AUTHENTICATION_MECHANISMS: Os usuários não podem alterar as configurações de autenticação.

  • DISABLE_SET_MONGOD_CONFIG: Os usuários não podem alterar nenhuma das configurações mongod listadas no policies[n].disabledParams array.

  • DISABLE_SET_MONGOD_VERSION: Os usuários não podem alterar a versão de nenhum mongod ou mongos.

  • DISABLE_BACKUP_AGENT: Os usuários não podem ativar ou desativar o agente de backup.

  • DISABLE_MONGOD_LOG_MANAGEMENT: Os usuários não podem alterar as configurações de gerenciamento de log.

  • DISABLE_IMPORT_TO_AUTOMATION: Os usuários não podem gerenciar implantações usando a automação.

  • DISABLE_AGENT_API_KEY_MANAGEMENT: Os usuários não podem criar ou atualizar chaves de API do agente.

  • DISABLE_MONGOD_HOST_MANAGEMENT: Os usuários não podem alterar o tipo de servidor dos hosts.

policies[n]
.disabledParams

array

Lista de mongod configurações a serem desabilitadas ao aplicar a política DISABLE_SET_MONGOD_CONFIG. Nem todas as opções do MongoDB estão disponíveis na automação, o que pode levar a tentativas de importação malsucedidas. Para saber mais, consulte Configurações do MongoDB e suporte de automação.

Nome
Tipo
Descrição

_id

string

Identificador exclusivo do projeto ao qual esta política se aplica.

created

string

Registro de data/hora no formato de data e hora ISO 8601 em UTC quando esta política de controle de funcionalidades foi criada.

updated

string

Carimbo de data/hora na ISO 8601 formato de data e hora em UTC quando esta política de controle de recurso foi atualizada.

externalManagementSystem

objeto

Identificar parâmetros para o sistema externo que managed este projeto do Cloud Manager.

externalManagementSystem
.name

string

Etiqueta de identificação para o sistema externo que managed este projeto do Cloud Manager.

externalManagementSystem
.systemId

string

Identificador único do sistema externo que managed este projeto do Cloud Manager.

externalManagementSystem
.version

string

Versão ativa do sistema externo que managed este projeto do Cloud Manager.

policies

array

Lista de políticas que o sistema externo aplica a este projeto do Cloud Manager.

policies
.policy[n]

objeto

Política única definida para este projeto do Cloud Manager. Este parâmetro pode ser definido uma ou mais vezes na array policies .

Os valores possíveis são:

  • EXTERNALLY_MANAGED_LOCK: Os usuários não podem usar o Cloud Manager para gerenciar outras configurações listadas no policies.policy[n] array. Esses mesmos usuários podem usar um sistema externo configurado, como o operador do Kubernetes, para gerenciar essas configurações.

  • DISABLE_USER_MANAGEMENT: Usuários não podem gerenciar usuários ou funções.

  • DISABLE_AUTHENTICATION_MECHANISMS: Os usuários não podem alterar as configurações de autenticação.

  • DISABLE_SET_MONGOD_CONFIG: Os usuários não podem alterar nenhuma das configurações mongod listadas no policies[n].disabledParams array.

  • DISABLE_SET_MONGOD_VERSION: Os usuários não podem alterar a versão de nenhum mongod ou mongos.

  • DISABLE_BACKUP_AGENT: Os usuários não podem ativar ou desativar o agente de backup.

  • DISABLE_MONGOD_LOG_MANAGEMENT: Os usuários não podem alterar as configurações de gerenciamento de log.

  • DISABLE_IMPORT_TO_AUTOMATION: Os usuários não podem gerenciar implantações usando a automação.

  • DISABLE_AGENT_API_KEY_MANAGEMENT: Os usuários não podem criar ou atualizar chaves de API do agente.

  • DISABLE_MONGOD_HOST_MANAGEMENT: Os usuários não podem alterar o tipo de servidor dos hosts.

policies[n]
.disabledParams

array

Lista de mongod configurações a serem desativadas se você aplicar a política DISABLE_SET_MONGOD_CONFIG. Nem todas as opções do MongoDB estão disponíveis na automação, o que pode levar a tentativas de importação malsucedidas. Para saber mais, consulte Configurações do MongoDB e suporte de automação.

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