よくある 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 ファイルのデプロイ |
次の手順
- 検証エラーまたはデプロイ エラーの詳細については、「 エラー コードの検索」を参照してください。
- デプロイのトラブルシューティングの詳細を確認するには、「デバッグ ログを有効 にする」を参照してください。
- デプロイ エラーの原因を特定するには、トラブルシューティング テンプレートの 作成に関するページを参照してください。