正常性チェックのエラー リファレンス

  • [アーティクル]

以下は、az acr check-health コマンドによって返されるエラー コードの詳細です。 各エラーについて、考えられる解決策が示されています。

az acr check-health の実行の詳細については、「Azure コンテナー レジストリの正常性のチェック」を参照してください。

DOCKER_COMMAND_ERROR

このエラーは、CLI の Docker クライアントが見つからなかったことを意味します。 その結果、Docker のバージョンの検出、Docker デーモンの状態の評価、docker pull コマンドの実行の各チェックは実行されません。

考えられる解決策: Docker クライアントをインストールします。Docker パスをシステム変数に追加します。

DOCKER_DAEMON_ERROR

このエラーは、Docker デーモンの状態が利用できないか、または CLI を使用して状態にアクセスできなかったことを意味します。 その結果、Docker 操作 (docker login や docker pull など) を CLI から使用できません。

考えられる解決策: Docker デーモンを再起動するか、正しくインストールされていることを確認します。

DOCKER_VERSION_ERROR

このエラーは、CLI が docker --version コマンドを実行できなかったことを意味します。

考えられる解決策: コマンドを手動で実行してみます。最新の CLI バージョンを使用していることを確認し、エラー メッセージを調べます。

DOCKER_PULL_ERROR

このエラーは、CLI がサンプル イメージを環境にプルできなかったことを意味します。

考えられる解決策: イメージをプルするために必要なすべてのコンポーネントが正しく実行されていることを確認します。

HELM_COMMAND_ERROR

このエラーは、CLI が Helm クライアントを見つけることができなかったため、他の Helm 操作を実行できないことを意味します。

考えられる解決策: Helm クライアントがインストールされていることを確認し、そのパスがシステム環境変数に追加されていることを確認します。

HELM_VERSION_ERROR

このエラーは、インストールされている Helm のバージョンを CLI が特定できなかったことを意味します。 これは、使用されている Azure CLI のバージョン (または Helm のバージョン) が古い場合に発生する可能性があります。

考えられる解決策: 最新の Azure CLI バージョンまたは推奨される Helm バージョンに更新します。コマンドを手動で実行し、エラー メッセージを調べます。

CMK_ERROR

このエラーは、カスタマー マネージド キーを使用したレジストリの暗号化を構成するために使用されるユーザー割り当てまたはシステム割り当てのマネージド ID に、レジストリがアクセスできないことを示します。 マネージド ID が削除されている可能性があります。

考えられる解決策: この問題を解決し、別のマネージド ID を使用してキーをローテーションするには、ユーザー割り当て ID をトラブルシューティングするための手順を参照してください。

CONNECTIVITY_DNS_ERROR

このエラーは、指定されたレジストリ ログイン サーバーの DNS に対して ping を実行したが応答がなかったこと (つまり、DNS を使用できないこと) を意味します。 これは、接続の問題を示している可能性があります。 または、レジストリが存在しない、ユーザーが (ログイン サーバーを正しく取得するための) レジストリに対するアクセス許可を持っていない、あるいはターゲット レジストリが Azure CLI で使用されているものとは異なるクラウドにある可能性があります。

考えられる解決策: 接続を検証します。レジストリのスペルと、そのレジストリが存在することを確認します。ユーザーがレジストリに対する適切なアクセス許可を持っていること、およびレジストリのクラウドが Azure CLI で使用されているものと同じであることを確認します。

CONNECTIVITY_FORBIDDEN_ERROR

このエラーは、指定されたレジストリのチャレンジ エンドポイントが HTTP ステータス 403 Forbidden で応答したことを意味します。 このエラーは、ユーザーがレジストリにアクセスできないことを意味し、おそらく、仮想ネットワークの構成、またはレジストリのパブリック エンドポイントへのアクセスが許可されていないことが原因であると考えられます。 現在構成されているファイアウォール規則を確認するには、az acr show --query networkRuleSet --name <registry> を実行します。

考えられる解決策: 仮想ネットワーク規則を削除するか、現在のクライアント IP アドレスを許可リストに追加します。

CONNECTIVITY_CHALLENGE_ERROR

このエラーは、ターゲット レジストリのチャレンジ エンドポイントがチャレンジを発行しなかったことを意味します。

考えられる解決策: しばらくしてからもう一度試してください。 エラーが解決しない場合は、 https://aka.ms/acr/issues で問題を開いてください。

CONNECTIVITY_AAD_LOGIN_ERROR

このエラーは、ターゲット レジストリのチャレンジ エンドポイントがチャレンジを発行したが、レジストリで Microsoft Entra 認証がサポートされていないことを意味します。

考えられる解決策: 管理者の資格情報を使用するなど、別の方法で認証してみます。 ユーザーが Microsoft Entra ID を使って認証する必要がある場合は、https://aka.ms/acr/issues でイシューを開きます。

CONNECTIVITY_REFRESH_TOKEN_ERROR

このエラーは、レジストリ ログイン サーバーが更新トークンで応答しなかったため、ターゲット レジストリへのアクセスが拒否されたことを意味します。 このエラーは、ユーザーがレジストリに対する適切なアクセス許可を持っていない場合、または Azure CLI のユーザーの資格情報が古い場合に発生する可能性があります。

考えられる解決策: ユーザーがレジストリに対する適切なアクセス許可を持っているかどうかを確認します。az login を実行して、アクセス許可、トークン、資格情報を更新します。

CONNECTIVITY_ACCESS_TOKEN_ERROR

このエラーは、レジストリ ログイン サーバーがアクセス トークンで応答しなかったため、ターゲット レジストリへのアクセスが拒否されたことを意味します。 このエラーは、ユーザーがレジストリに対する適切なアクセス許可を持っていない場合、または Azure CLI のユーザーの資格情報が古い場合に発生する可能性があります。

考えられる解決策: ユーザーがレジストリに対する適切なアクセス許可を持っているかどうかを確認します。az login を実行して、アクセス許可、トークン、資格情報を更新します。

CONNECTIVITY_SSL_ERROR

このエラーは、クライアントがコンテナー レジストリへのセキュリティで保護された接続を確立できなかったことを意味します。 このエラーは一般に、プロキシ サーバーの実行中または使用中に発生します。

考えられる解決策: プロキシの内側の動作について詳しくは、こちらをご覧ください。

LOGIN_SERVER_ERROR

このエラーは、CLI が指定されたレジストリのログイン サーバーを見つけることができず、現在のクラウドの既定のサフィックスが見つからなかったことを意味します。 このエラーは、レジストリが存在しない場合、ユーザーがレジストリに対する適切なアクセス許可を持っていない場合、レジストリのクラウドと現在の Azure CLI のクラウドが一致しない場合、または Azure CLI のバージョンが古い場合に発生する可能性があります。

考えられる解決策: スペルが正しいこと、およびレジストリが存在することを確認します。ユーザーがレジストリに対する適切なアクセス許可を持っていること、およびレジストリと CLI 環境のクラウドが一致していることを確認します。Azure CLI を最新バージョンに更新します。

NOTARY_VERSION_ERROR

このエラーは、現在インストールされている Docker と Notary のバージョンと CLI の間に互換性がないことを意味します。 Docker インストールの Notary クライアントを手動で置換することで notary.exe のバージョンを 0.6.0 より前にダウングレードし、この問題が解決されるかどうかをお試しください。 GitHub の Notary リポジトリのリリース ページから、64 ビット Linux または macOS X 用に 0.6.0 より前の Notary のバイナリをダウンロードしてインストールすることもできます。 Windows が.exe をダウンロードする場合、それを (既定のパス: C:\ProgramFiles\Docker\Docker\resources\bin) に配置し、その名前を notary.exe に変更します。

CONNECTIVITY_TOOMANYREQUESTS_ERROR

このエラーは、ユーザーが短時間に送信した要求が多すぎるため、認証システムが過負荷を防ぐためにこれ以上の要求をブロックしたことを意味します。 このエラーは、ユーザーのレジストリ サービス レベルまたは環境での構成済みの限度に達したことによって発生します。 しばらく待ってから、別の要求を送信することをお勧めします。 これにより、認証システムのブロックを解除し、もう一度要求の送信を試すことができます。

次のステップ

レジストリの正常性チェックのオプションについては、「Azure コンテナー レジストリの正常性のチェック」をご覧ください。

Azure Container Registry に関するよくあるご質問や他の既知の問題については、FAQ をご覧ください。