Compartir por


Códigos de error comunes de la API REST

Una operación en cualquiera de los servicios de Azure Storage puede devolver los siguientes códigos de error:

Código de error Código de estado HTTP Mensaje de usuario
NoAuthenticationInformation No autorizado (401) El servidor no pudo autenticar la solicitud. Consulte la información del encabezado www-authenticate.
InvalidAuthenticationInfo No autorizado (401) El servidor no pudo autenticar la solicitud. Consulte la información del encabezado www-authenticate.
AccountAlreadyExists Conflicto (409) La cuenta especificada ya existe.
AccountBeingCreated Conflicto (409) La cuenta especificada se está creando.
AccountIsDisabled Prohibido (403) La cuenta especificada está deshabilitada.
AccountProtectedFromDeletion Conflicto (409) Los contenedores <containerName> de cuenta <accountName> tienen <have legal hold\locked immutability policy>.
AuthenticationFailed Prohibido (403) El servidor no pudo autenticar la solicitud. Compruebe que el valor del encabezado Authorization está formado correctamente y que incluye la firma.
ConditionHeadersNotSupported BadRequest (400) No se admiten encabezados de condición.
ConditionNotMet No modificado (304) La condición especificada en los encabezados condicionales no se cumplió para una operación de lectura.
ConditionNotMet Error de condición previa (412) La condición especificada en los encabezados condicionales no se cumplió para una operación de escritura.
EmptyMetadataKey Solicitud incorrecta (400) La clave de uno de los pares clave-valor de metadatos está vacía.
InsufficientAccountPermissions Prohibido (403) Las operaciones de lectura están deshabilitadas actualmente.
InsufficientAccountPermissions Prohibido (403) No se permiten operaciones de escritura.
InsufficientAccountPermissions Prohibido (403) La cuenta a la que se accede no tiene permisos suficientes para ejecutar esta operación.
InternalError Error interno del servidor (500) Se produjo un error interno en el servidor. Vuelva a intentar realizar la solicitud.
InvalidAuthenticationInfo Solicitud incorrecta (400) La información de autenticación no se proporcionó en el formato correcto. Compruebe el valor del encabezado Authorization.
InvalidHeaderValue Solicitud incorrecta (400) El valor proporcionado para uno de los encabezados HTTP no estaba en el formato correcto.
InvalidHttpVerb Solicitud incorrecta (400) El servidor no reconoció el verbo HTTP especificado.
InvalidInput Solicitud incorrecta (400) Una de las entradas de la solicitud no es válida.
InvalidMd5 Solicitud incorrecta (400) El valor MD5 especificado en la solicitud no es válido. El valor MD5 debe ser de 128 bits y con codificación Base64.
InvalidMetadata Solicitud incorrecta (400) Los metadatos especificados no son válidos. Incluye caracteres que no están permitidos.
InvalidQueryParameterValue Solicitud incorrecta (400) Se especificó un valor no válido para uno de los parámetros de consulta del URI de solicitud.
InvalidRange No se puede satisfacer el intervalo solicitado (416) El intervalo especificado no es válido para el tamaño actual del recurso.
InvalidResourceName Solicitud incorrecta (400) El nombre de recurso especificado contiene caracteres no válidos.
InvalidUri Solicitud incorrecta (400) El URI solicitado no representa ningún recurso en el servidor.
InvalidXmlDocument Solicitud incorrecta (400) El código XML especificado no es válido desde el punto de vista sintáctico.
InvalidXmlNodeValue Solicitud incorrecta (400) El valor proporcionado para uno de los nodos XML del cuerpo de la solicitud no estaba en el formato correcto.
KeyVaultAccessTokenCannotBeAcquired Prohibido (403) No se puede adquirir un token de acceso para el almacén de claves desde Microsoft Entra mediante la identidad de este recurso.
KeyVaultEncryptionKeyNotFound Prohibido (403) No se encuentra la clave del almacén de claves para desencapsular la clave de cifrado.
KeyVaultVaultNotFound Prohibido (403) No se encuentra el almacén de key vault.
Md5Mismatch Solicitud incorrecta (400) El valor MD5 especificado en la solicitud no coincide con el valor MD5 calculado por el servidor.
MetadataTooLarge Solicitud incorrecta (400) El tamaño de los metadatos especificados supera el tamaño máximo permitido.
MissingContentLengthHeader Longitud requerida (411) El encabezado Content-Length no se ha especificado.
MissingRequiredQueryParameter Solicitud incorrecta (400) No se especificó un parámetro de consulta necesario para esta solicitud.
MissingRequiredHeader Solicitud incorrecta (400) No se especificó un encabezado HTTP necesario.
MissingRequiredXmlNode Solicitud incorrecta (400) No se especificó un nodo XML necesario en el cuerpo de la solicitud.
MultipleConditionHeadersNotSupported Solicitud incorrecta (400) No se admiten varios encabezados de condición.
OperationTimedOut Error interno del servidor (500) La operación no se pudo completar en el tiempo permitido. Es posible que la operación se haya realizado correctamente o no en el lado servidor. Consulte el estado del servidor antes de volver a intentar la operación.
OutOfRangeInput Solicitud incorrecta (400) Una de las entradas de la solicitud está fuera del intervalo.
OutOfRangeQueryParameterValue Solicitud incorrecta (400) Un parámetro de consulta especificado en el URI de solicitud está fuera del intervalo válido.
RequestBodyTooLarge Entidad solicitada demasiado grande (413) El tamaño del cuerpo de la solicitud supera el tamaño máximo permitido.
ResourceTypeMismatch Conflicto (409) El tipo de recurso especificado no coincide con el tipo del recurso existente.
RequestUrlFailedToParse Solicitud incorrecta (400) No se pudo analizar la dirección URL de la solicitud.
ResourceAlreadyExists Conflicto (409) El recurso especificado ya existe.
ResourceNotFound No encontrado (404) El recurso especificado no existe.
ServerBusy Servicio no disponible (503) El servidor actualmente no puede recibir solicitudes. Vuelva a intentar realizar la solicitud.
ServerBusy Servicio no disponible (503) La entrada supera el límite de la cuenta.
ServerBusy Servicio no disponible (503) La salida supera el límite de la cuenta.
ServerBusy Servicio no disponible (503) Las operaciones por segundo superan el límite de la cuenta.
UnsupportedHeader Solicitud incorrecta (400) No se admite uno de los encabezados HTTP especificados en la solicitud.
UnsupportedXmlNode Solicitud incorrecta (400) No se admite uno de los nodos XML especificados en el cuerpo de la solicitud.
UnsupportedQueryParameter Solicitud incorrecta (400) No se admite uno de los parámetros de consulta especificados en el URI de solicitud.
UnsupportedHttpVerb Método no permitido (405) El recurso no admite el verbo HTTP especificado.

Consulte también

Códigos de error de Blob Storage
Códigos de error de Queue Storage
Códigos de error de Table Storage
códigos de error de Azure Files
Solución de problemas de operaciones de API
Enumeración HttpStatusCode
Referencia de API REST de Azure Storage