Policy Assignments - List

Riferimento

Servizio:: Policy

Versione API:: 2023-04-01

Recupera tutte le assegnazioni di criteri che si applicano a una sottoscrizione.
Questa operazione recupera l'elenco di tutte le assegnazioni di criteri associate alla sottoscrizione specificata che corrispondono alla $filter facoltativa specificata. I valori validi per $filter sono: 'atScope()', 'atExactScope()' o 'policyDefinitionId eq '{value}''. Se $filter non viene fornito, l'elenco non filtrato include tutte le assegnazioni di criteri associate alla sottoscrizione, incluse quelle che si applicano direttamente o dai gruppi di gestione che contengono la sottoscrizione specificata, nonché qualsiasi oggetto applicato agli oggetti contenuti nella sottoscrizione. Se viene specificato $filter=atScope(), l'elenco restituito include tutte le assegnazioni di criteri che si applicano alla sottoscrizione, ovvero tutto nell'elenco non filtrato, ad eccezione di quelli applicati agli oggetti contenuti nella sottoscrizione. Se viene specificato $filter=atExactScope(), l'elenco restituito include solo tutte le assegnazioni di criteri che vengono visualizzate nella sottoscrizione. Se viene specificato $filter=policyDefinitionId eq '{value}', l'elenco restituito include tutte le assegnazioni di criteri della definizione dei criteri il cui ID è {value}.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments?api-version=2023-04-01

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments?$filter={$filter}&$top={$top}&api-version=2023-04-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string uuid	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string	Versione dell'API da usare per questa operazione.
$filter	query		string	Filtro da applicare all'operazione. I valori validi per $filter sono: 'atScope()', 'atExactScope()' o 'policyDefinitionId eq '{value}''. Se $filter non viene fornito, non viene eseguito alcun filtro. Se viene specificato $filter=atScope(), l'elenco restituito include solo tutte le assegnazioni di criteri che si applicano all'ambito, ovvero tutto nell'elenco non filtrato, ad eccezione di quelli applicati ai sotto ambiti contenuti nell'ambito specificato. Se $filter=atExactScope() viene fornito, l'elenco restituito include solo tutte le assegnazioni di criteri presenti nell'ambito specificato. Se viene specificato $filter=policyDefinitionId eq '{value}', l'elenco restituito include tutte le assegnazioni di criteri della definizione dei criteri il cui ID è {value}.
$top	query		integer int32	Numero massimo di record da restituire. Quando il filtro $top non viene fornito, restituirà 500 record.

Risposte

Nome	Tipo	Descrizione
200 OK	PolicyAssignmentListResult	OK: restituisce una matrice di assegnazioni di criteri.
Other Status Codes	CloudError	Risposta di errore che descrive perché l'operazione non è riuscita.

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	rappresentare l'account utente

Esempio

List policy assignments that apply to a subscription

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments?$filter=atScope()&api-version=2023-04-01

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/CostManagement",
      "type": "Microsoft.Authorization/policyAssignments",
      "name": "CostManagement",
      "location": "eastus",
      "identity": {
        "type": "SystemAssigned",
        "principalId": "e6d23f8d-af97-4fbc-bda6-00604e4e3d0a",
        "tenantId": "4bee2b8a-1bee-47c2-90e9-404241551135"
      },
      "properties": {
        "displayName": "Storage Cost Management",
        "description": "Minimize the risk of accidental cost overruns",
        "metadata": {
          "category": "Cost Management"
        },
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/storageSkus",
        "parameters": {
          "allowedSkus": {
            "value": "Standard_A1"
          }
        },
        "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2",
        "notScopes": []
      }
    },
    {
      "id": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyAssignments/TagEnforcement",
      "type": "Microsoft.Authorization/policyAssignments",
      "name": "TagEnforcement",
      "properties": {
        "displayName": "Enforces a tag key and value",
        "description": "Ensure a given tag key and value are present on all resources",
        "policyDefinitionId": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2/providers/Microsoft.Authorization/policyDefinitions/TagKeyValue",
        "scope": "/subscriptions/ae640e6b-ba3e-4256-9d62-2993eecfa6f2",
        "notScopes": []
      }
    }
  ]
}

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 sulla 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 singolo.
NonComplianceMessage	Messaggio che descrive perché una risorsa non è conforme ai criteri. 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 di criteri.
PolicyAssignmentListResult	Elenco delle assegnazioni di criteri.
ResourceIdentityType	Tipo di identità. Questo è l'unico campo obbligatorio quando si aggiunge un'identità assegnata dall'utente o dal sistema 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 modulo: '/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 di Resource Manager di Azure per restituire i dettagli degli errori per le operazioni non riuscite. Questo 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 sulla 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 singolo.

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 dall'utente o dal sistema a una risorsa.
userAssignedIdentities	UserAssignedIdentities	Identità utente associata al criterio. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel modulo: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

NonComplianceMessage

Messaggio che descrive perché una risorsa non è conforme ai criteri. Viene visualizzato nei messaggi di errore "Deny" e nei risultati di conformità non conformi della risorsa.

Nome	Tipo	Descrizione
message	string	Messaggio che descrive perché una risorsa non è conforme ai criteri. Viene visualizzato nei messaggi di errore "Deny" e nei risultati di conformità non conformi della risorsa.
policyDefinitionReferenceId	string	L'ID di riferimento alla definizione dei criteri all'interno di una definizione del set di criteri è destinato al messaggio. Questa operazione è applicabile solo se l'assegnazione di criteri assegna una definizione del set di criteri. Se questo messaggio non viene fornito 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 da 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.