Cloud TPU 稽核記錄

注意：本頁內容適用於 Cloud TPU API。如果是 Ironwood (TPU7x)，則必須使用 Google Kubernetes Engine (GKE)。詳情請參閱「關於 GKE 中的 TPU」。

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

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

服務名稱

Cloud TPU 稽核記錄會使用 tpu.googleapis.com 這個服務名稱。如要篩選此服務，請使用：

    protoPayload.serviceName="tpu.googleapis.com"
  

按權限類型劃分的方法

每個 IAM 權限都有 type 屬性，這個屬性的值只能是以下四個選項之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。呼叫方法時，Cloud TPU 會產生一筆稽核記錄，記錄類別依執行該方法所需權限的 type 屬性而定。若方法需要的 IAM 權限，type 屬性值為 DATA_READ、DATA_WRITE 或 ADMIN_READ，就會產生資料存取稽核記錄；若所需 IAM 權限的 type 屬性值為 ADMIN_WRITE，則會產生管理員活動稽核記錄。

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

權限類型	方法
ADMIN_READ	google.cloud.tpu.v1.Tpu.GetNode google.cloud.tpu.v1.Tpu.ListNodes google.cloud.tpu.v1alpha1.Tpu.GetNode google.cloud.tpu.v1alpha1.Tpu.ListNodes google.cloud.tpu.v2.Tpu.GetGuestAttributes google.cloud.tpu.v2.Tpu.GetNode google.cloud.tpu.v2.Tpu.GetQueuedResource google.cloud.tpu.v2.Tpu.ListNodes google.cloud.tpu.v2.Tpu.ListQueuedResources google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes google.cloud.tpu.v2alpha1.Tpu.GetNode google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource google.cloud.tpu.v2alpha1.Tpu.ListNodes google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources google.cloud.tpu.v2alpha1.Tpu.ListReservations
ADMIN_WRITE	google.cloud.tpu.v1.Tpu.CreateNode (LRO) google.cloud.tpu.v1.Tpu.DeleteNode (LRO) google.cloud.tpu.v1.Tpu.ReimageNode google.cloud.tpu.v1.Tpu.StartNode (LRO) google.cloud.tpu.v1.Tpu.StopNode (LRO) google.cloud.tpu.v1alpha1.Tpu.CreateNode (LRO) google.cloud.tpu.v1alpha1.Tpu.DeleteNode (LRO) google.cloud.tpu.v1alpha1.Tpu.ReimageNode (LRO) google.cloud.tpu.v1alpha1.Tpu.StartNode (LRO) google.cloud.tpu.v1alpha1.Tpu.StopNode (LRO) google.cloud.tpu.v2.Tpu.CreateNode (LRO) google.cloud.tpu.v2.Tpu.CreateQueuedResource (LRO) google.cloud.tpu.v2.Tpu.DeleteNode (LRO) google.cloud.tpu.v2.Tpu.DeleteQueuedResource (LRO) google.cloud.tpu.v2.Tpu.ResetQueuedResource (LRO) google.cloud.tpu.v2.Tpu.StartNode (LRO) google.cloud.tpu.v2.Tpu.StopNode (LRO) google.cloud.tpu.v2.Tpu.UpdateNode (LRO) google.cloud.tpu.v2alpha1.Tpu.CreateNode (LRO) google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource (LRO) google.cloud.tpu.v2alpha1.Tpu.DeleteNode (LRO) google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource (LRO) google.cloud.tpu.v2alpha1.Tpu.ResetQueuedResource (LRO) google.cloud.tpu.v2alpha1.Tpu.SimulateMaintenanceEvent (LRO) google.cloud.tpu.v2alpha1.Tpu.StartNode (LRO) google.cloud.tpu.v2alpha1.Tpu.StopNode (LRO) google.cloud.tpu.v2alpha1.Tpu.UpdateNode (LRO)

API 介面稽核記錄

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

google.cloud.tpu.v1.Tpu

屬於 google.cloud.tpu.v1.Tpu 的方法會產生以下稽核記錄。

CreateNode

• 方法：google.cloud.tpu.v1.Tpu.CreateNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.create - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1.Tpu.CreateNode"
  

DeleteNode

• 方法：google.cloud.tpu.v1.Tpu.DeleteNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.delete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1.Tpu.DeleteNode"
  

GetNode

• 方法：google.cloud.tpu.v1.Tpu.GetNode
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1.Tpu.GetNode"
  

ListNodes

• 方法：google.cloud.tpu.v1.Tpu.ListNodes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.list - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1.Tpu.ListNodes"
  

ReimageNode

• 方法：google.cloud.tpu.v1.Tpu.ReimageNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.reimage - ADMIN_WRITE
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1.Tpu.ReimageNode"
  

StartNode

• 方法：google.cloud.tpu.v1.Tpu.StartNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.start - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1.Tpu.StartNode"
  

StopNode

• 方法：google.cloud.tpu.v1.Tpu.StopNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.stop - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1.Tpu.StopNode"
  

google.cloud.tpu.v1alpha1.Tpu

屬於 google.cloud.tpu.v1alpha1.Tpu 的方法會產生以下稽核記錄。

CreateNode

• 方法：google.cloud.tpu.v1alpha1.Tpu.CreateNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.create - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.CreateNode"
  

DeleteNode

• 方法：google.cloud.tpu.v1alpha1.Tpu.DeleteNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.delete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.DeleteNode"
  

GetNode

• 方法：google.cloud.tpu.v1alpha1.Tpu.GetNode
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.GetNode"
  

ListNodes

• 方法：google.cloud.tpu.v1alpha1.Tpu.ListNodes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.list - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.ListNodes"
  

ReimageNode

• 方法：google.cloud.tpu.v1alpha1.Tpu.ReimageNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.reimage - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.ReimageNode"
  

StartNode

• 方法：google.cloud.tpu.v1alpha1.Tpu.StartNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.start - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.StartNode"
  

StopNode

• 方法：google.cloud.tpu.v1alpha1.Tpu.StopNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.stop - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v1alpha1.Tpu.StopNode"
  

google.cloud.tpu.v2.Tpu

屬於 google.cloud.tpu.v2.Tpu 的方法會產生以下稽核記錄。

CreateNode

• 方法：google.cloud.tpu.v2.Tpu.CreateNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.create - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.CreateNode"
  

CreateQueuedResource

• 方法：google.cloud.tpu.v2.Tpu.CreateQueuedResource
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.create - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.CreateQueuedResource"
  

DeleteNode

• 方法：google.cloud.tpu.v2.Tpu.DeleteNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.delete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.DeleteNode"
  

DeleteQueuedResource

• 方法：google.cloud.tpu.v2.Tpu.DeleteQueuedResource
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.delete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.DeleteQueuedResource"
  

GetGuestAttributes

• 方法：google.cloud.tpu.v2.Tpu.GetGuestAttributes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.GetGuestAttributes"
  

GetNode

• 方法：google.cloud.tpu.v2.Tpu.GetNode
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.GetNode"
  

GetQueuedResource

• 方法：google.cloud.tpu.v2.Tpu.GetQueuedResource
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.GetQueuedResource"
  

ListNodes

• 方法：google.cloud.tpu.v2.Tpu.ListNodes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.list - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.ListNodes"
  

ListQueuedResources

• 方法：google.cloud.tpu.v2.Tpu.ListQueuedResources
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.list - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.ListQueuedResources"
  

ResetQueuedResource

• 方法：google.cloud.tpu.v2.Tpu.ResetQueuedResource
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.reset - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.ResetQueuedResource"
  

StartNode

• 方法：google.cloud.tpu.v2.Tpu.StartNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.start - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.StartNode"
  

StopNode

• 方法：google.cloud.tpu.v2.Tpu.StopNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.stop - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.StopNode"
  

UpdateNode

• 方法：google.cloud.tpu.v2.Tpu.UpdateNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.update - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2.Tpu.UpdateNode"
  

google.cloud.tpu.v2alpha1.Tpu

屬於 google.cloud.tpu.v2alpha1.Tpu 的方法會產生以下稽核記錄。

CreateNode

• 方法：google.cloud.tpu.v2alpha1.Tpu.CreateNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.create - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.CreateNode"
  

CreateQueuedResource

• 方法：google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.create - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.CreateQueuedResource"
  

DeleteNode

• 方法：google.cloud.tpu.v2alpha1.Tpu.DeleteNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.delete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.DeleteNode"
  

DeleteQueuedResource

• 方法：google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.delete - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.DeleteQueuedResource"
  

GetGuestAttributes

• 方法：google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.GetGuestAttributes"
  

GetNode

• 方法：google.cloud.tpu.v2alpha1.Tpu.GetNode
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.GetNode"
  

GetQueuedResource

• 方法：google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.GetQueuedResource"
  

ListNodes

• 方法：google.cloud.tpu.v2alpha1.Tpu.ListNodes
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.list - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.ListNodes"
  

ListQueuedResources

• 方法：google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.list - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.ListQueuedResources"
  

ListReservations

• 方法：google.cloud.tpu.v2alpha1.Tpu.ListReservations
  
• 稽核記錄類型：資料存取
  
• 權限：
  • tpu.nodes.get - ADMIN_READ
• 方法的作業種類： 非長時間執行或串流作業。
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.ListReservations"
  

ResetQueuedResource

• 方法：google.cloud.tpu.v2alpha1.Tpu.ResetQueuedResource
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.reset - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.ResetQueuedResource"
  

SimulateMaintenanceEvent

• 方法：google.cloud.tpu.v2alpha1.Tpu.SimulateMaintenanceEvent
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.simulateMaintenanceEvent - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.SimulateMaintenanceEvent"
  

StartNode

• 方法：google.cloud.tpu.v2alpha1.Tpu.StartNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.start - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.StartNode"
  

StopNode

• 方法：google.cloud.tpu.v2alpha1.Tpu.StopNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.stop - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.StopNode"
  

UpdateNode

• 方法：google.cloud.tpu.v2alpha1.Tpu.UpdateNode
  
• 稽核記錄類型：管理員活動
  
• 權限：
  • tpu.nodes.update - ADMIN_WRITE
• 方法的作業種類： 長時間執行的作業
  
• 篩選條件： protoPayload.methodName="google.cloud.tpu.v2alpha1.Tpu.UpdateNode"
  

系統事件

系統事件稽核記錄是由 GCP 系統產生，而非使用者直接操作。詳情請參閱「系統事件稽核記錄」。

方法名稱	篩選這個活動	附註
tpu.nodes.restart	protoPayload.methodName="tpu.nodes.restart"	在終止的節點修復並重新啟動時發生。
tpu.nodes.terminate	protoPayload.methodName="tpu.nodes.terminate"	節點非自願終止時會發生此事件，例如因維護事件而終止。終止原因請參閱 protoPayload.metadata.terminateReason。

不會產生稽核記錄的方法

某些方法可能不會產生稽核記錄，原因包括以下一或多項：

• 該方法的流量使用量高，若產生稽核記錄，會導致記錄與儲存成本過高。
• 稽核價值低。
• 其他稽核記錄或平台記錄已涵蓋該方法的活動。

下列方法不會產生稽核記錄：

• google.cloud.location.Locations.GetLocation
• google.cloud.location.Locations.ListLocations
• google.cloud.tpu.v1.Tpu.GetAcceleratorType
• google.cloud.tpu.v1.Tpu.GetTensorFlowVersion
• google.cloud.tpu.v1.Tpu.ListAcceleratorTypes
• google.cloud.tpu.v1.Tpu.ListTensorFlowVersions
• google.cloud.tpu.v1alpha1.Tpu.GetAcceleratorType
• google.cloud.tpu.v1alpha1.Tpu.GetTensorFlowVersion
• google.cloud.tpu.v1alpha1.Tpu.ListAcceleratorTypes
• google.cloud.tpu.v1alpha1.Tpu.ListTensorFlowVersions
• google.cloud.tpu.v2.Tpu.GetAcceleratorType
• google.cloud.tpu.v2.Tpu.GetRuntimeVersion
• google.cloud.tpu.v2.Tpu.ListAcceleratorTypes
• google.cloud.tpu.v2.Tpu.ListRuntimeVersions
• google.cloud.tpu.v2alpha1.Tpu.GetAcceleratorType
• google.cloud.tpu.v2alpha1.Tpu.GetRuntimeVersion
• google.cloud.tpu.v2alpha1.Tpu.ListAcceleratorTypes
• google.cloud.tpu.v2alpha1.Tpu.ListRuntimeVersions
• google.longrunning.Operations.WaitOperation