Policy Assignments - Delete

Servizio:: Policy

Versione API:: 2026-07-01

Questa operazione elimina un'assegnazione di criteri, in base al nome e all'ambito in cui è stata creata. L'ambito di un'assegnazione di criteri è la parte dell'ID precedente "/providers/Microsoft. Authorization/policyAssignments/{policyAssignmentName}'.

DELETE https://management.azure.com/{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}?api-version=2026-07-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
policyAssignmentName	path	True	string pattern: ^[^<>%&:\?/]*[^<>%&:\?/ ]+$	Nome dell'assegnazione dei criteri da ottenere.
scope	path	True	string	L'identificatore Azure Resource Manager completamente qualificato della risorsa.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	PolicyAssignment	L'operazione di Azure è stata completata correttamente.
204 No Content		La risorsa non esiste.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

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

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

Delete a policy assignment

Esempio di richiesta

HTTP

DELETE https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/EnforceNaming?api-version=2026-07-01

Risposta di esempio

Codice di stato:: 200

{
  "name": "EnforceNaming",
  "type": "Microsoft.Authorization/policyAssignments",
  "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/EnforceNaming",
  "properties": {
    "description": "Force resource names to begin with given DeptA and end with -LC",
    "definitionVersion": "1.*.*",
    "displayName": "Enforce resource naming rules",
    "instanceId": "e4b0f5a6-7c8d-4e9f-8a1b-2c3d4e5f6a7b",
    "metadata": {
      "assignedBy": "Special Someone"
    },
    "notScopes": [],
    "parameters": {
      "prefix": {
        "value": "DeptA"
      },
      "suffix": {
        "value": "-LC"
      }
    },
    "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/ResourceNaming",
    "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2"
  }
}

Codice di stato:: 204

Definizioni

Nome	Descrizione
AssignmentType	Tipo di assegnazione dei criteri. I valori possibili sono NotSpecified, System, SystemHidden e Custom. Non modificabile.
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.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
Identity	Identità per la risorsa. Le assegnazioni di criteri supportano un massimo di un'identità. Si tratta di un'identità assegnata dal sistema o di una singola identità assegnata dall'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	Valore di un parametro.
PolicyAssignment	Assegnazione di criteri.
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.
SelfServeExemptionSettings	Le impostazioni di esenzione self-service per un'assegnazione di politica.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentitiesValue

AssignmentType

Enumerazione

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

Valore	Descrizione
NotSpecified	Il tipo di assegnazione non specificato.
System	Il tipo di assegnazione del sistema.
SystemHidden	Il tipo di assegnazione nascosta del sistema.
Custom	Il tipo di assegnazione personalizzata.

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 dei criteri 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.

ErrorDetail

Oggetto

Dettagli dell'errore.

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

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

Identity

Oggetto

Identità per la risorsa. Le assegnazioni di criteri supportano un massimo di un'identità. Si tratta di un'identità assegnata dal sistema o di una singola identità assegnata dall'utente.

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità della risorsa. Questa proprietà sarà fornita solo per un'identità assegnata al sistema
tenantId	string	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	<string, UserAssignedIdentitiesValue>	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	Eseguirà l'override del tipo di effetto dei criteri.
definitionVersion	Sostituirà il valore della proprietà della versione della definizione dell'assegnazione dei criteri.

ParameterValuesValue

Oggetto

Valore di un parametro.

Nome	Tipo	Descrizione
value		Valore del parametro .