使用 Azure 監視器 REST API 擷取活動記錄資料
Azure 活動記錄可針對在訂用帳戶中資源上執行的作業提供深入解析。 作業包括建立、更新、刪除和其他對資源採取的動作。 活動記錄是全平台的記錄，不限於特定服務。 本文說明如何使用 Azure 監視器 REST API 擷取活動記錄資料。 如需活動記錄的詳細資訊，請參閱 Azure 活動記錄事件結構描述。
驗證
若要擷取資源記錄，您必須向 Microsoft Entra 進行驗證。 如需詳細資訊，請參閱 Azure 監視 REST API 逐步解說。
取出活動記錄資料
使用 Azure 監視器 REST API 來查詢活動記錄資料。
下列要求格式用於要求活動記錄資料。
GET /subscriptions/<subscriptionId>/providers/Microsoft.Insights/eventtypes/management/values \
?api-version=2015-04-01 \
&$filter=<filter> \
&$select=<select>
host: management.azure.com
authorization: Bearer <token>
$filter
$filter 會減少收集的資料集。 此引數是必要的，而且至少需要開始日期/時間。
$filter 引數接受下列模式：
- 列出資源群組的事件：
$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z' and resourceGroupName eq <resourceGroupName>。 - 列出特定資源的事件：
$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z' and resourceUri eq <resourceURI>。 - 列出時間範圍內訂用帳戶的事件：
$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z'。 - 列出資源提供者的事件：
$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z' and resourceProvider eq <resourceProviderName>。 - 列出相互關聯識別碼的事件：
$filter=eventTimestamp ge '2014-07-16T04:36:37.6407898Z' and eventTimestamp le '2014-07-20T04:36:37.6407898Z' and correlationId eq '<correlationID>。
$select
$select 擷取所傳回事件的指定屬性清單。
$select 引數是要傳回之屬性名稱的逗號分隔清單。
有效值為：authorization、claims、correlationId、description、eventDataId、eventName、eventTimestamp、httpRequest、level、operationId、operationName、properties、resourceGroupName、resourceProviderName、resourceId、status、submissionTimestamp、subStatus 和 subscriptionId。
下列範例要求會使用 Azure 監視器 REST API 查詢活動記錄。
利用 filter 取得活動記錄：
下列範例會取得資源群組 MSSupportGroup 在日期 2023-03-21T20:00:00Z 與 2023-03-24T20:00:00Z 之間的活動記錄
GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2023-03-21T20:00:00Z' and eventTimestamp le '2023-03-24T20:00:00Z' and resourceGroupName eq 'MSSupportGroup'
利用 filter 和 select 取得活動記錄：
下列範例會取得資源群組 MSSupportGroup 在日期 2023-03-21T20:00:00Z 與 2023-03-24T20:00:00Z 之間的活動記錄，並傳回元素 eventName、operationName、status、eventTimestamp、correlationId、submissionTimestamp 和 level 等元素。
GET https://management.azure.com/subscriptions/12345678-abcd-98765432-abcdef012345/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01&$filter=eventTimestamp ge '2023-03-21T20:00:00Z' and eventTimestamp le '2023-03-24T20:00:00Z'and resourceGroupName eq 'MSSupportGroup'&$select=eventName,operationName,status,eventTimestamp,correlationId,submissionTimestamp,level