Compartir a través de

Get Blob Properties

  • Artículo

La operación Get Blob Properties devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para el blob. No devuelve el contenido del blob.

Solicitud

Puede construir la solicitud de la Get Blob Properties siguiente manera. Se recomienda usar HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento.

URI de solicitud de método HEAD 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.1

URI del servicio de almacenamiento emulado

Cuando realice 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 HEAD Versión de HTTP
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

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

Parámetros del identificador URI

Puedes especificar los siguientes parámetros adicionales en el URI de la solicitud:

Parámetro Descripción
snapshot Opcional. El parámetro snapshot es un valor opaco DateTime que, cuando está presente, especifica la instantánea de 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 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 Necesario para todas las solicitudes autorizadas. Opcional para solicitudes anónimas. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de los servicios de Azure Storage.
x-ms-lease-id: <ID> Opcional. Si se especifica este encabezado, la Get Blob Properties 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 no se cumple alguna de estas condiciones, se produce un error en la solicitud y se produce un error en la Get Blob Properties operación con el código de estado 412 (error de condición previa).
x-ms-upn Opcional. Versión 2020-06-12 y posteriores. Válido para las cuentas con el espacio de nombres jerárquico habilitado. Si es true, los valores de identidad de usuario que se devuelven en los x-ms-ownerencabezados de respuesta y x-ms-groupx-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 se habilita 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 devolver las propiedades y los metadatos de los blobs 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 siguientes encabezados 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 que la operación de lectura se pueda completar correctamente.

Encabezado de solicitud Descripción
x-ms-encryption-key Necesario. La 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 y un conjunto de encabezados de respuesta.

status code

Una operación correcta devuelve el código de estado 200 Correcto.

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

Encabezados de respuesta

La respuesta de esta operación incluye los encabezados de la tabla siguiente. 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.

Encabezado de respuesta Descripción
Last-Modified La fecha y la hora en la que se modificó por última vez el blob. El formato de la fecha sigue las convenciones de RFC 1123. Para obtener más información, vea Representar valores de fecha y hora en encabezados.

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. Para obtener más información, vea Representar valores de fecha y hora en encabezados.
x-ms-meta-name:value Conjunto de pares nombre-valor que corresponden a los metadatos definidos por el usuario asociados a este blob.
x-ms-tag-count Versión 2019-12-12 y posteriores. Si el blob tiene etiquetas, devuelve el número de etiquetas almacenadas en el blob. Este encabezado no se devuelve si no hay etiquetas en el blob.
x-ms-blob-type:<BlockBlob\|PageBlob\|AppendBlob> El tipo de blob.
x-ms-copy-completion-time:<datetime> Versión 2012-02-12 y posteriores. Hora de finalización del último intento de la operación 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 usa 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 de un error grave o no irrecuperable de 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 usa 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 , 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 usa 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 copiados y el total de bytes del origen en la última operación intentada Copy Blob , donde este blob era el blob de destino. 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 usa Set Blob Properties, Put Blobo Put Block List.
x-ms-copy-source: url Versión 2012-02-12 y posteriores. Una dirección URL de hasta 2 KiB de longitud que especifica el blob de origen que se usó 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 usa Set Blob Properties, Put Blobo Put Block List.
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 se producen errores intermitentes o recuperables que impiden el progreso de la copia, pero que no provocan un error general.
- aborted: la copia finalizó por Abort Copy Blob.
- failed: error de copia. Para obtener información sobre los errores, vea x-ms-copy-status-description.

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 completada Copy Blob que usa Set Blob Properties, Put Blobo Put Block List.
x-ms-incremental-copy: true Versión 2016-05-31 y posteriores. Se incluye si el blob es un blob de copia incremental.
x-ms-copy-destination-snapshot:<datetime> Versión 2016-05-31 y posteriores. Se incluye si el blob es un blob de copia incremental o una instantánea de copia incremental, si x-ms-copy-status es correcto. Hora de instantánea de la última instantánea de copia incremental correcta para este blob.
x-ms-lease-duration: <infinite \| fixed> Cuando se concede un blob, especifica si la concesión es de duración infinita o fija. Se incluye para las solicitudes que usan la versión 2012-02-12 y posteriores.
x-ms-lease-state: <available \| leased \| expired \| breaking \| broken> Estado de concesión del blob. Se incluye para las solicitudes que usan la versión 2012-02-12 y posteriores.
x-ms-lease-status:<locked\| unlocked> El estado de concesión del blob.
Content-Length Tamaño del blob en bytes. Para un blob en páginas, este encabezado devuelve el valor del x-ms-blob-content-length encabezado que se almacena con el blob.
Content-Type Tipo de contenido especificado para el blob. Si no se especifica ningún tipo de contenido, el tipo de contenido predeterminado es application/octet-stream.
Etag La ETag contiene un valor que se puede utilizar para realizar operaciones condicionales. 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 se ha establecido el encabezado Content-MD5 para el blob, 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 MD5 de un blob en bloques incluso cuando la Put Blob solicitud no incluye un encabezado MD5.
Content-Encoding Si anteriormente se estableció el encabezado de solicitud Content-Encoding para el blob, se devuelve ese valor en el encabezado.
Content-Language Si anteriormente se estableció el encabezado de solicitud Content-Language para el blob, se devuelve ese valor en el encabezado.
Content-Disposition Si anteriormente se estableciste el encabezado de solicitud Content-Disposition para el blob, se devuelve ese valor en el encabezado para solicitudes respecto a la versión 2013-08-15 o versiones posteriores.

El campo de encabezado de respuesta Content-Disposition transmite información adicional sobre cómo procesar la carga de respuesta y también se puede utilizar para adjuntar metadatos adicionales. Por ejemplo, si el encabezado se establece attachmenten , indica que el agente de usuario no debe mostrar la respuesta, sino que, en su lugar, muestra un cuadro de diálogo Guardar como.
Cache-Control Si anteriormente se estableció el encabezado de solicitud Cache-Control para el blob, se devuelve ese valor en el encabezado.
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.

Este encabezado no se devuelve para blobs en bloques.
x-ms-request-id Este encabezado identifica de forma única la solicitud que se realizó y puede usarla 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 usa para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en 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.
Date Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.
Accept-Ranges: bytes Indica que el servicio admite solicitudes de contenido parcial de blobs. Se incluye para las solicitudes realizadas con la versión 2013-08-15 y posteriores.
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 de los metadatos de blob o 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-access-tier Versión 2017-04-17 y posteriores. Nivel de blob en páginas en una cuenta de Premium Storage o nivel de un blob en bloques en una cuenta de Blob Storage o de uso general v2. Para obtener una lista de los niveles de blob en páginas Premium permitidos, consulte High-performance Premium Storage and managed disks for VMs (Discos administrados y Premium Storage de alto rendimiento para máquinas virtuales). En el caso de la cuenta de almacenamiento de blobs o de uso general v2, los valores válidos son Hot, CoolCold, y Archive. Nota:Cold el nivel es compatible con la versión 2021-12-02 y posteriores. Para obtener información detallada sobre los niveles de blob en bloques de cuentas de blobs estándar, consulte Niveles de almacenamiento de acceso frecuente , esporádico y de archivo.
x-ms-access-tier-inferred: true Versión 2017-04-17 y posteriores. Solo para blobs en páginas en una cuenta de Premium Storage. Si el nivel de acceso no se establece explícitamente en el blob, el nivel se deduce en función de su longitud de contenido y este encabezado se devuelve con un valor de true. En el caso de los blobs en bloques en Blob Storage o en una cuenta de uso general v2, si el blob no tiene el nivel de acceso establecido, puede deducir el nivel de las propiedades de la cuenta de almacenamiento. Este encabezado solo se establece si se deduce el nivel de blob en bloques.
x-ms-archive-status Versión 2017-04-17 y posteriores. En el caso de la cuenta de blob Storage o de uso general v2, los valores válidos son rehydrate-pending-to-hot, rehydrate-pending-to-cooly rehydrate-pending-to-cold. Si el blob se está rehidratando y está incompleto, se devuelve este encabezado, que indica que el rehidrato está pendiente y muestra el nivel de destino. Para obtener información detallada sobre los niveles de blob en bloques de la cuenta de blob estándar, consulte Niveles de almacenamiento de acceso frecuente , esporádico y de archivo.
x-ms-access-tier-change-time Versión 2017-04-17 y posteriores. Indica la última vez que se cambió el nivel en el objeto . Este encabezado solo se devuelve si se ha establecido un nivel en el blob en bloques. El formato de la fecha sigue las convenciones de RFC 1123. Para obtener más información, vea Representar valores de fecha y hora en encabezados. Para más información sobre los niveles de blob en bloques de la cuenta de blob estándar, consulte Niveles de almacenamiento de acceso frecuente , esporádico y de archivo.
x-ms-client-request-id Se puede usar para solucionar problemas de solicitudes y sus 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 es como máximo 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-rehydrate-priority Versión 2019-12-12 y posteriores. Si un objeto está en estado de rehidratación pendiente, este encabezado se devuelve con prioridad de rehidratación. Los valores válidos son High/Standard. Para obtener información detallada sobre los niveles de blob en bloques de cuentas de blobs estándar, consulte Niveles de almacenamiento de acceso frecuente , esporádico y de archivo.
x-ms-or-{policy-id}_{rule-id} La versión 2019-12-12 y posteriores solo se devuelve para blobs en bloques. policy-id es un valor GUID que representa el identificador de una directiva de replicación de objetos en la cuenta de almacenamiento. rule-id es un valor GUID que representa el identificador de una regla de directiva en el contenedor de blobs. Si la cuenta está ObjectReplicationhabilitada, el valor de este encabezado representa el estado de replicación del blob con los identificadores de regla y directiva especificados, ya sea complete o failed.
x-ms-or-policy-id La versión 2019-12-12 y posteriores solo se devuelve para blobs en bloques. Si la cuenta está ObjectReplicationhabilitada, el valor de este encabezado representa la directiva que rige la replicación.
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 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 Storage.
x-ms-blob-sealed La 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 fecha "retención hasta" 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 es RFC1123 formato.
x-ms-immutability-policy-mode: unlocked/locked Versión 2020-06-12 y posteriores. El modo de directiva de inmutabilidad, devuelto si se establece una directiva de inmutabilidad en el blob. Los valores son unlocked/locked. unlocked indica que el usuario puede cambiar la directiva aumentando o disminuyendo la fecha de 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 en true si el blob contiene una suspensión legal y su valor es true. De lo contrario, el valor se establece en false si el blob contiene una suspensión legal y su valor 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 de propietarios 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 está en [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 de un directorio; de lo contrario, el ámbito es implícito y la ACE pertenece a la ACL de acceso. Cada permiso individual está en [r,w,x,-]{3} formato.
x-ms-resource-type Versión 2020-10-02 y posteriores. Solo para las cuentas con un espacio de nombres jerárquico habilitado. Devuelve el tipo de recurso de la ruta de acceso, que puede ser file o directory.
x-ms-expiry-time Versión 2020-02-10 y posteriores. Solo para las cuentas con un espacio de nombres jerárquico habilitado. Devuelve la hora de expiración establecida en el blob. Solo se devuelve para los archivos que tienen un tiempo de expiración establecido.

Response body

Ninguno.

Respuesta de muestra

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
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 Properties 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.

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, identidad administrada o entidad de servicio de Microsoft Entra para llamar a la Get Blob Properties 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 determinar si una Copy Blob operación ha finalizado, compruebe primero que el valor del x-ms-copy-id encabezado 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 . Pero 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 anteriores a 2012-02-12.

x-ms-copy-status-description contiene más información sobre el error de Copy Blob. Los x-ms-copy-status-description valores 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 con texto de error estándar asociado al código de estado HTTP de 3 dígitos en la especificación HTTP. Para más información, consulte Códigos de error comunes de la API de 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 siguientes descripciones de error pueden cambiar sin advertencia, incluso sin un cambio de versión, por lo que es posible que el texto no coincida exactamente.

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 de copia al leer el origen". Nota: Cuando el servicio notifica este error subyacente, devuelve ResourceNotFound en el <elemento ErrorCode> . Si no aparece ningún <elemento ErrorCode> en la respuesta, aparecerá una representación de cadena estándar del estado HTTP, como NotFound, .
El tiempo de espera que limita todas las operaciones de copia realizadas. (Actualmente, el período de tiempo de espera es de dos 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 Properties las solicitudes basadas en el tipo de cuenta de almacenamiento:

Operación Tipo de cuenta de almacenamiento Categoría de facturación
Get Blob Properties Blobs en bloques Premium
De uso general, estándar, v2		 Otras operaciones
Get Blob Properties 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