Códigos de error y estado HTTP para XML

El siguiente documento proporciona información de referencia sobre los mensajes de error y los códigos de estado que se usan en la API de XML de Cloud Storage. Para ver los mensajes de error y los códigos de estado que usa la API de JSON de Cloud Storage, consulta esta página.

Formato de la respuesta de error

Cloud Storage usa el formato estándar de informe de errores HTTP. Las solicitudes exitosas muestran códigos de estado HTTP en el rango de 2xx. Las solicitudes fallidas muestran códigos de estado en los rangos 4xx y 5xx. Las solicitudes que requieren un redireccionamiento muestran los códigos de estado en el rango de 3xx. Por lo general, las respuestas de error incluyen un documento XML en el cuerpo de la respuesta, que contiene información sobre el error.

El siguiente es un ejemplo de una respuesta de error.

HTTP/1.1 409 Conflict
Content-Type: application/xml
Content-Length: 182
Date: Wed, 03 Mar 2010 00:22:00 GMT
Expires: Wed, 03 Mar 2010 00:22:00 GMT
Cache-Control: private, max-age=0

<?xml version='1.0' encoding='utf-8'?> <Error> <Code>BucketNameUnavailable</Code> <Message> The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again. </Message> </Error>

En la siguiente tabla, se describen los elementos que se incluyen en el cuerpo de la respuesta:

Elemento Descripción
Error Contenedor para la información de error.
Code Nombre del error
Message Descripción del error.

Códigos de estado y error HTTP

Las siguientes son descripciones del estado HTTP y los códigos de error que usa Cloud Storage.

301— Movido de forma permanente

Nombre del error Descripción
Redireccionamiento permanente Se debe tratar el depósito al que intentas acceder con el extremo especificado. Envía todas las solicitudes futuras a este extremo.

304—No modificado

Nombre del error Descripción
No modificado El recurso que solicitó no se modificó en función de la condición que especificó.

307— Redireccionamiento temporal

Nombre del error Descripción
Redirect Redireccionamiento temporal.
Redireccionamiento temporal Estás siendo redireccionando al depósito mientras se actualiza el DNS.

308: Reanudación incompleta

Nombre del error Descripción
Reanudación incompleta Indica una carga reanudable incompleta y proporciona el rango de bytes que ya recibió Cloud Storage.

400—Solicitud incorrecta

Nombre del error Descripción
AmbiguousProByEmailAddress La dirección de correo electrónico que proporcionaste está asociada con más de una cuenta.
Mal resumen El contenido MD5 que especificaste no coincide con lo que recibimos.
CloudKmsBadKey Clave incorrecta de Cloud KMS
CloudKmsCannotChangeKeyName El nombre de clave de Cloud KMS no se puede cambiar.
CloudKmsDecryptionKeyNotFound No se encontró la clave de desencriptación del recurso Cloud KMS del recurso.
CloudKmsDisabledKey La clave de Cloud KMS está inhabilitada, destruida o está programada para su destrucción.
CloudKmsEncryptionKeyNotFound No se encontró la clave de encriptación de Cloud KMS.
CloudKmsKeyLocationNotAllowed No se permite la ubicación de la clave de Cloud KMS.
No se admiten las credenciales Esta solicitud no es compatible con credenciales.
Crusmatch El CRC32C que especificaste no coincide con lo que calculamos.
El algoritmo EncriptaciónEncryptionAlgo no es válido Falta un algoritmo de encriptación o el algoritmo proporcionado no es “AE256”.
CustomerEncryptionKeyFormatIsInvalid no válido. Falta una clave de encriptación, o no está codificada en Base64, o no cumple con la longitud requerida del algoritmo de encriptación.
CustomerEncryptionKeyIsIncorrect La clave de encriptación proporcionada es incorrecta.
CustomerEncryptionKeySha256IsInvalid Falta un hash SHA256 de la clave de encriptación o no está codificado en Base64 o no coincide con la clave de encriptación.
DottyBucketNameNotUnderTld El depósito especificado contiene un "." pero no en un dominio de nivel superior reconocido.
Entidad demasiado pequeña La carga propuesta es más pequeña que el tamaño mínimo del objeto permitido.
Entidad demasiado grande La carga propuesta supera el tamaño máximo de objeto permitido.
ExcessHeaderValues Varios valores de encabezado HTTP en los que se esperaba uno.
Venció el token El token proporcionado caducó.
Cuerpo incompleto No proporcionó la cantidad de bytes especificados por el encabezado HTTP de longitud de contenido.
NumberNumberOfFilesInPostRequest POST requiere exactamente una carga de archivo por solicitud.
IllegalEndpoint Los extremos de solo carga y de descarga solo se pueden usar para subir o descargar objetos, respectivamente.
InlineDataTooLarge Los datos intercalados superan el tamaño máximo permitido.
Argumento no válido Argumento no válido.
Nombre de depósito no válido El depósito especificado no es válido.
Recuento de componentes no válidos Se intentó componer un elemento con demasiados o demasiados componentes en la solicitud.
Tipo de referencia no válido El CRC32c que especificaste no era válido.
Resumen no válido El contenido MD5 que especificaste no era válido.
Nombre de depósito no válido El depósito especificado contiene un "." pero no es válido sintácticamente.
Hash no válido El encabezado x-goog-hash que especificaste no era válido.
Restricción de ubicación no válida La restricción de ubicación especificada no es válida. No puedes especificar ubicaciones con la API de Cloud Storage.
Política no válida El contenido del formulario no cumple con las condiciones especificadas en el documento de la política.
StorageClass no válido La clase de almacenamiento que especificaste no es válida.
Combinación deUbicación de restricción no válida No se admite esta combinación de ubicación y clase de almacenamiento especificada. En particular, los depósitos regionales no admiten MULTI_REGIONAL de almacenamiento, y los depósitos multirregionales no admiten REGIONAL Storage.
Nombre de objeto no válido El nombre del objeto especificado no es válido.
TargetTargetBucketLogging El depósito de destino para el registro no existe o no otorga permiso de escritura al grupo "cloud-storage-analytics@google.com". Consulta Configura la entrega de registros.
InvalidToken El token proporcionado tiene un formato incorrecto o no es válido.
URI no válido No se pudo analizar el URI especificado.
Clave demasiado larga El nombre de tu objeto es demasiado largo.
Error de LCA incorrecto El XML que proporcionaste no tenía el formato correcto o no se validaron con respecto al esquema publicado.
Valor del encabezado con formato incorrecto Un formato de encabezado HTTP tenía un formato incorrecto.
ErrorPOSTPOSTRequest El cuerpo de tu solicitud POST no tiene un formato formado/datos múltiples de forma múltiples.
XML con formato incorrecto Esto sucede cuando el usuario envía un archivo XML con formato incorrecto (XML que no se ajusta al XSD publicado) para la configuración.
MaxMessageLengthExceeded Tu solicitud era demasiado grande.
MaxPostPreDataLengthExceededError Los campos de solicitud POST antes del archivo de subida eran demasiado grandes.
Metadatos demasiado grandes Los encabezados de tus metadatos exceden el tamaño máximo de metadatos permitido.
Error RequestRequest Esto sucede cuando el usuario envía un documento XML vacío como solicitud.
MissingSecurityHeader A tu solicitud le faltaba un encabezado obligatorio.
NoLoggingStatusForKey No existe un subrecurso de estado de registro para una clave.
Sin implementar Un encabezado o una consulta que proporcionó solicitó una función que no está implementada.
NoMd5Provided MD5 es obligatorio para la operación solicitada, pero no se proporcionó.
RequestIsNotMultiPartContent El POST de depósito debe ser de varias partes de formulario/forma-datos.
Tiempo de espera de la solicitud Tu conexión de socket al servidor no se leyó o se escribió en el tiempo de espera.
ResourceIsEncryptedWithCustomerEncryptionKey El recurso se encripta con una clave de encriptación proporcionada por el cliente, pero la solicitud no proporcionó una.
ResourceNotEncryptedWithCustomerEncryptionKey El recurso no está encriptado con una clave de encriptación proporcionada por el cliente, pero la solicitud proporcionó una.
Se requiere una conexión segura Se requiere una conexión segura para procesar esta solicitud.
TokenRefreshRequired Se debe actualizar el token proporcionado.
Demasiados depósitos Intentaste crear más depósitos de los que se permiten.
Contenido inesperado Esta solicitud no admite contenido.
No se puede resolver La dirección de correo electrónico que proporcionaste no coincide con ninguna de las cuentas registradas.
No se admite el LCA No se admite la LCA especificada. Para obtener más información sobre las LCA compatibles con Cloud Storage, consulta Control de acceso.
La clave del usuario debe especificarse El depósito POST debe contener el nombre de campo especificado. Si se especifica, revisa el orden de los campos.
userProjectInconsistente El proyecto de usuario especificado en la solicitud no coincide con el proyecto de usuario especificado en una solicitud anterior y relacionada.
UserProject no válido El proyecto de usuario especificado en la solicitud no es válido, ya sea un ID del proyecto con formato incorrecto o porque hace referencia a un proyecto inexistente.
Falta un proyecto de usuario El depósito solicitado tiene habilitados los pagos del solicitante, el solicitante no es propietario del depósito y no hay ningún proyecto de usuario presente en la solicitud.

401: Sin autorización

Nombre del error Descripción
Pagos obligatorios del solicitante de autenticación Para acceder al depósito de pagos del solicitante, se requiere autenticación.
Sin autorización

Indica que Cloud Storage recibió una solicitud no autorizada.
El encabezado de la solicitud no es válido o no se especificó.
Para obtener más información, consulta RFC 7235 § 3.1.
La práctica estándar para manejar este error es una de las siguientes opciones o ambas:

  1. Realiza un seguimiento de cuándo obtuviste el token de acceso actual y actualízalo cuando encuentres que es mayor que la duración que se mostró cuando se adquirió (normalmente, una hora).
  2. Si detectas la excepción 401, adquiere automáticamente un nuevo token de acceso y vuelve a intentar la solicitud.

403— Prohibido

Nombre del error Descripción
Se denegó el acceso Se denegó el acceso. Esto se aplica a cualquier objeto al que no tengas acceso, independientemente de si existe o no el objeto.
Problema de cuenta Existe un problema con tu Cuenta de Google que impide que la operación se complete correctamente. Un problema podría ser la facturación. Consulta la página de facturación para ver si tienes un saldo pendiente o si la tarjeta de crédito (o algún otro mecanismo de pago) en tu cuenta está vencida. Para crear un proyecto, consulta la página Proyectos en Google Cloud Console. Para obtener información sobre otros problemas, consulta la página Recursos y asistencia.
OtroUsuarioOwsDomain El depósito que intentó crear es un nombre de dominio que pertenece a otro usuario.
BucketAlreadys El nombre del depósito solicitado no está disponible. Todos los usuarios del sistema comparten el espacio de nombres del depósito. Selecciona otro nombre y vuelve a intentarlo.
CrossLocationLogging prohibido No se permite el registro de ubicación cruzada. Un depósito en una ubicación no puede registrar información en un depósito en otra ubicación.
Se requiere la verificación del dominio El depósito que intentaste crear requiere la verificación de propiedad del dominio. Si deseas obtener más información, consulta Requisitos para los nombres de depósitos.
Cuota insuficiente El usuario no tiene cuota suficiente para completar esta operación.
ID de acceso no válido El ID de usuario que proporcionó no existe en nuestros registros.
Pagador no válido Se inhabilitó el acceso a este objeto.
Seguridad no válida Las credenciales de seguridad proporcionadas no son válidas.
ObjectUnderActiveHold No se permite reemplazar o borrar objetos debido a una conservación activa en el objeto.
RequestTimeTooSkewed La diferencia entre el tiempo de solicitud y la hora del servidor es demasiado grande.
RetentionPolicyNotMet El reemplazo o la eliminación de objetos no están permitidos hasta que el objeto cumpla con el período de retención establecido por la política de retención en el depósito.
Firma La firma de la solicitud que calculamos no coincide con la firma que proporcionaste. Revisa tu secreto de Google y el método de firma.
Se denegó el acceso al usuario El solicitante no está autorizado para usar el proyecto especificado en su solicitud. El solicitante debe tener el permiso serviceusage.services.use para el proyecto especificado.
Problema para la cuenta de usuario Hay un problema con el proyecto usado en la solicitud que impide que la operación se complete con éxito. Un problema podría ser la facturación. Consulta la página de facturación para ver si tienes un saldo pendiente o si la tarjeta de crédito (o algún otro mecanismo de pago) en tu cuenta está vencida. Para crear un proyecto, consulta la página Proyectos en Google Cloud Console. Para obtener información sobre otros problemas, consulta la página Recursos y asistencia.

404—No encontrado

Nombre del error Descripción
NoSuchBucket El bucket especificado no existe.
NoSuKeyKey El nombre del objeto especificado no existe.

405: Método no permitido

Nombre del error Descripción
Se denegó el acceso Se denegó el acceso.
Método no permitido El método especificado no está permitido en este recurso.

408—Tiempo de espera de solicitud

Nombre del error Descripción
UploadrodConnection Se agotó el tiempo de espera de la solicitud. Espera un momento con la retirada exponencial antes de continuar.

409—Conflicto

Nombre del error Descripción
Depósito ya perteneciente Su solicitud anterior para crear el depósito con nombre se realizó correctamente y ya es el propietario.
Nombre del depósito no disponible El nombre del depósito solicitado no está disponible. Todos los usuarios del sistema comparten el espacio de nombres del depósito. Selecciona otro nombre y vuelve a intentarlo. Este error puede ocurrir cuando intentas crear un nombre de depósito que ya existe o cuando intentas crear un nombre de depósito que no cumpla con los requisitos de nomenclatura de depósitos.
El depósito no está vacío El depósito que intentaste borrar no está vacío.
Operación cancelada En este momento, hay una operación condicional en conflicto con este recurso. Vuelve a intentarlo.
RewriteTokenDendingEnded Intenta llamar a reescritura con un RewriteToken para una operación de reescritura ya completada.

411: Se requiere longitud

Nombre del error Descripción
Falta contenidoContentLength Debes proporcionar el encabezado HTTP de la longitud del contenido.

412: Error de condición previa

Nombre del error Descripción
Error de condición previa Al menos una de las condiciones previas que especificó no se retenía.

416— Rango solicitado no satisfecho

Nombre del error Descripción
El rango no es válido No se puede cumplir el rango solicitado.

429—Demasiadas solicitudes

Nombre del error Descripción
Límite de frecuencia excedido Se excedió el límite de frecuencia de Cloud Storage. Vuelve a intentarlo con una retirada exponencial.
Para reducir la velocidad Envías solicitudes con demasiada frecuencia. Por ejemplo, las actualizaciones de objeto tienen un límite de aproximadamente 1 actualización por segundo. Para obtener más información, consulta Límites y cuotas. Espera un momento con la retirada exponencial antes de continuar y disminuye la velocidad a la que envías solicitudes.

500— Error de servidor interno

Nombre del error (si está presente) Descripción
InternalError Se detectó un error interno. Espera un momento con la retirada exponencial antes de continuar.

503—Servicio no disponible

Nombre del error (si está presente) Descripción
Para reducir la velocidad El servicio no está disponible temporalmente. Espera un momento con la retirada exponencial antes de continuar.

504— Tiempo de espera de Gateway

Nombre del error Descripción
N/A Por el momento, el servicio no puede acceder a otro servicio. Espera brevemente con la retirada exponencial antes de continuar.