サービス: storagebatchoperations.googleapis.com
エラーが発生した場合は、このカタログを参照しながら、クライアント ライブラリを使用してください。独自のライブラリを使用している場合は、デバッグやエラー解決のためにこのガイドを手元に置いておいてください。エラー レスポンスの構造の詳細については、エラーの概要ページをご覧ください。
エラーコード
次の表に、API の操作時に発生する可能性のある HTTP ステータス コードと関連するエラーを示します。各ステータス コードには、アプリケーションでエラーを効果的にトラブルシューティングして処理するのに役立つ理由と説明が 1 つ以上対応しています。説明内の波かっこ（{}）で示される変数は、リクエストに固有の値のプレースホルダを表します。
| 理由 | HTTP ステータス コード | 説明 |
|---|---|---|
JOB_ID_INVALID |
400 |
「job_id」が無効です。ジョブ ID はパターン [a-z0-9]([-a-z0-9]*[a-z0-9])? と一致する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
RESOURCE_NAME_TOO_LONG |
400 |
リソース名が最大許容長 {max_length} バイトを超えています。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
DESCRIPTION_TOO_LONG |
400 |
ジョブの「説明」が、許容される最大長 {max_length} バイトを超えています。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
SOURCE_NOT_SPECIFIED |
400 |
ジョブのソース（bucket_list または project_source）を指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
TRANSFORMATION_NOT_SPECIFIED |
400 |
ジョブに変換を指定する必要があります。変換を 1 つだけ指定します。指定できる変換は、delete_object、put_object_hold、put_metadata、rewrite_object、update_object_custom_context、set_object_acls、drop_object_google_context です。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
BUCKET_LIST_EMPTY |
400 |
bucket_list は空にできません。バケット構成を 1 つ以上指定します。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
TOO_MANY_BUCKETS |
400 |
'bucket_list' は {max_buckets} バケットを超えてはなりません。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
BUCKET_NAME_REQUIRED |
400 |
バケット構成で「bucket」フィールドを指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
OBJECT_CONFIGURATION_REQUIRED |
400 |
バケット オペレーションでオブジェクト構成（prefix_list、manifest、project_source）を指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
MANIFEST_LOCATION_REQUIRED |
400 |
'manifest_location' フィールドを指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
MANIFEST_LOCATION_INVALID |
400 |
マニフェストの場所「{manifest_location}」が無効です。ロケーションは gs://<bucket_name>/<path>/<object_name>.csv 形式に従う必要があります。ここで、<path> は省略可能で、<object_name> の後に .csv が続き、ワイルドカード文字（「*」）を 1 つだけ含めることができます。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
BUCKET_NAME_INVALID |
400 |
バケット名「{bucket_name}」が Cloud Storage バケットの命名要件に準拠していません。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
OBJECT_NAME_INVALID |
400 |
オブジェクト名「{object_name}」が Cloud Storage のオブジェクトの命名要件に準拠していません。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
OBJECT_PREFIX_INVALID_UTF8 |
400 |
オブジェクトの接頭辞に無効な UTF-8 文字が含まれています。接頭辞が有効な UTF-8 であることを確認します。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
OBJECT_PREFIX_TOO_LONG |
400 |
オブジェクトの接頭辞が、許容される最大長 {max_length} バイトを超えています。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
OBJECT_PREFIX_INVALID_CHARACTER |
400 |
オブジェクトの接頭辞に無効な改行文字または復帰文字が含まれています。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
OBJECT_PREFIX_OVERLAP |
400 |
オブジェクトの接頭辞「{prefix_1}」が「{prefix_2}」と重複しています。オブジェクトの接頭辞は、他の接頭辞の接頭辞にすることはできません。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
DUPLICATE_OBJECT_PREFIX |
400 |
「included_object_prefixes」に重複したオブジェクト接頭辞「{object_prefix}」が見つかりました。重複するエントリを削除します。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
TOO_MANY_OBJECT_PREFIXES |
400 |
prefix_list に含めるオブジェクトの接頭辞は {max_prefixes} 個以下にする必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
PROJECT_SOURCE_DRY_RUN_ID_INVALID |
400 |
dry_run_job_id が無効です。ジョブ ID はパターン [a-z0-9]([-a-z0-9]*[a-z0-9])? と一致する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
PROJECT_SOURCE_DRY_RUN_FIELDS_EXCLUSIVE |
400 |
dry_run_job_id が指定されている場合、ProjectSource の他のフィールドはすべて空にする必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
PROJECT_SOURCE_PROJECT_INVALID |
400 |
プロジェクト「{project}」が無効です。プロジェクトは、projects/{project_number} または projects/{project_id} の形式にする必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
INSIGHTS_DATASET_CONFIG_INVALID |
400 |
分析情報データセットの構成「{insights_dataset_config}」が無効です。構成リソース名は、projects/{project}/locations/{location}/datasetConfigs/{dataset_config} の形式にする必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
TARGET_LOCATIONS_REQUIRED_FOR_SNAPSHOT_TIME |
400 |
「snapshot_time」を指定する場合は、「target_locations」の「locations」フィールドを指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
TOO_MANY_TARGET_LOCATIONS |
400 |
target_locations リストは {max_locations} 個の地域を超えてはなりません。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
CEL_EXPRESSION_TOO_LONG |
400 |
フィルタ式は {max_length} バイトを超えないようにしてください。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
KMS_KEY_INVALID |
400 |
KMS 鍵が無効です。鍵は、projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key} の形式にする必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
REWRITE_OBJECT_MISSING_PARAMETERS |
400 |
「RewriteObject」には、「storage_class」または「kms_key」の少なくとも 1 つを指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
PUT_OBJECT_HOLD_MISSING_PARAMETERS |
400 |
「temporary_hold」または「event_based_hold」のいずれかを指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
PUT_METADATA_MISSING_PARAMETERS |
400 |
PutMetadata のフィールドを少なくとも 1 つ指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
RETAIN_UNTIL_TIME_REQUIRED |
400 |
retention_mode が設定されている場合、retain_until_time フィールドは RFC 3339 形式で指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
RETENTION_MODE_REQUIRED |
400 |
'retention_mode' フィールドは 'LOCKED' または 'UNLOCKED' に設定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
RETAIN_UNTIL_TIME_INVALID_FORMAT |
400 |
retain_until_time フィールドは RFC 3339 タイムスタンプ形式（例: 2026-12-31T23:59:59Z）にする必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
CUSTOM_CONTEXT_KEY_CONFLICT |
400 |
同じキーを「updates」と「keys_to_clear」の両方に指定することはできません。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
UPDATE_OBJECT_CUSTOM_CONTEXT_MISSING_ACTION |
400 |
UpdateObjectCustomContext で少なくとも 1 つのアクションを指定する必要があります。「clear_all」を指定する場合は、true に設定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
SET_OBJECT_ACLS_MISSING_ACTION |
400 |
「SetObjectAcls」で「grants」または「remove_entities」の少なくとも 1 つを指定する必要があります。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
UNSUPPORTED_ACL_ENTITY |
400 |
エンティティ「{entity}」はサポートされていません。'allUsers' と 'allAuthenticatedUsers' のみがサポートされています。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
ACL_ENTITY_CONFLICT |
400 |
同じエンティティを「grants」と「remove_entities」の両方に指定することはできません。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED |
400 |
Autoclass が有効になっているバケットでは、ストレージ クラスの変換を実行できません。バケットで Autoclass を無効にするか、ストレージ クラスの変換を削除します。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
UBLA_OBJECT_ACL_UPDATE_UNSUPPORTED |
400 |
均一なバケットレベルのアクセスが有効になっているバケット内のオブジェクトのアクセス制御リスト（ACL）を更新できません。代わりに IAM 権限を使用してアクセスを管理します。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
BUCKET_DISCOVERY_INSIGHTS_DATASET_NOT_FOUND |
404 |
バケットの検出を実行できませんでした。「insights_dataset_config」が見つかりません。分析情報データセットが存在し、アクセス可能であることを確認します。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
BUCKET_DISCOVERY_SNAPSHOT_TOO_OLD |
400 |
バケットの検出を実行できませんでした。最新のデータセット スナップショットの作成日時が 2 日以上前です。データセット構成がアクティブで、スナップショットを生成していることを確認し、snapshot_time と target_locations のオーバーライドを指定するか、代わりに CSV マニフェストを使用します。詳細については、トラブルシューティングのドキュメントをご覧ください。 |
BUCKET_DISCOVERY_TOO_MANY_BUCKETS |
400 |
バケットの検出を実行できませんでした。検出されたバケットが多すぎます。サポートされているバケットは 1,000 個のみです。詳細については、トラブルシューティングのドキュメントをご覧ください。 |