API 金鑰稽核記錄

本文說明 API 金鑰的稽核記錄功能。 Google Cloud 服務會產生稽核記錄，用於記錄 Google Cloud 資源中的管理和存取活動。如要進一步瞭解 Cloud 稽核記錄，請參閱以下內容：

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

服務名稱

API 金鑰稽核記錄會使用服務名稱 apikeys.googleapis.com。如要篩選此服務，請使用：

    protoPayload.serviceName="apikeys.googleapis.com"
  

按權限類型劃分的方法

每個 IAM 權限都具有 type 屬性，其值為以下四個列舉值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。呼叫方法時，API 金鑰會產生一筆稽核記錄，類別取決於執行該方法所需權限的 type 屬性。若方法需要的 IAM 權限，type 屬性值為 DATA_READ、DATA_WRITE 或 ADMIN_READ，就會產生資料存取稽核記錄；若所需 IAM 權限的 type 屬性值為 ADMIN_WRITE，則會產生管理員活動稽核記錄。

下表列出的 API 方法中，如標有 (LRO) 字樣，表示為長時間執行的作業。這類方法通常會產生兩個稽核記錄項目，作業開始和結束時各一個。詳情請參閱「長時間執行的作業稽核記錄」。

權限類型	方法
ADMIN_READ	google.api.apikeys.v2.ApiKeys.GetKeyString
ADMIN_WRITE	google.api.apikeys.v2.ApiKeys.CreateKey (LRO) google.api.apikeys.v2.ApiKeys.DeleteKey (LRO) google.api.apikeys.v2.ApiKeys.UndeleteKey (LRO) google.api.apikeys.v2.ApiKeys.UpdateKey (LRO) google.longrunning.Operations.GetOperation

API 介面稽核記錄

如要瞭解各方法所需的權限及評估方式，請參閱 API 金鑰的 Identity and Access Management 說明文件。

google.api.apikeys.v2.ApiKeys

屬於 google.api.apikeys.v2.ApiKeys 的方法會產生以下稽核記錄。

CreateKey

• 方法：google.api.apikeys.v2.ApiKeys.CreateKey
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • serviceusage.apiKeys.create - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.CreateKey"
  

DeleteKey

• 方法：google.api.apikeys.v2.ApiKeys.DeleteKey
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • serviceusage.apiKeys.delete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.DeleteKey"
  

GetKeyString

• 方法：google.api.apikeys.v2.ApiKeys.GetKeyString
  
• 稽核記錄類型：資料存取
  
• 權限：
  • apikeys.keys.getKeyString - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.GetKeyString"
  

UndeleteKey

• 方法：google.api.apikeys.v2.ApiKeys.UndeleteKey
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • apikeys.keys.undelete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.UndeleteKey"
  

UpdateKey

• 方法：google.api.apikeys.v2.ApiKeys.UpdateKey
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • serviceusage.apiKeys.update - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.api.apikeys.v2.ApiKeys.UpdateKey"
  

google.longrunning.Operations

屬於 google.longrunning.Operations 的方法會產生以下稽核記錄。

GetOperation

• 方法：google.longrunning.Operations.GetOperation
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • apikeys.keys.create - ADMIN_WRITE
  • apikeys.keys.delete - ADMIN_WRITE
  • serviceusage.operations.get - DATA_READ
  • serviceusage.services.get - DATA_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 此方法的篩選條件： protoPayload.methodName="google.longrunning.Operations.GetOperation"