每個 IAM 權限都有 type 屬性，其值為列舉，可以是下列四個值之一：ADMIN_READ、ADMIN_WRITE、DATA_READ 或 DATA_WRITE。呼叫方法時，Recommender 會產生稽核記錄，其類別取決於執行方法所需權限的 type 屬性。如果方法需要 IAM 權限，且 type 屬性值為 DATA_READ、DATA_WRITE 或 ADMIN_READ，就會產生「資料存取」稽核記錄。需要 IAM 權限且 type 屬性值為 ADMIN_WRITE 的方法會產生管理員活動稽核記錄。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-09-04 (世界標準時間)。"],[],[],null,["# Recommender audit logging\n=========================\n\nThis document describes audit logging for Recommender. Google Cloud services\ngenerate audit logs that record administrative and access activities within your Google Cloud resources.\nFor more information about Cloud Audit Logs, see the following:\n\n- [Types of audit logs](/logging/docs/audit#types)\n- [Audit log entry structure](/logging/docs/audit#audit_log_entry_structure)\n- [Storing and routing audit logs](/logging/docs/audit#storing_and_routing_audit_logs)\n- [Cloud Logging pricing summary](/stackdriver/pricing#logs-pricing-summary)\n- [Enable Data Access audit logs](/logging/docs/audit/configure-data-access)\n\n\u003cbr /\u003e\n\nService name\n------------\n\nRecommender audit logs use the service name `recommender.googleapis.com`.\nFilter for this service: \n\n```gdscript\n protoPayload.serviceName=\"recommender.googleapis.com\"\n \n```\n\n\u003cbr /\u003e\n\nMethods by permission type\n--------------------------\n\nEach IAM permission has a `type` property, whose value is an enum\nthat can be one of four values: `ADMIN_READ`, `ADMIN_WRITE`,\n`DATA_READ`, or `DATA_WRITE`. When you call a method,\nRecommender generates an audit log whose category is dependent on the\n`type` property of the permission required to perform the method.\n\nMethods that require an IAM permission with the `type` property value\nof `DATA_READ`, `DATA_WRITE`, or `ADMIN_READ` generate\n[Data Access](/logging/docs/audit#data-access) audit logs.\n\nMethods that require an IAM permission with the `type` property value\nof `ADMIN_WRITE` generate\n[Admin Activity](/logging/docs/audit#admin-activity) audit logs.\n\nAPI interface audit logs\n------------------------\n\nFor information about how and which permissions are evaluated for each method,\nsee the Identity and Access Management documentation for Recommender.\n\n### `google.cloud.recommender.v1.Recommender`\n\nThe following audit logs are associated with methods belonging to\n`google.cloud.recommender.v1.Recommender`.\n\n#### `GetInsightTypeConfig`\n\n- **Method** : `google.cloud.recommender.v1.Recommender.GetInsightTypeConfig` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `recommender.computeInstanceBestPracticeInsightTypeConfig.get - ADMIN_READ`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.cloud.recommender.v1.Recommender.GetInsightTypeConfig\"\n ` \n\n#### `GetRecommenderConfig`\n\n- **Method** : `google.cloud.recommender.v1.Recommender.GetRecommenderConfig` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `recommender.computeInstanceBestPracticeRecommenderConfig.get - ADMIN_READ`\n - `recommender.iamPolicyRecommenderConfig.get - ADMIN_READ`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.cloud.recommender.v1.Recommender.GetRecommenderConfig\"\n ` \n\n#### `UpdateInsightTypeConfig`\n\n- **Method** : `google.cloud.recommender.v1.Recommender.UpdateInsightTypeConfig` \n- **Audit log type** : [Admin activity](/logging/docs/audit#admin-activity) \n- **Permissions** :\n - `recommender.computeFirewallInsightTypeConfigs.update - ADMIN_WRITE`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.cloud.recommender.v1.Recommender.UpdateInsightTypeConfig\"\n ` \n\n#### `UpdateRecommenderConfig`\n\n- **Method** : `google.cloud.recommender.v1.Recommender.UpdateRecommenderConfig` \n- **Audit log type** : [Admin activity](/logging/docs/audit#admin-activity) \n- **Permissions** :\n - `recommender.computeInstanceBestPracticeRecommenderConfig.update - ADMIN_WRITE`\n - `recommender.iamPolicyRecommenderConfig.update - ADMIN_WRITE`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.cloud.recommender.v1.Recommender.UpdateRecommenderConfig\"\n ` \n\n### `google.cloud.recommender.v1beta1.Recommender`\n\nThe following audit logs are associated with methods belonging to\n`google.cloud.recommender.v1beta1.Recommender`.\n\n#### `GetInsightTypeConfig`\n\n- **Method** : `google.cloud.recommender.v1beta1.Recommender.GetInsightTypeConfig` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `recommender.computeFirewallInsightTypeConfigs.get - ADMIN_READ`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.cloud.recommender.v1beta1.Recommender.GetInsightTypeConfig\"\n ` \n\n#### `GetRecommenderConfig`\n\n- **Method** : `google.cloud.recommender.v1beta1.Recommender.GetRecommenderConfig` \n- **Audit log type** : [Data access](/logging/docs/audit#data-access) \n- **Permissions** :\n - `recommender.computeInstanceBestPracticeRecommenderConfig.get - ADMIN_READ`\n - `recommender.iamPolicyRecommenderConfig.get - ADMIN_READ`\n - `recommender.spendBasedCommitmentRecommenderConfig.get - ADMIN_READ`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.cloud.recommender.v1beta1.Recommender.GetRecommenderConfig\"\n ` \n\n#### `UpdateInsightTypeConfig`\n\n- **Method** : `google.cloud.recommender.v1beta1.Recommender.UpdateInsightTypeConfig` \n- **Audit log type** : [Admin activity](/logging/docs/audit#admin-activity) \n- **Permissions** :\n - `recommender.computeFirewallInsightTypeConfigs.update - ADMIN_WRITE`\n - `recommender.computeInstanceBestPracticeInsightTypeConfig.update - ADMIN_WRITE`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.cloud.recommender.v1beta1.Recommender.UpdateInsightTypeConfig\"\n ` \n\n#### `UpdateRecommenderConfig`\n\n- **Method** : `google.cloud.recommender.v1beta1.Recommender.UpdateRecommenderConfig` \n- **Audit log type** : [Admin activity](/logging/docs/audit#admin-activity) \n- **Permissions** :\n - `recommender.computeInstanceBestPracticeRecommenderConfig.update - ADMIN_WRITE`\n - `recommender.spendBasedCommitmentRecommenderConfig.update - ADMIN_WRITE`\n- **Method is a long-running or streaming operation** : No. \n- **Filter for this method** : `\n protoPayload.methodName=\"google.cloud.recommender.v1beta1.Recommender.UpdateRecommenderConfig\"\n ` \n\nMethods that don't produce audit logs\n-------------------------------------\n\nA method might not produce audit logs for one or more of the following\nreasons:\n\n- It is a high volume method involving significant log generation and storage costs.\n- It has low auditing value.\n- Another audit or platform log already provides method coverage.\n\n\u003cbr /\u003e\n\nThe following methods don't produce audit logs:\n\n- `google.cloud.recommender.v1.Recommender.GetInsight`\n- `google.cloud.recommender.v1.Recommender.GetRecommendation`\n- `google.cloud.recommender.v1.Recommender.ListInsights`\n- `google.cloud.recommender.v1.Recommender.ListRecommendations`\n- `google.cloud.recommender.v1.Recommender.MarkInsightAccepted`\n- `google.cloud.recommender.v1.Recommender.MarkRecommendationClaimed`\n- `google.cloud.recommender.v1.Recommender.MarkRecommendationDismissed`\n- `google.cloud.recommender.v1.Recommender.MarkRecommendationFailed`\n- `google.cloud.recommender.v1.Recommender.MarkRecommendationSucceeded`\n- `google.cloud.recommender.v1beta1.Recommender.GetInsight`\n- `google.cloud.recommender.v1beta1.Recommender.GetRecommendation`\n- `google.cloud.recommender.v1beta1.Recommender.ListInsightTypes`\n- `google.cloud.recommender.v1beta1.Recommender.ListInsights`\n- `google.cloud.recommender.v1beta1.Recommender.ListLocations`\n- `google.cloud.recommender.v1beta1.Recommender.ListRecommendations`\n- `google.cloud.recommender.v1beta1.Recommender.ListRecommenders`\n- `google.cloud.recommender.v1beta1.Recommender.MarkInsightAccepted`\n- `google.cloud.recommender.v1beta1.Recommender.MarkRecommendationClaimed`\n- `google.cloud.recommender.v1beta1.Recommender.MarkRecommendationDismissed`\n- `google.cloud.recommender.v1beta1.Recommender.MarkRecommendationFailed`\n- `google.cloud.recommender.v1beta1.Recommender.MarkRecommendationSucceeded`"]]
