本頁面由 Cloud Translation API 翻譯而成。

Model Armor 稽核和平台記錄

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

服務名稱

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

    protoPayload.serviceName="modelarmor.googleapis.com"

依權限類型劃分的方法

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

權限類型	方法
`ADMIN_READ`	`google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting` `google.cloud.modelarmor.v1.ModelArmor.GetTemplate` `google.cloud.modelarmor.v1.ModelArmor.ListTemplates` `google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting` `google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate` `google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates`
`ADMIN_WRITE`	`google.cloud.modelarmor.v1.ModelArmor.CreateTemplate` `google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate` `google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting` `google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate` `google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate` `google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate` `google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting` `google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate`
`DATA_READ`	`google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse` `google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt` `google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse` `google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt`

API 介面稽核記錄

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

`google.cloud.modelarmor.v1.ModelArmor`

下列稽核記錄與屬於 google.cloud.modelarmor.v1.ModelArmor 的方法相關聯。

`CreateTemplate`

方法：google.cloud.modelarmor.v1.ModelArmor.CreateTemplate
稽核記錄類型：管理員活動
權限：
- modelarmor.templates.create - ADMIN_WRITE
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.CreateTemplate"

`DeleteTemplate`

方法：google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate
稽核記錄類型：管理員活動
權限：
- modelarmor.templates.delete - ADMIN_WRITE
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.DeleteTemplate"

`GetFloorSetting`

方法：google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting
稽核記錄類型：資料存取
權限：
- modelarmor.floorSettings.get - ADMIN_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetFloorSetting"

`GetTemplate`

方法：google.cloud.modelarmor.v1.ModelArmor.GetTemplate
稽核記錄類型：資料存取
權限：
- modelarmor.templates.get - ADMIN_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.GetTemplate"

`ListTemplates`

方法：google.cloud.modelarmor.v1.ModelArmor.ListTemplates
稽核記錄類型：資料存取
權限：
- modelarmor.templates.list - ADMIN_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.ListTemplates"

`SanitizeModelResponse`

方法：google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse
稽核記錄類型：資料存取
權限：
- modelarmor.templates.useToSanitizeModelResponse - DATA_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeModelResponse"

`SanitizeUserPrompt`

方法：google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt
稽核記錄類型：資料存取
權限：
- modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.SanitizeUserPrompt"

`UpdateFloorSetting`

方法：google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting
稽核記錄類型：管理員活動
權限：
- modelarmor.floorSettings.update - ADMIN_WRITE
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateFloorSetting"

`UpdateTemplate`

方法：google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate
稽核記錄類型：管理員活動
權限：
- modelarmor.templates.update - ADMIN_WRITE
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1.ModelArmor.UpdateTemplate"

`google.cloud.modelarmor.v1alpha.ModelArmor`

下列稽核記錄與屬於 google.cloud.modelarmor.v1alpha.ModelArmor 的方法相關聯。

`CreateTemplate`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate
稽核記錄類型：管理員活動
權限：
- modelarmor.templates.create - ADMIN_WRITE
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.CreateTemplate"

`DeleteTemplate`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate
稽核記錄類型：管理員活動
權限：
- modelarmor.templates.delete - ADMIN_WRITE
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.DeleteTemplate"

`GetFloorSetting`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting
稽核記錄類型：資料存取
權限：
- modelarmor.floorSettings.get - ADMIN_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetFloorSetting"

`GetTemplate`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate
稽核記錄類型：資料存取
權限：
- modelarmor.templates.get - ADMIN_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.GetTemplate"

`ListTemplates`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates
稽核記錄類型：資料存取
權限：
- modelarmor.templates.list - ADMIN_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.ListTemplates"

`SanitizeModelResponse`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse
稽核記錄類型：資料存取
權限：
- modelarmor.templates.useToSanitizeModelResponse - DATA_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeModelResponse"

`SanitizeUserPrompt`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt
稽核記錄類型：資料存取
權限：
- modelarmor.templates.useToSanitizeUserPrompt - DATA_READ
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.SanitizeUserPrompt"

`UpdateFloorSetting`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting
稽核記錄類型：管理員活動
權限：
- modelarmor.floorSettings.update - ADMIN_WRITE
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateFloorSetting"

`UpdateTemplate`

方法：google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate
稽核記錄類型：管理員活動
權限：
- modelarmor.templates.update - ADMIN_WRITE
方法是長時間執行的作業或串流作業：否。
篩選這個方法：protoPayload.methodName="google.cloud.modelarmor.v1alpha.ModelArmor.UpdateTemplate"

不會產生稽核記錄的方法

方法可能不會產生稽核記錄，原因如下：

這項方法會產生大量記錄，因此需要支付高昂的記錄產生和儲存費用。
稽核價值偏低。
其他稽核或平台記錄已提供方法涵蓋範圍。

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

envoy.service.ext_proc.v3.ExternalProcessor.Process
google.cloud.location.Locations.GetLocation
google.cloud.location.Locations.ListLocations

記錄設定

您可以設定 Model Armor 記錄下列作業：

建立、更新及刪除範本
清除使用者提示和模型回覆中的有害內容

REST

  curl -X POST \
   -d "{filter_config: {}, 'template_metadata': { 'log_template_operations': 'true', 'log_sanitize_operations': 'true'} }" \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://modelarmor.<var>LOCATION</var>.rep.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/templates?template_id=<var>TEMPLATE_ID</var>"

Python

   request = modelarmor_v1.CreateTemplateRequest(
     parent="projects/PROJECT_ID/locations/LOCATION",
     template_id="TEMPLATE_ID",
     template={
        "name": "projects/PROJECT_ID/locations/LOCATION/templates/TEMPLATE_ID",
        "filter_config": {},
        "template_metadata": {
           "log_template_operations": True,
           "log_sanitize_operations": True
        }
     }
   )
   response = client.create_template(request=request)

log_template_operations：布林值，用於判斷是否應在平台記錄中記錄建立、更新、讀取及刪除範本的操作。
log_sanitize_operations：布林值，決定是否要在平台記錄中記錄清除作業。記錄包括提示和回覆、Model Armor 的評估結果，以及額外的清除中繼資料欄位。

更改下列內容：
- PROJECT_ID 是範本所屬的專案 ID。
- LOCATION 是範本的位置。
- TEMPLATE_ID 是範本的 ID。

Model Armor 稽核和平台記錄 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

服務名稱

依權限類型劃分的方法

API 介面稽核記錄

google.cloud.modelarmor.v1.ModelArmor

CreateTemplate

DeleteTemplate

GetFloorSetting

GetTemplate

ListTemplates

SanitizeModelResponse

SanitizeUserPrompt

UpdateFloorSetting

UpdateTemplate

google.cloud.modelarmor.v1alpha.ModelArmor

CreateTemplate

DeleteTemplate

GetFloorSetting

GetTemplate

ListTemplates

SanitizeModelResponse

SanitizeUserPrompt

UpdateFloorSetting

UpdateTemplate

不會產生稽核記錄的方法

記錄設定

REST

Python

Model Armor 稽核和平台記錄

`google.cloud.modelarmor.v1.ModelArmor`

`CreateTemplate`

`DeleteTemplate`

`GetFloorSetting`

`GetTemplate`

`ListTemplates`

`SanitizeModelResponse`

`SanitizeUserPrompt`

`UpdateFloorSetting`

`UpdateTemplate`

`google.cloud.modelarmor.v1alpha.ModelArmor`

`CreateTemplate`

`DeleteTemplate`

`GetFloorSetting`

`GetTemplate`

`ListTemplates`

`SanitizeModelResponse`

`SanitizeUserPrompt`

`UpdateFloorSetting`

`UpdateTemplate`