Get Blob

  • Artículo

La operación Get Blob lee o descarga un blob del sistema, incluidos sus metadatos y propiedades. También se puede llamar a Get Blob para leer una instantánea.

Solicitud

Puede construir la Get Blob solicitud como se indica a continuación. Se recomienda usar HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento:

URI de solicitud de método GET Versión de HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>

 HTTP/1.0

HTTP/1.1

URI del servicio de almacenamiento emulado

Al realizar una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y Azure Blob Storage puerto como 127.0.0.1:10000, seguido del nombre de la cuenta de almacenamiento emulada:

URI de solicitud de método GET Versión de HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

Para más información, consulte Uso del emulador de Azure Storage para desarrollo y pruebas.

Parámetros del identificador URI

Se pueden especificar los siguientes parámetros adicionales en el URI de solicitud:

Parámetro Descripción
snapshot Opcional. El parámetro snapshot es un valor opaco DateTime que, cuando está presente, especifica la instantánea del blob que se va a recuperar. Para más información sobre cómo trabajar con instantáneas de blob, consulte Creación de una instantánea de un blob.
versionid Opcional, versión 2019-12-12 y posteriores. El versionid parámetro es un valor opaco DateTime que, cuando está presente, especifica la versión del blob que se va a recuperar.
timeout Opcional. El parámetro timeout se expresa en segundos. Para más información, consulte Establecimiento de tiempos de espera para las operaciones de Blob Storage.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
x-ms-version Obligatorio para todas las solicitudes autorizadas. Opcional para las solicitudes anónimas. Especifica la versión de la operación que se utiliza para esta solicitud. Si se omite este encabezado para una solicitud anónima, el servicio ejecuta la solicitud con la versión 2009-09-19. Para obtener más información, vea Versiones de los servicios de Azure Storage.
Range Opcional. Devuelve los bytes del blob solo en el intervalo especificado.
x-ms-range Opcional. Devuelve los bytes del blob solo en el intervalo especificado. Si se especifican Range y x-ms-range, el servicio utiliza el valor de x-ms-range. Si no se especifica ningún intervalo, se devuelve todo el contenido del blob. Para más información, consulte Especificación del encabezado de intervalo para las operaciones de Blob Storage.
x-ms-lease-id: <ID> Opcional. Si se especifica este encabezado, la operación solo se realiza si se cumplen las dos condiciones siguientes:

- La concesión del blob está activa actualmente.
: el identificador de concesión especificado en la solicitud coincide con el identificador de concesión del blob.

Si se especifica este encabezado pero no se cumple alguna de estas condiciones, se produce un error en la solicitud y se produce un error en la Get Blob operación con el código de estado 412 (error de condición previa).
x-ms-range-get-content-md5: true Opcional. Cuando este encabezado se establece true en y se especifica junto con el Range encabezado , el servicio devuelve el hash MD5 para el rango, siempre que el intervalo sea menor o igual que 4 mebibytes (MiB) de tamaño.

Si el encabezado se especifica sin el Range encabezado , el servicio devuelve el código de estado 400 (solicitud incorrecta).

Si el encabezado se establece true en cuando el intervalo supera 4 MiB, el servicio devuelve el código de estado 400 (solicitud incorrecta).
x-ms-range-get-content-crc64: true Opcional. Cuando este encabezado se establece true en y se especifica junto con el Range encabezado , el servicio devuelve el hash CRC64 para el rango, siempre que el intervalo sea menor o igual que 4 MiB de tamaño.

Si el encabezado se especifica sin el Range encabezado , el servicio devuelve el código de estado 400 (solicitud incorrecta).

Si el encabezado se establece true en cuando el intervalo supera 4 MiB, el servicio devuelve el código de estado 400 (solicitud incorrecta).

Si los x-ms-range-get-content-md5 encabezados y x-ms-range-get-content-crc64 están presentes, la solicitud produce un error 400 (solicitud incorrecta).

Este encabezado es compatible con las versiones 2019-02-02 y posteriores.
Origin Opcional. Especifica el origen del que se emitirá la solicitud. La presencia de este encabezado da lugar a encabezados de uso compartido de recursos entre orígenes (CORS) en la respuesta.
x-ms-client-request-id Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB), que se registra en los registros de análisis cuando está habilitado el registro de análisis de almacenamiento. Se recomienda encarecidamente usar este encabezado al correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para más información, consulte Acerca del registro de Azure Storage Analytics.

Esta operación también admite el uso de encabezados condicionales que permiten leer el blob solo si se cumple una condición especificada. Para más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Storage.

Encabezados de solicitud (claves de cifrado proporcionadas por el cliente)

A partir de la versión 2019-02-02, puede especificar los encabezados siguientes en la solicitud para leer un blob cifrado con una clave proporcionada por el cliente. El cifrado con una clave proporcionada por el cliente (y el conjunto de encabezados correspondiente) es opcional. Si un blob se ha cifrado previamente con una clave proporcionada por el cliente, debe incluir estos encabezados en la solicitud para completar correctamente la operación de lectura.

Encabezado de solicitud Descripción
x-ms-encryption-key Necesario. Clave de cifrado AES-256 codificada en Base64.
x-ms-encryption-key-sha256 Opcional. Hash SHA256 codificado en Base64 de la clave de cifrado.
x-ms-encryption-algorithm: AES256 Necesario. Especifica el algoritmo que se va a usar para el cifrado. El valor de este encabezado debe ser AES256.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y el cuerpo de respuesta, que incluye el contenido del blob.

status code

Una operación correcta para leer todo el blob devuelve el código de estado 200 (CORRECTO).

Una operación correcta para leer un intervalo especificado devuelve el código de estado 206 (Contenido parcial).

Para obtener más información sobre los códigos de estado, vea Códigos de estado y de error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Sintaxis Descripción
Last-Modified Fecha y hora en que se modificó por última vez el blob. El formato de la fecha sigue las convenciones de RFC 1123.

Cualquier operación que modifique el blob, incluida una actualización de los metadatos o las propiedades del blob, cambia la hora de la última modificación del blob.
x-ms-creation-time Versión 2017-11-09 y posteriores. Fecha y hora en que se creó el blob. El formato de la fecha sigue las convenciones de RFC 1123.
x-ms-meta-name:value Conjunto de pares nombre-valor asociados a este blob como metadatos definidos por el usuario.
x-ms-tag-count Versión 2019-12-12 y posteriores. Si el blob tiene etiquetas, este encabezado devuelve el número de etiquetas que se almacenan en el blob. El encabezado no se devuelve si no hay etiquetas en el blob.
Content-Length El número de bytes presentes en el cuerpo de respuesta.
Content-Type Tipo de contenido especificado para el blob. El tipo de contenido predeterminado es application/octet-stream.
Content-Range Indica el intervalo de bytes que se devuelve en caso de que el cliente solicitó un subconjunto del blob estableciendo el encabezado de Range solicitud.
ETag Contiene un valor que puede usar para realizar operaciones condicionalmente. Para más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Storage. Si la versión de la solicitud es 2011-08-18 o posterior, el valor ETag se incluye entre comillas.
Content-MD5 Si el blob tiene un hash MD5 y esta operación Get Blob tiene como fin leer el blob completo, se devuelve este encabezado de respuesta para que el cliente pueda comprobar la integridad del contenido del mensaje.

En la versión 2012-02-12 y posteriores, Put Blob establece el valor hash MD5 de un blob en bloques incluso cuando la Put Blob solicitud no incluye un encabezado MD5.

Si la solicitud va a leer un intervalo especificado y x-ms-range-get-content-md5 se establece trueen , la solicitud devuelve un hash MD5 para el intervalo, siempre que el tamaño del intervalo sea menor o igual que 4 MiB.

Si ninguno de estos conjuntos de condiciones es true, no se devuelve ningún valor para el Content-MD5 encabezado .

Si se especifica x-ms-range-get-content-md5 sin el encabezado Range, el servicio devuelve el código de estado 400 (Solicitud incorrecta).

Si x-ms-range-get-content-md5 se establece true en cuando el intervalo supera 4 MiB, el servicio devuelve el código de estado 400 (solicitud incorrecta).
x-ms-content-crc64 Si la solicitud va a leer un intervalo especificado y x-ms-range-get-content-crc64 se establece trueen , la solicitud devuelve un hash CRC64 para el intervalo, siempre que el tamaño del intervalo sea menor o igual que 4 MiB.

Si se especifica x-ms-range-get-content-crc64 sin el encabezado Range, el servicio devuelve el código de estado 400 (Solicitud incorrecta).

Si x-ms-range-get-content-crc64 se establece true en cuando el intervalo supera 4 MiB, el servicio devuelve el código de estado 400 (solicitud incorrecta).
Content-Encoding Devuelve el valor especificado para el encabezado de Content-Encoding solicitud.
Content-Language Devuelve el valor especificado para el encabezado de Content-Language solicitud.
Cache-Control Se devuelve si el encabezado se especificó anteriormente para el blob.
Content-Disposition Se devuelve para las solicitudes realizadas en la versión 2013-08-15 y posteriores. Este encabezado devuelve el valor especificado para el encabezado x-ms-blob-content-disposition.

El Content-Disposition campo de encabezado de respuesta transmite información adicional sobre cómo procesar la carga de respuesta y se puede usar para adjuntar metadatos adicionales. Por ejemplo, si el encabezado se establece attachmenten , indica que el agente de usuario no debe mostrar la respuesta. En su lugar, muestra un cuadro de diálogo Guardar como con un nombre de archivo distinto del nombre de blob especificado.
x-ms-blob-sequence-number El número de secuencia actual de un blob en páginas.

Este encabezado no se devuelve para blobs en bloques o blobs en anexos.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Devuelve el tipo del blob.
x-ms-copy-completion-time: <datetime> Versión 2012-02-12 y posteriores. La hora de conclusión de la última operación intentada Copy Blob en la que este blob era el blob de destino. Este valor puede especificar la hora de un intento de copia completado, anulado o con errores. Este encabezado no aparece si una copia está pendiente, si este blob nunca ha sido el destino de una Copy Blob operación, o si este blob se ha modificado después de una operación concluida Copy Blob que usó Set Blob Properties, Put Blobo Put Block List.
x-ms-copy-status-description: <error string> Versión 2012-02-12 y posteriores. Solo aparece cuando x-ms-copy-status es failed o pending. Describe la causa del último error recuperable o irrecuperable que se ha producido en la operación de copia. Este encabezado no aparece si este blob nunca ha sido el destino de una Copy Blob operación, o si este blob se ha modificado después de una operación concluida Copy Blob que usó Set Blob Properties, Put Blobo Put Block List.
x-ms-copy-id: <id> Versión 2012-02-12 y posteriores. Identificador de cadena de la última operación intentada Copy Blob en la que este blob era el blob de destino. Este encabezado no aparece si este blob nunca ha sido el destino de una Copy Blob operación, o si este blob se ha modificado después de una operación concluida Copy Blob que usó Set Blob Properties, Put Blobo Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Versión 2012-02-12 y posteriores. Contiene el número de bytes que se copiaron y el total de bytes del origen en la última operación intentada Copy Blob en la que este blob era el blob de destino. Se puede mostrar de 0 a Content-Length bytes copiados. Este encabezado no aparece si este blob nunca ha sido el destino de una Copy Blob operación, o si este blob se ha modificado después de una operación concluida Copy Blob que usó Set Blob Properties, Put Blobo Put Block List.
x-ms-copy-source: url Versión 2012-02-12 y posteriores. Dirección URL de hasta 2 KiB de longitud que especifica el blob o archivo de origen usado en la última operación intentada Copy Blob donde este blob era el blob de destino. Este encabezado no aparece si este blob nunca ha sido el destino de una Copy Blob operación, o si este blob se ha modificado después de una operación concluida Copy Blob que usó Set Blob Properties, Put Blobo Put Block List.

La dirección URL que se devuelve en este encabezado contiene los parámetros de solicitud que se usaron en la operación de copia en el blob de origen, incluido el token de firma de acceso compartido (SAS) que se usó para acceder al blob de origen.
x-ms-copy-status: <pending | success | aborted | failed> Versión 2012-02-12 y posteriores. Estado de la operación de copia identificada por x-ms-copy-id, con estos valores:

- success: se ha completado correctamente la copia.
- pending: la copia está en curso. Compruebe x-ms-copy-status-description si los errores intermitentes y no irrecuperables ralentizan el progreso de la copia, pero no provocan errores.
- aborted: la copia finalizó por Abort Copy Blob.
- failed: error de copia. Consulte x-ms-copy-status-description para obtener más información sobre los errores.

Este encabezado no aparece si este blob nunca ha sido el destino en una Copy Blob operación, o si este blob se ha modificado después de una operación completada Copy Blob que usó Set Blob Properties, Put Blobo Put Block List.
x-ms-lease-duration: <infinite | fixed> Versión 2012-02-12 y posteriores. Cuando se concede un blob, especifica si la concesión es de duración infinita o fija.
x-ms-lease-state: <available | leased | expired | breaking | broken> Versión 2012-02-12 y posteriores. Estado de concesión del blob.
x-ms-lease-status:<locked | unlocked> El estado de concesión actual del blob.
x-ms-request-id Identifica de forma única la solicitud que se realizó y se puede usar para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión de Blob Storage que se usó para ejecutar la solicitud. Se incluye para las solicitudes realizadas mediante la versión 2009-09-19 y posteriores.

Este encabezado también se devuelve para las solicitudes anónimas sin una versión especificada si el contenedor se marcó para el acceso público mediante Blob Storage versión 2009-09-19.
Accept-Ranges: bytes Indica que el servicio admite solicitudes de contenido parcial de blobs. Se incluye para las solicitudes realizadas mediante la versión 2011-08-18 y posteriores, y para el servicio de almacenamiento local en la versión 1.6 del SDK y versiones posteriores.
Date Valor de fecha y hora UTC generado por el servicio, que indica la hora a la que se inició la respuesta.
Access-Control-Allow-Origin Se devuelve si la solicitud incluye un encabezado Origin y se ha habilitado CORS con una regla de coincidencia. Este encabezado devuelve el valor del encabezado Origin de la solicitud en caso de que haya una coincidencia.
Access-Control-Expose-Headers Se devuelve si la solicitud incluye un encabezado Origin y se ha habilitado CORS con una regla de coincidencia. Devuelve la lista de encabezados de respuesta que se van a exponer al cliente o el emisor de la solicitud.
Vary Se devuelve con el valor del encabezado Origin cuando se especifican reglas de CORS. Consulte Compatibilidad con CORS para los servicios de Azure Storage para más información.
Access-Control-Allow-Credentials Se devuelve si la solicitud incluye un Origin encabezado y CORS está habilitado con una regla coincidente que no permite todos los orígenes. Este encabezado se establecerá en true.
x-ms-blob-committed-block-count Número de bloques confirmados presentes en el blob. Este encabezado solo se devuelve para blobs en anexos.
x-ms-server-encrypted: true/false Versión 2015-12-11 y posteriores. El valor de este encabezado se establece true en si los datos de blob y los metadatos de la aplicación se cifran completamente mediante el algoritmo especificado. De lo contrario, el valor se establece false en (cuando el blob está sin cifrar o si solo se cifran partes del blob o los metadatos de la aplicación).
x-ms-encryption-key-sha256 Versión 2019-02-02 y posteriores. Este encabezado se devuelve si el blob está cifrado con una clave proporcionada por el cliente.
x-ms-encryption-context Versión 2021-08-06 y posteriores. Si el valor de la propiedad de contexto de cifrado se establece, devolverá el valor establecido. Válido solo cuando el espacio de nombres jerárquico está habilitado para la cuenta.
x-ms-encryption-scope Versión 2019-02-02 y posteriores. Este encabezado se devuelve si el blob está cifrado con un ámbito de cifrado.
x-ms-blob-content-md5 Versión 2016-05-31 y posteriores. Si el blob tiene un hash MD5 y si la solicitud contiene un encabezado de intervalo (Range o x-ms-range), este encabezado de respuesta se devuelve con el valor del valor MD5 de todo el blob. Este valor podría ser o no igual al valor que se devuelve en el encabezado Content-MD5, con el último calculado a partir del intervalo solicitado.
x-ms-client-request-id Se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado si está presente en la solicitud y el valor no contiene más de 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no está presente en la respuesta.
x-ms-last-access-time Versión 2020-02-10 y posteriores. Indica la última vez que se accedió a los datos del blob en función de la directiva de seguimiento de la hora de último acceso de la cuenta de almacenamiento. El encabezado no se devuelve si la cuenta de almacenamiento no tiene una directiva de seguimiento de la hora de último acceso o si la directiva está deshabilitada. Para obtener información sobre cómo establecer la directiva de seguimiento de la hora de último acceso de la cuenta de almacenamiento, consulte Api de Blob Service.
x-ms-blob-sealed Versión 2019-12-12 y posteriores. Solo se devuelve para blobs en anexos. Si el blob en anexos se ha sellado, el valor sería true. Para obtener más información, consulte Append Blob Seal
x-ms-immutability-policy-until-date Versión 2020-06-12 y posteriores. Especifica la retención hasta la fecha establecida en el blob. Esta es la fecha hasta la que se puede proteger el blob de que se va a modificar o eliminar. Solo se devuelve si se establece una directiva de inmutabilidad en el blob. El valor de este encabezado está en formato RFC1123.
x-ms-immutability-policy-mode: unlocked/locked Versión 2020-06-12 y posteriores. Se devuelve si se establece una directiva de inmutabilidad en el blob. Los valores son unlocked y locked. unlocked indica que el usuario puede cambiar la directiva aumentando o disminuyendo la retención hasta la fecha. locked indica que estas acciones están prohibidas.
x-ms-legal-hold: true/false Versión 2020-06-12 y posteriores. Este encabezado no se devuelve si no hay ninguna suspensión legal en el blob. El valor de este encabezado se establece true en si el blob contiene una suspensión legal y su valor es true. De lo contrario, el valor se establece false en si el blob contiene una suspensión legal y su valor es false.
x-ms-owner Versión 2020-06-12 y posteriores, solo para cuentas con espacio de nombres jerárquico habilitado. Devuelve el usuario propietario del archivo o directorio.
x-ms-group Versión 2020-06-12 y posteriores, solo para cuentas con espacio de nombres jerárquico habilitado. Devuelve el grupo propietario del archivo o directorio.
x-ms-permissions Versión 2020-06-12 y posteriores, solo para cuentas con espacio de nombres jerárquico habilitado. Devuelve los permisos establecidos para "usuario", "grupo" y "otros" en el archivo o directorio. Cada permiso individual tiene el formato [r,w,x-].{3}
x-ms-resource-type Versión 2020-10-02 y posteriores, solo para cuentas con espacio de nombres jerárquico habilitado. Devuelve el tipo de recurso de la ruta de acceso, que puede ser file o directory.

Response body

El cuerpo de respuesta incluye el contenido del blob.

Respuesta de muestra

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>

Authorization

Se requiere autorización al llamar a cualquier operación de acceso a datos en Azure Storage. Puede autorizar la Get Blob operación como se describe a continuación.

Azure Storage admite el uso de Microsoft Entra ID para autorizar solicitudes a datos de blobs. Con Microsoft Entra ID, puede usar el control de acceso basado en rol de Azure (RBAC de Azure) para conceder permisos a una entidad de seguridad. La entidad de seguridad puede ser un usuario, un grupo, una entidad de servicio de aplicación o una identidad administrada de Azure. La entidad de seguridad se autentica mediante Microsoft Entra ID para devolver un token de OAuth 2.0. Después, el token se puede usar para autorizar una solicitud en Blob service.

Para más información sobre la autorización mediante Microsoft Entra ID, consulte Autorización del acceso a blobs mediante Microsoft Entra ID.

Permisos

A continuación se enumeran las acciones de RBAC necesarias para un usuario, grupo o entidad de servicio de Microsoft Entra para llamar a la Get Blob operación y el rol RBAC integrado con privilegios mínimos que incluye esta acción:

Para más información sobre la asignación de roles mediante RBAC de Azure, consulte Asignación de un rol de Azure para el acceso a datos de blobs.

Comentarios

Para un blob en páginas, la operación Get Blob sobre un intervalo de páginas que aún no tienen contenido o que han sido borradas devuelve ceros para esos bytes.

Si llama a Get Blob en un blob en páginas sin intervalo especificado, el servicio devuelve el intervalo de páginas hasta el valor especificado para el x-ms-blob-content-length encabezado. Para las páginas que carecen de contenido, el servicio devuelve ceros para esos bytes.

Para un blob en anexos, la Get Blob operación devuelve el x-ms-blob-committed-block-count encabezado . Este encabezado indica el número de bloques confirmados en el blob. El x-ms-blob-committed-block-count encabezado no se devuelve para blobs en bloques o blobs en páginas.

Una Get Blob operación se permite que se completen dos minutos por MiB. Si la operación tarda más de dos minutos por MiB en promedio, la operación agotará el tiempo de espera.

El encabezado x-ms-version es necesario para recuperar un blob que pertenece a un contenedor privado. Si el blob pertenece a un contenedor que está disponible para el acceso público completo o parcial, cualquier cliente puede leerlo sin especificar una versión; La versión del servicio no es necesaria para recuperar un blob que pertenece a un contenedor público. Para obtener más información, consulte Restringir acceso a contenedores y blobs.

Se Get Blob producirá un error en una operación en un blob en bloques archivado.

Operaciones de copia

Para determinar si se ha completado una Copy Blob operación, compruebe primero que el x-ms-copy-id valor de encabezado del blob de destino coincida con el identificador de copia proporcionado por la llamada original a Copy Blob. Una coincidencia garantiza que otra aplicación no anule la copia e inicie una nueva Copy Blob operación. A continuación, compruebe el x-ms-copy-status: success encabezado . Sin embargo, tenga en cuenta que todas las operaciones de escritura en un blob excepto Lease, Put Pagey Put Block quitan todas las x-ms-copy-* propiedades del blob. Estas propiedades tampoco se copian mediante Copy Blob operaciones que usan versiones de Blob Storage anteriores a 2012-02-12.

Advertencia

La dirección URL que se devuelve en el x-ms-copy-source encabezado contiene los parámetros de solicitud que se usaron en la operación de copia en el blob de origen. Si usa un token de SAS para acceder al blob de origen, ese token de SAS aparecerá en el x-ms-copy-source encabezado cuando Get Blob se llame a en el blob de destino.

Cuando x-ms-copy-status: failed aparece en la respuesta, x-ms-copy-status-description contiene más información sobre el error de Copy Blob.

Los tres campos de cada x-ms-copy-status-description valor se describen en la tabla siguiente:

Componente Descripción
Código de estado HTTP Entero estándar de 3 dígitos que especifica el error.
Código de error Palabra clave que describe el error, proporcionado por Azure en el <elemento ErrorCode> . Si no aparece ningún <elemento ErrorCode> , se usa una palabra clave que contiene texto de error estándar asociado al código de estado HTTP de 3 dígitos en la especificación HTTP. Consulte Códigos de error comunes de la API rest.
Information Descripción detallada del error, entre comillas.

Los x-ms-copy-status valores y x-ms-copy-status-description de los escenarios de error comunes se describen en la tabla siguiente:

Importante

Las descripciones de error de esta tabla pueden cambiar sin advertencia, incluso sin un cambio de versión, por lo que es posible que no coincidan exactamente con el texto.

Escenario Valor de x-ms-copy-status Valor de x-ms-copy-status-description
Operación de copia completada correctamente. success empty
El usuario ha anulado la operación de copia antes de que se haya completado. aborted empty
Se produjo un error al leer el blob de origen durante una operación de copia, pero la operación se volverá a intentar. pending 502 BadGateway "Al leer el origen se encontró un error que se puede reintentar. Se volverá a intentar. Tiempo de error: <tiempo>"
Se produjo un error al escribir en el blob de destino durante una operación de copia, pero la operación se volverá a intentar. pending 500 InternalServerError "Se encontró un error que se puede volver a intentar. Se volverá a intentar. Tiempo de error: <tiempo>"
Se produjo un error irrecuperable al leer el blob de origen durante una operación de copia. con errores 404 ResourceNotFound "Error en la copia al leer el origen."

Nota: Cuando el servicio notifica este error subyacente, devuelve ResourceNotFound en el ErrorCode elemento . Si no aparece ningún ErrorCode elemento en la respuesta, aparece una representación de cadena estándar del estado HTTP, como NotFound, .
El tiempo de espera que limita todas las operaciones de copia realizadas. (En la actualidad, el tiempo de espera es de 2 semanas). con errores 500 OperationCancelled "La copia superó el tiempo máximo permitido."
Se produjo un error en la operación de copia con demasiada frecuencia al leer desde el origen y no cumplan una proporción mínima de intentos de éxito. (Este tiempo de espera impide volver a intentar un origen muy deficiente durante dos semanas antes de que se produzca un error). con errores 500 OperationCancelled "Error en la copia al leer el origen."

x-ms-last-access-time realiza un seguimiento de la hora en que se accedió a los datos del blob en función de la directiva de seguimiento de hora de acceso de la última cuenta de almacenamiento. El acceso a los metadatos de un blob no cambia su última hora de acceso.

Facturación

Las solicitudes de precios pueden originarse en clientes que usan API de Blob Storage, ya sea directamente a través de la API REST de Blob Storage o desde una biblioteca cliente de Azure Storage. Estas solicitudes acumulan cargos por transacción. El tipo de transacción afecta a cómo se cobra la cuenta. Por ejemplo, las transacciones de lectura se acumulan en una categoría de facturación diferente a las transacciones de escritura. En la tabla siguiente se muestra la categoría de facturación de Get Blob las solicitudes basadas en el tipo de cuenta de almacenamiento:

Operación Tipo de cuenta de almacenamiento Categoría de facturación
Get Blob Blobs en bloques Premium
De uso general, estándar, v2
De uso general, estándar, v1		 Lee operaciones.

Para obtener información sobre los precios de la categoría de facturación especificada, consulte precios Azure Blob Storage.

Consulte también

Autorización de solicitudes a Azure Storage
Estado y códigos de error
Códigos de error de Blob Storage
Establecimiento de tiempos de espera para las operaciones de Blob Storage