Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Storage Intelligence の問題のトラブルシューティング

このドキュメントでは、 Storage Intelligence、Storage Insights インベントリレポート、 Storage Insights データセット、およびストレージバッチオペレーションに関する一般的な問題のトラブルシューティング方法について説明します。

Storage Intelligence の構成エラー

以降のセクションでは、リソースの Storage Intelligence の構成または管理時に発生する可能性のあるエラーについて説明します。

400: バケット名が無効です

問題: リクエストが 400 Bad Request を返し、メッセージ The specified bucket is not valid.

解決策: リクエストが無効です。リクエストが次の要件を満たしていることを確認してください。

locations/global を使用してください。Storage Intelligence は他のロケーションをサポートしていません。
bucket_id_regexes のバケット名または正規表現が有効であることを確認します。

有効なリクエストの例を次に示します。

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./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_TIME など）を UPDATE_MASK から削除します。 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 に設定されている場合、サポートされていません。

400: フィルタ内のロケーションまたはバケットの値が空です

問題: リクエストが 400 Bad Request を返し、メッセージ Empty location or bucket values in filter.

解決策: location と bucket のどちらも空の文字列でないことをバケットフィルタで確認します。

Storage Insights の一般的な問題

このセクションでは、インベントリレポートとデータセットに関する一般的な問題を解決する方法について説明します。

毎日複数のインベントリレポートが生成される

問題: インベントリレポートの構成で、毎日複数のレポートファイルが生成されます。

ソリューション: Cloud Storage は、1,000,000 個を超えるオブジェクトを含むバケットのインベントリレポートをシャード化し、1,000,000 個のオブジェクトごとに 1 つのシャードを生成します。たとえば、3,500,000 個のオブジェクトを含むバケットでは、4 つのレポートシャードと、各シャードを一覧表示するマニフェストファイルが生成されます。

インベントリレポートが宛先バケットに表示されない

問題: インベントリレポートが宛先バケットに表示されません。

解決策: レポートが宛先バケットに配信されない場合は、次のことを確認してください。

構成された開始日が過ぎていることを確認します。詳細については、インベントリレポート構成を作成するをご覧ください。
インベントリレポートの履歴を表示して、不具合とその根本原因を確認します。インベントリレポートの履歴を表示する手順は次のとおりです。
1. Google Cloud コンソールで Cloud Storage の [バケット] ページに移動します。
  [バケット] に移動
2. バケットのリストで、インベントリレポートの構成を含むソースバケットの名前をクリックします。
3. [バケットの詳細] ページで、[インベントリレポート] タブをクリックします。
4. インベントリレポートの構成のリストで、確認するレポートを生成したインベントリレポート構成の UUID をクリックします。
5. [インベントリレポートの履歴] セクションで不具合を確認します。[ヘルプ]（）にカーソルを合わせると、不具合が発生した理由の詳細が表示されます。
プロジェクトレベルのサービスエージェントに、インベントリレポートの読み取りと書き込みに必要な IAM ロールが付与されていることを確認します。詳細については、サービスエージェントに必要なロールを付与するをご覧ください。

インベントリレポートの遅延が発生する

問題: インベントリレポートの生成が遅延します。

解決策: レポートの生成時間は異なります。最大 24 時間の遅延は正常です。

データセットが入力されない

問題: Storage Insights データセットテーブルが空のままです。

解決策: リンクされた BigQuery データセットで、 error_attributes_view にエラーコードがないか確認します。詳細については、データセットエラーのトラブルシューティングをご覧ください。

データセットのクエリ時に [ref] 列に null 値が表示される

問題: BigQuery で Storage Insights データセットをクエリすると、 ref 列に null が返されます。

解決策: / で終わるオブジェクトの場合、データセットの ref 列は null です。

BigQuery で Storage Insights データセットをクエリしたときに ref 列に null 値が返される場合は、BigQuery を使用してオブジェクトデータとメタデータを分析するで説明されているように、Cloud Storage リソースへのアクセスなど、必要な接続権限とロールが付与されていることを確認してください。

ストレージバッチオペレーションジョブの検証エラー

このセクションでは、バッチオペレーションジョブのリクエストを 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])?）で構成され、リソースパス全体の長さが 1,024 バイトを超えていないことを確認します。詳細については、ジョブ名をご覧ください。

400: 変換パラメータが競合しているか、欠落している

問題: ジョブ作成リクエストが 400 Bad Request（INVALID_ARGUMENT）レスポンスを返し、理由が TRANSFORMATION_NOT_SPECIFIED、 REWRITE_OBJECT_MISSING_PARAMETERS、PUT_OBJECT_HOLD_MISSING_PARAMETERS、または PUT_METADATA_MISSING_PARAMETERS です。

解決策: 必要なパラメータをすべて指定して、変換タイプを 1 つだけ指定します。オブジェクトの保持を構成する場合は、オブジェクトロックがバケットで有効になっていることと、タイムスタンプが 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）であり、 Storage バッチオペレーションサービスエージェントにマニフェストバケットに対する roles/storage.objectViewer ロールがあることを確認します。CSV の形式とスキーマ要件の詳細については、マニフェストをご覧ください。

400: Storage Insights データセットの検出エラー

問題: オブジェクト検出に Storage Insights データセットを使用すると、 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 時間以内であることを確認し、バケットの target_locations を指定して、検出クエリが 1,000 個以下のバケットと一致するようにします。詳細については、Storage Insights データセットを使用してマニフェストを作成するをご覧ください。

400: Autoclass が有効なバケットでストレージクラスの変換が失敗する

問題: ジョブ作成リクエストが 400 Bad Request (FAILED_PRECONDITION) レスポンスを返し、理由が AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED です。

解決策: Autoclass が有効なバケットでストレージクラスの変換を実行することはできません。Autoclass がないバケットをターゲットにするか、ストレージクラスの変換を削除します。詳細については、Autoclass の制限事項をご覧ください。

400: 均一なバケットレベルのアクセスバケットでオブジェクト ACL の更新が失敗する

問題: ジョブ作成リクエストが 400 Bad Request (FAILED_PRECONDITION) レスポンスを返し、理由が UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED です。

解決策: 均一なバケットレベルのアクセスが有効になっているバケットでオブジェクト ACL を更新することはできません。代わりに、バケットまたはプロジェクトレベルで IAM ロールを使用してアクセスを管理します。詳細については、均一なバケットレベルのアクセスをご覧ください。

ストレージバッチオペレーションのランタイムと実行に関する問題

このセクションでは、バッチオペレーションジョブの非同期実行中に発生する問題について説明します。

403: 実行中の権限エラー

問題: バッチジョブが実行中に失敗し、403 Forbidden （PERMISSION_DENIED）が返されます。

解決策: ストレージバッチオペレーションサービスエージェント（service-PROJECT_NUMBER@gcp-sa-storagebatchoperations.）に、変換タイプに必要な IAM ロールを付与します。詳細については、サービスエージェントに権限を付与するをご覧ください。

オブジェクトの書き換え中の CMEK 暗号化エラー

問題: Cloud KMS 鍵のステータスまたは権限エラーにより、オブジェクトの書き換えが 400 Bad Request または 403 Forbidden で失敗します。

解決策: Cloud KMS 鍵が Enabled であり、ターゲットバケットと同じリージョンに存在し、サービスエージェントに roles/cloudkms.cryptoKeyEncrypterDecrypter ロールがあることを確認します。詳細については、サービスの種類: オブジェクトの書き換えをご覧ください。

error_summaries の失敗回数が多い

問題: バッチジョブが完了し、counters.failed_object_count がゼロ以外で、error_summaries にエラーコード（404 NOT_FOUND、412 FAILED_PRECONDITION、403 PERMISSION_DENIED など）が含まれています。

ソリューション: gcloud storage batch-operations jobs describe を --location フラグを指定して実行し（例: gcloud storage batch-operations jobs describe JOB_ID --location=LOCATION）、集計されたエラーの内訳を表示します。また、オブジェクトごとのエラーログについては Cloud Logging を確認します。詳細については、ジョブの詳細を取得するをご覧ください。

2 日以上前のスナップショットが原因でストレージバッチオペレーションジョブが失敗する

問題: CEL フィルタに基づくストレージバッチオペレーションジョブを作成すると、ジョブの作成が失敗します。エラーメッセージには、スナップショットの時刻が 2 日以上前であることが示されます。

解決策: 古いオブジェクトの状態に対するアクションを防ぐため、ストレージバッチオペレーションではジョブの作成が自動的に失敗します。このエラーは、選択したスナップショットが 2 日以上前の場合に発生します。この問題を解決するには、次のいずれかの方法を選択します。

マニフェストファイルを使用する: BigQuery でデータセットを手動でクエリします。結果を CSV マニフェストファイルにエクスポートし、そのファイルを Cloud Storage バケットにアップロードします。マニフェストメソッドを使用してバッチオペレーションジョブを作成すると、2 日間の制限を回避できます。
データセットの構成を確認する: データセットの構成が有効で、一時停止していないことを確認します。データセットのスナップショットが正常に実行されることを確認します。構成を確認する方法については、データセットの構成を表示するをご覧ください。
ターゲットロケーションとスナップショット時刻のオーバーライドを使用する: --target-snapshot-time フラグを指定して、RFC 3339 形式でスナップショットを明示的に選択することで、2 日間の有効期限切れエラーを回避します。--target-locations フラグを指定して、スナップショットが存在するロケーションにオペレーションを制限します。これらのオーバーライドを使用すると、自動化されたグローバルスナップショットの更新を妨げる同期の遅延を解決できます。その結果、より新しいリージョンスナップショットを手動でターゲットにできます。コマンド構文については、高度なフィルタを使用してジョブを作成するをご覧ください。

CEL フィルタに基づくストレージバッチオペレーションジョブが、新しくサブスクライブしたプロジェクトで失敗する

問題: 新しくサブスクライブしたプロジェクトで CEL フィルタに基づくストレージバッチオペレーションジョブを実行すると、有効なスナップショットが見つからないため失敗します。

解決策: Storage Intelligence サブスクリプションを有効にした後、CEL フィルタに基づくストレージバッチオペレーションジョブを実行するまでに 24 時間待つ必要があります。この遅延により、システムは最初のメタデータスナップショットを実行し、開始スナップショット時刻を確立できます。

CEL フィルタに基づくストレージバッチオペレーションジョブが権限エラーで失敗するか、ランタイムエラーが発生する

問題: CEL フィルタに基づくストレージバッチオペレーションジョブが実行中に失敗するか、ランタイム権限エラーが返されます。

解決策: ストレージバッチオペレーションでは、ユーザーの認証情報を使用してオブジェクトを処理します。ターゲットのバケットとオブジェクトに必要な IAM 閲覧者または書き込み権限がない場合、ジョブは失敗します。この問題は、CEL フィルタがアクセスできないリソースを選択した場合に発生します。アカウントに、ジョブのスコープ内のすべてのバケットとオブジェクトに対するストレージ管理者（roles/storage.admin）、ストレージオブジェクト管理者（roles/storage.objectAdmin）、または同等のロールがあることを確認します。ロールの付与手順については、IAM 権限を使用するをご覧ください。

モニタリングとログ分析

Cloud Logging でオブジェクトごとの実行エラーとエラーペイロードを検査する方法については、ストレージバッチオペレーションログを表示するをご覧ください。

Storage Intelligence の問題のトラブルシューティング コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。