查看及套用 Cloud Storage 值區的角色建議

本頁說明如何查看、瞭解及套用 Cloud Storage bucket 的 IAM 角色建議。角色建議可協助您強制執行最小權限原則，確保主體只有實際所需的權限。

事前準備

• 如果 IAM 和 Recommender API 尚未啟用，請啟用這些 API。

  啟用 API 時所需的角色

  如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

  啟用 API

• 請確認您已在機構或專案層級啟用 Security Command Center 的 Premium 或 Enterprise 方案。詳情請參閱「帳單問題」。

• 瞭解角色建議。

• 設定驗證方法。

  選取這個頁面上您打算如何使用範例的分頁：

  控制台

  使用 Google Cloud 控制台存取 Google Cloud 服務和 API 時，不需要設定驗證。

  gcloud

  在 Google Cloud 控制台中啟用 Cloud Shell。

  啟用 Cloud Shell

  控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。 Google Cloud Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已針對您目前的專案設定好相關值。工作階段可能要幾秒鐘的時間才能初始化。

  REST

  如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

  安裝 Google Cloud CLI。

  如果您使用外部識別資訊提供者 (IdP)，請先 使用聯合身分登入 gcloud CLI。

  詳情請參閱 Google Cloud 驗證說明文件中的「使用 REST 進行驗證」。

必要的 IAM 角色

如要取得管理 bucket 層級角色建議所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

• 角色檢視者 (roles/iam.roleViewer)
• 儲存空間管理員 (roles/storage.admin)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備管理 bucket 層級角色建議所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要管理 bucket 層級的角色建議，必須具備下列權限：

• 如要查看建議：
  • iam.roles.get
  • iam.roles.list
  • recommender.iamPolicyRecommendations.get
  • recommender.iamPolicyRecommendations.list
  • recommender.iamPolicyInsights.get
  • recommender.iamPolicyInsights.list
  • storage.buckets.getIamPolicy
• 如何套用及略過最佳化建議：
  • recommender.iamPolicyRecommendations.update
  • storage.buckets.setIamPolicy

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

查看及套用建議

您可以使用 Google Cloud CLI 和 Recommender API，查看及套用儲存空間層級的角色建議。

注意： IAM 建議工具不會將其他形式的存取權控管納入考量。如果您使用與 IAM 分開的存取控管機制，例如 Cloud Storage 存取控制清單 (ACL) 或 Kubernetes 角色式存取控管 (RBAC)，請先確認每項建議不會中斷這些存取控管機制，再套用建議。

控制台

1. 在 Google Cloud 控制台，前往「Cloud Storage bucket」頁面。

   前往「Buckets」(值區) 頁面

2. 找出「安全性深入分析資訊」欄。如果沒有看到這個資料欄，請按一下「資料欄顯示選項」圖示 ，然後選取「安全性洞察」。

   「安全性洞察」欄會顯示 bucket 的所有政策洞察摘要。每份摘要都會指出該 bucket 中所有角色擁有的過多權限總數。

   

   

   如果系統提供建議來解決任何洞察資料， Google Cloud 控制台會顯示「有可用的建議」圖示。

   附註： 建議工具不會分析所有角色的權限。如要瞭解建議工具會分析哪些角色，請參閱「身分與存取權管理政策最佳化建議的適用情形」。

3. 如有建議可供查看，請按一下政策洞察摘要，開啟「安全性建議」窗格。這個窗格會列出 bucket 中具有角色的所有主體、這些主體的角色，以及與這些角色相關聯的任何政策洞察資訊。

   

   

4. 按一下「有最佳化建議」 圖示，即可查看建議的詳細資料。

   如果建議是替換角色，角色建議一律會提供一組可套用的預先定義角色。

   在某些情況下，角色建議也會建議在專案層級建立新的自訂角色。如有自訂角色建議， Google Cloud 控制台預設會顯示。如要改用建議的預先定義角色，請按一下「查看建議的預先定義角色」。

5. 請仔細查看建議，並確認您瞭解上次重新整理的時間，以及這項建議會如何變更主體對Google Cloud 資源的存取權。除非是服務代理程式的最佳化建議，否則最佳化建議絕不會提高主體的存取層級。詳情請參閱「角色建議的產生方式」。

   如要瞭解如何在控制台中查看建議，請參閱本頁的「查看建議」一節。

6. 選用：如果建議是建立自訂角色，請視需要更新「名稱」、「說明」、「ID」和「角色發布階段」。

   如要為自訂角色新增權限，請按一下「新增權限」。

   如要從自訂角色移除權限，請取消勾選要移除的權限。

7. 根據建議採取行動。

   如要套用建議，請按一下「套用」或「建立並套用」。如果改變心意，可以在接下來 90 天內使用最佳化建議記錄還原選擇。

   如要關閉建議，請按一下「關閉」，然後確認選擇。 只要最佳化建議仍有效，您就能還原已略過的建議。

8. 重複上述步驟，直到查看完所有建議為止。

gcloud

查看最佳化建議：

如要列出 bucket 層級的建議，請執行 gcloud recommender recommendations list 指令，並只篩選 Cloud Storage bucket 建議：

gcloud recommender recommendations list \
    --location=LOCATION \
    --recommender=google.iam.policy.Recommender \
    --project=PROJECT_ID \
    --format=json \
    --filter="recommenderSubtype:REMOVE_ROLE_STORAGE_BUCKET OR recommenderSubtype:REPLACE_ROLE_STORAGE_BUCKET"

替換下列值：

• LOCATION：Cloud Storage bucket 所在的區域，例如 us 或 us-central1。
• PROJECT_ID：包含 Cloud Storage bucket 的 Google Cloud 專案 ID。專案 ID 是英數字元字串，例如 my-project。

回覆內容類似於下列範例。在這個範例中，所有已通過驗證的使用者 (allAuthenticatedUsers) 在 bucket mybucket 中都具有 Storage 舊版物件讀取者角色 (roles/storage.legacyObjectReader)。但過去 90 天內，這個角色未曾使用任何權限。因此，角色建議會建議您撤銷角色：

[
  {
    "associatedInsights": [
      {
        "insight": "projects/123456789012/locations/us/insightTypes/google.iam.policy.Insight/insights/7849add9-73c0-419e-b169-42b3671173fb"
      }
    ],
    "associatedResourceNames": [
      "//storage.googleapis.com/my-bucket"
    ],
    "content": {
      "operationGroups": [
        {
          "operations": [
            {
              "action": "remove",
              "path": "/iamPolicy/bindings/*/members/*",
              "pathFilters": {
                "/iamPolicy/bindings/*/condition/expression": "",
                "/iamPolicy/bindings/*/members/*": "allAuthenticatedUsers",
                "/iamPolicy/bindings/*/role": "roles/storage.legacyObjectReader"
              },
              "resource": "//storage.googleapis.com/my-bucket",
              "resourceType": "storage.googleapis.com/Bucket"
            }
          ]
        }
      ]
    },
    "description": "This role has not been used during the observation window.",
    "etag": "\"7caf4103d7669e12\"",
    "lastRefreshTime": "2022-05-24T07:00:00Z",
    "name": "projects/123456789012/locations/us/recommenders/google.iam.policy.Recommender/recommendations/fbc885b7-f0a8-47e6-90fe-6141aa2c4257",
    "primaryImpact": {
      "category": "SECURITY",
      "securityProjection": {
        "details": {
          "revokedIamPermissionsCount": 1
        }
      }
    },
    "priority": "P1",
    "recommenderSubtype": "REMOVE_ROLE_STORAGE_BUCKET",
    "stateInfo": {
      "state": "ACTIVE"
    }
  }
]

請仔細查看每項建議，並考量上次重新整理的時間，以及建議會如何變更主體對 Google Cloud 資源的存取權。如要瞭解如何透過 gcloud CLI 查看最佳化建議，請參閱本頁的「查看最佳化建議」一節。

套用最佳化建議：

1. 使用 gcloud recommender recommendations mark-claimed 指令將建議的狀態變更為 CLAIMED,，這樣在套用建議時，建議就不會變更：

   gcloud recommender recommendations mark-claimed \
       RECOMMENDATION_ID \
       --location=LOCATION \
       --recommender=google.iam.policy.Recommender \
       --project=PROJECT_ID \
       --format=FORMAT \
       --etag=ETAG \
       --state-metadata=STATE_METADATA
   

   替換下列值：

   • RECOMMENDATION_ID：建議的專屬 ID。這項值會顯示在最佳化建議的「name」欄位結尾。舉例來說，如果 name 欄位為 projects/example-project/locations/global/recommenders/google.iam.policy.Recommender/recommendations/fb927dc1-9695-4436-0000-f0f285007c0f，則建議 ID 為 fb927dc1-9695-4436-0000-f0f285007c0f。
   • LOCATION：Cloud Storage bucket 所在的區域，例如 us 或 us-central1。
   • PROJECT_ID：包含 Cloud Storage bucket 的 Google Cloud 專案 ID。專案 ID 是英數字元字串，例如 my-project。
   • FORMAT：回應格式。使用 json 或 yaml。
   • ETAG：建議中 etag 欄位的值，例如 "dd0686e7136a4cbb"。請注意，這個值可以包含引號。
   • STATE_METADATA：選用。以半形逗號分隔的鍵/值組合，內含您選擇的建議相關中繼資料。例如 --state-metadata=reviewedBy=alice,priority=high。中繼資料會取代建議中的 stateInfo.stateMetadata 欄位。

   如果指令成功，回應會顯示處於 CLAIMED 狀態的建議，如下例所示。為求明確，範例省略了大多數欄位：

   ...
   "priority": "P1",
   "recommenderSubtype": "REMOVE_ROLE_STORAGE_BUCKET",
   "stateInfo": {
     "state": "CLAIMED"
   }
   ...

2. 取得 bucket 的允許政策，然後修改並設定允許政策，以反映建議。

3. 如果可以套用最佳化建議，請將最佳化建議的狀態更新為 SUCCEEDED；如果無法套用，請更新為 FAILED：

   gcloud recommender recommendations COMMAND \
       RECOMMENDATION_ID \
       --location=LOCATION \
       --recommender=google.iam.policy.Recommender \
       --project=PROJECT_ID \
       --format=FORMAT \
       --etag=ETAG \
       --state-metadata=STATE_METADATA
   

   替換下列值：

   • COMMAND：如果已套用最佳化建議，請使用 mark-succeeded；如果無法套用，請使用 mark-failed。
   • RECOMMENDATION_ID：建議的專屬 ID。這項值會顯示在最佳化建議的「name」欄位結尾。舉例來說，如果 name 欄位為 projects/example-project/locations/global/recommenders/google.iam.policy.Recommender/recommendations/fb927dc1-9695-4436-0000-f0f285007c0f，則建議 ID 為 fb927dc1-9695-4436-0000-f0f285007c0f。
   • LOCATION：Cloud Storage bucket 所在的區域，例如 us 或 us-central1。
   • PROJECT_ID：包含 Cloud Storage bucket 的 Google Cloud 專案 ID。專案 ID 是英數字元字串，例如 my-project。
   • FORMAT：回應格式。使用 json 或 yaml。
   • ETAG：建議中 etag 欄位的值，例如 "dd0686e7136a4cbb"。請注意，這個值可以包含引號。
   • STATE_METADATA：選用。以半形逗號分隔的鍵/值組合，內含您選擇的建議相關中繼資料。例如 --state-metadata=reviewedBy=alice,priority=high。中繼資料會取代建議中的 stateInfo.stateMetadata 欄位。

   舉例來說，如果您將建議標示為成功，回應會顯示建議處於 SUCCEEDED 狀態。為求明確，這個範例省略了大部分的欄位：

   ...
   "priority": "P1",
   "recommenderSubtype": "REMOVE_ROLE_STORAGE_BUCKET",
   "stateInfo": {
     "state": "SUCCEEDED"
   }
   ...

REST

查看最佳化建議：

如要列出 Cloud Storage bucket 的所有可用建議，請使用 Recommender API 的 recommendations.list 方法。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID：包含 Cloud Storage bucket 的Google Cloud 專案 ID。專案 ID 是英數字元字串，例如 my-project。
• LOCATION：Cloud Storage bucket 所在的區域，例如 us 或 us-central1。
• PAGE_SIZE：選用。這項要求傳回的結果數上限。如未指定，伺服器會決定要傳回的結果數量。如果建議數量大於頁面大小，回應會包含分頁符記，可用於擷取下一頁結果。
• PAGE_TOKEN：選用。這個方法先前回應中傳回的分頁符記。如果指定了這項參數，建議清單就會從上一個要求結束的位置開始。
• PROJECT_ID：您的 Google Cloud 專案 ID。專案 ID 是英數字元字串，例如 my-project。

HTTP 方法和網址：

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations?filter=recommenderSubtype%20%3D%20REMOVE_ROLE_STORAGE_BUCKET%20OR%20recommenderSubtype%20%3D%20REPLACE_ROLE_STORAGE_BUCKET&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations?filter=recommenderSubtype%20%3D%20REMOVE_ROLE_STORAGE_BUCKET%20OR%20recommenderSubtype%20%3D%20REPLACE_ROLE_STORAGE_BUCKET&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations?filter=recommenderSubtype%20%3D%20REMOVE_ROLE_STORAGE_BUCKET%20OR%20recommenderSubtype%20%3D%20REPLACE_ROLE_STORAGE_BUCKET&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

回覆內容類似於下列範例。在這個範例中，所有已通過驗證的使用者 (allAuthenticatedUsers) 在 bucket mybucket 中都具有 Storage 舊版物件讀取者角色 (roles/storage.legacyObjectReader)。但過去 90 天內，這個角色未曾使用任何權限。因此，角色建議會建議您撤銷角色：

{
  "recommendations": [
    "name": "projects/123456789012/locations/us/recommenders/google.iam.policy.Recommender/recommendations/fbc885b7-f0a8-47e6-90fe-6141aa2c4257",
    "description": "This role has not been used during the observation window.",
    "lastRefreshTime": "2022-05-24T07:00:00Z",
    "primaryImpact": {
      "category": "SECURITY",
      "securityProjection": {
        "details": {
          "revokedIamPermissionsCount": 1
        }
      }
    },
    "content": {
      "operationGroups": [
        {
          "operations": [
            {
              "action": "remove",
              "resourceType": "storage.googleapis.com/Bucket",
              "resource": "//storage.googleapis.com/my-bucket",
              "path": "/iamPolicy/bindings/*/members/*",
              "pathFilters": {
                "/iamPolicy/bindings/*/condition/expression": "",
                "/iamPolicy/bindings/*/members/*": "allAuthenticatedUsers",
                "/iamPolicy/bindings/*/role": "roles/storage.legacyObjectReader"
              }
            }
          ]
        }
      ]
    },
    "stateInfo": {
      "state": "ACTIVE"
    },
    "etag": "\"7caf4103d7669e12\"",
    "recommenderSubtype": "REMOVE_ROLE_STORAGE_BUCKET",
    "associatedInsights": [
      {
        "insight": "projects/123456789012/locations/us/insightTypes/google.iam.policy.Insight/insights/7849add9-73c0-419e-b169-42b3671173fb"
      }
    ],
    "priority": "P1"
  ]
}

請仔細查看每項建議，並考量上次重新整理的時間，以及建議會如何變更主體對 Google Cloud 資源的存取權。如要瞭解如何透過 REST API 查看最佳化建議，請參閱本頁的「查看最佳化建議」一節。

套用最佳化建議：

1. 將建議標示為CLAIMED：

   如要將建議標示為 CLAIMED，防止建議在您套用時變更，請使用 Recommender API 的 recommendations.markClaimed 方法。

   使用任何要求資料之前，請先修改下列項目的值：

   • PROJECT_ID：包含 Cloud Storage bucket 的Google Cloud 專案 ID。專案 ID 是英數字元字串，例如 my-project。
   • LOCATION：Cloud Storage bucket 所在的區域，例如 us 或 us-central1。
   • RECOMMENDATION_ID：建議的專屬 ID。這個值會顯示在建議的「name」欄位結尾。舉例來說，如果 name 欄位為 projects/example-project/locations/global/recommenders/google.iam.policy.Recommender/recommendations/fb927dc1-9695-4436-0000-f0f285007c0f，建議 ID 就是 fb927dc1-9695-4436-0000-f0f285007c0f。
   • ETAG：建議中 etag 欄位的值，例如 "dd0686e7136a4cbb"。使用反斜線逸出引號，例如 "\"df7308cca9719dcc\""。
   • STATE_METADATA：選用。物件，其中包含鍵/值組合，以及您選擇的建議中繼資料。例如：{"reviewedBy": "alice", "priority": "high"}。中繼資料會取代建議中的 stateInfo.stateMetadata 欄位。

   HTTP 方法和網址：

   POST https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markClaimed

   JSON 要求主體：

   {
     "etag": "ETAG",
     "stateMetadata": {
       "STATE_METADATA"
     }
   }
   

   請展開以下其中一個選項，以傳送要求：

   curl (Linux、macOS 或 Cloud Shell)

   注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

   將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "x-goog-user-project: PROJECT_ID" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markClaimed"

   PowerShell (Windows)

   注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

   將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markClaimed" | Select-Object -Expand Content

   回應會以 CLAIMED 狀態顯示建議，如下列範例所示。 為求明確，這個範例省略了大部分的欄位：

   ...
   "stateInfo": {
     "state": "CLAIMED"
   },
   "etag": "\"7caf4103d7669e12\"",
   "recommenderSubtype": "REMOVE_ROLE_STORAGE_BUCKET",
   ...
   

2. 取得專案的允許政策，然後修改允許政策，使其反映建議。

3. 如果可以套用最佳化建議，請將最佳化建議的狀態更新為 SUCCEEDED；如果無法套用，請更新為 FAILED：

   SUCCEEDED

   如要將建議標示為 SUCCEEDED，表示您已套用建議，請使用 Recommender API 的 recommendations.markSucceeded 方法。

   使用任何要求資料之前，請先修改下列項目的值：

   • PROJECT_ID：包含 Cloud Storage bucket 的Google Cloud 專案 ID。專案 ID 是英數字元字串，例如 my-project。
   • LOCATION：Cloud Storage bucket 所在的區域，例如 us 或 us-central1。
   • RECOMMENDATION_ID：建議的專屬 ID。這個值會顯示在建議的「name」欄位結尾。舉例來說，如果 name 欄位為 projects/example-project/locations/global/recommenders/google.iam.policy.Recommender/recommendations/fb927dc1-9695-4436-0000-f0f285007c0f，建議 ID 就是 fb927dc1-9695-4436-0000-f0f285007c0f。
   • ETAG：建議中 etag 欄位的值，例如 "dd0686e7136a4cbb"。使用反斜線逸出引號，例如 "\"df7308cca9719dcc\""。
   • STATE_METADATA：選用。物件，其中包含鍵/值組合，以及您選擇的建議中繼資料。例如：{"reviewedBy": "alice", "priority": "high"}。中繼資料會取代建議中的 stateInfo.stateMetadata 欄位。

   HTTP 方法和網址：

   POST https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markSucceeded

   JSON 要求主體：

   {
     "etag": "ETAG",
     "stateMetadata": {
       "STATE_METADATA"
     }
   }
   

   請展開以下其中一個選項，以傳送要求：

   curl (Linux、macOS 或 Cloud Shell)

   注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

   將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "x-goog-user-project: PROJECT_ID" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markSucceeded"

   PowerShell (Windows)

   注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

   將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markSucceeded" | Select-Object -Expand Content

   回應會以 SUCCEEDED 狀態顯示建議，如下列範例所示。 為求明確，這個範例省略了大部分的欄位：

   ...
   "stateInfo": {
     "state": "SUCCEEDED"
   },
   "etag": "\"7caf4103d7669e12\"",
   "recommenderSubtype": "REMOVE_ROLE_STORAGE_BUCKET",
   ...
   

   FAILED

   如要將建議標示為 FAILED，表示您無法套用建議，請使用 Recommender API 的 recommendations.markFailed 方法。

   使用任何要求資料之前，請先修改下列項目的值：

   • PROJECT_ID：包含 Cloud Storage bucket 的Google Cloud 專案 ID。專案 ID 是英數字元字串，例如 my-project。
   • LOCATION：Cloud Storage bucket 所在的區域，例如 us 或 us-central1。
   • RECOMMENDATION_ID：建議的專屬 ID。這個值會顯示在建議的「name」欄位結尾。舉例來說，如果 name 欄位為 projects/example-project/locations/global/recommenders/google.iam.policy.Recommender/recommendations/fb927dc1-9695-4436-0000-f0f285007c0f，建議 ID 就是 fb927dc1-9695-4436-0000-f0f285007c0f。
   • ETAG：建議中 etag 欄位的值，例如 "dd0686e7136a4cbb"。使用反斜線逸出引號，例如 "\"df7308cca9719dcc\""。
   • STATE_METADATA：選用。物件，其中包含鍵/值組合，以及您選擇的建議中繼資料。例如：{"reviewedBy": "alice", "priority": "high"}。中繼資料會取代建議中的 stateInfo.stateMetadata 欄位。

   HTTP 方法和網址：

   POST https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markFailed

   JSON 要求主體：

   {
     "etag": "ETAG",
     "stateMetadata": {
       "STATE_METADATA"
     }
   }
   

   請展開以下其中一個選項，以傳送要求：

   curl (Linux、macOS 或 Cloud Shell)

   注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

   將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

   curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "x-goog-user-project: PROJECT_ID" \
        -H "Content-Type: application/json; charset=utf-8" \
        -d @request.json \
        "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markFailed"

   PowerShell (Windows)

   注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

   將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }
   
   Invoke-WebRequest `
       -Method POST `
       -Headers $headers `
       -ContentType: "application/json; charset=utf-8" `
       -InFile request.json `
       -Uri "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.iam.policy.Recommender/recommendations/RECOMMENDATION_ID:markFailed" | Select-Object -Expand Content

   回應會以 FAILED 狀態顯示建議，如下列範例所示。 為求明確，這個範例省略了大部分的欄位：

   ...
   "stateInfo": {
     "state": "FAILED"
   },
   "etag": "\"7caf4103d7669e12\"",
   "recommenderSubtype": "REMOVE_ROLE_STORAGE_BUCKET",
   ...
   

瞭解最佳化建議

每項建議都包含相關資訊，協助您瞭解提出建議的原因。

控制台

為協助您瞭解系統提出這項建議的原因，Google Cloud 控制台會顯示主體的權限用量，這是由與建議相關聯的政策洞察回報。

注意：如果建議是針對基本角色， Google Cloud 控制台中的權限清單可能不會列出主體所需的所有權限。這是因為部分服務會使用基本角色，間接授予其他角色。即使主體使用這些額外角色，權限清單可能也不會包含這些角色的權限。角色建議會自動考量這項差異。

間接授予的角色包括透過 Cloud Storage 便利值和 BigQuery 特殊群組成員資格授予的角色。

為協助您瞭解套用建議的影響，Google Cloud 控制台也會顯示以顏色和符號標示的權限清單。這份清單會顯示套用建議後，主體的權限會如何變更。例如，系統可能會顯示如下清單：

各顏色和符號代表的權限類型如下：

• 灰色，沒有符號：主體目前角色和建議角色都有的權限。

  

• 紅色並附上減號 (-)：主體目前角色中的權限，但不在建議角色中，因為主體過去 90 天內未曾使用這些權限。

  

• 綠色加號 (+)：主體目前角色沒有的權限，但建議角色有。這類權限只會顯示在服務代理商的建議中。

  

• 藍色，並顯示「機器學習」圖示 ()： 主體的目前角色和建議角色都有的權限。這並非因為主體在過去 90 天內使用過這些權限，而是因為 Recommender 透過機器學習判斷主體日後可能需要這些權限。

  

gcloud

每項建議都包含相關資訊，協助您瞭解提出建議的原因。

如要進一步瞭解建議的欄位，請參閱Recommendation參考資料。

如要查看這項建議的權限使用情況，請查看與建議相關聯的政策深入分析。 這些洞察資料會列在 associatedInsights 欄位中。如要查看與最佳化建議相關聯的政策洞察資料，請按照下列步驟操作：

1. 複製相關洞察資料的 ID。ID 是「insight」欄位中 insights/ 後方的所有內容。舉例來說，如果 insight 欄位顯示 projects/123456789012/locations/us/insightTypes/google.iam.policy.Insight/insights/7849add9-73c0-419e-b169-42b3671173fb，洞察 ID 就是 7849add9-73c0-419e-b169-42b3671173fb。
2. 按照操作說明，使用複製的洞察 ID 取得政策洞察。

REST

每項建議都包含相關資訊，協助您瞭解提出建議的原因。

如要進一步瞭解建議的欄位，請參閱Recommendation參考資料。

如要查看這項建議的權限使用情況，請查看與建議相關聯的政策深入分析。 這些洞察資料會列在 associatedInsights 欄位中。如要查看與最佳化建議相關聯的政策洞察資料，請按照下列步驟操作：

1. 複製相關洞察資料的 ID。ID 是「insight」欄位中 insights/ 後方的所有內容。舉例來說，如果 insight 欄位顯示 projects/123456789012/locations/us/insightTypes/google.iam.policy.Insight/insights/7849add9-73c0-419e-b169-42b3671173fb，洞察 ID 就是 7849add9-73c0-419e-b169-42b3671173fb。
2. 按照操作說明，使用複製的洞察 ID 取得政策洞察。

查看、還原及復原變更

套用或關閉專案層級角色繫結的最佳化建議後，該動作會顯示在最佳化建議記錄中。

您可以在Google Cloud 控制台查看 bucket 的建議記錄：

1. 前往 Google Cloud 控制台的「Bucket」頁面。

   前往「Buckets」(值區) 頁面

2. 找出「安全性深入分析資訊」欄。如果沒有看到這個資料欄，請按一下「資料欄顯示選項」圖示 ，然後選取「安全性洞察」。

3. 找出要查看建議記錄的 bucket，然後按一下該列中的安全性深入分析摘要。

4. 在隨即顯示的「安全性建議」窗格中，按一下「建議記錄」分頁標籤。

   Google Cloud 控制台會顯示您對角色建議採取的先前動作清單。

5. 如要查看建議的詳細資料，請按一下展開箭頭。

   Google Cloud 控制台會顯示所採取動作的詳細資料，包括採取動作的主體：

   

   

6. 選用：如有需要，您可以還原最佳化建議，撤銷最佳化建議中的變更，或是還原您略過的最佳化建議。

   如要還原先前套用的建議變更，請按一下「還原」。 Google Cloud 控制台會將主體角色變更還原。該最佳化建議不會再顯示在Google Cloud 控制台。

   如要還原已關閉的建議，請按一下「還原」。建議會顯示在Google Cloud 控制台的「IAM」頁面。角色或權限不會變更。

後續步驟

• 進一步瞭解 Recommender。
• 瞭解如何使用 Cloud Storage bucket 的允許政策洞察。