Get Blob

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 Create 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-upn	Opcional. Versión 2023-11-03 y posteriores. Válido para las cuentas con espacio de nombres jerárquico habilitado. Si es true, los valores de identidad de usuario que se devuelven en los x-ms-ownerx-ms-group encabezados de respuesta y x-ms-acl se transformarán de Microsoft Entra identificadores de objeto a nombres principales de usuario. Si el valor es false, se devuelven como identificadores de objeto Microsoft Entra. El valor predeterminado es false. Tenga en cuenta que los identificadores de objeto de grupo y aplicación no se traducen, ya que no tienen nombres descriptivos únicos.
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 del 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 de los metadatos del blob o de la aplicación).
x-ms-encryption-key-sha256	Versión 2019-02-02 y posteriores. Este encabezado se devuelve si el blob se cifra 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 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 o no ser 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 acceso de la última 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 hora de último acceso de la cuenta de almacenamiento, consulte Blob Service API.
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 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 el usuario, el grupo y otros en el archivo o directorio. Cada permiso individual tiene [r,w,x,-]{3} formato.
x-ms-acl	Versión 2023-11-03 y posteriores. Solo para cuentas con espacio de nombres jerárquico habilitado. Devuelve la lista combinada de acceso y la lista de control de acceso predeterminada que se establecen para el usuario, el grupo y otro en el archivo o directorio. Cada entrada de control de acceso (ACE) consta de un ámbito, un tipo, un identificador de usuario o grupo y permisos con el formato [scope]:[type]:[id]:[permissions]. El default ámbito indica que la ACE pertenece a la ACL predeterminada para un directorio; de lo contrario, el ámbito es implícito y la ACE pertenece a la ACL de acceso. Cada permiso individual tiene [r,w,x,-]{3} formato.
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

La autorización es necesaria 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.

Importante

Microsoft recomienda usar Microsoft Entra ID con identidades administradas para autorizar solicitudes a Azure Storage. Microsoft Entra ID proporciona una mayor seguridad y facilidad de uso en comparación con la autorización de clave compartida.

Microsoft Entra ID (recomendado)

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 muestra la acción de RBAC necesaria para que un usuario, grupo, identidad administrada o entidad de servicio Microsoft Entra llame a la Get Blob operación y el rol RBAC integrado con privilegios mínimos que incluya esta acción:

• Acción RBAC de Azure:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
• Rol integrado con privilegios mínimos:Lector de datos de Blob de Storage

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

Firmas de acceso compartido (SAS)

Una firma de acceso compartido (SAS) proporciona acceso delegado seguro a los recursos de una cuenta de almacenamiento. Con una SAS, tiene un control pormenorizado sobre cómo un cliente puede acceder a los datos. Puede especificar a qué recurso puede acceder el cliente, qué permisos tienen para esos recursos y cuánto tiempo es válido la SAS.

La Get Blob operación admite tres tipos de firmas de acceso compartido: SAS de delegación de usuarios, SAS de servicio y SAS de cuenta.

Como procedimiento recomendado de seguridad, se recomienda usar Microsoft Entra credenciales en lugar de la clave de la cuenta de almacenamiento, que se puede poner en peligro más fácilmente. Si el diseño de la aplicación requiere firmas de acceso compartido, use Microsoft Entra credenciales para crear una SAS de delegación de usuarios, siempre que sea posible.

Cuando no se permite el acceso a la clave compartida para la cuenta de almacenamiento, no se permitirá un token de SAS de servicio o un token de SAS de cuenta en una solicitud a Blob Storage. Para más información, consulte Descripción de cómo no permitir la clave compartida afecta a los tokens de SAS.

SAS de delegación de usuarios

Una SAS de delegación de usuarios está protegida con credenciales de Microsoft Entra y también por los permisos especificados para la SAS.

La llamada a la Get Blob operación mediante un token de SAS delegado en un recurso de contenedor o blob requiere el permiso De lectura (r) como parte del token de SAS de delegación de usuarios.

Para más información sobre la SAS de delegación de usuarios, consulte Create una SAS de delegación de usuarios.

SAS de servicio

Una SAS de servicio está protegida con la clave de cuenta de almacenamiento. Una SAS de servicio delega el acceso a un recurso en un único servicio de Azure Storage, como Blob Storage.

La llamada a la Get Blob operación mediante un token de SAS delegado en un recurso de contenedor o blob requiere el permiso De lectura (r) como parte del token de SAS de servicio.

Para más información sobre la SAS de servicio, consulte Create una SAS de servicio.

SAS de cuenta

Una SAS de cuenta está protegida con la clave de cuenta de almacenamiento. SAS de cuenta delega el acceso a los recursos en uno o varios de los servicios de almacenamiento. Todas las operaciones disponibles con una SAS de servicio o delegación de usuarios están también disponibles con una SAS de cuenta.

En la tabla siguiente se indica el tipo de recurso firmado y los permisos firmados que se especificarán al delegar el acceso:

Operación	Servicio firmado	Tipo de recurso firmado	Permiso firmado
Get Blob	Blob (b)	Objeto (o)	Lectura (r)

Para más información sobre la SAS de cuenta, consulte Create una SAS de cuenta.

Clave compartida

La Get Blob operación admite la autorización de clave compartida. No se recomienda autorizar con claves de cuenta para la mayoría de los escenarios, ya que es menos seguro.

Microsoft recomienda no permitir la autorización de clave compartida para la cuenta de almacenamiento siempre que sea posible. Para más información, consulte Evitar autorización con clave compartida.

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