Compartir vía


Estado y códigos de error

Las operaciones de la API REST para Azure Storage devuelven códigos de estado HTTP estándar, tal como se define en las definiciones de código de estado HTTP/1.1.

Las operaciones de API también pueden devolver información de error adicional definida por el servicio. Esta información de error adicional se devuelve en el cuerpo de respuesta.

El cuerpo de respuesta de error sigue el formato básico que se muestra aquí. El code elemento indica la cadena de código de error, mientras que el message elemento indica la cadena del mensaje de error.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>string-value</Code>  
  <Message>string-value</Message>  
</Error>  

Para la versión 2017-07-29 y posteriores, las operaciones de API con errores también devuelven la cadena de código de error de Azure Storage en un encabezado de respuesta.

Encabezado de respuesta Descripción
x-ms-error-code Valor que indica la cadena de código de error.

Una respuesta de error determinada también puede incluir información adicional sobre errores para proporcionar al desarrollador más información. Por ejemplo, la siguiente respuesta de error indica que un parámetro de consulta especificado en el URI de solicitud no es válido y proporciona información adicional sobre el nombre y el valor del parámetro no válido y el motivo del error.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>InvalidQueryParameterValue</Code>  
  <Message>Value for one of the query parameters specified in the request URI is invalid.</Message>  
  <QueryParameterName>popreceipt</QueryParameterName>  
  <QueryParameterValue>33537277-6a52-4a2b-b4eb-0f905051827b</QueryParameterValue>  
  <Reason>invalid receipt format</Reason>  
</Error>  

Para la versión 2024-08-04 y posteriores, la respuesta de error incluirá información de error adicional cuando el tipo de recurso firmado de SAS de la cuenta no coincida con el recurso al que se accede. Por ejemplo, la siguiente respuesta de error indica que se requiere el tipo de recurso firmado "o" para realizar la operación.

<?xml version="1.0" encoding="utf-8"?>
<Error>
  <Code>AuthorizationResourceTypeMismatch</Code>
  <Message>This request is not authorized to perform this operation using this resource type. RequestId:42a48a49-201e-0092-3770-a7ea70000000 Time:2024-05-16T09:04:16.3226200Z</Message>
  <ExtendedErrorDetail>SignedResourceTypes 'o' is required to perform this operation.</ExtendedErrorDetail>
</Error>

En los temas siguientes se proporcionan listas de códigos de error que puede resultar útil:

Respuestas de error para Table Storage

Las respuestas de error de Table Storage cumplen el formato de error descrito en la sección 19 de la especificación de OData. Es posible que se incluya información adicional sobre errores, pero la respuesta de error siempre cumple con la OData especificación.

Las respuestas de error por lotes son similares a las respuestas de error estándar de Table Storage. Para más información, consulte Realización de transacciones de grupos de entidades.

Nota

JSON es el formato de carga recomendado para Table Storage. Es el único formato compatible con la versión 2015-12-11 y posteriores.

A continuación se muestra el cuerpo de error básico en formato JSON (versión 2013-08-15 y posteriores):

{"odata.error":{"code":"ResourceNotFound","message":{"lang":"en-US","value":"The specified resource does not exist.\nRequestId:102a2b55-eb35-4254-9daf-854db78a47bd\nTime:2014-06-04T16:18:20.4307735Z"}}}  
  

A continuación se muestra el cuerpo de error básico en formato Atom (versiones anteriores a 2015-12-11):

<?xml version="1.0" encoding="utf-8"?>  
<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">  
  <code>ResourceNotFound</code>  
  <message xml:lang="en-US">The specified resource does not exist.  
RequestId:e288ba1e-f5dd-4014-9e09-f1263d223dec  
Time:2014-06-04T16:18:20.7088013Z</message>  
</error>  
  

Consulte también

Solución de problemas de operaciones de API
Enumeración HttpStatusCode
REST de servicios de almacenamiento