Microsoft.Authorization policyDefinizioni/versioni

Definizione della risorsa Bicep

Il tipo di risorsa policyDefinitions/versions 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.

Formato risorsa

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

resource symbolicname 'Microsoft.Authorization/policyDefinitions/versions@2026-01-01-preview' = {
  parent: resourceSymbolicName
  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'
  }
}

Valori delle proprietà

Microsoft.Authorization/policyDefinitions/versions

Nome Descrizione Valore
nome Nome della risorsa corda

Vincoli:
Pattern = ^\d+\.\d+\.\d+$ (obbligatorio)
genitore In Bicep, puoi specificare la risorsa genitore per una risorsa figlia. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.
Nome simbolico per la risorsa di tipo: policyDefinitions
proprietà Proprietà della versione della definizione dei criteri. PolicyDefinitionVersionProperties

ExternalEvaluationEndpointSettings

Nome Descrizione Valore
Dettagli Dettagli dell'endpoint. qualunque
tipo/gentile Tipo di endpoint. corda

ExternalEvaluationEnforcementSettings

Nome Descrizione Valore
endpointImpostazioni Impostazioni di un endpoint esterno che forniscono risultati di valutazione. ExternalEvaluationEndpointSettings
missingTokenAction Cosa fare quando si valuta un criterio di imposizione che richiede una valutazione esterna e il token non è presente. I valori possibili sono Audit e Deny e le espressioni di linguaggio sono supportate. corda
risultatoDurata della vita Durata del risultato della chiamata dell'endpoint dopo la quale non è più valida. È previsto che il valore segua il formato di durata ISO 8601 e le espressioni di linguaggio siano supportate. corda
roleDefinitionIds Per richiamare l'endpoint, una matrice della definizione del ruolo ID dell'identità del servizio gestito dell'assegnazione. stringa[]

ParameterDefinitionsValue

Nome Descrizione Valore
allowedValues Valori consentiti per il parametro . qualsiasi[]
valore predefinito Valore predefinito per il parametro se non viene specificato alcun valore. qualunque
dati descrittivi Metadati generali per il parametro . ParametriDefinizioniValoreMetadati
schema Fornisce la convalida degli input dei parametri durante l'assegnazione usando uno schema JSON self-defined. Questa proprietà è supportata solo per i parametri di tipo oggetto e segue l'implementazione dello schema Json.NET 2019-09. Per altre informazioni sull'uso degli schemi, vedere https://json-schema.org/ e testare gli schemi bozza in https://www.jsonschemavalidator.net/. qualunque
tipo Tipo di dati del parametro. 'Schieramento'
'Booleano'
'Data/ora'
'Galleggiare'
'Intero'
'Oggetto'
'Stringa'

ParametriDefinizioniValoreMetadati

Nome Descrizione Valore
assignPermissions Imposta su true per far sì che il portale Azure crei assegnazioni di ruolo sull'ID risorsa o sul valore dell'ambito della risorsa di questo parametro durante l'assegnazione delle policy. Questa proprietà è utile nel caso in cui si desideri assegnare autorizzazioni all'esterno dell'ambito di assegnazione. Bool
descrizione Descrizione del parametro. corda
nome visualizzato Nome visualizzato per il parametro. corda
strongType Usato quando si assegna la definizione dei criteri tramite il portale. Fornisce un elenco di valori con riconoscimento del contesto tra cui scegliere l'utente. corda

PolicyDefinitionVersionProperties

Nome Descrizione Valore
descrizione Descrizione della definizione dei criteri. corda
nome visualizzato Nome visualizzato della definizione dei criteri. corda
externalEvaluationEnforcementSettings Dettagli dell'origine dei risultati della valutazione esterna richiesti dai criteri durante la valutazione dell'imposizione. ExternalEvaluationEnforcementSettings
dati descrittivi Metadati della definizione dei criteri. I metadati sono un oggetto aperto terminato ed è in genere una raccolta di coppie chiave-valore. qualunque
modalità Modalità di definizione dei criteri. Alcuni esempi sono Tutti, Indicizzati, Microsoft.KeyVault.Data. corda
Parametri Definizioni dei parametri per i parametri usati nella regola dei criteri. Le chiavi sono i nomi dei parametri. PolicyDefinitionVersionPropertiesParameters
policyRule Regola dei criteri. qualunque
policyType Tipo di definizione dei criteri. I valori possibili sono NotSpecified, BuiltIn, Custom e Static. 'Incorporato'
'Personalizzato'
'Non specificato'
'Statico'
Versione Versione della definizione dei criteri in formato #.#.# . corda

PolicyDefinitionVersionPropertiesParameters

Nome Descrizione Valore

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa policyDefinitions/versions 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.

Formato risorsa

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

{
  "type": "Microsoft.Authorization/policyDefinitions/versions",
  "apiVersion": "2026-01-01-preview",
  "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"
  }
}

Valori delle proprietà

Microsoft.Authorization/policyDefinitions/versions

Nome Descrizione Valore
versione dell'API Versione dell'API 'anteprima 2026-01-01-preview'
nome Nome della risorsa corda

Vincoli:
Pattern = ^\d+\.\d+\.\d+$ (obbligatorio)
proprietà Proprietà della versione della definizione dei criteri. PolicyDefinitionVersionProperties
tipo Tipo di risorsa 'Microsoft.Authorization/policyDefinitions/versioni'

ExternalEvaluationEndpointSettings

Nome Descrizione Valore
Dettagli Dettagli dell'endpoint. qualunque
tipo/gentile Tipo di endpoint. corda

ExternalEvaluationEnforcementSettings

Nome Descrizione Valore
endpointImpostazioni Impostazioni di un endpoint esterno che forniscono risultati di valutazione. ExternalEvaluationEndpointSettings
missingTokenAction Cosa fare quando si valuta un criterio di imposizione che richiede una valutazione esterna e il token non è presente. I valori possibili sono Audit e Deny e le espressioni di linguaggio sono supportate. corda
risultatoDurata della vita Durata del risultato della chiamata dell'endpoint dopo la quale non è più valida. È previsto che il valore segua il formato di durata ISO 8601 e le espressioni di linguaggio siano supportate. corda
roleDefinitionIds Per richiamare l'endpoint, una matrice della definizione del ruolo ID dell'identità del servizio gestito dell'assegnazione. stringa[]

ParameterDefinitionsValue

Nome Descrizione Valore
allowedValues Valori consentiti per il parametro . qualsiasi[]
valore predefinito Valore predefinito per il parametro se non viene specificato alcun valore. qualunque
dati descrittivi Metadati generali per il parametro . ParametriDefinizioniValoreMetadati
schema Fornisce la convalida degli input dei parametri durante l'assegnazione usando uno schema JSON self-defined. Questa proprietà è supportata solo per i parametri di tipo oggetto e segue l'implementazione dello schema Json.NET 2019-09. Per altre informazioni sull'uso degli schemi, vedere https://json-schema.org/ e testare gli schemi bozza in https://www.jsonschemavalidator.net/. qualunque
tipo Tipo di dati del parametro. 'Schieramento'
'Booleano'
'Data/ora'
'Galleggiare'
'Intero'
'Oggetto'
'Stringa'

ParametriDefinizioniValoreMetadati

Nome Descrizione Valore
assignPermissions Imposta su true per far sì che il portale Azure crei assegnazioni di ruolo sull'ID risorsa o sul valore dell'ambito della risorsa di questo parametro durante l'assegnazione delle policy. Questa proprietà è utile nel caso in cui si desideri assegnare autorizzazioni all'esterno dell'ambito di assegnazione. Bool
descrizione Descrizione del parametro. corda
nome visualizzato Nome visualizzato per il parametro. corda
strongType Usato quando si assegna la definizione dei criteri tramite il portale. Fornisce un elenco di valori con riconoscimento del contesto tra cui scegliere l'utente. corda

PolicyDefinitionVersionProperties

Nome Descrizione Valore
descrizione Descrizione della definizione dei criteri. corda
nome visualizzato Nome visualizzato della definizione dei criteri. corda
externalEvaluationEnforcementSettings Dettagli dell'origine dei risultati della valutazione esterna richiesti dai criteri durante la valutazione dell'imposizione. ExternalEvaluationEnforcementSettings
dati descrittivi Metadati della definizione dei criteri. I metadati sono un oggetto aperto terminato ed è in genere una raccolta di coppie chiave-valore. qualunque
modalità Modalità di definizione dei criteri. Alcuni esempi sono Tutti, Indicizzati, Microsoft.KeyVault.Data. corda
Parametri Definizioni dei parametri per i parametri usati nella regola dei criteri. Le chiavi sono i nomi dei parametri. PolicyDefinitionVersionPropertiesParameters
policyRule Regola dei criteri. qualunque
policyType Tipo di definizione dei criteri. I valori possibili sono NotSpecified, BuiltIn, Custom e Static. 'Incorporato'
'Personalizzato'
'Non specificato'
'Statico'
Versione Versione della definizione dei criteri in formato #.#.# . corda

PolicyDefinitionVersionPropertiesParameters

Nome Descrizione Valore

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

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

  • Gruppi di gestione* sottoscrizione

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

Formato risorsa

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Authorization/policyDefinitions/versions@2026-01-01-preview"
  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"
    }
  }
}

Valori delle proprietà

Microsoft.Authorization/policyDefinitions/versions

Nome Descrizione Valore
nome Nome della risorsa corda

Vincoli:
Pattern = ^\d+\.\d+\.\d+$ (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: policyDefinitions
proprietà Proprietà della versione della definizione dei criteri. PolicyDefinitionVersionProperties
tipo Tipo di risorsa "Microsoft.Authorization/policyDefinitions/versions@2026-01-01-preview"

ExternalEvaluationEndpointSettings

Nome Descrizione Valore
Dettagli Dettagli dell'endpoint. qualunque
tipo/gentile Tipo di endpoint. corda

ExternalEvaluationEnforcementSettings

Nome Descrizione Valore
endpointImpostazioni Impostazioni di un endpoint esterno che forniscono risultati di valutazione. ExternalEvaluationEndpointSettings
missingTokenAction Cosa fare quando si valuta un criterio di imposizione che richiede una valutazione esterna e il token non è presente. I valori possibili sono Audit e Deny e le espressioni di linguaggio sono supportate. corda
risultatoDurata della vita Durata del risultato della chiamata dell'endpoint dopo la quale non è più valida. È previsto che il valore segua il formato di durata ISO 8601 e le espressioni di linguaggio siano supportate. corda
roleDefinitionIds Per richiamare l'endpoint, una matrice della definizione del ruolo ID dell'identità del servizio gestito dell'assegnazione. stringa[]

ParameterDefinitionsValue

Nome Descrizione Valore
allowedValues Valori consentiti per il parametro . qualsiasi[]
valore predefinito Valore predefinito per il parametro se non viene specificato alcun valore. qualunque
dati descrittivi Metadati generali per il parametro . ParametriDefinizioniValoreMetadati
schema Fornisce la convalida degli input dei parametri durante l'assegnazione usando uno schema JSON self-defined. Questa proprietà è supportata solo per i parametri di tipo oggetto e segue l'implementazione dello schema Json.NET 2019-09. Per altre informazioni sull'uso degli schemi, vedere https://json-schema.org/ e testare gli schemi bozza in https://www.jsonschemavalidator.net/. qualunque
tipo Tipo di dati del parametro. 'Schieramento'
'Booleano'
'Data/ora'
'Galleggiare'
'Intero'
'Oggetto'
'Stringa'

ParametriDefinizioniValoreMetadati

Nome Descrizione Valore
assignPermissions Imposta su true per far sì che il portale Azure crei assegnazioni di ruolo sull'ID risorsa o sul valore dell'ambito della risorsa di questo parametro durante l'assegnazione delle policy. Questa proprietà è utile nel caso in cui si desideri assegnare autorizzazioni all'esterno dell'ambito di assegnazione. Bool
descrizione Descrizione del parametro. corda
nome visualizzato Nome visualizzato per il parametro. corda
strongType Usato quando si assegna la definizione dei criteri tramite il portale. Fornisce un elenco di valori con riconoscimento del contesto tra cui scegliere l'utente. corda

PolicyDefinitionVersionProperties

Nome Descrizione Valore
descrizione Descrizione della definizione dei criteri. corda
nome visualizzato Nome visualizzato della definizione dei criteri. corda
externalEvaluationEnforcementSettings Dettagli dell'origine dei risultati della valutazione esterna richiesti dai criteri durante la valutazione dell'imposizione. ExternalEvaluationEnforcementSettings
dati descrittivi Metadati della definizione dei criteri. I metadati sono un oggetto aperto terminato ed è in genere una raccolta di coppie chiave-valore. qualunque
modalità Modalità di definizione dei criteri. Alcuni esempi sono Tutti, Indicizzati, Microsoft.KeyVault.Data. corda
Parametri Definizioni dei parametri per i parametri usati nella regola dei criteri. Le chiavi sono i nomi dei parametri. PolicyDefinitionVersionPropertiesParameters
policyRule Regola dei criteri. qualunque
policyType Tipo di definizione dei criteri. I valori possibili sono NotSpecified, BuiltIn, Custom e Static. 'Incorporato'
'Personalizzato'
'Non specificato'
'Statico'
Versione Versione della definizione dei criteri in formato #.#.# . corda

PolicyDefinitionVersionPropertiesParameters

Nome Descrizione Valore