排解 Storage Intelligence 問題

本文說明如何排解 Storage Intelligence、Storage Insights 庫存報表、Storage Insights 資料集、物件擴充功能 (預覽版) 和 Storage 批次作業的常見問題。

Storage Intelligence 設定錯誤

下列各節說明設定或管理資源的 Storage Intelligence 時，可能會遇到的錯誤。

400：bucket 名稱無效

問題：要求傳回 400 Bad Request，並顯示 The specified bucket is not valid. 訊息

解決方案：要求無效。請確認要求符合下列規定：

• 使用 locations/global。Storage Intelligence 不支援其他位置。
• 確認 bucket_id_regexes 中的 bucket 名稱或規則運算式有效。

以下是有效要求的範例：

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "edition_config": "STANDARD",
      "filter": {
        "included_cloud_storage_buckets": {
          "bucket_id_regexes": [
            "my-bucket-name",
            "prod-data-.*"
          ]
        }
      }
    }' \
    "https://storage.s3nsapis.fr/v2/projects/PROJECT_ID/locations/global/intelligenceConfig?updateMask=edition_config,filter"

400：引數無效 - 更新遮罩為空白

問題：傳送設定或更新要求時，要求會傳回 400 Bad Request，並顯示 Empty UPDATE_MASK in the request. 訊息

解決方法：在要求中提供非空白的 UPDATE_MASK。UPDATE_MASK 指定要更新的 IntelligenceConfig 資源中 FieldMask 欄位的逗號分隔清單 (例如 updateMask=edition_config 或 updateMask=edition_config,filter)。

400：更新遮罩路徑無效

問題：更新設定時，要求會傳回 400 Bad Request ，並顯示訊息 Invalid UPDATE_MASK paths.

解決方案：確認 UPDATE_MASK 中的每個欄位名稱都與 IntelligenceConfig 資源中的有效欄位相符。

400：無法編輯欄位

問題：更新設定時，要求會傳回 400 Bad Request ，並顯示訊息 Invalid UPDATE_MASK: UPDATE_TIME field is not editable.

解決方法：從 UPDATE_MASK 移除無法編輯的系統欄位 (例如 UPDATE_TIME)。只能指定在 IntelligenceConfig 中定義的可變動欄位。

400：無效值

問題：要求會傳回 400 Bad Request，並顯示訊息 Invalid value at storage_intelligence.edition_config.

解決方法：將 edition_config 設為支援的值：INHERIT、STANDARD 或 DISABLED。

400：非空白篩選器

問題：要求會傳回 400 Bad Request，並顯示訊息 Non-empty filter cannot be specified for INHERIT or DISABLED edition configuration.

解決方法：從要求中移除值區篩選器。如果 edition_config 設為 INHERIT 或 DISABLED，則不支援 bucket 篩選器。

400：篩選器中的位置或值區值為空白

問題：要求會傳回 400 Bad Request，並顯示訊息 Empty location or bucket values in filter.

解決方法：請確認值區篩選器中的 location 和 bucket 都不是空字串。

儲存空間分析常見問題

本節說明如何解決目錄報表和資料集的常見問題。

每天產生多份商品目錄報表

問題：庫存報表設定每天會產生多個報表檔案。

解決方案：Cloud Storage 會對物件數量超過 100 萬個的值區，將其庫存報表進行 shard 處理，每 100 萬個物件會產生一個 shard。舉例來說，如果 bucket 包含 3,500,000 個物件，就會產生四個報表分片和一個列出每個分片的資訊清單檔案。

目的地值區中未顯示庫存報表

問題：商品目錄報表未顯示在目的地 bucket 中。

解決方法：如果報表未傳送至目的地值區，請確認下列事項：

• 確認設定的開始日期已過。詳情請參閱「建立商品目錄報表設定」。

• 查看商品目錄報表記錄，瞭解失敗情形和根本原因。如要查看商品目錄報表記錄，請完成下列步驟：

  1. 前往 Cloud de Confiance 控制台的「Cloud Storage bucket」頁面。
     

     前往「Buckets」(值區) 頁面

  2. 在 bucket 清單中，按一下含有庫存報表設定的來源 bucket 名稱。

  3. 在「Bucket details」(值區詳細資料) 頁面中，按一下「Inventory reports」(庫存報表) 分頁標籤。

  4. 在庫存報表設定清單中，按一下產生要檢查報表的庫存報表設定 UUID。

  5. 檢查「目錄報表記錄」部分是否有失敗情形。將游標懸停在「Help」(說明) 圖示 help 上，即可查看失敗原因的詳細資料。

• 請確認專案層級服務代理具備讀取及寫入庫存報表所需的 IAM 角色。詳情請參閱「授予服務代理必要的角色」。

廣告空間報表延遲

問題：系統延遲產生資產盤點清單報表。

解決方法：報表產生時間不一。最多延遲 24 小時是正常現象。

資料集未填入資料

問題：儲存空間分析資料集資料表仍為空白。

解決方法：在連結的 BigQuery 資料集中，檢查 error_attributes_view錯誤代碼。詳情請參閱「排解資料集錯誤」。

查詢資料集時，「ref」欄中出現空值

問題：在 BigQuery 中查詢儲存空間分析資料集時，ref 欄會傳回 null。

解決方法：如果物件結尾為 /，資料集中的 ref 欄會是空值。

在 BigQuery 中查詢 Storage Insights 資料集時，如果 ref 資料欄傳回空值，請確認您已授予必要的連線權限和角色，包括 Cloud Storage 資源的存取權，詳情請參閱「使用 BigQuery 分析物件資料和中繼資料」。

object enrichments 錯誤

本節說明如何解決設定、產生或查詢物件擴充功能時的常見問題。

物件缺少擴充功能

問題：設定 object enrichments 後，物件未顯示 object enrichments。

解決方法：請確認下列事項：

• 服務代理權限：請務必將目標 bucket (或專案) 的 roles/storage.annotationGeneratorService 角色，以及專案的 roles/storage.bucketViewer 角色，授予物件擴充服務代理。如需操作說明，請參閱「授予服務代理權限」。
• 篩選器和範圍設定：確認 FeatureConfig 資源明確包含目標 bucket 名稱。Cloud Storage 不會自動納入在您建立 FeatureConfig 資源後建立的值區。此外，如果刪除並重新建立或重新放置 bucket，則必須更新 FeatureConfig 資源，才能重新納入 bucket。
• 模型必要條件和 Content-Type 中繼資料：確認物件符合已啟用模型的內容類型和大小限制。Cloud Storage 會使用物件的 Content-Type 中繼資料欄位判斷資格 (圖片為 BMP、GIF、ICO、JPEG、PNG、TIFF 或 WEBP；PDF 分類為 application/pdf)。如果 Content-Type 中繼資料遺失或有誤，Cloud Storage 會等到您更新中繼資料後，才會處理物件。此外，object enrichments 服務會略過大於 20 MiB 的物件。詳情請參閱「支援的模型和結構定義」。
• 處理延遲時間：請預留足夠時間，讓系統進行非同步處理。物件資料充實服務會以非同步方式處理物件。新上傳物件的擴充資料通常會在幾小時內顯示。相較之下，在大型值區中回填現有物件可能需要數小時或數天。

BigQuery 中未顯示物件擴充功能

問題：API 中顯示物件擴充功能，但 BigQuery 中未顯示。

解決方案：請檢查下列事項：

• 儲存空間分析資料集設定：確認您已為 bucket 設定儲存空間分析資料集。
• 每日報表時間安排：等待每日資料集更新。儲存空間分析 資料集每 24 小時更新一次。因此，新產生的擴充資料最多可能需要 24 小時，才會顯示在 BigQuery 的 object_contexts_catalog_view 檢視畫面中。
• IAM 權限：請確認您具備在 BigQuery 中執行工作和讀取資料的權限 (例如 roles/bigquery.jobUser 和 roles/bigquery.dataViewer)。如需查詢指引，請參閱「在 BigQuery 中分析物件擴充功能」。

權限遭拒，無法擷取擴充物件強化資料

問題：擷取擴充物件強化資料時，發生權限錯誤。

解決方案：您必須具備物件或 bucket 的 storage.objects.viewFullContext 權限，才能擷取擴充資料，例如定界框座標或類別可信度分數。Storage 物件使用者 (roles/storage.objectUser) 和 Storage 管理員 (roles/storage.admin) 等角色都包含這項權限。詳情請參閱「管理物件擴充功能」。

權限遭拒，無法管理功能設定

問題：建立、更新或刪除 FeatureConfig 時發生權限錯誤。

解決方案：確認您的帳戶在目標專案中具備「儲存空間管理員」roles/storage.admin 角色，或是具備必要權限的自訂角色。這些必要權限包括 storage.featureConfigs.create、storage.featureConfigs.update 或 storage.featureConfigs.delete。如要瞭解方法專屬權限，請參閱「設定物件擴充」和「featureConfigs API 資源」。

儲存空間批次作業工作驗證錯誤

本節說明向 storagebatchoperations.googleapis.com 提交批次作業工作要求時發生的驗證錯誤。

400：工作 ID 或資源名稱無效

問題：工作建立要求傳回 400 Bad Request (INVALID_ARGUMENT) 回應，原因為 JOB_ID_INVALID 或 RESOURCE_NAME_TOO_LONG。

解決方案：確認工作 ID 是由 1 至 63 個小寫英數字元或連字號 ([a-z0-9]([-a-z0-9]*[a-z0-9])?) 組成，且完整工作資源路徑 (projects/PROJECT_ID/locations/LOCATION/jobs/JOB_ID) 不超過 200 個位元組。如果路徑超過 200 個位元組，請縮短工作 ID。詳情請參閱「工作名稱」。

400：職務說明超過上限

問題：工作建立要求傳回 400 Bad Request (INVALID_ARGUMENT) 回應，原因為 DESCRIPTION_TOO_LONG。

解決方法：確認工作說明不超過 1,024 個位元組。如果超過上限，請縮短文字。詳情請參閱「職位說明」。

400：缺少或無效的徵才來源設定

問題：工作建立要求會傳回 400 Bad Request (INVALID_ARGUMENT) 回應，原因如下：

• SOURCE_NOT_SPECIFIED
• BUCKET_LIST_EMPTY
• TOO_MANY_BUCKETS
• MULTI_BUCKET_NOT_SUPPORTED
• BUCKET_NAME_REQUIRED
• OBJECT_CONFIGURATION_REQUIRED

解決方案：請確認工作指定有效的來源設定 (bucket_list 或 project_source)，且每個 bucket 都定義了物件選取方法。詳情請參閱「建立及管理批次作業工作」。

400：bucket 或物件名稱無效

問題：工作建立要求會傳回 400 Bad Request (INVALID_ARGUMENT) 回應，原因為 BUCKET_NAME_INVALID 或 OBJECT_NAME_INVALID。

解決方法：請確認所有 bucket 和物件名稱都符合 Cloud Storage 命名規定。詳情請參閱「Bucket 命名規範」和「物件命名規範」。

400：專案來源設定錯誤

問題：工作建立要求會傳回 400 Bad Request (INVALID_ARGUMENT) 回應，原因如下：

• PROJECT_SOURCE_PROJECT_INVALID
• PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE
• PROJECT_SOURCE_DRY_RUN_ID_INVALID

解決方法：確認專案來源設定符合格式和欄位專屬性規定。如果指定模擬測試工作 ID，請省略所有其他 project_source 參數。詳情請參閱「使用進階篩選器建立工作」。

400：轉換參數衝突或遺漏

問題：工作建立要求會傳回 400 Bad Request (INVALID_ARGUMENT) 回應，原因如下：

• TRANSFORMATION_NOT_SPECIFIED
• REWRITE_OBJECT_MISSING_PARAMETERS
• PUT_OBJECT_HOLD_MISSING_PARAMETERS
• PUT_METADATA_MISSING_PARAMETERS

解決方案：請指定一種轉換類型，並提供所有必要參數。如要設定物件保留，請確認值區已啟用物件鎖定功能，且時間戳記採用 RFC 3339 UTC 格式。如要進一步瞭解各項轉換的參數需求，請參閱「工作類型」。

400：物件前置字串重疊或重複

問題：工作建立要求會傳回 400 Bad Request (INVALID_ARGUMENT) 回應，原因為 OBJECT_PREFIX_OVERLAP 或 DUPLICATE_OBJECT_PREFIX。

解決方案：移除重複的前置字串，並確保 included_object_prefixes 中沒有任何前置字串與清單中的其他項目相同。詳情請參閱「物件前置字元」。

400：資訊清單檔案格式和存取問題

問題：工作建立要求會傳回 400 Bad Request (INVALID_ARGUMENT) 回應，原因為 MANIFEST_LOCATION_REQUIRED 或 MANIFEST_LOCATION_INVALID，或工作無法讀取資訊清單。

解決方法：確認資訊清單 URI 是有效的 CSV 路徑 (gs://<bucket_name>/<path>/<object_name>.csv)，且儲存空間批次作業服務代理程式在資訊清單值區中具有 roles/storage.objectViewer 角色。如要進一步瞭解 CSV 格式和結構定義規定，請參閱「資訊清單」。

400：儲存空間分析資料集探索錯誤

問題：使用儲存空間分析資料集探索物件時，傳回 400 Bad Request (INVALID_ARGUMENT 或 FAILED_PRECONDITION) 回應，並顯示下列任一原因：

• BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD
• TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME
• BUCKET_DISCOVERY_TOO_MANY_BUCKETS

解決方法：確認 snapshot_time 位於過去 48 小時內，為 bucket 指定 target_locations，並確保探索查詢符合的 bucket 不超過 1,000 個。詳情請參閱「使用儲存空間分析資料集建立資訊清單」。

400：已啟用 Autoclass 的 bucket 無法轉換儲存空間級別

問題：工作建立要求會傳回 400 Bad Request (FAILED_PRECONDITION) 回應，並附上原因 AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED。

解決方案：如果 bucket 已啟用自動調整級別功能，就無法執行儲存空間級別轉換。您可以指定沒有自動調整級別功能的值區，或是移除儲存空間級別轉換。詳情請參閱「Autoclass 限制」。

400：無法在統一 bucket 層級存取權 bucket 中更新物件 ACL

問題：工作建立要求會傳回 400 Bad Request (FAILED_PRECONDITION) 回應，並附上原因 UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED。

解決方案：如果 bucket 啟用統一 bucket 層級存取權，就無法更新物件 ACL。請改用 bucket 或專案層級的 IAM 角色管理存取權。詳情請參閱「統一 bucket 層級存取權」。

儲存空間批次作業執行階段和執行問題

本節說明非同步執行批次作業工作時發生的問題。

403：執行期間發生權限錯誤

問題：批次工作在執行期間失敗，並顯示 403 Forbidden (PERMISSION_DENIED)。

解決方案：將轉換類型所需的 IAM 角色，授予儲存空間批次作業服務代理 (service-PROJECT_NUMBER@gcp-sa-storagebatchoperations.s3ns-system.iam.gserviceaccount.com)。詳情請參閱「授予服務代理權限」。

物件重寫期間發生 CMEK 加密錯誤

問題：由於 Cloud KMS 金鑰狀態或權限錯誤，物件重寫失敗，並顯示 400 Bad Request 或 403 Forbidden。

解決方案：確認 Cloud KMS 金鑰為 Enabled，且與目標 bucket 位於相同區域，以及服務代理具備 roles/cloudkms.cryptoKeyEncrypterDecrypter 角色。詳情請參閱「工作類型：重寫物件」。

error_summaries 中的失敗次數偏高

問題：批次工作完成時，counters.failed_object_count 非零，且 error_summaries 中有錯誤代碼 (例如 404 NOT_FOUND、412 FAILED_PRECONDITION 或 403 PERMISSION_DENIED)。

解決方法：使用 --location 標記 (例如 gcloud storage batch-operations jobs describe JOB_ID --location=LOCATION) 執行 gcloud storage batch-operations jobs describe，查看匯總的錯誤細目，並檢查 Cloud Logging 的每個物件錯誤記錄。詳情請參閱「取得工作詳細資料」。

快照已超過兩天，因此儲存空間批次作業工作失敗

問題：建立以 CEL 篩選器為基礎的儲存空間批次作業工作時，工作建立作業會失敗。錯誤訊息指出快照時間已超過兩天。

解決方法：為避免對過時的物件狀態執行操作，儲存空間批次作業會自動停止建立工作。如果所選快照的建立時間超過兩天，就會發生這種情況。請選取下列任一做法來解決這個問題：

• 使用資訊清單檔案：在 BigQuery 中手動查詢資料集。將結果匯出至 CSV 資訊清單檔案，然後將該檔案上傳至 Cloud Storage bucket。然後使用資訊清單方法建立批次作業，即可避開兩天限制。
• 檢查資料集設定：確認資料集設定已啟用，而非暫停狀態。確認資料集快照順利執行。如要瞭解如何驗證設定，請參閱「查看資料集設定」。
• 使用目標位置和快照時間覆寫：指定 --target-snapshot-time 旗標，以 RFC 3339 格式明確選取快照，略過兩天過時失敗。指定 --target-locations 旗標，將作業限制在有快照的位置。您可以運用這些覆寫設定，解決導致自動全域快照無法更新的同步延遲問題。因此，您可以手動指定較新的區域性快照。如需指令語法，請參閱「使用進階篩選器建立工作」。

新訂閱的專案無法執行以 CEL 篩選器為基礎的儲存空間批次作業工作

問題：在剛訂閱的專案上執行以 CEL 篩選器為準的儲存空間批次作業工作時，系統找不到有效的快照，因此作業會失敗。

解決方法：啟用 Storage Intelligence 訂閱方案後，必須等待 24 小時，才能執行以 CEL 篩選器為準的儲存空間批次作業工作。這段延遲時間可讓系統執行初始中繼資料快照，並建立起始快照時間。

以 CEL 篩選器為基礎的儲存空間批次作業工作失敗，並顯示權限錯誤或擲回執行階段錯誤

問題：執行以 CEL 篩選器為基礎的儲存空間批次作業工作時失敗，或傳回執行階段權限錯誤。

解決方法：儲存空間批次作業會使用您的使用者憑證處理物件。如果沒有目標 bucket 和物件的必要 IAM 讀取者或寫入權限，工作就會失敗。如果 CEL 篩選器選取了您無權存取的資源，就會發生這個問題。確認您的帳戶具備 Storage 管理員 (roles/storage.admin)、Storage 物件管理員 (roles/storage.objectAdmin) 或同等角色，可存取工作範圍內的所有 bucket 和物件。如要瞭解如何授予角色，請參閱「使用 IAM 權限」。

監控與記錄分析

如要進一步瞭解如何檢查 Cloud Logging 中每個物件的執行失敗情形和錯誤酬載，請參閱「查看儲存空間批次作業記錄」。

Storage Intelligence 建議工具問題

本節提供指南，說明如何解決使用Storage Intelligence 顧問時常見的問題。

Storage Intelligence 建議工具權限遭拒錯誤

問題：存取 Storage Intelligence 顧問時收到 Permission denied 錯誤，且圖表和指標為空白或顯示權限錯誤。

解決方法：如果沒有具備必要權限的 IAM 角色，就無法查看 Storage Intelligence 顧問。請要求管理員授予您要查看的專案、資料夾或組織的「儲存空間管理員」(roles/storage.admin) 角色。如需必要權限清單，請參閱「必要角色」。

權限不足，無法查看受影響的專案

問題：在組織或資料夾層級查看發現項目時，「偵測到發現項目的專案」面板會顯示警告指標，並在專案旁顯示「You've insufficient permission to access this project」訊息。

解決方案：如果您有權在組織或資料夾層級查看 Storage Intelligence 建議，但缺少該特定專案的必要 IAM 權限，就會發生這個問題。請專案管理員授予您受影響專案的「Storage 管理員」角色 (roles/storage.admin)。

Storage Intelligence 建議工具空白或缺少資料

問題：Storage Intelligence Advisor 頁面載入後，「At a glance」(一覽) 部分 (標示為「Project at a glance」(專案一覽)、「Folder at a glance」(資料夾一覽) 或「Organization at a glance」(組織一覽)，視所選資源而定) 或「Top findings」(主要發現項目) 部分的圖表和指標為空白，或資料已過時。

解決方案：這個問題可能是下列原因所致：

• 資料處理延遲時間：Storage Intelligence 指標和發現項目仰賴每日快照和儲存空間用量分析。資料可能需要 24 到 48 小時，才會顯示在 Storage Intelligence 建議工具中。這類延遲通常發生在您建立新 bucket 後，或是首次查看 Storage Intelligence 顧問時。如果想查看最近的活動資料，請等待 48 小時後再查看。
• 沒有儲存空間資源：如果所選專案、資料夾或機構在所選時間範圍內沒有任何 bucket 或物件，Storage Intelligence 顧問就會顯示空白畫面。選擇含有儲存空間資源的其他專案、資料夾或機構。
• 時間篩選條件不正確：時間篩選條件設為沒有儲存空間活動的範圍。將時間篩選器調整為包含儲存空間活動的範圍。

Storage Intelligence 建議工具未顯示發現項目

問題：您預期「主要發現項目」部分會根據最近的儲存空間活動顯示發現項目，但該部分卻是空白。

解決方法：如果 Storage Intelligence 顧問在所選時間範圍內未產生任何發現項目，就會發生這個問題。可能的原因如下：

• 沒有相符的模式：最近一次分析週期未偵測到符合發現項目模式的儲存行為。
• 資料處理延遲：調查結果會依據儲存空間指標，而這些指標需要 24 到 48 小時才能處理完畢。過去 24 小時內發生的事件，其發現項目會在下一個處理週期完成後顯示。

使用 VPC Service Controls 時的問題

問題：嘗試從 VPC Service Controls service perimeter 內的專案存取 Storage Intelligence 建議工具時，收到存取遭拒或權限錯誤訊息。

解決方案：如果 VPC Service Controls 設定不正確，無法在專案、 Cloud de Confiance 控制台和 Storage Intelligence 資源之間通訊，就會發生這個問題。如要解決這個問題，請確認是否符合下列規定：

• 受限服務：確認服務安全防護範圍是否限制 Cloud Storage API (storage.googleapis.com) 和 Storage Insights (storageinsights.googleapis.com) API。詳情請參閱「列出並說明服務參數」。
• 範圍設定：確認您用來查看 Storage Intelligence 顧問的專案，與您監控的專案位於同一個服務範圍。如果兩者位於不同 perimeter，您必須設定輸入和輸出規則，或使用 perimeter bridge。
• 從範圍外存取：如果您從範圍外的網路存取 Cloud de Confiance 控制台，則必須建立輸入規則或存取層級，其中包含您的使用者帳戶和您使用的公用 IP 位址範圍。
• Shared VPC：如果您使用 Shared VPC，請確認專案與服務專案位於相同的 service perimeter。詳情請參閱「Shared VPC」。
• 稽核記錄：使用違規分析工具，檢查稽核記錄中的 VPC Service Controls 違規事項。違規分析工具可協助診斷違規情形並找出原因，例如 RESOURCES_NOT_IN_SAME_SERVICE_PERIMETER 錯誤。

後續步驟

• Storage Intelligence 總覽
• 設定及管理 Storage Intelligence
• 物件擴充功能總覽
• 建立及管理批次作業工作
• 使用 BigQuery 分析物件資料和中繼資料