Policy Events - List Query Results For Resource Group

Servizio:: Policy

Versione API:: 2024-10-01

Esegue una query sugli eventi dei criteri per le risorse nel gruppo di risorse.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyEvents/default/queryResults?api-version=2024-10-01

Con parametri facoltativi:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.PolicyInsights/policyEvents/default/queryResults?api-version=2024-10-01&$top={$top}&$orderby={$orderby}&$select={$select}&$from={$from}&$to={$to}&$filter={$filter}&$apply={$apply}&$skiptoken={$skiptoken}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
policyEventsResource	path	True	PolicyEventsResourceType	Nome della risorsa virtuale in Tipo di risorsa PolicyEvents; è consentito solo "default".
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	ID abbonamento Microsoft Azure.
api-version	query	True	string	Versione dell'API client.
$apply	query		string	OData applica l'espressione per le aggregazioni.
$filter	query		string	Espressione di filtro OData.
$from	query		string (date-time)	Timestamp formattato ISO 8601 che specifica l'ora di inizio dell'intervallo su cui eseguire la query. Se non specificato, il servizio usa ($to - 1 giorno).
$orderby	query		string	Ordinamento dell'espressione utilizzando la notazione OData. Uno o più nomi di colonna delimitati da virgole con un "desc" facoltativo (impostazione predefinita) o "asc", ad esempio "$orderby=PolicyAssignmentId, ResourceId asc".
$select	query		string	Selezionare l'espressione usando la notazione OData. Limita le colonne di ogni record solo a quelle richieste, ad esempio "$select=PolicyAssignmentId, ResourceId".
$skiptoken	query		string	Skiptoken viene fornito solo se una risposta precedente ha restituito un risultato parziale come parte dell'elemento nextLink.
$to	query		string (date-time)	Timestamp formattato ISO 8601 che specifica l'ora di fine dell'intervallo su cui eseguire la query. Se non specificato, il servizio usa l'ora della richiesta.
$top	query		integer (int32) minimum: 0	Numero massimo di record da restituire.

Risposte

Nome	Tipo	Descrizione
200 OK	PolicyEventsQueryResults	Risultati della query.
Other Status Codes	QueryFailure	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

Query at resource group scope

Query at resource group scope with next link

Query at resource group scope

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyEvents/default/queryResults?api-version=2024-10-01

Risposta di esempio

Codice di stato:: 200

{
  "@odata.nextLink": null,
  "@odata.context": "https://management.azure.com/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyEvents/$metadata#default",
  "@odata.count": 2,
  "value": [
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyEvents/$metadata#default/$entity",
      "timestamp": "2018-02-07T20:43:04.6971328Z",
      "resourceId": "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApplication",
      "policyAssignmentId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/ec62f9b2a454487296f2ccd4",
      "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyDefinitions/72c0c41a-c752-4bc0-9c61-0d6adc567066",
      "effectiveParameters": null,
      "isCompliant": false,
      "subscriptionId": "fff10b27-fff3-fff5-fff8-fffbe01e86a5",
      "resourceType": "/Microsoft.ServiceFabric/clusters/applications",
      "resourceLocation": "eastus",
      "resourceGroup": "myResourceGroup",
      "resourceTags": "tbd",
      "policyAssignmentName": "ec62f9b2a454487296f2ccd4",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{\"ALLOWEDRESOURCEGROUPS_1\":{\"value\":[\"rg1\",\"rg2\"]},\"ALLOWEDRESOURCEGROUPS_2\":{\"value\":[\"myrg3\",\"myrg4\"]}}",
      "policyAssignmentScope": "/providers/Microsoft.Management/managementGroups/myManagementGroup",
      "policyDefinitionName": "72c0c41a-c752-4bc0-9c61-0d6adc567066",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policySetDefinitions/00b36c66-612b-44e2-9f8e-b758296d40fe",
      "policySetDefinitionName": "00b36c66-612b-44e2-9f8e-b758296d40fe",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "myManagementGroup,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": "181565554491747128",
      "tenantId": "fff988bf-fff1-ffff-fffb-fffcd011db47",
      "principalOid": "fffdfc0f-fff5-fff0-fff3-fff1a968dcc6",
      "complianceState": "NonCompliant"
    },
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyEvents/$metadata#default/$entity",
      "timestamp": "2018-02-07T20:43:04.6971328Z",
      "resourceId": "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApplication",
      "policyAssignmentId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/ec62f9b2a454487296f2ccd4",
      "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyDefinitions/72c0c41a-c752-4bc0-9c61-0d6adc567066",
      "effectiveParameters": null,
      "isCompliant": false,
      "subscriptionId": "fff10b27-fff3-fff5-fff8-fffbe01e86a5",
      "resourceType": "/Microsoft.ServiceFabric/clusters/applications",
      "resourceLocation": "eastus",
      "resourceGroup": "myResourceGroup",
      "resourceTags": "tbd",
      "policyAssignmentName": "ec62f9b2a454487296f2ccd4",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{\"ALLOWEDRESOURCEGROUPS_1\":{\"value\":[\"rg1\",\"rg2\"]},\"ALLOWEDRESOURCEGROUPS_2\":{\"value\":[\"myrg3\",\"myrg4\"]}}",
      "policyAssignmentScope": "/providers/Microsoft.Management/managementGroups/myManagementGroup",
      "policyDefinitionName": "72c0c41a-c752-4bc0-9c61-0d6adc567066",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policySetDefinitions/00b36c66-612b-44e2-9f8e-b758296d40fe",
      "policySetDefinitionName": "00b36c66-612b-44e2-9f8e-b758296d40fe",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "myManagementGroup,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": "624540685646900425",
      "tenantId": "fff988bf-fff1-ffff-fffb-fffcd011db47",
      "principalOid": "fffdfc0f-fff5-fff0-fff3-fff1a968dcc6",
      "complianceState": "NonCompliant"
    }
  ]
}

Query at resource group scope with next link

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/fffedd8f-ffff-fffd-fffd-fffed2f84852/resourceGroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyEvents/default/queryResults?api-version=2024-10-01&$skiptoken=WpmWfBSvPhkAK6QD

Risposta di esempio

Codice di stato:: 200

{
  "@odata.nextLink": null,
  "@odata.context": "https://management.azure.com/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyEvents/$metadata#default",
  "@odata.count": 2,
  "value": [
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyEvents/$metadata#default/$entity",
      "timestamp": "2018-02-07T20:43:04.6971328Z",
      "resourceId": "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApplication",
      "policyAssignmentId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/ec62f9b2a454487296f2ccd4",
      "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyDefinitions/72c0c41a-c752-4bc0-9c61-0d6adc567066",
      "effectiveParameters": null,
      "isCompliant": false,
      "subscriptionId": "fff10b27-fff3-fff5-fff8-fffbe01e86a5",
      "resourceType": "/Microsoft.ServiceFabric/clusters/applications",
      "resourceLocation": "eastus",
      "resourceGroup": "myResourceGroup",
      "resourceTags": "tbd",
      "policyAssignmentName": "ec62f9b2a454487296f2ccd4",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{\"ALLOWEDRESOURCEGROUPS_1\":{\"value\":[\"rg1\",\"rg2\"]},\"ALLOWEDRESOURCEGROUPS_2\":{\"value\":[\"myrg3\",\"myrg4\"]}}",
      "policyAssignmentScope": "/providers/Microsoft.Management/managementGroups/myManagementGroup",
      "policyDefinitionName": "72c0c41a-c752-4bc0-9c61-0d6adc567066",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policySetDefinitions/00b36c66-612b-44e2-9f8e-b758296d40fe",
      "policySetDefinitionName": "00b36c66-612b-44e2-9f8e-b758296d40fe",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "myManagementGroup,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": "181565554491747128",
      "tenantId": "fff988bf-fff1-ffff-fffb-fffcd011db47",
      "principalOid": "fffdfc0f-fff5-fff0-fff3-fff1a968dcc6",
      "complianceState": "NonCompliant"
    },
    {
      "@odata.id": null,
      "@odata.context": "https://management.azure.com/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.PolicyInsights/policyEvents/$metadata#default/$entity",
      "timestamp": "2018-02-07T20:43:04.6971328Z",
      "resourceId": "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourcegroups/myResourceGroup/providers/Microsoft.ServiceFabric/clusters/myCluster/applications/myApplication",
      "policyAssignmentId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/ec62f9b2a454487296f2ccd4",
      "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyDefinitions/72c0c41a-c752-4bc0-9c61-0d6adc567066",
      "effectiveParameters": null,
      "isCompliant": false,
      "subscriptionId": "fff10b27-fff3-fff5-fff8-fffbe01e86a5",
      "resourceType": "/Microsoft.ServiceFabric/clusters/applications",
      "resourceLocation": "eastus",
      "resourceGroup": "myResourceGroup",
      "resourceTags": "tbd",
      "policyAssignmentName": "ec62f9b2a454487296f2ccd4",
      "policyAssignmentOwner": "tbd",
      "policyAssignmentParameters": "{\"ALLOWEDRESOURCEGROUPS_1\":{\"value\":[\"rg1\",\"rg2\"]},\"ALLOWEDRESOURCEGROUPS_2\":{\"value\":[\"myrg3\",\"myrg4\"]}}",
      "policyAssignmentScope": "/providers/Microsoft.Management/managementGroups/myManagementGroup",
      "policyDefinitionName": "72c0c41a-c752-4bc0-9c61-0d6adc567066",
      "policyDefinitionAction": "audit",
      "policyDefinitionCategory": "tbd",
      "policySetDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policySetDefinitions/00b36c66-612b-44e2-9f8e-b758296d40fe",
      "policySetDefinitionName": "00b36c66-612b-44e2-9f8e-b758296d40fe",
      "policySetDefinitionOwner": null,
      "policySetDefinitionCategory": null,
      "policySetDefinitionParameters": null,
      "managementGroupIds": "myManagementGroup,fff988bf-fff1-ffff-fffb-fffcd011db47",
      "policyDefinitionReferenceId": "624540685646900425",
      "tenantId": "fff988bf-fff1-ffff-fffb-fffcd011db47",
      "principalOid": "fffdfc0f-fff5-fff0-fff3-fff1a968dcc6",
      "complianceState": "NonCompliant"
    }
  ]
}

Definizioni

Nome	Descrizione
ComponentEventDetails	Dettagli dell'evento del componente.
Error	Definizione di errore.
PolicyEvent	Record dell'evento di criteri.
PolicyEventsQueryResults	Risultati della query.
PolicyEventsResourceType	Nome della risorsa virtuale in Tipo di risorsa PolicyEvents; è consentito solo "default".
QueryFailure	Risposta di errore.

ComponentEventDetails

Oggetto

Dettagli dell'evento del componente.

Nome	Tipo	Descrizione
id	string	ID componente.
name	string	Nome componente.
policyDefinitionAction	string	Azione di definizione dei criteri, ovvero effetto.
principalOid	string	ID oggetto entità per l'utente che ha avviato l'operazione del componente della risorsa che ha attivato l'evento dei criteri.
tenantId	string	ID tenant per il record dell'evento dei criteri.
timestamp	string (date-time)	Timestamp per il record dell'evento dei criteri del componente.
type	string	Tipo di componente.

Error

Oggetto

Definizione di errore.

Nome	Tipo	Descrizione
code	string	Codice di errore specifico del servizio che funge da stato secondario per il codice di errore HTTP.
message	string	Descrizione dell'errore.

PolicyEvent

Oggetto

Record dell'evento di criteri.

Nome	Tipo	Descrizione
@odata.context	string	Stringa di contesto OData; usato dai client OData per risolvere le informazioni sul tipo in base ai metadati.
@odata.id	string	ID entità OData; sempre impostato su Null perché i record eventi dei criteri non hanno un ID entità.
complianceState	string	Stato di conformità della risorsa.
components	ComponentEventDetails[]	Gli eventi dei componenti vengono popolati solo quando l'URL contiene $expand=clausola components.
effectiveParameters	string	Parametri effettivi per l'assegnazione dei criteri.
isCompliant	boolean	Flag che indica se la risorsa è conforme all'assegnazione di criteri rispetto all'assegnazione di criteri rispetto a cui è stata valutata.
managementGroupIds	string	Elenco delimitato da virgole degli ID dei gruppi di gestione, che rappresentano la gerarchia dei gruppi di gestione in cui si trova la risorsa.
policyAssignmentId	string	ID assegnazione criteri.
policyAssignmentName	string	Nome dell'assegnazione dei criteri.
policyAssignmentOwner	string	Proprietario dell'assegnazione dei criteri.
policyAssignmentParameters	string	Parametri di assegnazione dei criteri.
policyAssignmentScope	string	Ambito di assegnazione dei criteri.
policyDefinitionAction	string	Azione di definizione dei criteri, ovvero effetto.
policyDefinitionCategory	string	Categoria di definizione dei criteri.
policyDefinitionId	string	ID definizione criteri.
policyDefinitionName	string	Nome della definizione dei criteri.
policyDefinitionReferenceId	string	ID di riferimento per la definizione di criteri all'interno del set di criteri, se l'assegnazione dei criteri è per un set di criteri.
policySetDefinitionCategory	string	Categoria di definizione del set di criteri, se l'assegnazione dei criteri è per un set di criteri.
policySetDefinitionId	string	ID definizione del set di criteri, se l'assegnazione dei criteri è per un set di criteri.
policySetDefinitionName	string	Nome della definizione del set di criteri, se l'assegnazione dei criteri è per un set di criteri.
policySetDefinitionOwner	string	Proprietario della definizione del set di criteri, se l'assegnazione dei criteri è per un set di criteri.
policySetDefinitionParameters	string	Parametri di definizione del set di criteri, se l'assegnazione dei criteri è per un set di criteri.
principalOid	string	ID oggetto principal per l'utente che ha avviato l'operazione di risorsa che ha attivato l'evento di criteri.
resourceGroup	string	Nome del gruppo di risorse.
resourceId	string	ID risorsa.
resourceLocation	string	Percorso della risorsa.
resourceTags	string	Elenco dei tag delle risorse.
resourceType	string	Tipo di risorsa.
subscriptionId	string	ID sottoscrizione.
tenantId	string	ID tenant per il record dell'evento dei criteri.
timestamp	string (date-time)	Timestamp per il record dell'evento dei criteri.

PolicyEventsQueryResults

Oggetto

Risultati della query.

Nome	Tipo	Descrizione
@odata.context	string	Stringa di contesto OData; usato dai client OData per risolvere le informazioni sul tipo in base ai metadati.
@odata.count	integer (int32) minimum: 0	Numero di entità OData; rappresenta il numero di record di eventi dei criteri restituiti.
@odata.nextLink	string	Collegamento successivo di Odata; URL per ottenere il set di risultati successivo.
value	PolicyEvent[]	Risultati della query.

PolicyEventsResourceType

Enumerazione

Nome della risorsa virtuale in Tipo di risorsa PolicyEvents; è consentito solo "default".

Valore	Descrizione
default

QueryFailure

Oggetto

Risposta di errore.

Nome	Tipo	Descrizione
error	Error	Definizione di errore.

Condividi tramite

Policy Events - List Query Results For Resource Group

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Query at resource group scope

Esempio di richiesta

Risposta di esempio

Query at resource group scope with next link

Esempio di richiesta

Risposta di esempio

Definizioni

ComponentEventDetails

Error

PolicyEvent

PolicyEventsQueryResults

PolicyEventsResourceType

QueryFailure