Microsoft.Политика авторизацииОпределения

Определение ресурса Bicep

Тип ресурса policyDefinitions можно развернуть с помощью операций, предназначенных для следующих операций:

• групп управления . См. команды развертывания группы управления подписке . См. команды развертывания подписки

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Authorization/policyDefinitions, добавьте следующий Bicep в ваш шаблон.

resource symbolicname 'Microsoft.Authorization/policyDefinitions@2026-06-01' = {
  name: 'string'
  properties: {
    description: 'string'
    displayName: 'string'
    externalEvaluationEnforcementSettings: {
      endpointSettings: {
        details: any(...)
        kind: 'string'
      }
      missingTokenAction: 'string'
      resultLifespan: 'string'
      roleDefinitionIds: [
        'string'
      ]
    }
    metadata: any(...)
    mode: 'string'
    parameters: {
      {customized property}: {
        allowedValues: [
          any(...)
        ]
        defaultValue: any(...)
        metadata: {
          assignPermissions: bool
          description: 'string'
          displayName: 'string'
          strongType: 'string'
        }
        schema: any(...)
        type: 'string'
      }
    }
    policyRule: any(...)
    policyType: 'string'
    version: 'string'
    versions: [
      'string'
    ]
  }
}

Значения свойств

Microsoft.Authorization/policyDefinitions

ExternalEvaluationEndpointSettings (ВнешняяEvaluationEndpointSettings)

ExternalEvaluationEnforcementSettings (ВнешняяОценкаПринудительныеНастройки)

ЗначениеParameterDefinitionsValue

ParameterDefinitionsValueMetadata

PolicyDefinitionProperties (Свойства PolicyDefinition)

PolicyDefinitionPropertiesParameters

Примеры использования

Примеры Bicep

Простой пример развертывания определений политики авторизации.

targetScope = 'subscription'

param resourceName string = 'acctest0001'
param location string = 'eastus'

resource policyDefinition 'Microsoft.Authorization/policyDefinitions@2021-06-01' = {
  name: resourceName
  properties: {
    description: ''
    displayName: 'my-policy-definition'
    mode: 'All'
    parameters: {
      allowedLocations: {
        metadata: {
          description: 'The list of allowed locations for resources.'
          displayName: 'Allowed locations'
          strongType: 'location'
        }
        type: 'Array'
      }
    }
    policyRule: {
      if: {
        not: {
          field: 'location'
          in: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
        }
      }
      then: {
        effect: 'audit'
      }
    }
    policyType: 'Custom'
  }
}

Примеры быстрого запуска Azure

Следующие шаблоны Azure Quickstart содержат Bicep образцов для развертывания этого типа ресурсов.

Определение ресурса шаблона ARM

Тип ресурса policyDefinitions можно развернуть с помощью операций, предназначенных для следующих операций:

• групп управления . См. команды развертывания группы управления подписке . См. команды развертывания подписки

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Authorization/policyDefinitions, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Authorization/policyDefinitions",
  "apiVersion": "2026-06-01",
  "name": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "externalEvaluationEnforcementSettings": {
      "endpointSettings": {
        "details": {},
        "kind": "string"
      },
      "missingTokenAction": "string",
      "resultLifespan": "string",
      "roleDefinitionIds": [ "string" ]
    },
    "metadata": {},
    "mode": "string",
    "parameters": {
      "{customized property}": {
        "allowedValues": [ {} ],
        "defaultValue": {},
        "metadata": {
          "assignPermissions": "bool",
          "description": "string",
          "displayName": "string",
          "strongType": "string"
        },
        "schema": {},
        "type": "string"
      }
    },
    "policyRule": {},
    "policyType": "string",
    "version": "string",
    "versions": [ "string" ]
  }
}

Значения свойств

Microsoft.Authorization/policyDefinitions

ExternalEvaluationEndpointSettings (ВнешняяEvaluationEndpointSettings)

ExternalEvaluationEnforcementSettings (ВнешняяОценкаПринудительныеНастройки)

ЗначениеParameterDefinitionsValue

ParameterDefinitionsValueMetadata

PolicyDefinitionProperties (Свойства PolicyDefinition)

PolicyDefinitionPropertiesParameters

Примеры использования

Шаблоны быстрого запуска Azure

Следующие Azure шаблоны быстрого запуска развёртают этот тип ресурса.

Шаблон	Описание
Создать Диспетчер виртуальных сетей Azure и сэмплировать VNET	Этот шаблон развёртает Диспетчер виртуальных сетей Azure и размещает виртуальные сети в указанную группу ресурсов. Он поддерживает несколько топологий подключения и типов членства в группах сети.
развернуть политику и назначить нескольким группам MGMT	Этот шаблон — это шаблон уровня группы управления, который создаст определение политики и назначит эту политику нескольким группам управления.
Развернуть определение политики и назначить её группе управления	Этот шаблон — это шаблон уровня группы управления, который создаст определение политики и назначит эту политику целевой группе управления. В настоящее время этот шаблон нельзя развернуть через портал Azure.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса policyDefinitions можно развернуть с помощью операций, предназначенных для следующих операций:

• группы управления* подписки

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Authorization/policyDefinitions, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Authorization/policyDefinitions@2026-06-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      description = "string"
      displayName = "string"
      externalEvaluationEnforcementSettings = {
        endpointSettings = {
          details = ?
          kind = "string"
        }
        missingTokenAction = "string"
        resultLifespan = "string"
        roleDefinitionIds = [
          "string"
        ]
      }
      metadata = ?
      mode = "string"
      parameters = {
        {customized property} = {
          allowedValues = [
            ?
          ]
          defaultValue = ?
          metadata = {
            assignPermissions = bool
            description = "string"
            displayName = "string"
            strongType = "string"
          }
          schema = ?
          type = "string"
        }
      }
      policyRule = ?
      policyType = "string"
      version = "string"
      versions = [
        "string"
      ]
    }
  }
}

Значения свойств

Microsoft.Authorization/policyDefinitions

ExternalEvaluationEndpointSettings (ВнешняяEvaluationEndpointSettings)

ExternalEvaluationEnforcementSettings (ВнешняяОценкаПринудительныеНастройки)

ЗначениеParameterDefinitionsValue

ParameterDefinitionsValueMetadata

PolicyDefinitionProperties (Свойства PolicyDefinition)

PolicyDefinitionPropertiesParameters

Примеры использования

Примеры Terraform

Простой пример развертывания определений политики авторизации.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "eastus"
}

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "policyDefinition" {
  type      = "Microsoft.Authorization/policyDefinitions@2021-06-01"
  parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  name      = var.resource_name
  body = {
    properties = {
      description = ""
      displayName = "my-policy-definition"
      mode        = "All"
      parameters = {
        allowedLocations = {
          metadata = {
            description = "The list of allowed locations for resources."
            displayName = "Allowed locations"
            strongType  = "location"
          }
          type = "Array"
        }
      }
      policyRule = {
        if = {
          not = {
            field = "location"
            in    = "[parameters('allowedLocations')]"
          }
        }
        then = {
          effect = "audit"
        }
      }
      policyType = "Custom"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}