次の方法で共有


よくある Azure デプロイ エラーのトラブルシューティングに関する記事

この記事では、よくある Azure デプロイ エラーのトラブルシューティング方法について説明し、その解決方法についての情報を提供します。 Azure リソースは Bicep ファイルまたは Azure Resource Manager テンプレート (ARM テンプレート) を使用してデプロイできます。 デプロイ エラーのエラー コードを見つけることができない場合は、「エラー コードを見つける」を参照してください。

エラー コードが一覧にない場合は、GitHub の問題を提出してください。 ページの右側にある [フィードバック] を選択します。 ページの下部にある [フィードバック][This page](このページ) を選択します。 ドキュメントに関するフィードバックを提供しますが、GitHub 問題は公開されているため、秘密情報は含めないでください

エラー コード

エラー コード 対応策 詳細情報
AccountNameInvalid ストレージ アカウントの名前付けガイドラインに従います。 ストレージ アカウント名のエラーの解決
AccountPropertyCannotBeSet 使用可能なストレージ アカウント プロパティを確認してください。 storageAccounts
AllocationFailed クラスターまたはリージョンに使用可能なリソースがないか、要求された VM サイズをサポートできません。 後で要求を再試行するか、別の VM サイズを要求します。 Linux のプロビジョニングと割り当ての問題

Windows のプロビジョニングと割り当ての問題

割り当てエラーのトラブルシューティングを行う
AnotherOperationInProgress 同時実行操作の完了を待ちます。
AuthorizationFailed お客様のアカウントまたはサービス プリンシパルには、デプロイを完了するために十分なアクセス権がありません。 自分のアカウントが属するロールと、デプロイの範囲に対するアクセス権を確認してください。

必要なリソース プロバイダーが登録されていないと、このエラーを受け取ることがあります。
Azure ロールベースのアクセス制御 (Azure RBAC)

登録を解決する
BadRequest Resource Manager で予期される値と一致しないデプロイ値を送信しました。 トラブルシューティングの方法については、内部ステータス メッセージを確認してください。

既存の Azure リソースからエクスポートされたテンプレートを使用する場合のデプロイ エラーを解決するには、テンプレートの構文を検証します。
テンプレート リファレンス

ARM テンプレート内のリソースの場所

Bicep ファイル内のリソースの場所

無効なテンプレートを解決する
Conflict リソースの現在の状態では許可されていない操作を要求しています。 たとえば、ディスクのサイズ変更が許可されているのは、VM の作成時と VM の割り当て解除時のみです。
DeploymentActiveAndUneditable このリソース グループへの同時実行デプロイが完了するまで待ちます。
DeploymentFailedCleanUp 完全モードでデプロイすると、テンプレートにないすべてのリソースが削除されます。 このエラーは、テンプレートにないすべてのリソースを削除するための適切なアクセス許可がない場合に表示されます。 このエラーを回避するには、デプロイ モードを増分モードに変更します。 Azure Resource Manager のデプロイ モード
DeploymentNameInvalidCharacters デプロイ名には、英字、数字、ハイフン (-)、ドット (.)、アンダースコア (_) のみを含めることができます。
DeploymentNameLengthLimitExceeded デプロイ名は、64 文字までに制限されています。
DeploymentFailed DeploymentFailed エラーは、そのエラーを解決するために必要な詳細が示されない一般的なエラーです。 エラー コードのエラー詳細で情報を確認してください。 エラー コードを見つける
DeploymentQuotaExceeded リソース グループあたり 800 のデプロイという上限に達した場合、不要になった履歴からデプロイを削除します。 デプロイ数が 800 を超えたときのエラーを解決する
DeploymentJobSizeExceeded テンプレートを簡略化して、サイズを小さくします。 テンプレートのサイズ エラーの解決
DnsRecordInUse DNS レコード名は、一意の名前にする必要があります。 別の番号を入力します。
ImageNotFound VM イメージの設定を確認してください。
InaccessibleImage Azure Container Instance のデプロイは失敗します。 場合によっては、コンテナーをデプロイする構文 registry/image:tag と共にイメージのタグを含める必要があります。 プライベート レジストリの場合、資格情報が正しいことを確認します。 エラー コードを見つける
InternalServerError 一時的な問題が原因で発生します。 デプロイを再試行してください。
InUseSubnetCannotBeDeleted このエラーは、リソースを更新しようとしたときに、要求プロセスによってリソースの削除と作成が行われている場合に発生する可能性があります。 変更されていないすべての値を指定してください。 リソースを更新する
InvalidAuthenticationTokenTenant 該当するテナントのアクセス トークンを取得します。 トークンは、自分のアカウントが属するテナントからのみ取得できます。
InvalidContentLink これは、入れ子になった無効なテンプレートにリンクしようとしたことが原因と考えられます。 入れ子になったテンプレートに指定した URI を十分に確認してください。 ストレージ アカウントにテンプレートがある場合は、URI がアクセス可能であることを確認してください。 場合によっては、SAS トークンを渡す必要があります。 現時点では、Azure Storage ファイアウォールの背後にあるストレージ アカウントのテンプレートにリンクすることはできません。 GitHub などの別のリポジトリにテンプレートを移動することを検討してください。 リンクされた、および入れ子になった ARM テンプレート

Bicep モジュール
InvalidDeploymentLocation サブスクリプション レベルでデプロイする場合は、以前に使用したデプロイ名に別の場所を指定しています。 ARM テンプレート サブスクリプションのデプロイ

Bicep サブスクリプションのデプロイ
InvalidParameter リソースに対して指定したいずれかの値が、予期される値に一致しません。 このエラーはさまざまな状況が原因となって発生する可能性があります。 たとえば、パスワードが十分でない場合や、BLOB 名が正しくない場合があります。 エラー メッセージから、どの値を修正する必要があるかがわかるはずです。 ARM テンプレート パラメーター

Bicep パラメーター
InvalidRequestContent デプロイの値に認識されない値が含まれているか、必要な値が不足しています。 リソースの種類の値を確認してください。 テンプレート リファレンス
InvalidRequestFormat デプロイを実行するときにデバッグ ログを有効にし、要求の内容を確認してください。 デバッグ ログ
InvalidResourceLocation ストレージ アカウントに一意の名前を指定してください。 ストレージ アカウント名のエラーの解決
InvalidResourceNamespace type プロパティに指定したリソース名前空間を確認してください。 テンプレート リファレンス
InvalidResourceReference リソースがまだ存在しないか、正しく参照されていません。 依存関係を追加する必要があるかどうかを確認してください。 シナリオに必要なパラメーターを含めて reference 関数を使用しているかどうかを確認してください。 依存関係を解決する
InvalidResourceType type プロパティに指定したリソースの種類を確認してください。 テンプレート リファレンス
InvalidSubscriptionRegistrationState リソース プロバイダーにサブスクリプションを登録してください。 登録を解決する
InvalidTemplateDeployment
InvalidTemplate
テンプレートの構文にエラーがないか確認してください。 無効なテンプレートを解決する
InvalidTemplateCircularDependency 不要な依存関係を削除します。 循環依存関係を解決する
JobSizeExceeded テンプレートを簡略化して、サイズを小さくします。 テンプレートのサイズ エラーの解決
LinkedAuthorizationFailed デプロイ先のリソース グループと同じテナントに自分のアカウントが属しているかどうかを確認してください。
LinkedInvalidPropertyId リソースのリソース ID が解決されていません。 リソース ID に必要なすべての値を指定していることを確認してください。 たとえば、サブスクリプション ID、リソース グループ名、リソースの種類、親リソース名 (必要な場合)、リソース名などです。 リソースの名前および種類のエラーを解決する
LocationRequired リソースの場所を指定します。 ARM テンプレート内のリソースの場所

Bicep ファイル内のリソースの場所
MismatchingResourceSegments 入れ子になったリソースに、名前と種類のセグメントの数が正しく設定されていることを確認します。 リソース セグメントを解決する
MissingRegistrationForLocation リソース プロバイダーの登録状態、およびサポートされている場所を確認してください。 登録を解決する
MissingSubscriptionRegistration リソース プロバイダーにサブスクリプションを登録してください。 登録を解決する
NoRegisteredProviderFound リソース プロバイダーの登録状態を確認してください。 登録を解決する
NotFound 依存するリソースを、親リソースと並列にデプロイしようとしている可能性があります。 依存関係を追加する必要があるかどうかを確認してください。 依存関係を解決する
OperationNotAllowed このエラー メッセージには、いくつかの原因が考えられます。

1. デプロイで、指定された SKU で許可されていない操作が試行されている。

2. デプロイで、サブスクリプション、リソース グループ、またはリージョンのクォータを超過する操作が試行されている。 可能であれば、クォータ内に収まるようにデプロイを修正してください。 修正できない場合は、クォータの変更を要求することを検討してください。
クォータを解決する
OperationNotAllowedOnVMImageAsVMsBeingProvisioned 削除しようとしているイメージが VM のプロビジョニングに現在使用されている可能性があります。 デプロイ プロセス中に仮想マシンで使用されているイメージを削除することはできません。 VM のデプロイが完了した後に、イメージの削除操作を再試行してください。
ParentResourceNotFound 子リソースを作成する前に親リソースが存在することを確認してください。 親リソースを解決する
PasswordTooLong 文字数の多すぎるパスワードを選択したか、パスワードの値をパラメーターとして渡す前にセキュリティで保護された文字列に変換した可能性があります。 テンプレートに secure string パラメーターが含まれている場合、値をセキュリティで保護された文字列に変換する必要はありません。 パスワードの値はテキストとして指定してください。
PrivateIPAddressInReservedRange 指定した IP アドレスは、Azure で必要なアドレス範囲に含まれます。 予約済みの範囲を避けるように IP アドレスを変更してください。 プライベート IP アドレス
PrivateIPAddressNotInSubnet 指定した IP アドレスがサブネットの範囲外です。 サブネットの範囲に収まるように IP アドレスを変更してください。 プライベート IP アドレス
PropertyChangeNotAllowed デプロイ済みのリソースで、一部のプロパティを変更できません。 リソースを更新する際は、許可されているプロパティに変更を制限してください。 リソースを更新する
PublicIPCountLimitReached 実行中のパブリック IPS の数の上限に達しました。 不要なリソースをシャットダウンするか、Azure サポートに問い合わせ、増加を要求してください。 たとえば、Azure Databricks では、「 予期しないクラスターの終了」および「 IP アドレスの制限によってクラスターを作成できない」に関 するページを参照してください。 パブリック IP アドレスの制限
RegionDoesNotAllowProvisioning 別のリージョンを選択するか、リージョン アクセスのクォータ サポート要求を送信します。
RequestDisallowedByPolicy サブスクリプションには、デプロイ中に実行しようとしているアクションを防ぐリソース ポリシーが含まれています。 アクションをブロックしているポリシーを見つけてください。 可能であれば、ポリシーの制限を満たすようにデプロイを変更してください。 ポリシーを解決する
ReservedResourceName 予約された名前が含まれていないリソース名を指定します。 予約されたリソース名
ResourceGroupBeingDeleted 削除が完了するまで待ちます。
ResourceGroupNotFound デプロイのターゲット リソース グループの名前を確認してください。 サブスクリプションにターゲット リソース グループが既に存在している必要があります。 サブスクリプションのコンテキストを確認してください。 Azure CLI PowerShell
ResourceNotFound 解決できないリソースをデプロイで参照しています。 reference 関数に、シナリオに必要なパラメーターを含まれていることを確認してください。 参照を解決する
ResourceQuotaExceeded デプロイで、サブスクリプション、リソース グループ、またはリージョンのクォータを超過するリソースの作成が試みられています。 可能であれば、クォータ内に収まるようにインフラストラクチャを変更してください。 修正できない場合は、クォータの変更を要求することを検討してください。 クォータを解決する
SkuNotAvailable 選択した場所で利用可能な SKU (VM サイズなど) を選択します。 SKU を解決する
StorageAccountAlreadyTaken
StorageAccountAlreadyExists
ストレージ アカウントに一意の名前を指定してください。 ストレージ アカウント名のエラーの解決
StorageAccountInAnotherResourceGroup ストレージ アカウントに一意の名前を指定してください。 ストレージ アカウント名のエラーの解決
StorageAccountNotFound サブスクリプション、リソース グループ、および使用するストレージ アカウントの名前を確認してください。
SubnetsNotInSameVnet 仮想マシンでは、仮想ネットワークを 1 つのみを持つことができます。 複数の NIC をデプロイするときは、それらが同じ仮想ネットワークに属していることを確認してください。 Windows VM の複数 NIC

Linux VM の複数 NIC
SubnetIsFull リソースをデプロイするのに十分なアドレスがサブネットにありません。 サブネットからアドレスを解放したり、別のサブネットを使用したり、新しいサブネットを作成したりできます。 サブネットの管理仮想ネットワークに関する FAQ

プライベート IP アドレス
SubscriptionNotFound デプロイ用に指定されたサブスクリプションにアクセスできません。 サブスクリプション ID が間違っている、テンプレートをデプロイしているユーザーにサブスクリプションにデプロイするための適切なアクセス許可がない、またはサブスクリプション ID の形式が間違っている可能性があります。 デプロイが入れ子になっている ARM テンプレートを使用してスコープにまたがってデプロイする場合は、サブスクリプションの GUID を指定してください。 スコープ間での ARM テンプレートのデプロイ

スコープ間での Bicep ファイルのデプロイ
SubscriptionNotRegistered リソースがデプロイされるとき、リソース プロバイダーをサブスクリプションに登録する必要があります。 デプロイに Azure Resource Manager テンプレートを使用すると、リソース プロバイダーがサブスクリプションに自動的に登録されます。 自動登録が時間内に完了しないことがあります。 この断続的なエラーを回避するには、デプロイの前にリソース プロバイダーを登録します。 登録を解決する
SubscriptionRequestsThrottled Azure Resource Manager は、サブスクリプション レベルまたはテナント レベルで要求を抑えます。 Microsoft.Compute などのリソース プロバイダーも、その操作に固有の要求を抑えます。

制限に達すると、新しい要求を送信する前に待機する必要がある時間を含むメッセージと値が表示されます。 例: Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds.

HTTP 応答は、Retry-After 値を含む HTTP status code 429 Too Many Requests などのメッセージを返します。これは、別の要求を送信するまでに待機する秒数を示します。
Resource Manager の要求のスロットル

API の調整エラーのトラブルシューティング - 仮想マシン

Azure Kubernetes Service の調整
TemplateResourceCircularDependency 不要な依存関係を削除します。 循環依存関係を解決する
TooManyTargetResourceGroups 1 回のデプロイのリソース グループ数を減らします。 スコープ間での ARM テンプレートのデプロイ

スコープ間での Bicep ファイルのデプロイ

次の手順