Compartir a través de

Obtención de propiedades de blobs

La Get Blob Properties operación 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.

Request

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

URI de solicitud del método HEAD HTTP version
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

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

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

URI parameters

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

Parameter Description
snapshot Optional. 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 obtener más información sobre cómo trabajar con instantáneas de blobs, consulte Creación de una instantánea de un blob.
versionid Optional. 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 Optional. El parámetro timeout se expresa en segundos. Para obtener más información, consulte Configuración de tiempos de espera para operaciones de Blob Storage.

Request headers

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

Request header Description
Authorization Required. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para más información, consulte Autorizar solicitudes a Azure Storage.
Date o x-ms-date Required. Especifica la hora universal coordinada (UTC) de la solicitud. Para más información, consulte Autorizar 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 va a usar para esta solicitud. Para obtener más información, vea Versiones de los servicios de Azure Storage.
x-ms-lease-id: <ID> Optional. Si se especifica este encabezado, la Get Blob Properties operación se realiza solo 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 operación con el Get Blob Properties código de estado 412 (error de condición previa).
x-ms-upn Optional. Versión 2020-06-12 y posteriores. Válido para 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 respuesta se transformarán de identificadores de objeto de Microsoft Entra a nombres principales de usuario. Si el valor es false, se devuelven como identificadores de objeto de 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 Optional. 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 solicitudes recibidas por el servidor. Para obtener más información, consulte Acerca del registro de Azure Storage Analytics.

Esta operación también admite el uso de encabezados condicionales para devolver propiedades y metadatos de blob solo si se cumple una condición especificada. Para obtener más información, consulte Especificar 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.

Request header Description
x-ms-encryption-key Required. Clave de cifrado AES-256 codificada en Base64.
x-ms-encryption-key-sha256 Optional. Hash SHA256 codificado en Base64 de la clave de cifrado.
x-ms-encryption-algorithm: AES256 Required. Especifica el algoritmo que se va a usar para el cifrado. El valor de este encabezado debe ser AES256.

Request body

None.

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, vea Códigos de estado y de error.

Response headers

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

Response header Description
Last-Modified La fecha y hora en que se modificó por última vez el blob. El formato de fecha sigue a 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.

Tenga en cuenta que Last-Modified no se devolverá para discos administrados e instantáneas de discos administrados que tengan más de 4 TiB.
x-ms-creation-time Versión 2017-11-09 y posteriores. Fecha y hora en que se creó el blob. El formato de fecha sigue a RFC 1123. Para obtener más información, vea Representar valores de fecha y hora en encabezados.
x-ms-meta-name:value Un 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> Tipo de blob.
x-ms-copy-completion-time:<datetime> Versión 2012-02-12 y posteriores. 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 erróneo. Este encabezado no aparece si hay una copia 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. Aparece solo cuando x-ms-copy-status es failed o pending. Describe la causa de un error grave o no grave 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 para 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 desde 0 hasta 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. El estado de la operación de copia identificado por x-ms-copy-id, con estos valores:

- success: La copia se completó correctamente.
- pending: la copia está en curso. Compruebe x-ms-copy-status-description si los errores intermitentes y no irrecuperables impiden el progreso de la copia, pero no provocan errores.
- aborted: La copia terminó con 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 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 se realiza correctamente. Hora de instantánea de la última instantánea de copia incremental correcta para este blob.
x-ms-lease-duration: <infinite \| fixed> Cuando se alquila un blob, especifica si la concesión es 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> Estado de concesión del blob.
Content-Length Tamaño del blob en bytes. En el caso de un blob en páginas, este encabezado devuelve el valor del x-ms-blob-content-length encabezado almacenado 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 puede usar para realizar operaciones condicionalmente. Para obtener más información, consulte Especificar encabezados condicionales para las operaciones de Blob Storage. Si la versión de la solicitud es 2011-08-18 o posterior, el valor de ETag se incluye entre comillas.
Content-MD5 Si se ha establecido el Content-MD5 encabezado 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 el encabezado de Content-Encoding solicitud se ha establecido previamente para el blob, ese valor se devuelve en este encabezado.
Content-Language Si el encabezado de Content-Language solicitud se ha establecido previamente para el blob, ese valor se devuelve en este encabezado.
Content-Disposition Si el encabezado de Content-Disposition solicitud se ha establecido previamente para el blob, ese valor se devuelve en este encabezado, para las solicitudes en la versión 2013-08-15 y posteriores.

El Content-Disposition campo de encabezado de respuesta transmite información adicional sobre cómo procesar la carga útil de respuesta y también se puede usar para adjuntar metadatos adicionales. Por ejemplo, si el encabezado se establece en attachment, indica que el agente de usuario no debe mostrar la respuesta, sino mostrar un cuadro de diálogo Guardar como.
Cache-Control Si el encabezado de Cache-Control solicitud se ha establecido previamente para el blob, ese valor se devuelve en este encabezado.
x-ms-blob-sequence-number Número de secuencia actual de un blob en páginas.

Este encabezado no se devuelve para blobs en bloques ni 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 usarlo para solucionar problemas de la solicitud. Para obtener 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 que se realizan en la versión 2009-09-19 y posteriores.

Este encabezado también se devuelve para solicitudes anónimas sin una versión especificada si el contenedor se marcó para el acceso público mediante la versión 2009-09-19 de Blob Storage.
Date Un valor de fecha y hora UTC generado por el servicio que indica la hora en que se inició la respuesta.
Accept-Ranges: bytes Indica que el servicio admite solicitudes de contenido de blob parcial. 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 en true si los datos del blob y los metadatos de la aplicación están completamente cifrados mediante el algoritmo especificado. De lo contrario, el valor se establece en false (cuando el blob no está cifrado o si solo se cifran partes de los metadatos del blob o 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 se establece el valor de la propiedad de contexto de cifrado, 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 de una cuenta de Premium Storage o nivel de blob en bloques de una cuenta de Blob Storage o de uso general v2. Para obtener una lista de los niveles de blob en páginas prémium permitidos, consulte Premium Storage de alto rendimiento y discos administrados para máquinas virtuales. Para la cuenta de blob Storage o de uso general v2, los valores válidos son Hot, Cool, Coldy Archive. Nota:Cold nivel es compatible con la versión 2021-12-02 y posteriores. Para obtener información detallada sobre la organización en niveles de blob en bloques de cuenta de blob estándar , consulte Niveles de almacenamiento 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 de 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 de Blob Storage o en una cuenta de uso general v2, si el blob no tiene establecido el nivel de acceso, puede inferir el nivel a partir 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. Para el almacenamiento de blobs o la cuenta 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 la rehidratación está pendiente y muestra el nivel de destino. Para obtener información detallada sobre la organización en niveles de blob de bloque de 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 alguna vez se estableció un nivel en el blob en bloques. El formato de fecha sigue a RFC 1123. Para obtener más información, vea Representar valores de fecha y hora en encabezados. Para obtener más información sobre la organización en niveles de blob de bloque de 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 1.024 caracteres ASCII visibles. Si el encabezado x-ms-client-request-id 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 la organización en niveles de blob en bloques de cuenta de blob estándar , consulte Niveles de almacenamiento frecuente, esporádico y de archivo.
x-ms-or-{policy-id}_{rule-id} Versión 2019-12-12 y posteriores, devueltas solo 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 directiva y regla especificados, o completefailed.
x-ms-or-policy-id Versión 2019-12-12 y posteriores, devueltas solo 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 del tiempo 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 del último acceso o si la directiva está deshabilitada. Para obtener información sobre cómo establecer la directiva de seguimiento del tiempo de último acceso de la cuenta de almacenamiento, consulte API de Blob Storage.
x-ms-blob-sealed Versión 2019-12-12 y posteriores, devueltas solo para blobs en anexos. Si se ha sellado el blob en anexos, el valor sería true. Para obtener más información, consulte Anexar Blob Seal
x-ms-immutability-policy-until-date Versión 2020-06-12 y posteriores. Especifica la fecha de "retención hasta" establecida en el blob. Esta es la fecha hasta la que se puede proteger el blob para que no se modifique o elimine. 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. 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 retenció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 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 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 lista de control de acceso predeterminada que se establecen para el usuario, el grupo y otros 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 en 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 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 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 establecido un tiempo de expiración.

Response body

None.

Sample response

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 operación de Get Blob Properties como se describe a continuación.

Important

Microsoft recomienda usar el identificador de Entra de Microsoft con identidades administradas para autorizar solicitudes a Azure Storage. Microsoft Entra ID proporciona seguridad y facilidad de uso superiores 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 principal es autenticada por Microsoft Entra ID para devolver un token OAuth 2.0. Después, el token se puede usar para autorizar una solicitud en Blob service.

Para obtener más información sobre la autorización mediante el identificador de Entra de Microsoft, consulte Autorizar el acceso a blobs mediante el identificador de Microsoft Entra.

Permissions

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

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

Remarks

Para determinar si una Copy Blob operación ha finalizado, primero compruebe 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 anuló la copia e inició una nueva Copy Blob operación. A continuación, verifique 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 las operaciones quitan todas las x-ms-copy-* propiedades del blob. Estas propiedades tampoco se copian en 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:

Component Description
Código de estado HTTP Un entero estándar de 3 dígitos que especifica el error.
Error code 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 obtener más información, consulte códigos de error comunes de la API REST.
Information Descripción detallada del fallo, entre comillas.

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

Important

Las siguientes descripciones de errores pueden cambiar sin previo aviso, incluso sin un cambio de versión, por lo que es posible que el texto no coincida exactamente.

Scenario x-ms-copy-status value x-ms-copy-status-description value
La operación de copia se completó correctamente. success empty
El usuario anuló la operación de copia antes de que se completara. aborted empty
Se produjo un error al leer desde el blob de origen durante una operación de copia, pero se volverá a intentar la operación. pending 502 BadGateway "Se encontró un error que se puede reintentar al leer el origen. Will retry. Hora de error: <tiempo>"
Se produjo un error al escribir en el blob de destino de una operación de copia, pero se volverá a intentar la operación. pending 500 InternalServerError "Se encontró un error que se puede reintentar. Will retry. Hora de error: <tiempo>"
Se produjo un error irrecuperable al leer desde el blob de origen de una operación de copia. failed 404 ResourceNotFound "Error de copia al leer el origen". Nota: Cuando el servicio notifica este error subyacente, se devuelve ResourceNotFound en el <elemento ErrorCode> . Si no aparecía ningún <elemento ErrorCode> en la respuesta, aparecería una representación de cadena estándar del estado HTTP, como NotFound, .
El período de tiempo de espera que limita todas las operaciones de copia transcurridos. (Actualmente, el período de tiempo de espera es de dos semanas). failed 500 OperationCancelled "La copia superó el tiempo máximo permitido".
La operación de copia fallaba con demasiada frecuencia al leer desde el origen y no cumplía con una proporción mínima de intentos a éxitos. (Este tiempo de espera impide volver a intentar un origen muy deficiente durante dos semanas antes de que se produzca un error). failed 500 OperationCancelled "Error de 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 del tiempo de último acceso de la cuenta de almacenamiento. El acceso a los metadatos de un blob no cambia su última hora de acceso.

Billing

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 las solicitudes de Get Blob Properties en función del tipo de cuenta de almacenamiento:

Operation Tipo de cuenta de almacenamiento Billing category
Obtención de propiedades de blobs Blobs en bloques premium
De uso general estándar, v2		 Other operations
Obtención de propiedades de blobs De uso general, estándar, v1 Read operations

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

See also

Autorizar solicitudes a Azure Storage
Estado y códigos de error
códigos de error de Blob Storage

  • Last updated on