Firestore 稽核記錄資訊

Firestore 稽核記錄資訊

本文說明 Firestore 的稽核記錄。 Google Cloud 服務會產生稽核記錄，記錄 Google Cloud 資源中的管理和存取活動。如要進一步瞭解 Cloud 稽核記錄，請參閱下列文章：

• 稽核記錄類型
• 稽核記錄項目結構
• 儲存及轉送稽核記錄
• Cloud Logging 定價摘要
• 啟用資料存取稽核記錄

附註

設定稽核記錄時，請使用服務名稱 datastore.googleapis.com 同時設定 datastore.googleapis.com 和 firestore.googleapis.com。設定完成後，Firestore API 的記錄會包含服務名稱 firestore.googleapis.com。

如要查看處理 DATA_READ 或 DATA_WRITE 要求所花費的時間，請參閱 AuditLog 的 metadata 物件中的 processing_duration 欄位。 processing_duration：資料庫實際處理要求所花費的時間。這比使用者延遲時間還短。特別是不包含網路負擔。

如果是 Listen 要求，processing_duration 只會出現在初始結果集的稽核記錄中。在該Listen目標
的後續稽核記錄中，不會再出現這類項目。
匯入、大量刪除作業和存留時間的個別寫入作業不會記錄在稽核記錄中。

服務名稱

Firestore 稽核記錄會使用服務名稱 firestore.googleapis.com。篩選這項服務：

    protoPayload.serviceName="firestore.googleapis.com"
  

依權限類型劃分的方法

Firestore 也將下列作業納入 Key Visualizer 診斷工具。這些是「資料存取」稽核記錄，服務名稱為 firestorekeyvisualizer.googleapis.com。只要為 firestore.googleapis.com 服務啟用 DATA_READ，即可使用這些功能。

• google.cloud.keyvisualizer.KeyVisualizer.GetScan
• google.cloud.keyvisualizer.KeyVisualizer.ListScans

每個 IAM 權限都有 type 屬性，其值為列舉，可以是下列四個值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。呼叫方法時，Firestore 會產生稽核記錄，記錄的類別取決於執行方法所需的權限的 type 屬性。如果方法需要 IAM 權限，且 type 屬性值為 DATA_READ、DATA_WRITE 或 ADMIN_READ，就會產生「資料存取」稽核記錄。需要 IAM 權限且 type 屬性值為 ADMIN_WRITE 的方法，會產生管理員活動稽核記錄。

下列清單中標示 (LRO) 的 API 方法，都是長時間執行的作業 (LRO)。這些方法通常會產生兩筆稽核記錄項目：一筆是在作業開始時產生，另一筆則是在作業結束時產生。詳情請參閱長時間執行的作業的稽核記錄。

權限類型	方法
ADMIN_READ	google.cloud.location.Locations.GetLocation google.cloud.location.Locations.ListLocations google.firestore.admin.v1.FirestoreAdmin.GetBackup google.firestore.admin.v1.FirestoreAdmin.GetBackupSchedule google.firestore.admin.v1.FirestoreAdmin.GetDatabase google.firestore.admin.v1.FirestoreAdmin.GetField google.firestore.admin.v1.FirestoreAdmin.GetIndex google.firestore.admin.v1.FirestoreAdmin.ListBackupSchedules google.firestore.admin.v1.FirestoreAdmin.ListBackups google.firestore.admin.v1.FirestoreAdmin.ListDatabases google.firestore.admin.v1.FirestoreAdmin.ListFields google.firestore.admin.v1.FirestoreAdmin.ListIndexes google.firestore.admin.v1beta1.FirestoreAdmin.GetIndex google.firestore.admin.v1beta1.FirestoreAdmin.ListIndexes google.firestore.admin.v1beta2.FirestoreAdmin.GetField google.firestore.admin.v1beta2.FirestoreAdmin.GetIndex google.firestore.admin.v1beta2.FirestoreAdmin.ListFields google.firestore.admin.v1beta2.FirestoreAdmin.ListIndexes google.longrunning.Operations.GetOperation google.longrunning.Operations.ListOperations
ADMIN_WRITE	google.firestore.admin.v1.FirestoreAdmin.BulkDeleteDocuments (LRO) google.firestore.admin.v1.FirestoreAdmin.CreateBackupSchedule google.firestore.admin.v1.FirestoreAdmin.CreateDatabase google.firestore.admin.v1.FirestoreAdmin.CreateIndex (LRO) google.firestore.admin.v1.FirestoreAdmin.DeleteBackup google.firestore.admin.v1.FirestoreAdmin.DeleteBackupSchedule google.firestore.admin.v1.FirestoreAdmin.DeleteDatabase google.firestore.admin.v1.FirestoreAdmin.DeleteIndex google.firestore.admin.v1.FirestoreAdmin.ExportDocuments (LRO) google.firestore.admin.v1.FirestoreAdmin.ImportDocuments (LRO) google.firestore.admin.v1.FirestoreAdmin.RestoreDatabase google.firestore.admin.v1.FirestoreAdmin.UpdateBackupSchedule google.firestore.admin.v1.FirestoreAdmin.UpdateDatabase google.firestore.admin.v1.FirestoreAdmin.UpdateField (LRO) google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex (LRO) google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex google.firestore.admin.v1beta1.FirestoreAdmin.ExportDocuments (LRO) google.firestore.admin.v1beta1.FirestoreAdmin.ImportDocuments (LRO) google.firestore.admin.v1beta2.FirestoreAdmin.CreateIndex (LRO) google.firestore.admin.v1beta2.FirestoreAdmin.DeleteIndex google.firestore.admin.v1beta2.FirestoreAdmin.ExportDocuments (LRO) google.firestore.admin.v1beta2.FirestoreAdmin.ImportDocuments (LRO) google.firestore.admin.v1beta2.FirestoreAdmin.UpdateField (LRO) google.longrunning.Operations.CancelOperation google.longrunning.Operations.DeleteOperation
DATA_READ	google.firestore.v1.Firestore.BatchGetDocuments google.firestore.v1.Firestore.BeginTransaction google.firestore.v1.Firestore.GetDocument google.firestore.v1.Firestore.ListCollectionIds google.firestore.v1.Firestore.ListDocuments google.firestore.v1.Firestore.Listen google.firestore.v1.Firestore.PartitionQuery google.firestore.v1.Firestore.Rollback google.firestore.v1.Firestore.RunAggregationQuery google.firestore.v1.Firestore.RunQuery google.firestore.v1beta1.Firestore.BatchGetDocuments google.firestore.v1beta1.Firestore.BatchWrite google.firestore.v1beta1.Firestore.BeginTransaction google.firestore.v1beta1.Firestore.GetDocument google.firestore.v1beta1.Firestore.ListCollectionIds google.firestore.v1beta1.Firestore.ListDocuments google.firestore.v1beta1.Firestore.PartitionQuery google.firestore.v1beta1.Firestore.Rollback google.firestore.v1beta1.Firestore.RunAggregationQuery google.firestore.v1beta1.Firestore.RunQuery
DATA_WRITE	google.firestore.v1.Firestore.BatchWrite google.firestore.v1.Firestore.Commit google.firestore.v1.Firestore.CreateDocument google.firestore.v1.Firestore.DeleteDocument google.firestore.v1.Firestore.UpdateDocument google.firestore.v1.Firestore.Write google.firestore.v1beta1.Firestore.BatchWrite google.firestore.v1beta1.Firestore.Commit google.firestore.v1beta1.Firestore.CreateDocument google.firestore.v1beta1.Firestore.DeleteDocument google.firestore.v1beta1.Firestore.UpdateDocument

API 介面稽核記錄

如要瞭解系統如何評估每種方法的權限，請參閱 Firestore 的 Identity and Access Management 說明文件。

google.cloud.location.Locations

下列稽核記錄與屬於 google.cloud.location.Locations 的方法相關聯。

GetLocation

• 方法：google.cloud.location.Locations.GetLocation
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.locations.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.cloud.location.Locations.GetLocation"
  

ListLocations

• 方法：google.cloud.location.Locations.ListLocations
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.locations.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.cloud.location.Locations.ListLocations"
  

google.firestore.admin.v1.FirestoreAdmin

下列稽核記錄與屬於 google.firestore.admin.v1.FirestoreAdmin 的方法相關聯。

BulkDeleteDocuments

• 方法：google.firestore.admin.v1.FirestoreAdmin.BulkDeleteDocuments
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.bulkDelete - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.BulkDeleteDocuments"
  

CreateBackupSchedule

• 方法：google.firestore.admin.v1.FirestoreAdmin.CreateBackupSchedule
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.backupSchedules.create - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.CreateBackupSchedule"
  

CreateDatabase

• 方法：google.firestore.admin.v1.FirestoreAdmin.CreateDatabase
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.create - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.CreateDatabase"
  

CreateIndex

• 方法：google.firestore.admin.v1.FirestoreAdmin.CreateIndex
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.indexes.create - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.CreateIndex"
  

DeleteBackup

• 方法：google.firestore.admin.v1.FirestoreAdmin.DeleteBackup
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.backups.delete - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.DeleteBackup"
  

DeleteBackupSchedule

• 方法：google.firestore.admin.v1.FirestoreAdmin.DeleteBackupSchedule
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.backupSchedules.delete - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.DeleteBackupSchedule"
  

DeleteDatabase

• 方法：google.firestore.admin.v1.FirestoreAdmin.DeleteDatabase
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.delete - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.DeleteDatabase"
  

DeleteIndex

• 方法：google.firestore.admin.v1.FirestoreAdmin.DeleteIndex
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.indexes.delete - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.DeleteIndex"
  

ExportDocuments

• 方法：google.firestore.admin.v1.FirestoreAdmin.ExportDocuments
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.export - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.ExportDocuments"
  

GetBackup

• 方法：google.firestore.admin.v1.FirestoreAdmin.GetBackup
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.backups.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.GetBackup"
  

GetBackupSchedule

• 方法：google.firestore.admin.v1.FirestoreAdmin.GetBackupSchedule
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.backupSchedules.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.GetBackupSchedule"
  

GetDatabase

• 方法：google.firestore.admin.v1.FirestoreAdmin.GetDatabase
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.getMetadata - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.GetDatabase"
  

GetField

• 方法：google.firestore.admin.v1.FirestoreAdmin.GetField
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.GetField"
  

GetIndex

• 方法：google.firestore.admin.v1.FirestoreAdmin.GetIndex
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.GetIndex"
  

ImportDocuments

• 方法：google.firestore.admin.v1.FirestoreAdmin.ImportDocuments
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.import - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.ImportDocuments"
  

ListBackupSchedules

• 方法：google.firestore.admin.v1.FirestoreAdmin.ListBackupSchedules
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.backupSchedules.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.ListBackupSchedules"
  

ListBackups

• 方法：google.firestore.admin.v1.FirestoreAdmin.ListBackups
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.backups.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.ListBackups"
  

ListDatabases

• 方法：google.firestore.admin.v1.FirestoreAdmin.ListDatabases
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.ListDatabases"
  

ListFields

• 方法：google.firestore.admin.v1.FirestoreAdmin.ListFields
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.ListFields"
  

ListIndexes

• 方法：google.firestore.admin.v1.FirestoreAdmin.ListIndexes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.ListIndexes"
  

RestoreDatabase

• 方法：google.firestore.admin.v1.FirestoreAdmin.RestoreDatabase
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.backups.restoreDatabase - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.RestoreDatabase"
  

UpdateBackupSchedule

• 方法：google.firestore.admin.v1.FirestoreAdmin.UpdateBackupSchedule
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.backupSchedules.update - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.UpdateBackupSchedule"
  

UpdateDatabase

• 方法：google.firestore.admin.v1.FirestoreAdmin.UpdateDatabase
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.update - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.UpdateDatabase"
  

UpdateField

• 方法：google.firestore.admin.v1.FirestoreAdmin.UpdateField
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.indexes.update - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1.FirestoreAdmin.UpdateField"
  

google.firestore.admin.v1beta1.FirestoreAdmin

下列稽核記錄與屬於 google.firestore.admin.v1beta1.FirestoreAdmin 的方法相關聯。

CreateIndex

• 方法：google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.indexes.create - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta1.FirestoreAdmin.CreateIndex"
  

DeleteIndex

• 方法：google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.indexes.delete - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta1.FirestoreAdmin.DeleteIndex"
  

ExportDocuments

• 方法：google.firestore.admin.v1beta1.FirestoreAdmin.ExportDocuments
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.export - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta1.FirestoreAdmin.ExportDocuments"
  

GetIndex

• 方法：google.firestore.admin.v1beta1.FirestoreAdmin.GetIndex
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta1.FirestoreAdmin.GetIndex"
  

ImportDocuments

• 方法：google.firestore.admin.v1beta1.FirestoreAdmin.ImportDocuments
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.import - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta1.FirestoreAdmin.ImportDocuments"
  

ListIndexes

• 方法：google.firestore.admin.v1beta1.FirestoreAdmin.ListIndexes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta1.FirestoreAdmin.ListIndexes"
  

google.firestore.admin.v1beta2.FirestoreAdmin

下列稽核記錄與屬於 google.firestore.admin.v1beta2.FirestoreAdmin 的方法相關聯。

CreateIndex

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.CreateIndex
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.indexes.create - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.CreateIndex"
  

DeleteIndex

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.DeleteIndex
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.indexes.delete - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.DeleteIndex"
  

ExportDocuments

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.ExportDocuments
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.export - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.ExportDocuments"
  

GetField

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.GetField
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.GetField"
  

GetIndex

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.GetIndex
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.GetIndex"
  

ImportDocuments

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.ImportDocuments
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.databases.import - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.ImportDocuments"
  

ListFields

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.ListFields
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.ListFields"
  

ListIndexes

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.ListIndexes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.indexes.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.ListIndexes"
  

UpdateField

• 方法：google.firestore.admin.v1beta2.FirestoreAdmin.UpdateField
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.indexes.update - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 長時間執行的作業
  
• 篩選這個方法： protoPayload.methodName="google.firestore.admin.v1beta2.FirestoreAdmin.UpdateField"
  

google.firestore.v1.Firestore

下列稽核記錄與屬於 google.firestore.v1.Firestore 的方法相關聯。

BatchGetDocuments

• 方法：google.firestore.v1.Firestore.BatchGetDocuments
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.BatchGetDocuments"
  

BatchWrite

• 方法：google.firestore.v1.Firestore.BatchWrite
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.delete - DATA_WRITE
  • datastore.entities.update - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.BatchWrite"
  

BeginTransaction

• 方法：google.firestore.v1.Firestore.BeginTransaction
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.get - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.BeginTransaction"
  

Commit

• 方法：google.firestore.v1.Firestore.Commit
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.get - DATA_READ
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.delete - DATA_WRITE
  • datastore.entities.get - DATA_READ
  • datastore.entities.update - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.Commit"
  

CreateDocument

• 方法：google.firestore.v1.Firestore.CreateDocument
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.allocateIds - DATA_WRITE
  • datastore.entities.create - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.CreateDocument"
  

DeleteDocument

• 方法：google.firestore.v1.Firestore.DeleteDocument
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.delete - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.DeleteDocument"
  

GetDocument

• 方法：google.firestore.v1.Firestore.GetDocument
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.GetDocument"
  

ListCollectionIds

• 方法：google.firestore.v1.Firestore.ListCollectionIds
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.ListCollectionIds"
  

ListDocuments

• 方法：google.firestore.v1.Firestore.ListDocuments
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.ListDocuments"
  

Listen

• 方法：google.firestore.v1.Firestore.Listen
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 串流 RPC
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.Listen"
  

注意：

Listen 是結合多個串流目標的長期 RPC。每個目標都是查詢或一組文件鍵。每個目標的串流都包含初始結果集，以及結果集的更新、新增和移除序列。目標是相關的稽核單元。Firestore 會依下列方式稽核每個目標：

• 新增目標後，請發出記錄項目，並設定目標查詢或文件鍵。在這些項目中，operation.first 為 true。如果串流是先前 Listen 目標串流的續傳，則會省略這項稽核記錄。
• 定期發出更新，回報自上次稽核記錄以來，這個目標的更新次數。
• 當目標從串流中移除時 (無論是明確移除，還是因 Listen RPC 終止而移除)，請發出記錄項目。這項記錄項目會回報自上次稽核記錄以來，這個目標的更新次數。在這些項目中，operation.last 為 true。
• 發出的記錄項目會使用相同的 operation.id。

PartitionQuery

• 方法：google.firestore.v1.Firestore.PartitionQuery
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.PartitionQuery"
  

Rollback

• 方法：google.firestore.v1.Firestore.Rollback
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.get - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.Rollback"
  

RunAggregationQuery

• 方法：google.firestore.v1.Firestore.RunAggregationQuery
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.RunAggregationQuery"
  

RunQuery

• 方法：google.firestore.v1.Firestore.RunQuery
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.RunQuery"
  

注意： RunQuery 是生命週期短暫的串流 RPC，會在傳送最後一則訊息 (文件) 時發出記錄項目。

UpdateDocument

• 方法：google.firestore.v1.Firestore.UpdateDocument
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.update - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.UpdateDocument"
  

Write

• 方法：google.firestore.v1.Firestore.Write
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.update - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1.Firestore.Write"
  

注意： Write 會針對收到的每則訊息發出記錄項目，因為每則訊息都對應至資料庫的獨立寫入作業。發出的記錄項目會使用相同的 operation.id。

google.firestore.v1beta1.Firestore

下列稽核記錄與屬於 google.firestore.v1beta1.Firestore 的方法相關聯。

BatchGetDocuments

• 方法：google.firestore.v1beta1.Firestore.BatchGetDocuments
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.get - DATA_READ
  • datastore.entities.get - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.BatchGetDocuments"
  

BatchWrite

• 方法：google.firestore.v1beta1.Firestore.BatchWrite
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.get - DATA_READ
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.update - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.BatchWrite"
  

BeginTransaction

• 方法：google.firestore.v1beta1.Firestore.BeginTransaction
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.get - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.BeginTransaction"
  

Commit

• 方法：google.firestore.v1beta1.Firestore.Commit
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.get - DATA_READ
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.delete - DATA_WRITE
  • datastore.entities.update - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.Commit"
  

CreateDocument

• 方法：google.firestore.v1beta1.Firestore.CreateDocument
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.allocateIds - DATA_WRITE
  • datastore.entities.create - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.CreateDocument"
  

DeleteDocument

• 方法：google.firestore.v1beta1.Firestore.DeleteDocument
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.delete - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.DeleteDocument"
  

GetDocument

• 方法：google.firestore.v1beta1.Firestore.GetDocument
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.GetDocument"
  

ListCollectionIds

• 方法：google.firestore.v1beta1.Firestore.ListCollectionIds
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.ListCollectionIds"
  

ListDocuments

• 方法：google.firestore.v1beta1.Firestore.ListDocuments
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.ListDocuments"
  

PartitionQuery

• 方法：google.firestore.v1beta1.Firestore.PartitionQuery
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.PartitionQuery"
  

Rollback

• 方法：google.firestore.v1beta1.Firestore.Rollback
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.databases.get - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.Rollback"
  

RunAggregationQuery

• 方法：google.firestore.v1beta1.Firestore.RunAggregationQuery
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.RunAggregationQuery"
  

RunQuery

• 方法：google.firestore.v1beta1.Firestore.RunQuery
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.get - DATA_READ
  • datastore.entities.list - DATA_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.RunQuery"
  

注意： RunQuery 是生命週期短暫的串流 RPC，會在傳送最後一則訊息 (文件) 時發出記錄項目。

UpdateDocument

• 方法：google.firestore.v1beta1.Firestore.UpdateDocument
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.entities.create - DATA_WRITE
  • datastore.entities.update - DATA_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.firestore.v1beta1.Firestore.UpdateDocument"
  

google.longrunning.Operations

下列稽核記錄與屬於 google.longrunning.Operations 的方法相關聯。

CancelOperation

• 方法：google.longrunning.Operations.CancelOperation
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.operations.cancel - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.longrunning.Operations.CancelOperation"
  

DeleteOperation

• 方法：google.longrunning.Operations.DeleteOperation
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • datastore.operations.delete - ADMIN_WRITE
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.longrunning.Operations.DeleteOperation"
  

GetOperation

• 方法：google.longrunning.Operations.GetOperation
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.operations.get - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.longrunning.Operations.GetOperation"
  

ListOperations

• 方法：google.longrunning.Operations.ListOperations
  
• 稽核記錄類型：資料存取
  
• 權限：
  • datastore.operations.list - ADMIN_READ
• 方法是長時間執行的作業或串流作業： 否。
  
• 篩選這個方法： protoPayload.methodName="google.longrunning.Operations.ListOperations"
  

識別要求來電者

稽核記錄項目包含執行記錄作業的身分相關資訊。如要識別要求呼叫端，請參閱 AuditLog 物件中的下列欄位：

• 來電者的身分會保存在 AuthenticationInfo 欄位中。這可能包括使用者的 principalEmail。這項資訊有時會經過編輯。

  如果第三方驗證使用 JSON Web Token (JWT)，thirdPartyPrincipal 欄位會包含權杖的標頭和酬載。舉例來說，使用 Firebase 驗證進行驗證的要求稽核記錄，會包含該要求的驗證權杖。

• AuditLog 項目 requestMetadata 物件中的 callerIp 欄位包含呼叫端的 IP 位址。