ARMテンプレートデプロイ時にRoleAssignmentExistsエラーで失敗する

Question

ARMテンプレートデプロイ時にRoleAssignmentExistsエラーで失敗する

Sol 0

Azure PortalからARMテンプレート（またはBicep）をデプロイした際に、 Microsoft.Authorization/roleAssignments の作成でエラーが発生し、デプロイ全体が失敗します。既存の Role Assignment がある場合に、デプロイが失敗しないようにする正しい方法（推奨の実装方法）を確認したいです。（例：ARM/Bicepでのベストプラクティス）

エラーメッセージ： The role assignment already exists. The ID of the existing role assignment is PII removed.

状況：

・同一テンプレートの再デプロイで発生

・Microsoft.Authorization/roleAssignments のリソースで Conflict となる

・仮想マシンなど他のリソースは正常に作成されている

Lakshma Reddy Vattijonnala 920 評価のポイント Microsoft 外部スタッフモデレーター

2026-06-18T07:48:48.05+00:00
Hi @Sol 詳細をお知らせいただき、ありがとうございます。

回答は英語から翻訳しているため、多少の文法的な誤りがあるかもしれません。あらかじめご了承ください。

ご説明の内容から判断すると、この問題は Microsoft.Authorization/roleAssignments リソースのデプロイに関連しているようです。ARM テンプレートや Bicep ファイルを再デプロイする際、ロールの割り当てに決定論的な名前（固定名）を使用していないと、既に存在する割り当てを Azure が作成しようとした場合に競合が発生する可能性があります。根本的な原因を特定するには実際のデプロイエラーの詳細を確認する必要がありますが、これは RBAC のデプロイにおいてよくあるケースです。

推奨されるアプローチ:

Microsoftは、ロール割り当て名に決定論的なGUIDを使用することを推奨しています。これにより、繰り返しデプロイを行う際に、新しいロール割り当てリソースを作成しようとするのではなく、既存の同じリソースを参照するようになります。この目的には、一般的に guid() 関数が使用されます。

Bicep example:

resource roleAssignment 'Microsoft.Authorization/roleAssignments@2022-04-01'

= {

name: guid(resourceGroup().id, principalId, roleDefinitionId)

properties: {

roleDefinitionId: roleDefinitionId

principalId: principalId

}

}

ARM テンプレートの場合も同様の考え方が適用され、Microsoft.Authorization/roleAssignments リソースの name プロパティで決定論的な guid() 式を使用します。

固定のGUIDを使用することで、デプロイを冪等（べきとう）に保つことができ、同一のロール割り当てが複数回デプロイされる際に生じうる競合を防ぐことができます。

追加の推奨事項:

オートメーションでロールの割り当てを定義する際、Microsoftはロール名ではなくロール定義IDを使用することを推奨しています。これは、ロール名は時間の経過とともに変更される可能性がある一方、ロールIDは不変であるためです。

詳細については、Microsoftのドキュメントをご参照ください。

https://learn.microsoft.com/ja-jp/azure/azure-resource-manager/bicep/scenarios-rbac – Bicep を使用して Azure RBAC リソースをデプロイするためのガイダンス。

https://learn.microsoft.com/ja-jp/azure/templates/microsoft.authorization/roleassignments?pivots=deployment-language-bicep – リソーススキーマおよびデプロイメントリファレンス

https://learn.microsoft.com/ja-jp/azure/role-based-access-control/best-practices – RBACの展開と自動化に関するMicrosoftの推奨事項

この回答が役に立った場合は、「upvote（賛成票）」をクリックしてください。この回答に関してさらに質問がある場合は、お気軽に「Comment（コメント）」をクリックしてください。

次の方法で共有

ARMテンプレートデプロイ時にRoleAssignmentExistsエラーで失敗する

お客様の回答