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.

agentengine service-account create

Crie uma Conta de serviço.

Crie uma conta de serviço e emita seu primeiro segredo de cliente.

O segredo é exibido apenas uma vez; salve-o imediatamente.

Troque o ID e o segredo do cliente por um token de acesso de 1horas em POST /api/v1/oauth/token. Envie esse token apenas para pontos de extremidade explicitamente habilitados para autenticação de conta de serviço e que a função atribuída permita:

curl --fail-with-body --silent --show-error \ --user '<client-id>' \ --data grant_type=client_credentials \ '<base-url>/api/v1/oauth/token' | \jq -er '"Authorization: Bearer " + .access_token' | \curl --fail-with-body --silent --show-error \ --header @- \ '<base-url>/api/v1/<service-account-enabled-resource>'

As funções de projeto são PROJECT_OWNER e PROJECT_READ_ONLY; as funções de organização são ORG_OWNER, ORG_GROUP_CREATOR e ORG_READ_ONLY. ORG_OWNER é aceito apenas onde a organização tem a função de proprietário habilitada; caso contrário, o servidor o rejeita. List e get exibem a função Atlas da conta.

A criação de uma conta de serviço também pode criar uma conta de serviço Atlas emparelhada, que precisa que o emparelhamento de conta de serviço Atlas esteja ativado para a organização ou projeto. Se estiver desativado, o comando explica a conta emparelhada e, em um terminal, pergunta antes de ativá-la. Passe --enable-atlas-pairing para ativá-lo sem um prompt, por exemplo, em um script. Recusar ou omitir o sinalizador sem um terminal não cria nada. Quando uma conta de serviço Atlas emparelhada é criada, seu ID é mostrado com o resultado.

Exemplos:

agentengine service-account create ci-pipeline --role PROJECT_OWNERagentengine service-account create audit-reader --org-id <org-id> --role ORG_READ_ONLY
agentengine service-account create <name> --role <role> [flags]
--base-url string Platform base URL --context string Named context to target (see 'agentengine context list') --description string Human-readable description --enable-atlas-pairing Turn on Atlas service account pairing for the organization or project if it is off, without a prompt. The notice goes to stderr-h, --help help for create --ip-access-list strings IPs or CIDRs allowed to use the credential (default: unrestricted) --json Output the created service account as JSON --org-id string Organization scope for the service account --project-id string Project scope for the service account --role string Role granted to the service account (project: PROJECT_OWNER, PROJECT_READ_ONLY; organization: ORG_OWNER, ORG_GROUP_CREATOR, ORG_READ_ONLY) --secret-expires-in duration Secret lifetime as a whole number of hours, e.g. 720h (default: server default of 2160h)
--log-file string override log file path --log-level string file log verbosity (error|warn|info|debug) (default "info") --no-log disable file logging-q, --quiet silence stderr below error-v, --verbose count raise stderr verbosity (-v info, -vv debug)
Avalie esta página