Compartir a través de

Códigos de estado y error

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

Las operaciones de API también pueden devolver información detallada sobre errores que defina el servicio. Esta información de error se devuelve en el cuerpo de la respuesta.

El cuerpo de la 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 elemento indica la cadena de message 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 detallada sobre el error para proporcionar más información al desarrollador. Por ejemplo, la siguiente respuesta de error indica un parámetro de consulta no válido especificado en el URI de la solicitud y proporciona información adicional sobre el nombre y el valor del parámetro no válido, así como 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 detallada sobre errores cuando el tipo de recurso firmado de la SAS de cuenta no coincida con el recurso al que se accede. Por ejemplo, la siguiente respuesta de error indica que el tipo de recurso firmado "o" es necesario 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>

La siguiente lista de artículos proporciona colecciones de códigos de error que pueden resultarle útiles:

Copiar respuesta de error de API

La respuesta de error de las API de copia sigue el mismo formato que se mencionó anteriormente. El cuerpo de la respuesta de error contiene el code elemento de la cadena de código de error y el message elemento que indica la cadena de mensaje de error.

Para las versiones 2024-02-04 y posteriores, la respuesta de error puede incluir un error detallado si se produce un error en la operación de copia debido a un problema con el origen de copia, siempre que el error del origen devuelva esta información. La respuesta puede incluir CopySourceStatusCode la indicación del código de estado de la operación de origen de copia, CopySourceErrorCode especificando el x-ms-error-code devuelto en la respuesta de error del origen de copia e CopySourceErrorMessage indicando el mensaje de error correspondiente.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>CannotVerifyCopySource</Code>  
  <Message> The specified blob doesn’t exist.
      RequestId:de1e2279-b01e-0000-5f26-5c4741000000
      Time:2023-03-21T18:52:10.1018932Z</Message>
  <CopySourceStatusCode> 404 </CopySourceStatusCode>
  <CopySourceErrorCode> BlobNotFound </CopySourceErrorCode>
  <CopySourceErrorMessage> The specified blob doesn’t exist </CopySourceErrorMessage> 
</Error>

Para las versiones 2024-02-04 y posteriores, Azure Storage devuelve el código de estado de origen de copia y el código de error en el encabezado de respuesta, si se reciben en el error de origen de copia.

Encabezado de respuesta Descripción
x-ms-copy-source-status-code Valor que indica el código de estado del error de origen de copia.
x-ms-copy-source-error-code Valor que indica la cadena de código de error devuelta por el error de origen de copia.

Las siguientes API de copia devuelven estos detalles:

Respuestas de error para Table Storage

Las respuestas de error para Table Storage cumplen con el formato de error descrito en la sección 19 de la especificación de OData. Es posible que se incluya información detallada sobre el error, pero la respuesta al 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 obtener 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.

En el ejemplo siguiente se muestra el cuerpo del 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"}}}

En el ejemplo siguiente se muestra el cuerpo del error básico en formato Atom (versiones 2015-12-11 y anteriores):

<?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
Servicios de almacenamiento REST