Policy Assignments - Create By Id

Servizio:: Policy

Versione API:: 2025-01-01

Crea o aggiorna un'assegnazione di criteri.
Questa operazione crea o aggiorna l'assegnazione della policy con l'ID fornito. Le assegnazioni di policy effettuate su un ambito si applicano a tutte le risorse contenute in quell'ambito. Ad esempio, quando assegni una policy a un gruppo di risorse, quella policy si applica a tutte le risorse del gruppo. Gli ID delle assegnazioni policy hanno questo formato: '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'. Gli ambiti validi sono: gruppo di gestione (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), subscription (format: '/subscriptions/{subscriptionId}'), resource group (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', o resource (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}/{resourceName}'.

PUT https://management.azure.com/{policyAssignmentId}?api-version=2025-01-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
policyAssignmentId	path	True	string	L'ID dell'assegnazione della policy da creare. Usare il formato '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
identity	Identity	Identità gestita associata all'assegnazione dei criteri.
location	string	Posizione dell'assegnazione dei criteri. Obbligatorio solo quando si usa l'identità gestita.
properties.assignmentType	assignmentType	Tipo di assegnazione dei criteri. I valori possibili sono NotSpecified, System, SystemHidden e Custom. Non modificabile.
properties.definitionVersion	string	Versione della definizione di criteri da usare.
properties.description	string	Questo messaggio farà parte della risposta in caso di violazione dei criteri.
properties.displayName	string	Nome visualizzato dell'assegnazione dei criteri.
properties.enforcementMode	enforcementMode	Modalità di imposizione dell'assegnazione dei criteri. I valori possibili sono Default, DoNotEnforce e Enroll
properties.metadata	object	Metadati dell'assegnazione dei criteri. I metadati sono un oggetto aperto terminato ed è in genere una raccolta di coppie chiave-valore.
properties.nonComplianceMessages	NonComplianceMessage[]	Messaggi che descrivono il motivo per cui una risorsa non è conforme ai criteri.
properties.notScopes	string[]	Ambiti esclusi dai criteri.
properties.overrides	Override[]	Override del valore della proprietà dei criteri.
properties.parameters	<string, ParameterValuesValue>	Valori dei parametri per la regola dei criteri assegnata. Le chiavi sono i nomi dei parametri.
properties.policyDefinitionId	string	ID della definizione di criteri o della definizione del set di criteri assegnata.
properties.resourceSelectors	ResourceSelector[]	Elenco di selettore di risorse per filtrare i criteri in base alle proprietà delle risorse.

Risposte

Nome	Tipo	Descrizione
201 Created	PolicyAssignment	Creato - Restituisce informazioni relative all'assegnazione della polizza.
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Create or update policy assignment by ID

Create or update policy assignment with a managed identity by ID

Create or update policy assignment by ID

Esempio di richiesta

HTTP

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage?api-version=2025-01-01

{
  "properties": {
    "displayName": "Enforce storage account SKU",
    "description": "Allow only storage accounts of SKU Standard_GRS or Standard_LRS to be created",
    "metadata": {
      "assignedBy": "Cheapskate Boss"
    },
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
    "definitionVersion": "1.*.*",
    "parameters": {
      "listOfAllowedSKUs": {
        "value": [
          "Standard_GRS",
          "Standard_LRS"
        ]
      }
    },
    "enforcementMode": "Default"
  }
}

Risposta di esempio

Codice di stato:: 201

{
  "properties": {
    "displayName": "Enforce storage account SKU",
    "description": "Allow only storage accounts of SKU Standard_GRS or Standard_LRS to be created",
    "metadata": {
      "assignedBy": "Cheapskate Boss"
    },
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
    "definitionVersion": "1.*.*",
    "notScopes": [],
    "parameters": {
      "listOfAllowedSKUs": {
        "value": [
          "Standard_GRS",
          "Standard_LRS"
        ]
      }
    },
    "enforcementMode": "Default",
    "instanceId": "b7e0f8a9-1c2d-4e3f-8b4c-5d6e7f8a9b0c"
  },
  "id": "/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage",
  "type": "Microsoft.Authorization/policyAssignments",
  "name": "LowCostStorage"
}

Create or update policy assignment with a managed identity by ID

Esempio di richiesta

HTTP

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage?api-version=2025-01-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "eastus",
  "properties": {
    "displayName": "Enforce storage account SKU",
    "description": "Allow only storage accounts of SKU Standard_GRS or Standard_LRS to be created",
    "metadata": {
      "assignedBy": "Cheapskate Boss"
    },
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
    "definitionVersion": "1.*.*",
    "parameters": {
      "listOfAllowedSKUs": {
        "value": [
          "Standard_GRS",
          "Standard_LRS"
        ]
      }
    },
    "enforcementMode": "Default"
  }
}

Risposta di esempio

Codice di stato:: 201

{
  "properties": {
    "displayName": "Enforce storage account SKU",
    "description": "Allow only storage accounts of SKU Standard_GRS or Standard_LRS to be created",
    "metadata": {
      "assignedBy": "Cheapskate Boss"
    },
    "policyDefinitionId": "/providers/Microsoft.Authorization/policyDefinitions/7433c107-6db4-4ad1-b57a-a76dce0154a1",
    "definitionVersion": "1.*.*",
    "notScopes": [],
    "parameters": {
      "listOfAllowedSKUs": {
        "value": [
          "Standard_GRS",
          "Standard_LRS"
        ]
      }
    },
    "enforcementMode": "Default",
    "instanceId": "b7e0f8a9-1c2d-4e3f-8b4c-5d6e7f8a9b0c"
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "e6d23f8d-af97-4fbc-bda6-00604e4e3d0a",
    "tenantId": "4bee2b8a-1bee-47c2-90e9-404241551135"
  },
  "location": "eastus",
  "id": "/providers/Microsoft.Management/managementGroups/MyManagementGroup/providers/Microsoft.Authorization/policyAssignments/LowCostStorage",
  "type": "Microsoft.Authorization/policyAssignments",
  "name": "LowCostStorage"
}

Definizioni

Nome	Descrizione
assignmentType	Tipo di assegnazione dei criteri. I valori possibili sono NotSpecified, System, SystemHidden e Custom. Non modificabile.
CloudError	Risposta di errore da un'operazione di criteri.
createdByType	Tipo di identità che ha creato la risorsa.
enforcementMode	Modalità di imposizione dell'assegnazione dei criteri. I valori possibili sono Default, DoNotEnforce e Enroll
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorResponse	Risposta errore
Identity	Identità per la risorsa. Le assegnazioni di policy supportano un massimo di un'identità. Cioè o un'identità assegnata al sistema o un'identità assegnata a un singolo utente.
NonComplianceMessage	Messaggio che descrive il motivo per cui una risorsa non è conforme ai criteri. Viene visualizzato nei messaggi di errore "nega" e nei risultati di conformità non conformi della risorsa.
Override	Override del valore della proprietà dei criteri.
OverrideKind	Tipo di override.
ParameterValuesValue	Il valore di un parametro.
PolicyAssignment	L'incarico di politica.
ResourceIdentityType	Tipo di identità. Questo è l'unico campo obbligatorio quando si aggiunge un'identità assegnata dal sistema o dall'utente a una risorsa.
ResourceSelector	Selettore di risorse per filtrare i criteri in base alle proprietà delle risorse.
Selector	Espressione del selettore.
SelectorKind	Tipo di selettore.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentities	Identità utente associata al criterio. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

assignmentType

Enumerazione

Tipo di assegnazione dei criteri. I valori possibili sono NotSpecified, System, SystemHidden e Custom. Non modificabile.

Valore	Descrizione
NotSpecified
System
SystemHidden
Custom

CloudError

Oggetto

Risposta di errore da un'operazione di criteri.

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta errore Risposta comune all'errore per tutte le API di Azure Resource Manager per restituire dettagli di errore per operazioni fallite. Questo segue anche il formato di risposta di errore OData.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

enforcementMode

Enumerazione

Modalità di imposizione dell'assegnazione dei criteri. I valori possibili sono Default, DoNotEnforce e Enroll

Valore	Descrizione
Default	L'effetto del criterio viene applicato durante la creazione o l'aggiornamento della risorsa.
DoNotEnforce	L'effetto della politica non viene applicato durante la creazione o l'aggiornamento delle risorse.
Enroll	L'effetto della policy non viene applicato durante la creazione o l'aggiornamento della risorsa finché la risorsa o l'ambito della risorsa non viene registrato nell'istanza dell'assegnazione. L'iscrizione avviene al momento dell'impiego della risorsa per l'iscrizione della politica.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorResponse

Oggetto

Risposta errore

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorResponse[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

Identity

Oggetto

Identità per la risorsa. Le assegnazioni di policy supportano un massimo di un'identità. Cioè o un'identità assegnata al sistema o un'identità assegnata a un singolo utente.

Nome	Tipo	Descrizione
principalId	string	L'ID principale dell'identità della risorsa. Questa proprietà sarà fornita solo per un'identità assegnata al sistema
tenantId	string	L'ID tenant dell'identità della risorsa. Questa proprietà sarà fornita solo per un'identità assegnata al sistema
type	ResourceIdentityType	Tipo di identità. Questo è l'unico campo obbligatorio quando si aggiunge un'identità assegnata dal sistema o dall'utente a una risorsa.
userAssignedIdentities	UserAssignedIdentities	Identità utente associata al criterio. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

NonComplianceMessage

Oggetto

Messaggio che descrive il motivo per cui una risorsa non è conforme ai criteri. Viene visualizzato nei messaggi di errore "nega" e nei risultati di conformità non conformi della risorsa.

Nome	Tipo	Descrizione
message	string	Messaggio che descrive il motivo per cui una risorsa non è conforme ai criteri. Viene visualizzato nei messaggi di errore "nega" e nei risultati di conformità non conformi della risorsa.
policyDefinitionReferenceId	string	L'ID riferimento alla definizione di criteri all'interno di una definizione del set di criteri per cui è destinato il messaggio. Questa opzione è applicabile solo se l'assegnazione di criteri assegna una definizione del set di criteri. Se non viene specificato, il messaggio si applica a tutti i criteri assegnati da questa assegnazione di criteri.

Override

Oggetto

Override del valore della proprietà dei criteri.

Nome	Tipo	Descrizione
kind	OverrideKind	Tipo di override.
selectors	Selector[]	Elenco delle espressioni del selettore.
value	string	Valore di cui eseguire l'override della proprietà dei criteri.

OverrideKind

Enumerazione

Tipo di override.

Valore	Descrizione
policyEffect	Prevalerà sul tipo di effetto della politica.
definitionVersion	Sovrascriverà il valore della proprietà della versione di definizione dell'assegnazione della policy.

ParameterValuesValue

Oggetto

Il valore di un parametro.

Nome	Tipo	Descrizione
value		Valore del parametro .