Errors

Every Storage error carries a stable numeric error_code and a machine-readable reason. This page lists the logical (domain) error codes Storage can return. For the full error envelope (the google.rpc.Status shape, the reason and metadata fields, and how codes are structured) see Errors.

Storage codes begin with 8 (for example 8300002, read as 8_300_002: service, group, specific error). The wire value is always the flat integer; you can match on either error_code or reason, both are stable.

The Status column is the canonical gRPC status the error maps to, which the gateway renders as the matching HTTP status (see the status codes table).

Code	Reason	Status	Description
8300001	NON_EMPTY_BUCKET_DELETION	INVALID_ARGUMENT	Cannot delete a non-empty bucket.
8300002	BUCKET_NOT_FOUND	NOT_FOUND	Bucket not found.
8300003	BUCKET_ALREADY_EXISTS	ALREADY_EXISTS	A bucket with this name already exists in the workspace.
8300004	BUCKET_NAME_VALIDATION	INVALID_ARGUMENT	Bucket name must match ^[a-z0-9][a-z0-9\-]{1,24}[a-z0-9]$ (3 to 26 chars).
8300005	BUCKET_WORKSPACE_ID_NOT_VALID	INVALID_ARGUMENT	Bucket workspace ID is required.
8300006	BUCKET_REGION_NOT_VALID	INVALID_ARGUMENT	Bucket region is required.
8300007	BUCKET_DEFAULT_STORAGE_CLASS_NOT_VALID	INVALID_ARGUMENT	Bucket default storage class ID is not valid.
8300008	BUCKET_PROVIDER_VALIDATION_NOT_IMPLEMENTED	INVALID_ARGUMENT	Bucket validation is not yet implemented for this provider.
8300009	BUCKET_NOT_MARKED_FOR_DELETION	FAILED_PRECONDITION	Bucket must be marked for deletion before removal.
8301001	STORAGE_CLASS_NOT_FOUND	NOT_FOUND	Storage class not found.
8301002	STORAGE_CLASS_ALREADY_EXISTS	ALREADY_EXISTS	A storage class with this name already exists in the region.
8301003	STORAGE_CLASS_NAME_VALIDATION	INVALID_ARGUMENT	Storage class name must match ^[A-Z][A-Z0-9_]{0,63}$ (1 to 64 chars, uppercase).
8301004	STORAGE_CLASS_REGION_NOT_VALID	INVALID_ARGUMENT	Storage class region is required.
8301005	STORAGE_CLASS_DATA_POOL_NOT_VALID	INVALID_ARGUMENT	Storage class data pool is required.
8301006	STORAGE_CLASS_COMPRESSION_TYPE_NOT_VALID	INVALID_ARGUMENT	Storage class compression type is not valid.
8301007	STORAGE_CLASS_NOT_MARKED_FOR_DELETION	FAILED_PRECONDITION	Storage class must be marked for deletion before removal.
8302001	OBJECT_KEY_IS_BLANK	INVALID_ARGUMENT	Object key must not be blank.
8302002	OBJECT_KEY_NOT_VALID	INVALID_ARGUMENT	Object key is not valid.
8303001	STORAGE_OPERATION_PROGRESS_OUT_OF_RANGE	INVALID_ARGUMENT	Operation progress must be between 0 and 100.
8303002	STORAGE_OPERATION_END_TIME_BEFORE_START_TIME	INVALID_ARGUMENT	Operation end time must not be before start time.