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 "firstname.lastname@example.org". 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.


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. |