エラーのトラブルシューティング

: このバージョンのドキュメントはアーカイブされており、サポートされなくなりました。 Atlas CLI のバージョンをアップグレードする方法については、現在のドキュメントを表示してください。

Atlas のローカル配置の問題のトラブルシューティング

ローカルマシンの問題

複数のローカル Atlas 配置を作成し、データをロードすると、Atlas CLI が使用できない状態に達した場合は、マシンの制限に達している可能性があります。

Windows または MacOS 用のDocker Desktop を使用している場合は、より多くのメモリを割り当てることを検討してください。

Docker の問題

Atlas CLI は、 atlas deploymentsコマンドにDockerを使用します。

MacOS またはWindowsの場合は、 Docker Desktop v4.31+ をインストールします。
Linuxの場合は、Docker Engine v27.0+ をインストールします。

Atlas のローカル配置が機能しない場合は、Docker 環境をクリーンアップして新しく起動する必要がある場合があります。

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

AtlasCLI プラグインのインストールまたは更新に失敗しました

Atlas CLI プラグインのインストールまたはアップデートが失敗した場合は、 Github APIにアクセスできることを確認してください。Atlas CLI プラグインをインストールまたはアップデートするにはGithub APIアクセスが必要です。

診断を実行する

atlas deploymentsコマンドとで問題が発生し、サポートが必要な場合は、次のコマンドを実行して詳細な診断を提供してください。

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

コマンドエラー

エラー: 認証情報がありません

次のいずれかを確認してください。

atlas config initを実行してプロファイルに API キーを追加するか、環境変数に API キーを追加します。カスタム名でプロファイルを作成した場合、または複数のプロファイルを使用している場合は、 --profileフラグを使用して正しいプロファイルを指定します。
Atlas のログイン認証情報と認証トークンを使用して認証するには、 atlas auth loginを実行します。

詳しくは、「 Atlas CLI からの接続」を参照してください。

Atlas : コマンドが見つかりません

atlas実行可能ファイルは、$PATH にないディレクトリにある場合があります。 $PATH にディレクトリを追加するか、実行可能ファイルを $PATH 内のディレクトリに移動するか、実行可能ファイルをその場所から直接実行できます。

400（リクエスト "TENANT_AtRIBUTE_READ_ONLY"））属性 pitEnabled はテナントクラスターの読み取り専用であり、ユーザーによる変更はできません。

このエラーは、共有クラスターに対して--backup引数を指定してAtlas クラスター作成を実行しようとすると表示されることがあります。 --backup引数はM10未満のクラスターでは使用できません。

401（リクエスト "UnAuthorized"）このリソースは許可されていません。

提供した認証情報は、Atlas CLI コマンドで指定されたプロジェクトでは無効です。公開キーと秘密キー文字列の精度を確認します。

認証情報が構成ファイルに保存されている場合は、構成ファイルが正しい場所にあることを確認してください。詳細については、「構成ファイルの検索」を参照してください。 Atlas CLI が構成ファイルを見つけられず、環境変数に認証情報を保存していない場合は、 401エラーが発生します。

401（リクエスト "UnAuthorized"）現在のユーザーには、この操作を実行する権限がありません。

Atlas CLI への接続に使用したユーザーアカウントまたは API キーに、要求されたアクションを実行する権限がありません。 Atlas CLI コマンドを実行するには、ユーザーアカウントと API キーに適切なユーザーロールが必要です。ユーザーのロールを割り当てまたは変更するには、以下を参照してください。

401（リクエスト "Un authorized"）<org-id>

このエラーは、新しいプロジェクトを作成しようとしたときに表示されることがあります。新しいプロジェクトを作成するには、認証に使用するユーザーアカウントまたは API キーに組織レベルでOrganization Project Creatorロールが必要です。

403（リクエスト "禁止"）IP アドレス <ip-address> はこのリソースへのアクセスを許可されていません。

認証に使用するユーザーの IP アドレスは、要求されたプロジェクトのアクセスリストにありません。 IP アドレスをアクセスリストに追加して、コマンドを実行します。

詳しくは、次のページを参照してください。

プロジェクトのアクセスリストについては、「 IP アクセスリストエントリの構成」を参照してください。
API キーアクセスリストについては、「 Atlas Administration API の使い始める」を参照してください。

API キーのアクセスリストに IP アドレスを追加するには、次の手順に従います。

プロジェクトの Access Manager ページに移動します。

まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーションバーのOrganizationsメニュー
Projectsページのプロジェクトのリストから目的のプロジェクトを選択します。
Projects メニューの横にある Options メニューをクリックし、 Project Settings をクリックします。
ナビゲーションバーの Access Manager をクリックします。

GoAPIキーのアクセスリストにします。

[API Keys] タブをクリックします。
をクリックします APIキーの右側にある）
[ Edit Permissionsと [ Next ] をクリックします。

IP アドレスを API キーのアクセスリストに追加します。

API Access Listセクションで次のいずれかのタスクを実行します。
- Add Access List Entryをクリックし、 IPアドレスを入力します。
- Atlas にアクセスするための現在のホストもこの API キーを使用して API リクエストを行う場合は、Use Current IP Address をクリックします。
[Save] をクリックします。

404（リクエスト "Not Found"）無効なグループ ID <group-id> が指定されました。

コマンドで入力されたプロジェクト ID は存在しません。 Atlas の左側のナビゲーションで [ Projectセクションの [ Settingsサブセクションに移動して、プロジェクト ID を確認します。

注意

group ID MongoDB Cloud サービスでは、とproject IDは同義語です。

アラート構成は削除されていない

このエラーは、Atlas CLI が ID で指定されたアラート構成を削除できない場合に表示されることがあります。

ポッドマンが見つかりません

このエラーは、公式の Dockerコンテナ内で atlas deployments コマンドを実行しようとすると表示されます（v 1.26 以降の mongodb/atlas）。代わりに、「 Dockerを使用したローカル Atlas 配置の作成」に記載されている手順に従ってください。

次のコマンドを使用して、クラスター内の過去のコンテナを検査する必要があります。

podman ps -a

次に、次のコマンドを使用して、mongod または mongot で始まるを削除します。

podman container rm -f -v <name or ID>

Tip

MacOS を使用している場合は、安全に podman をアンインストールできます。

podman を Homebrew でインストールした場合は、次のコマンドを使用してアンインストールします。

brew uninstall podman

構成エラー

ホームディレクトリの読み取り時に空白出力

このエラーは、Atlas CLI がホームページディレクトリにアクセスできない場合に表示されることがあります。

HomeDRIVE、HomePATH、または USERPROFILE は空白