Microsoft.Authorization policyAssignments

[アーティクル]
10/19/2024

Bicep リソース定義

policyAssignments リソースの種類は、拡張機能リソースです。つまり、別のリソースに適用できます。

このリソースの scope プロパティを使用して、このリソースのスコープを設定します。 Bicepの拡張機能リソースのスコープの設定を参照してください。

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

リソースグループの - リソースグループのデプロイコマンド参照
サブスクリプションの - サブスクリプションのデプロイコマンド参照
管理グループの - 管理グループの展開コマンドを参照してください

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

リソースの形式

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

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

プロパティ値

policyAssignments

名前	形容	価値
名前	リソース名	string (必須) 文字制限: 1 ~ 128 表示名 1 から 64 リソース名管理グループスコープでの 1 から 24 個のリソース名有効な文字: 表示名には任意の文字を含めることができます。リソース名では、次の情報を使用できません。 `<>*%&:\?.+/` または制御文字。ピリオドまたはスペースで終えることはできません。
場所	ポリシー割り当ての場所。マネージド ID を使用する場合にのみ必要です。	糸
スコープ	デプロイスコープとは異なるスコープで拡張機能リソースを作成する場合に使用します。	ターゲットリソース Bicep の場合は、このプロパティをリソースのシンボリック名に設定して、拡張リソース適用します。
同一性	ポリシーの割り当てに関連付けられているマネージド ID。	ID
プロパティ	ポリシー割り当てのプロパティ。	PolicyAssignmentProperties の

同一性

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

IdentityUserAssignedIdentities

名前	形容	価値
{カスタマイズされたプロパティ}		UserAssignedIdentitiesValue の

UserAssignedIdentitiesValue

このオブジェクトには、配置時に設定するプロパティは含まれません。すべてのプロパティは ReadOnly です。

PolicyAssignmentProperties

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

NonComplianceMessage

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

オーバーライド

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

セレクタ

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

ParameterValues

名前	形容	価値
{カスタマイズされたプロパティ}		ParameterValuesValue

ParameterValuesValue

名前	形容	価値
価値	パラメーターの値。	Bicep の場合は、any() 関数を使用できます。

ResourceSelector

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

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

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

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

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

policyAssignments リソースの種類は、拡張機能リソースです。つまり、別のリソースに適用できます。

このリソースの scope プロパティを使用して、このリソースのスコープを設定します。「ARM テンプレートの拡張機能リソースのスコープを設定する」を参照してください。

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

リソースグループの - リソースグループのデプロイコマンド参照
サブスクリプションの - サブスクリプションのデプロイコマンド参照
管理グループの - 管理グループの展開コマンドを参照してください

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

リソースの形式

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

{
  "type": "Microsoft.Authorization/policyAssignments",
  "apiVersion": "2024-04-01",
  "name": "string",
  "location": "string",
  "scope": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "assignmentType": "string",
    "description": "string",
    "displayName": "string",
    "enforcementMode": "string",
    "metadata": {},
    "nonComplianceMessages": [
      {
        "message": "string",
        "policyDefinitionReferenceId": "string"
      }
    ],
    "notScopes": [ "string" ],
    "overrides": [
      {
        "kind": "policyEffect",
        "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" ]
          }
        ]
      }
    ]
  }
}

プロパティ値

policyAssignments

名前	形容	価値
種類	リソースの種類	'Microsoft.Authorization/policyAssignments'
apiVersion	リソース API のバージョン	'2024-04-01'
名前	リソース名	string (必須) 文字制限: 1 ~ 128 表示名 1 から 64 リソース名管理グループスコープでの 1 から 24 個のリソース名有効な文字: 表示名には任意の文字を含めることができます。リソース名では、次の情報を使用できません。 `<>*%&:\?.+/` または制御文字。ピリオドまたはスペースで終えることはできません。
場所	ポリシー割り当ての場所。マネージド ID を使用する場合にのみ必要です。	糸
スコープ	デプロイスコープとは異なるスコープで拡張機能リソースを作成する場合に使用します。	ターゲットリソース JSON の場合、拡張機能リソースのを適用するリソースの完全な名前に値を設定します。
同一性	ポリシーの割り当てに関連付けられているマネージド ID。	ID
プロパティ	ポリシー割り当てのプロパティ。	PolicyAssignmentProperties の

同一性

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

IdentityUserAssignedIdentities

名前	形容	価値
{カスタマイズされたプロパティ}		UserAssignedIdentitiesValue の

UserAssignedIdentitiesValue

このオブジェクトには、配置時に設定するプロパティは含まれません。すべてのプロパティは ReadOnly です。

PolicyAssignmentProperties

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

NonComplianceMessage

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

オーバーライド

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

セレクタ

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

ParameterValues

名前	形容	価値
{カスタマイズされたプロパティ}		ParameterValuesValue

ParameterValuesValue

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

ResourceSelector

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

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

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

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

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

policyAssignments リソースの種類は、拡張機能リソースです。つまり、別のリソースに適用できます。

このリソースの parent_id プロパティを使用して、このリソースのスコープを設定します。

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

リソースグループの
サブスクリプション
管理グループの

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

リソースの形式

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

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

プロパティ値

policyAssignments

名前	形容	価値
種類	リソースの種類	"Microsoft.Authorization/policyAssignments@2024-04-01"
名前	リソース名	string (必須) 文字制限: 1 ~ 128 表示名 1 から 64 リソース名管理グループスコープでの 1 から 24 個のリソース名有効な文字: 表示名には任意の文字を含めることができます。リソース名では、次の情報を使用できません。 `<>*%&:\?.+/` または制御文字。ピリオドまたはスペースで終えることはできません。
場所	ポリシー割り当ての場所。マネージド ID を使用する場合にのみ必要です。	糸
parent_id	この拡張リソースを適用するリソースの ID。	string (必須)
同一性	ポリシーの割り当てに関連付けられているマネージド ID。	ID
プロパティ	ポリシー割り当てのプロパティ。	PolicyAssignmentProperties の

同一性

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

IdentityUserAssignedIdentities

名前	形容	価値
{カスタマイズされたプロパティ}		UserAssignedIdentitiesValue の

UserAssignedIdentitiesValue

このオブジェクトには、配置時に設定するプロパティは含まれません。すべてのプロパティは ReadOnly です。

PolicyAssignmentProperties

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

NonComplianceMessage

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

オーバーライド

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

セレクタ

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

ParameterValues

名前	形容	価値
{カスタマイズされたプロパティ}		ParameterValuesValue

ParameterValuesValue

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

ResourceSelector

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

次の方法で共有

Microsoft.Authorization policyAssignments

Bicep リソース定義

リソースの形式

プロパティ値

policyAssignments

同一性

IdentityUserAssignedIdentities

UserAssignedIdentitiesValue

PolicyAssignmentProperties

NonComplianceMessage

オーバーライド

セレクタ

ParameterValues

ParameterValuesValue

ResourceSelector

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

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

リソースの形式

プロパティ値

policyAssignments

同一性

IdentityUserAssignedIdentities

UserAssignedIdentitiesValue

PolicyAssignmentProperties

NonComplianceMessage

オーバーライド

セレクタ

ParameterValues

ParameterValuesValue

ResourceSelector

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

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

リソースの形式

プロパティ値

policyAssignments

同一性

IdentityUserAssignedIdentities

UserAssignedIdentitiesValue

PolicyAssignmentProperties

NonComplianceMessage

オーバーライド

セレクタ

ParameterValues

ParameterValuesValue

ResourceSelector

フィードバック

その他のリソース

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

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

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