Menu Docs
Página inicial do Docs
/
MongoDB Atlas
/
Atlas CLI

Solução de problemas de erros

Nesta página

  • Solucionar problemas locais de implantação do Atlas
  • Erros de comando
  • Erros de configuração

Solucionar problemas locais de implantação do Atlas

Problemas locais da máquina

Se a Atlas CLI ficar lenta e inutilizável após você criar vários sistemas locais do Atlas e carregar dados, você pode ter atingido o limite da sua máquina.

Se você estiver trabalhando no Docker Desktop para Windows ou macOS, considere a possibilidade de alocar mais memória.

Problemas do Docker

A Atlas CLI usa Docker para atlas deployments comandos.

Se a implantação local do Atlas não funcionar, talvez seja necessário limpar o ambiente do Docker e começar do zero:

docker stop $(docker ps -a -q) && docker system prune -a

Executar diagnósticos

Se você tiver problemas e com comandos atlas deployments e precisar de suporte, execute o seguinte comando para fornecer diagnósticos detalhados:

atlas deployments diagnostics <deploymentName> --output json > out.json

Erros de comando

Erro: credenciais ausentes

Certifique-se de que você:

  • Execute atlas config init e adicione suas chaves de API ao seuperfil do ou adicione suas chaves de API às suas variáveis de ambiente. Se você criou um perfil com um nome personalizado ou estiver usando mais de um perfil, especifique o perfil correto com o sinalizador --profile .

  • Execute o atlas auth login para autenticar utilizando suas credenciais de login do Atlas e um token de autenticação.

Para saber mais, consulte Conectar a partir do Atlas CLI.

Atlas: comando não encontrado

O executável atlas pode estar em um diretório que não está em seu $PATH. Você pode adicionar o diretório ao seu $PATH, mover o executável para um diretório que esteja no seu $PATH ou executar o executável diretamente de seu local.

400 (solicitação "TENANT_ATTRIBATE_READ_ONLY") O atributo pitEnabled é somente leitura para clusters de locatários e não pode ser alterado pelo usuário.

Esse erro pode aparecer se você tentar executar o cluster do Atlas create com o argumento --backup para um cluster compartilhado. O argumento --backup não está disponível para clusters menores que M10.

401 (solicitação "Não autorizado") Você não está autorizado para este recurso.

As credenciais que você forneceu não são válidas para o projeto especificado em seu comando Atlas CLI. Verifique a precisão das strings de suas chaves públicas e privadas.

Se suas credenciais forem armazenadas em um arquivo de configuração, certifique-se de que o arquivo de configuração esteja no local correto. Para saber mais, consulte Localizar o arquivo de configuração. Se o Atlas CLI não conseguir encontrar seu arquivo de configuração e você não armazenar credenciais em variáveis de ambiente, um erro 401 resultará.

401 (solicitação "Não autorizado") O usuário atual não está autorizado a executar essa ação.

A conta de usuário ou chave de API que você usou para se conectar ao Atlas CLI não tem permissão para executar a ação solicitada. As contas de usuário e as chaves de API devem ter as funções de usuário apropriadas para executar comandos do Atlas CLI. Para atribuir ou alterar as funções de um usuário, consulte:

401 (solicitação "Não autorizado") O usuário conectado no momento não tem a função de criador de grupos na organização <org-id>.

Este erro pode aparecer ao tentar criar um novo projeto. A conta do usuário ou a chave de API que você usa para autenticar deve ter a função Organization Project Creator no nível da organização para criar novos projetos.

403 (solicitação "Foribiden") O endereço IP <ip-address> não tem permissão para acessar esse recurso.

O endereço IP do usuário que você usa para autenticar não está na lista de acesso do projeto solicitado. Adicione seu endereço IP à lista de acesso para executar comandos.

Para saber mais, consulte as seguintes páginas:

Para adicionar seu endereço IP à lista de acesso de uma chave API:

1

Vá Access Manager para a página do seu projeto.

  1. Se ainda não estiver exibido, selecione a organização que contém o projeto desejado Organizations no menu na barra de navegação.

  2. Selecione o projeto desejado na lista de projetos na página Projects.

  3. Ao lado do menu Projects, expanda o menu Options e clique em Project Settings.

  4. Clique em Access Manager na barra de navegação.

2

Acesse a lista de acesso da chave de API.

  1. Clique na aba API Keys.

  2. Clique em à direita da chave deAPI .

  3. Clique em Edit Permissions e clique em Next.

3

Adicione seu endereço IP à lista de acesso da chave API.

  1. Execute uma das seguintes tarefas na seção API Access List :

    • Clique em Add Access List Entry e digite um endereço IP .

    • Se o seu host atual para acessar o Atlas também fizer solicitações de API com esta chave de API , clique em Use Current IP Address .

  2. Clique em Save.

404 (solicitação "Não encontrado") Um ID do grupo <group-id> inválido foi especificado.

O ID do projeto inserido com o comando não existe. Verifique o ID do projeto navegando até a subseção Settings da seção Project na navegação do lado esquerdo do Atlas.

Observação

group ID e project ID são sinônimos nos serviços de nuvem do MongoDB.

Configuração de alerta não excluída

Esse erro poderá aparecer se o Atlas CLI não puder excluir a configuração de alerta especificada pelo ID.

Erros de configuração

Saída em branco ao ler o diretório inicial

Esse erro pode aparecer se o Atlas CLI não conseguir acessar seu diretório inicial.

Homedrive, HomePath ou USERPROFILE estão em branco

Esse erro pode aparecer se o Atlas CLI não conseguir acessar seu diretório inicial.