Policy Events - List Query Results For Resource Group

Layanan:: Policy

Versi API:: 2024-10-01

Mengkueri peristiwa kebijakan untuk sumber daya di bawah grup sumber daya.

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

Dengan parameter opsional:

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}

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
policyEventsResource	path	True	PolicyEventsResourceType	Nama sumber daya virtual di bawah jenis sumber daya PolicyEvents; hanya "default" yang diizinkan.
resourceGroupName	path	True	string	Nama grup sumber daya.
subscriptionId	path	True	string	ID langganan Microsoft Azure.
api-version	query	True	string	Versi Api Klien.
$apply	query		string	OData menerapkan ekspresi untuk agregasi.
$filter	query		string	Ekspresi filter OData.
$from	query		string (date-time)	Tanda waktu berformat ISO 8601 yang menentukan waktu mulai interval untuk kueri. Ketika tidak ditentukan, layanan menggunakan ($to - 1 hari).
$orderby	query		string	Mengurutkan ekspresi menggunakan notasi OData. Satu atau beberapa nama kolom yang dipisahkan koma dengan "desc" opsional (default) atau "asc", misalnya "$orderby=PolicyAssignmentId, ResourceId asc".
$select	query		string	Pilih ekspresi menggunakan notasi OData. Membatasi kolom pada setiap rekaman hanya untuk yang diminta, misalnya "$select=PolicyAssignmentId, ResourceId".
$skiptoken	query		string	Skiptoken hanya disediakan jika respons sebelumnya mengembalikan hasil parsial sebagai bagian dari elemen nextLink.
$to	query		string (date-time)	Tanda waktu berformat ISO 8601 yang menentukan waktu akhir interval untuk kueri. Ketika tidak ditentukan, layanan menggunakan waktu permintaan.
$top	query		integer (int32) minimum: 0	Jumlah maksimum rekaman yang akan dikembalikan.

Respons

Nama	Jenis	Deskripsi
200 OK	PolicyEventsQueryResults	Hasil kueri.
Other Status Codes	QueryFailure	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Query at resource group scope

Query at resource group scope with next link

Query at resource group scope

Permintaan sampel

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

Respon sampel

Kode status:: 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

Permintaan sampel

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

Respon sampel

Kode status:: 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"
    }
  ]
}

Definisi

Nama	Deskripsi
ComponentEventDetails	Detail peristiwa komponen.
Error	Definisi kesalahan.
PolicyEvent	Rekaman peristiwa kebijakan.
PolicyEventsQueryResults	Hasil kueri.
PolicyEventsResourceType	Nama sumber daya virtual di bawah jenis sumber daya PolicyEvents; hanya "default" yang diizinkan.
QueryFailure	Respons kesalahan.

ComponentEventDetails

Objek

Detail peristiwa komponen.

Nama	Jenis	Deskripsi
id	string	Id Komponen.
name	string	Nama komponen.
policyDefinitionAction	string	Tindakan definisi kebijakan, yaitu efek.
principalOid	string	ID objek utama untuk pengguna yang memulai operasi komponen sumber daya yang memicu peristiwa kebijakan.
tenantId	string	ID Penyewa untuk rekaman peristiwa kebijakan.
timestamp	string (date-time)	Tanda waktu untuk rekaman peristiwa kebijakan komponen.
type	string	Jenis komponen.

Error

Objek

Definisi kesalahan.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan khusus layanan yang berfungsi sebagai substatus untuk kode kesalahan HTTP.
message	string	Deskripsi kesalahan.

PolicyEvent

Objek

Rekaman peristiwa kebijakan.

Nama	Jenis	Deskripsi
@odata.context	string	String konteks OData; digunakan oleh klien OData untuk mengatasi informasi jenis berdasarkan metadata.
@odata.id	string	ID entitas OData; selalu diatur ke null karena rekaman peristiwa kebijakan tidak memiliki ID entitas.
complianceState	string	Status kepatuhan sumber daya.
components	ComponentEventDetails[]	Peristiwa komponen hanya diisi saat URL berisi klausa $expand=components.
effectiveParameters	string	Parameter efektif untuk penetapan kebijakan.
isCompliant	boolean	Bendera yang menyatakan apakah sumber daya mematuhi penetapan kebijakan yang dievaluasi.
managementGroupIds	string	Daftar ID grup manajemen yang dipisahkan koma, yang mewakili hierarki grup manajemen tempat sumber daya berada.
policyAssignmentId	string	ID penetapan kebijakan.
policyAssignmentName	string	Nama penetapan kebijakan.
policyAssignmentOwner	string	Pemilik penetapan kebijakan.
policyAssignmentParameters	string	Parameter penetapan kebijakan.
policyAssignmentScope	string	Cakupan penetapan kebijakan.
policyDefinitionAction	string	Tindakan definisi kebijakan, yaitu efek.
policyDefinitionCategory	string	Kategori definisi kebijakan.
policyDefinitionId	string	ID definisi kebijakan.
policyDefinitionName	string	Nama definisi kebijakan.
policyDefinitionReferenceId	string	ID referensi untuk definisi kebijakan di dalam kumpulan kebijakan, jika penetapan kebijakan adalah untuk kumpulan kebijakan.
policySetDefinitionCategory	string	Kategori definisi kumpulan kebijakan, jika penetapan kebijakan adalah untuk kumpulan kebijakan.
policySetDefinitionId	string	ID definisi kumpulan kebijakan, jika penetapan kebijakan adalah untuk kumpulan kebijakan.
policySetDefinitionName	string	Nama definisi kumpulan kebijakan, jika penetapan kebijakan adalah untuk kumpulan kebijakan.
policySetDefinitionOwner	string	Pemilik definisi set kebijakan, jika penetapan kebijakan adalah untuk kumpulan kebijakan.
policySetDefinitionParameters	string	Parameter definisi kumpulan kebijakan, jika penetapan kebijakan adalah untuk kumpulan kebijakan.
principalOid	string	ID objek utama untuk pengguna yang memulai operasi sumber daya yang memicu peristiwa kebijakan.
resourceGroup	string	Nama grup sumber daya.
resourceId	string	ID Sumber Daya.
resourceLocation	string	Lokasi sumber daya.
resourceTags	string	Daftar tag sumber daya.
resourceType	string	Jenis sumber daya.
subscriptionId	string	ID Langganan.
tenantId	string	ID Penyewa untuk rekaman peristiwa kebijakan.
timestamp	string (date-time)	Tanda waktu untuk rekaman peristiwa kebijakan.

PolicyEventsQueryResults

Objek

Hasil kueri.

Nama	Jenis	Deskripsi
@odata.context	string	String konteks OData; digunakan oleh klien OData untuk mengatasi informasi jenis berdasarkan metadata.
@odata.count	integer (int32) minimum: 0	Jumlah entitas OData; menunjukkan jumlah rekaman peristiwa kebijakan yang dikembalikan.
@odata.nextLink	string	Tautan odata berikutnya; URL untuk mendapatkan serangkaian hasil berikutnya.
value	PolicyEvent[]	Hasil kueri.

PolicyEventsResourceType

Enumerasi

Nama sumber daya virtual di bawah jenis sumber daya PolicyEvents; hanya "default" yang diizinkan.

Nilai	Deskripsi
default

QueryFailure

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
error	Error	Definisi kesalahan.

Bagikan melalui

Policy Events - List Query Results For Resource Group

Parameter URI

Respons

Keamanan

azure_auth

Cakupan

Contoh

Query at resource group scope

Permintaan sampel

Respon sampel

Query at resource group scope with next link

Permintaan sampel

Respon sampel

Definisi

ComponentEventDetails

Error

PolicyEvent

PolicyEventsQueryResults

PolicyEventsResourceType

QueryFailure