Microsoft.Authorization policyAssignments

[アーティクル]
12/20/2024

Bicep リソース定義

policyAssignments リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Authorization/policyAssignments リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.Authorization/policyAssignments@2025-01-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    assignmentType: 'string'
    definitionVersion: 'string'
    description: 'string'
    displayName: 'string'
    enforcementMode: 'string'
    metadata: any(Azure.Bicep.Types.Concrete.AnyType)
    nonComplianceMessages: [
      {
        message: 'string'
        policyDefinitionReferenceId: 'string'
      }
    ]
    notScopes: [
      'string'
    ]
    overrides: [
      {
        kind: 'string'
        selectors: [
          {
            in: [
              'string'
            ]
            kind: 'string'
            notIn: [
              'string'
            ]
          }
        ]
        value: 'string'
      }
    ]
    parameters: {
      {customized property}: {
        value: any(Azure.Bicep.Types.Concrete.AnyType)
      }
    }
    policyDefinitionId: 'string'
    resourceSelectors: [
      {
        name: 'string'
        selectors: [
          {
            in: [
              'string'
            ]
            kind: 'string'
            notIn: [
              'string'
            ]
          }
        ]
      }
    ]
  }
}

プロパティ値

同一性

名前	形容	価値
種類	ID の種類。これは、システム割り当て ID またはユーザー割り当て ID をリソースに追加するときに必要な唯一のフィールドです。	'None' 'SystemAssigned' 'UserAssigned'
userAssignedIdentities	ポリシーに関連付けられているユーザー ID。ユーザー ID ディクショナリのキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。	IdentityUserAssignedIdentities の

IdentityUserAssignedIdentities

名前	形容	価値

Microsoft.Authorization/policyAssignments

名前	形容	価値
同一性	ポリシーの割り当てに関連付けられているマネージド ID。	ID
場所	ポリシー割り当ての場所。マネージド ID を使用する場合にのみ必要です。	糸
名前	リソース名	糸制約：パターン = `^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$` (必須)
プロパティ	ポリシー割り当てのプロパティ。	PolicyAssignmentProperties の
スコープ	デプロイスコープとは異なるスコープでリソースを作成するときに使用します。	このプロパティをリソースのシンボリック名に設定して、拡張リソースを適用します。

NonComplianceMessage

名前	形容	価値
メッセージ	リソースがポリシーに準拠していない理由を説明するメッセージ。これは、"拒否" エラーメッセージと、リソースの準拠していないコンプライアンスの結果に表示されます。	string (必須)
policyDefinitionReferenceId	メッセージの対象となるポリシーセット定義内のポリシー定義参照 ID。これは、ポリシー割り当てによってポリシーセット定義が割り当てられている場合にのみ適用されます。これが指定されていない場合、メッセージは、このポリシー割り当てによって割り当てられたすべてのポリシーに適用されます。	糸

オーバーライド

名前	形容	価値
種類	オーバーライドの種類。	'definitionVersion' 'policyEffect'
セレクター	セレクター式の一覧。	セレクター[]
価値	ポリシープロパティをオーバーライドする値。	糸

ParameterValues

名前	形容	価値

ParameterValuesValue

名前	形容	価値
価値	パラメーターの値。	任意

PolicyAssignmentProperties

名前	形容	価値
assignmentType	ポリシー割り当ての種類。指定できる値は、NotSpecified、System、SystemHidden、Custom です。不変。	'Custom' 'NotSpecified' 'System' 'SystemHidden'
definitionVersion	使用するポリシー定義のバージョン。	糸
形容	このメッセージは、ポリシー違反が発生した場合の応答の一部になります。	糸
displayName	ポリシー割り当ての表示名。	糸
enforcementMode	ポリシー割り当て適用モード。使用できる値は、既定値、DoNotEnforce、および登録です	'Default' 'DoNotEnforce' 'Enroll'
metadata	ポリシー割り当てのメタデータ。メタデータはオープンエンドオブジェクトであり、通常はキーと値のペアのコレクションです。	任意
nonComplianceMessages	リソースがポリシーに準拠していない理由を説明するメッセージ。	NonComplianceMessage[]
notScopes	ポリシーの除外されたスコープ。	string[]
オーバーライド	ポリシープロパティ値のオーバーライド。	オーバーライド[]
パラメーター	割り当てられたポリシールールのパラメーター値。キーはパラメーター名です。	ParameterValues
policyDefinitionId	割り当てられているポリシー定義またはポリシーセット定義の ID。	糸
resourceSelectors	リソースのプロパティでポリシーをフィルター処理するリソースセレクターの一覧。	ResourceSelector[]

ResourceSelector

名前	形容	価値
名前	リソースセレクターの名前。	糸
セレクター	セレクター式の一覧。	セレクター[]

セレクタ

名前	形容	価値
で	フィルター処理する値の一覧。	string[]
種類	セレクターの種類。	'policyDefinitionReferenceId' 'resourceLocation' 'resourceType' 'resourceWithoutLocation'
notIn	フィルター処理する値の一覧。	string[]

UserAssignedIdentitiesValue

名前	形容	価値

クイックスタートのサンプル

次のクイックスタートサンプルでは、このリソースの種類をデプロイします。

Bicep ファイル	形容
VM マネージドディスクを監査する組み込みポリシーを割り当	このテンプレートでは、組み込みのポリシーをリソースグループスコープに割り当てて、仮想マシン (VM) マネージドディスクを監査します。
Azure Virtual Network Manager とサンプル VNET を作成する	このテンプレートは、Azure Virtual Network Manager とサンプル仮想ネットワークを名前付きリソースグループにデプロイします。複数の接続トポロジとネットワークグループメンバーシップの種類をサポートします。
ポリシー Def を展開し、複数の Mgmt グループに割り当てる	このテンプレートは、ポリシー定義を作成し、そのポリシーを複数の管理グループに割り当てる管理グループレベルのテンプレートです。
ポリシー定義を展開し、管理グループに割り当てる	このテンプレートは、ポリシー定義を作成し、そのポリシーをターゲット管理グループに割り当てる管理グループレベルのテンプレートです。現時点では、このテンプレートは Azure Portal を使用してデプロイすることはできません。

ARM テンプレートリソース定義

policyAssignments リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Authorization/policyAssignments リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.Authorization/policyAssignments",
  "apiVersion": "2025-01-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "assignmentType": "string",
    "definitionVersion": "string",
    "description": "string",
    "displayName": "string",
    "enforcementMode": "string",
    "metadata": {},
    "nonComplianceMessages": [
      {
        "message": "string",
        "policyDefinitionReferenceId": "string"
      }
    ],
    "notScopes": [ "string" ],
    "overrides": [
      {
        "kind": "string",
        "selectors": [
          {
            "in": [ "string" ],
            "kind": "string",
            "notIn": [ "string" ]
          }
        ],
        "value": "string"
      }
    ],
    "parameters": {
      "{customized property}": {
        "value": {}
      }
    },
    "policyDefinitionId": "string",
    "resourceSelectors": [
      {
        "name": "string",
        "selectors": [
          {
            "in": [ "string" ],
            "kind": "string",
            "notIn": [ "string" ]
          }
        ]
      }
    ]
  }
}

プロパティ値

同一性

名前	形容	価値
種類	ID の種類。これは、システム割り当て ID またはユーザー割り当て ID をリソースに追加するときに必要な唯一のフィールドです。	'None' 'SystemAssigned' 'UserAssigned'
userAssignedIdentities	ポリシーに関連付けられているユーザー ID。ユーザー ID ディクショナリのキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。	IdentityUserAssignedIdentities の

IdentityUserAssignedIdentities

名前	形容	価値

Microsoft.Authorization/policyAssignments

名前	形容	価値
apiVersion	API のバージョン	'2025-01-01'
同一性	ポリシーの割り当てに関連付けられているマネージド ID。	ID
場所	ポリシー割り当ての場所。マネージド ID を使用する場合にのみ必要です。	糸
名前	リソース名	糸制約：パターン = `^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$` (必須)
プロパティ	ポリシー割り当てのプロパティ。	PolicyAssignmentProperties の
種類	リソースの種類	'Microsoft.Authorization/policyAssignments'

NonComplianceMessage

名前	形容	価値
メッセージ	リソースがポリシーに準拠していない理由を説明するメッセージ。これは、"拒否" エラーメッセージと、リソースの準拠していないコンプライアンスの結果に表示されます。	string (必須)
policyDefinitionReferenceId	メッセージの対象となるポリシーセット定義内のポリシー定義参照 ID。これは、ポリシー割り当てによってポリシーセット定義が割り当てられている場合にのみ適用されます。これが指定されていない場合、メッセージは、このポリシー割り当てによって割り当てられたすべてのポリシーに適用されます。	糸

オーバーライド

名前	形容	価値
種類	オーバーライドの種類。	'definitionVersion' 'policyEffect'
セレクター	セレクター式の一覧。	セレクター[]
価値	ポリシープロパティをオーバーライドする値。	糸

ParameterValues

名前	形容	価値

ParameterValuesValue

名前	形容	価値
価値	パラメーターの値。	任意

PolicyAssignmentProperties

名前	形容	価値
assignmentType	ポリシー割り当ての種類。指定できる値は、NotSpecified、System、SystemHidden、Custom です。不変。	'Custom' 'NotSpecified' 'System' 'SystemHidden'
definitionVersion	使用するポリシー定義のバージョン。	糸
形容	このメッセージは、ポリシー違反が発生した場合の応答の一部になります。	糸
displayName	ポリシー割り当ての表示名。	糸
enforcementMode	ポリシー割り当て適用モード。使用できる値は、既定値、DoNotEnforce、および登録です	'Default' 'DoNotEnforce' 'Enroll'
metadata	ポリシー割り当てのメタデータ。メタデータはオープンエンドオブジェクトであり、通常はキーと値のペアのコレクションです。	任意
nonComplianceMessages	リソースがポリシーに準拠していない理由を説明するメッセージ。	NonComplianceMessage[]
notScopes	ポリシーの除外されたスコープ。	string[]
オーバーライド	ポリシープロパティ値のオーバーライド。	オーバーライド[]
パラメーター	割り当てられたポリシールールのパラメーター値。キーはパラメーター名です。	ParameterValues
policyDefinitionId	割り当てられているポリシー定義またはポリシーセット定義の ID。	糸
resourceSelectors	リソースのプロパティでポリシーをフィルター処理するリソースセレクターの一覧。	ResourceSelector[]

ResourceSelector

名前	形容	価値
名前	リソースセレクターの名前。	糸
セレクター	セレクター式の一覧。	セレクター[]

セレクタ

名前	形容	価値
で	フィルター処理する値の一覧。	string[]
種類	セレクターの種類。	'policyDefinitionReferenceId' 'resourceLocation' 'resourceType' 'resourceWithoutLocation'
notIn	フィルター処理する値の一覧。	string[]

UserAssignedIdentitiesValue

名前	形容	価値

クイックスタートテンプレート

次のクイックスタートテンプレートでは、このリソースの種類をデプロイします。

テンプレート	形容
組み込みポリシーを既存のリソースグループに割り当てる Azure にデプロイする	このテンプレートは、組み込みのポリシーを既存のリソースグループに割り当てます。
VM マネージドディスクを監査する組み込みポリシーを割り当 Azure にデプロイする	このテンプレートでは、組み込みのポリシーをリソースグループスコープに割り当てて、仮想マシン (VM) マネージドディスクを監査します。
Azure Virtual Network Manager とサンプル VNET を作成する Azure にデプロイする	このテンプレートは、Azure Virtual Network Manager とサンプル仮想ネットワークを名前付きリソースグループにデプロイします。複数の接続トポロジとネットワークグループメンバーシップの種類をサポートします。
ポリシー Def を展開し、複数の Mgmt グループに割り当てる Azure にデプロイする	このテンプレートは、ポリシー定義を作成し、そのポリシーを複数の管理グループに割り当てる管理グループレベルのテンプレートです。
ポリシー定義を展開し、管理グループに割り当てる Azure にデプロイする	このテンプレートは、ポリシー定義を作成し、そのポリシーをターゲット管理グループに割り当てる管理グループレベルのテンプレートです。現時点では、このテンプレートは Azure Portal を使用してデプロイすることはできません。

Terraform (AzAPI プロバイダー) リソース定義

policyAssignments リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.Authorization/policyAssignments リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Authorization/policyAssignments@2025-01-01"
  name = "string"
  parent_id = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      assignmentType = "string"
      definitionVersion = "string"
      description = "string"
      displayName = "string"
      enforcementMode = "string"
      metadata = ?
      nonComplianceMessages = [
        {
          message = "string"
          policyDefinitionReferenceId = "string"
        }
      ]
      notScopes = [
        "string"
      ]
      overrides = [
        {
          kind = "string"
          selectors = [
            {
              in = [
                "string"
              ]
              kind = "string"
              notIn = [
                "string"
              ]
            }
          ]
          value = "string"
        }
      ]
      parameters = {
        {customized property} = {
          value = ?
        }
      }
      policyDefinitionId = "string"
      resourceSelectors = [
        {
          name = "string"
          selectors = [
            {
              in = [
                "string"
              ]
              kind = "string"
              notIn = [
                "string"
              ]
            }
          ]
        }
      ]
    }
  })
}

プロパティ値

同一性

名前	形容	価値
種類	ID の種類。これは、システム割り当て ID またはユーザー割り当て ID をリソースに追加するときに必要な唯一のフィールドです。	'None' 'SystemAssigned' 'UserAssigned'
userAssignedIdentities	ポリシーに関連付けられているユーザー ID。ユーザー ID ディクショナリのキー参照は、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' という形式の ARM リソース ID になります。	IdentityUserAssignedIdentities の

IdentityUserAssignedIdentities

名前	形容	価値

Microsoft.Authorization/policyAssignments

名前	形容	価値
同一性	ポリシーの割り当てに関連付けられているマネージド ID。	ID
場所	ポリシー割り当ての場所。マネージド ID を使用する場合にのみ必要です。	糸
名前	リソース名	糸制約：パターン = `^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$` (必須)
parent_id	この拡張リソースを適用するリソースの ID。	string (必須)
プロパティ	ポリシー割り当てのプロパティ。	PolicyAssignmentProperties の
種類	リソースの種類	"Microsoft.Authorization/policyAssignments@2025-01-01"

NonComplianceMessage

名前	形容	価値
メッセージ	リソースがポリシーに準拠していない理由を説明するメッセージ。これは、"拒否" エラーメッセージと、リソースの準拠していないコンプライアンスの結果に表示されます。	string (必須)
policyDefinitionReferenceId	メッセージの対象となるポリシーセット定義内のポリシー定義参照 ID。これは、ポリシー割り当てによってポリシーセット定義が割り当てられている場合にのみ適用されます。これが指定されていない場合、メッセージは、このポリシー割り当てによって割り当てられたすべてのポリシーに適用されます。	糸

オーバーライド

名前	形容	価値
種類	オーバーライドの種類。	'definitionVersion' 'policyEffect'
セレクター	セレクター式の一覧。	セレクター[]
価値	ポリシープロパティをオーバーライドする値。	糸

ParameterValues

名前	形容	価値

ParameterValuesValue

名前	形容	価値
価値	パラメーターの値。	任意

PolicyAssignmentProperties

名前	形容	価値
assignmentType	ポリシー割り当ての種類。指定できる値は、NotSpecified、System、SystemHidden、Custom です。不変。	'Custom' 'NotSpecified' 'System' 'SystemHidden'
definitionVersion	使用するポリシー定義のバージョン。	糸
形容	このメッセージは、ポリシー違反が発生した場合の応答の一部になります。	糸
displayName	ポリシー割り当ての表示名。	糸
enforcementMode	ポリシー割り当て適用モード。使用できる値は、既定値、DoNotEnforce、および登録です	'Default' 'DoNotEnforce' 'Enroll'
metadata	ポリシー割り当てのメタデータ。メタデータはオープンエンドオブジェクトであり、通常はキーと値のペアのコレクションです。	任意
nonComplianceMessages	リソースがポリシーに準拠していない理由を説明するメッセージ。	NonComplianceMessage[]
notScopes	ポリシーの除外されたスコープ。	string[]
オーバーライド	ポリシープロパティ値のオーバーライド。	オーバーライド[]
パラメーター	割り当てられたポリシールールのパラメーター値。キーはパラメーター名です。	ParameterValues
policyDefinitionId	割り当てられているポリシー定義またはポリシーセット定義の ID。	糸
resourceSelectors	リソースのプロパティでポリシーをフィルター処理するリソースセレクターの一覧。	ResourceSelector[]

ResourceSelector

名前	形容	価値
名前	リソースセレクターの名前。	糸
セレクター	セレクター式の一覧。	セレクター[]

セレクタ

名前	形容	価値
で	フィルター処理する値の一覧。	string[]
種類	セレクターの種類。	'policyDefinitionReferenceId' 'resourceLocation' 'resourceType' 'resourceWithoutLocation'
notIn	フィルター処理する値の一覧。	string[]

UserAssignedIdentitiesValue

名前	形容	価値

次の方法で共有

Microsoft.Authorization policyAssignments

Bicep リソース定義

リソースの形式

プロパティ値

同一性

IdentityUserAssignedIdentities

Microsoft.Authorization/policyAssignments

NonComplianceMessage

オーバーライド

ParameterValues

ParameterValuesValue

PolicyAssignmentProperties

ResourceSelector

セレクタ

UserAssignedIdentitiesValue

クイック スタートのサンプル

ARM テンプレート リソース定義

リソースの形式

プロパティ値

同一性

IdentityUserAssignedIdentities

Microsoft.Authorization/policyAssignments

NonComplianceMessage

オーバーライド

ParameterValues

ParameterValuesValue

PolicyAssignmentProperties

ResourceSelector

セレクタ

UserAssignedIdentitiesValue

クイック スタート テンプレート

Terraform (AzAPI プロバイダー) リソース定義

リソースの形式

プロパティ値

同一性

IdentityUserAssignedIdentities

Microsoft.Authorization/policyAssignments

NonComplianceMessage

オーバーライド

ParameterValues

ParameterValuesValue

PolicyAssignmentProperties

ResourceSelector

セレクタ

UserAssignedIdentitiesValue

フィードバック

その他のリソース

クイックスタートのサンプル

ARM テンプレートリソース定義

クイックスタートテンプレート