Microsoft. Politica di autorizzazioneDefinizioniSetDefinizioni 2025-12-01-preview

Definizione della risorsa Bicep

Il tipo di risorsa policySetDefinitions 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, consulta il log delle modifiche.

Esempi di utilizzo

Campioni di Bicep

Esempio di base di distribuzione della definizione del set di criteri.

targetScope = 'subscription'

param resourceName string = 'acctest0001'
param location string = 'westus'

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

resource policySetDefinition 'Microsoft.Authorization/policySetDefinitions@2025-01-01' = {
  name: 'acctestpolset-${resourceName}'
  properties: {
    description: ''
    displayName: 'acctestpolset-${resourceName}'
    parameters: {
      allowedLocations: {
        metadata: {
          description: 'The list of allowed locations for resources.'
          displayName: 'Allowed locations'
          strongType: 'location'
        }
        type: 'Array'
      }
    }
    policyDefinitions: [
      {
        groupNames: []
        parameters: {
          listOfAllowedLocations: {
            value: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          }
        }
        policyDefinitionId: policyDefinition.id
        policyDefinitionReferenceId: ''
      }
    ]
    policyType: 'Custom'
  }
}

Formato delle risorse

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

resource symbolicname 'Microsoft.Authorization/policySetDefinitions@2025-12-01-preview' = {
  name: 'string'
  properties: {
    description: 'string'
    displayName: 'string'
    metadata: any(...)
    parameters: {
      {customized property}: {
        allowedValues: [
          any(...)
        ]
        defaultValue: any(...)
        metadata: {
          assignPermissions: bool
          description: 'string'
          displayName: 'string'
          strongType: 'string'
        }
        schema: any(...)
        type: 'string'
      }
    }
    policyDefinitionGroups: [
      {
        additionalMetadataId: 'string'
        category: 'string'
        description: 'string'
        displayName: 'string'
        name: 'string'
      }
    ]
    policyDefinitions: [
      {
        definitionVersion: 'string'
        groupNames: [
          'string'
        ]
        parameters: {
          {customized property}: {
            value: any(...)
          }
        }
        policyDefinitionId: 'string'
        policyDefinitionReferenceId: 'string'
      }
    ]
    policyType: 'string'
    version: 'string'
    versions: [
      'string'
    ]
  }
}

Valori delle proprietà

Microsoft.Authorization/policySetDefinitions

ParameterDefinitionsValue

ParameterDefinitionsValueMetadata

ParameterValuesValue

PolicyDefinitionGroup

PolicyDefinitionReference

PolicyDefinitionReferenceParameters

PolicySetDefinitionProperties

ParametriProprietàDefinizioneInsiemePolitiche

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa policySetDefinitions 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

Formato delle risorse

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

{
  "type": "Microsoft.Authorization/policySetDefinitions",
  "apiVersion": "2025-12-01-preview",
  "name": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "metadata": {},
    "parameters": {
      "{customized property}": {
        "allowedValues": [ {} ],
        "defaultValue": {},
        "metadata": {
          "assignPermissions": "bool",
          "description": "string",
          "displayName": "string",
          "strongType": "string"
        },
        "schema": {},
        "type": "string"
      }
    },
    "policyDefinitionGroups": [
      {
        "additionalMetadataId": "string",
        "category": "string",
        "description": "string",
        "displayName": "string",
        "name": "string"
      }
    ],
    "policyDefinitions": [
      {
        "definitionVersion": "string",
        "groupNames": [ "string" ],
        "parameters": {
          "{customized property}": {
            "value": {}
          }
        },
        "policyDefinitionId": "string",
        "policyDefinitionReferenceId": "string"
      }
    ],
    "policyType": "string",
    "version": "string",
    "versions": [ "string" ]
  }
}

Valori delle proprietà

Microsoft.Authorization/policySetDefinitions

ParameterDefinitionsValue

ParameterDefinitionsValueMetadata

ParameterValuesValue

PolicyDefinitionGroup

PolicyDefinitionReference

PolicyDefinitionReferenceParameters

PolicySetDefinitionProperties

ParametriProprietàDefinizioneInsiemePolitiche

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa policySetDefinitions 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 della definizione del set di criteri.

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

provider "azapi" {
  skip_provider_registration = false
}

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

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

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

resource "azapi_resource" "policySetDefinition" {
  type      = "Microsoft.Authorization/policySetDefinitions@2025-01-01"
  parent_id = "/subscriptions/${data.azapi_client_config.current.subscription_id}"
  name      = "acctestpolset-${var.resource_name}"
  body = {
    properties = {
      description = ""
      displayName = "acctestpolset-${var.resource_name}"
      parameters = {
        allowedLocations = {
          metadata = {
            description = "The list of allowed locations for resources."
            displayName = "Allowed locations"
            strongType  = "location"
          }
          type = "Array"
        }
      }
      policyDefinitions = [{
        groupNames = []
        parameters = {
          listOfAllowedLocations = {
            value = "[parameters('allowedLocations')]"
          }
        }
        policyDefinitionId          = azapi_resource.policyDefinition.id
        policyDefinitionReferenceId = ""
      }]
      policyType = "Custom"
    }
  }
}

Formato delle risorse

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Authorization/policySetDefinitions@2025-12-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      description = "string"
      displayName = "string"
      metadata = ?
      parameters = {
        {customized property} = {
          allowedValues = [
            ?
          ]
          defaultValue = ?
          metadata = {
            assignPermissions = bool
            description = "string"
            displayName = "string"
            strongType = "string"
          }
          schema = ?
          type = "string"
        }
      }
      policyDefinitionGroups = [
        {
          additionalMetadataId = "string"
          category = "string"
          description = "string"
          displayName = "string"
          name = "string"
        }
      ]
      policyDefinitions = [
        {
          definitionVersion = "string"
          groupNames = [
            "string"
          ]
          parameters = {
            {customized property} = {
              value = ?
            }
          }
          policyDefinitionId = "string"
          policyDefinitionReferenceId = "string"
        }
      ]
      policyType = "string"
      version = "string"
      versions = [
        "string"
      ]
    }
  }
}

Valori delle proprietà

Microsoft.Authorization/policySetDefinitions

ParameterDefinitionsValue

ParameterDefinitionsValueMetadata

ParameterValuesValue

PolicyDefinitionGroup

PolicyDefinitionReference

PolicyDefinitionReferenceParameters

PolicySetDefinitionProperties

ParametriProprietàDefinizioneInsiemePolitiche