Microsoft.Authorization policyDefinizioni

Definizione della risorsa Bicep

Il tipo di risorsa policyDefinitions può essere distribuito con operazioni destinate a:

• Gruppi di gestione - Vedere i comandi di distribuzione del gruppo di gestione * sottoscrizione - Vedere comandi di distribuzione delle sottoscrizioni

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Campioni di Bicep

Esempio di base di distribuzione delle definizioni dei criteri di autorizzazione.

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'
  }
}

Esempi di Azure Quickstart

I seguenti template Azure Quickstart contengono Bicep esempi per il deployment di questo tipo di risorsa.

Formato risorsa

Per creare una risorsa Microsoft.Authorization/policyDefinitions, aggiungi il seguente Bicep al tuo template.

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'
    ]
  }
}

Valori delle proprietà

Microsoft.Authorization/policyDefinitions

ExternalEvaluationEndpointSettings

ExternalEvaluationEnforcementSettings

ParameterDefinitionsValue

ParametriDefinizioniValoreMetadati

PolicyDefinitionProperties

ParametriProprietàDefinizione della PoliticaT

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa policyDefinitions può essere distribuito con operazioni destinate a:

• Gruppi di gestione - Vedi comandi* di distribuzione del gruppo di gestioneAbbonamento - Vedi comandi di distribuzione in abbonamento Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro modifiche.

Esempi di utilizzo

Modelli di Avvio Rapido Azure

I seguenti template Azure Quickstart distribuiscono questo tipo di risorsa.

Modello	Descrizione
Crea un gestione rete virtuale di Azure e campiona VNET	Questo template implementa un gestione rete virtuale di Azure e campiona le reti virtuali nel gruppo di risorse nominato. Supporta più topologie di connettività e tipi di appartenenza a gruppi di rete.
Implementa una difesa politica e assegna a più gruppi di gestione	Questo modello è un modello a livello di gruppo di gestione che creerà una definizione di criteri e assegnerà tale criterio a più gruppi di gestione.
Distribuisci una definizione di policy e assegna a un gruppo di gestione	Questo modello è un modello a livello di gruppo di gestione che creerà una definizione di criteri e assegnerà tale criterio al gruppo di gestione di destinazione. Attualmente, questo modello non può essere distribuito tramite portale di Azure.

Formato risorsa

Per creare una risorsa Microsoft.Authorization/policyDefinitions, aggiungere il codice JSON seguente al modello.

{
  "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" ]
  }
}

Valori delle proprietà

Microsoft.Authorization/policyDefinitions

ExternalEvaluationEndpointSettings

ExternalEvaluationEnforcementSettings

ParameterDefinitionsValue

ParametriDefinizioniValoreMetadati

PolicyDefinitionProperties

ParametriProprietàDefinizione della PoliticaT

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa policyDefinitions può essere distribuito con operazioni destinate a:

• Gruppi * di gestioneAbbonamento Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione delle definizioni dei criteri di autorizzazione.

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    = ["*"]
}

Formato risorsa

Per creare una risorsa Microsoft.Authorization/policyDefinitions, aggiungere il codice Terraform seguente al modello.

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"
      ]
    }
  }
}

Valori delle proprietà

Microsoft.Authorization/policyDefinitions

ExternalEvaluationEndpointSettings

ExternalEvaluationEnforcementSettings

ParameterDefinitionsValue

ParametriDefinizioniValoreMetadati

PolicyDefinitionProperties

ParametriProprietàDefinizione della PoliticaT