Storage Batch Operations API Version v1: Error Catalog

서비스: storagebatchoperations.googleapis.com

오류가 발생하면 클라이언트 라이브러리를 사용하는 것과 함께 이 카탈로그를 참조하세요. 자체 라이브러리를 사용하는 경우 디버깅 및 오류 해결을 위해 이 가이드를 편리하게 사용할 수 있습니다. 오류 응답 구조에 대해 자세히 알아보려면 오류 개요 페이지를 방문하세요.

오류 코드

다음 표에는 API와 상호작용할 때 발생할 수 있는 HTTP 상태 코드와 관련 오류가 나와 있습니다. 각 상태 코드는 애플리케이션에서 오류를 효과적으로 해결하고 처리하는 데 도움이 되는 하나 이상의 이유와 설명에 해당합니다. 설명 내에서 중괄호 ({})로 표시된 변수는 요청과 관련된 값의 자리표시자를 나타냅니다.

이유 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 작업 'description'이 허용되는 최대 길이인 {max_length}바이트를 초과합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
SOURCE_NOT_SPECIFIED 400 작업의 소스('bucket_list' 또는 'project_source')를 지정해야 합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
TRANSFORMATION_NOT_SPECIFIED 400 작업의 변환을 지정해야 합니다. 변환을 정확히 하나 지정합니다. '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'는 비워 둘 수 없습니다. 버킷 구성을 하나 이상 지정합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
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가 오며 와일드 카드 문자 ('*')를 최대 하나 포함합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
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 Cloud KMS 키가 잘못되었습니다. 키는 'projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}' 형식을 따라야 합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
REWRITE_OBJECT_MISSING_PARAMETERS 400 'RewriteObject'에 대해 'storage_class' 또는 'kms_key' 중 하나 이상을 지정해야 합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
PUT_OBJECT_HOLD_MISSING_PARAMETERS 400 'temporary_hold' 또는 'event_based_hold' 중 하나 이상을 지정해야 합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
PUT_METADATA_MISSING_PARAMETERS 400 'PutMetadata'에서 하나 이상의 필드를 지정해야 합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
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'에서 하나 이상의 작업을 지정해야 합니다. 'clear_all'이 지정된 경우 true로 설정해야 합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
SET_OBJECT_ACLS_MISSING_ACTION 400 'SetObjectAcls'에서 'grants' 또는 'remove_entities' 중 하나 이상을 지정해야 합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
UNSUPPORTED_ACL_ENTITY 400 항목 '{entity}'가 지원되지 않습니다. 'allUsers' 및 'allAuthenticatedUsers'만 지원됩니다. 자세한 내용은 문제 해결 문서를 참조하세요.
ACL_ENTITY_CONFLICT 400 'grants'와 'remove_entities' 모두에서 동일한 항목을 지정할 수 없습니다. 자세한 내용은 문제 해결 문서를 참조하세요.
AUTOCLASS_STORAGE_CLASS_TRANSFORMATION_UNSUPPORTED 400 자동 클래스가 사용 설정된 버킷에서는 스토리지 클래스 변환을 실행할 수 없습니다. 버킷에서 자동 클래스를 사용 중지하거나 스토리지 클래스 변환을 삭제합니다. 자세한 내용은 문제 해결 문서를 참조하세요.
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개만 지원됩니다. 자세한 내용은 문제 해결 문서를 참조하세요.