Policy Assignments - Delete

Riferimento

Service:: Policy

API Version:: 2023-04-01

Questa operazione elimina un'assegnazione di criteri, in base al nome e all'ambito in cui è stato creato. 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=2023-04-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione

Nome	In	Necessario	Tipo	Descrizione
policyAssignmentName	path	True	string	Nome dell'assegnazione di criteri da eliminare. Regex pattern: `^[^<>%&:\?.+/][^<>*%&:\?.+/ ]+$`
scope	path	True	string	Ambito dell'assegnazione dei criteri. Gli ambiti validi sono: gruppo di gestione (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), sottoscrizione (formato: '/subscriptions/{subscriptionId}'), gruppo di risorse (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', o risorsa (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'
api-version	query	True	string	Versione dell'API da usare per questa operazione.

policyAssignmentName

path

True

string

Nome dell'assegnazione di criteri da eliminare.

Regex pattern: ^[^<>*%&:\?.+/]*[^<>*%&:\?.+/ ]+$

scope

path

True

string

Ambito dell'assegnazione dei criteri. Gli ambiti validi sono: gruppo di gestione (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), sottoscrizione (formato: '/subscriptions/{subscriptionId}'), gruppo di risorse (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', o risorsa (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

api-version

query

True

string

Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	PolicyAssignment	OK: restituisce informazioni sull'assegnazione eliminata.
204 No Content		Nessun contenuto: l'assegnazione dei criteri non esiste.
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Delete a policy assignment

Sample Request

HTTP

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

Sample Response

Status code:: 200

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

Status code:: 204

Definizioni

Nome	Descrizione
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 e DoNotEnforce.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorResponse	Risposta di errore
Identity	Identità per la risorsa. Le assegnazioni di criteri supportano un massimo di un'identità. Ovvero un'identità assegnata dal sistema o un'identità assegnata dall'utente.
NonComplianceMessage	Messaggio che descrive il motivo per cui una risorsa non è conforme ai criteri. Questo messaggio viene visualizzato nei messaggi di errore "Deny" 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 dei 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.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentities	Identità utente associata al criterio. I riferimenti alla chiave del dizionario identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

CloudError

Risposta di errore da un'operazione di criteri.

Nome	Tipo	Descrizione
error	ErrorResponse	Risposta di errore Risposta di errore comune per tutte le API Resource Manager di Azure per restituire i dettagli dell'errore per le operazioni non riuscite. Segue anche il formato di risposta di errore OData.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

enforcementMode

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

Nome	Tipo	Descrizione
Default	string	L'effetto del criterio viene applicato durante la creazione o l'aggiornamento della risorsa.
DoNotEnforce	string	L'effetto dei criteri non viene applicato durante la creazione o l'aggiornamento delle risorse.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorResponse

Risposta di 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

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

Nome	Tipo	Descrizione
principalId	string	ID principale dell'identità della risorsa. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema
tenantId	string	ID tenant dell'identità della risorsa. Questa proprietà verrà fornita solo per un'identità assegnata dal 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 identità utente saranno ID risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

NonComplianceMessage

Messaggio che descrive il motivo per cui una risorsa non è conforme ai criteri. Questo messaggio viene visualizzato nei messaggi di errore "Deny" 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. Questo messaggio viene visualizzato nei messaggi di errore "Deny" e nei risultati di conformità non conformi della risorsa.
policyDefinitionReferenceId	string	L'ID riferimento alla definizione dei criteri all'interno di una definizione del set di criteri è destinato al messaggio. Questa impostazione è applicabile solo se l'assegnazione dei criteri assegna una definizione di set di criteri. Se non viene specificato, il messaggio si applica a tutti i criteri assegnati da questa assegnazione di criteri.

Override

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

Tipo di override.

Nome	Tipo	Descrizione
policyEffect	string	Eseguirà l'override del tipo di effetto dei criteri.

ParameterValuesValue

Valore di un parametro.

Nome	Tipo	Descrizione
value	object	Valore del parametro.