Get Blob PropertiesGet Blob Properties

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.The Get Blob Properties operation returns all user-defined metadata, standard HTTP properties, and system properties for the blob. No devuelve el contenido de los blobs.It does not return the content of the blob.

SolicitudRequest

La solicitud Get Blob Properties se puede construir como sigue.The Get Blob Properties request may be constructed as follows. Se recomienda HTTPS.HTTPS is recommended. Reemplace mi cuenta por el nombre de la cuenta de almacenamiento:Replace myaccount with the name of your storage account:

URI de solicitud del método HEADHEAD Method Request URI Versión HTTPHTTP 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.1HTTP/1.1

URI del servicio de almacenamiento emuladoEmulated storage service URI

Al realizar una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto del servicio Blob como 127.0.0.1:10000, seguido del nombre de la cuenta de almacenamiento emulado:When making a request against the emulated storage service, specify the emulator hostname and Blob service port as 127.0.0.1:10000, followed by the emulated storage account name:

URI de solicitud del método HEADHEAD Method Request URI Versión HTTPHTTP Version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1HTTP/1.1

Para obtener más información, vea uso del emulador de Azure Storage para desarrollo y pruebas.For more information, see Using the Azure Storage Emulator for Development and Testing.

Parámetros de URIURI parameters

Se pueden especificar los parámetros adicionales siguientes en el URI de solicitud.The following additional parameters may be specified on the request URI.

ParámetroParameter DescripciónDescription
snapshot Opcional.Optional. El parámetro de instantánea es un valor DateTime opaco que, cuando está presente, especifica la instantánea de blob que se va a recuperar.The snapshot parameter is an opaque DateTime value that, when present, specifies the blob snapshot to retrieve. Para obtener más información sobre cómo trabajar con instantáneas de BLOB, vea crear una instantánea de un BLOB .For more information on working with blob snapshots, see Creating a Snapshot of a Blob
versionid Opcional, versión 2019-12-12 y versiones más recientes.Optional, version 2019-12-12 and newer. El parámetro VersionID es un DateTime valor opaco que, cuando está presente, especifica la versión del BLOB que se va a recuperar.The versionid parameter is an opaque DateTime value that, when present, specifies the Version of the blob to retrieve.
timeout Opcional.Optional. El parámetro timeout se expresa en segundos.The timeout parameter is expressed in seconds. Para obtener más información, consulte configuración de tiempos de espera para las operaciones de BLOB Service.For more information, see Setting Timeouts for Blob Service Operations.

Encabezados de solicitudRequest Headers

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.The following table describes required and optional request headers.

Encabezado de solicitudRequest Header DescripciónDescription
Authorization Obligatorio.Required. Especifica el esquema de autorización, el nombre de cuenta y la firma.Specifies the authorization scheme, account name, and signature. Para obtener más información, consulte autorización de solicitudes para Azure Storage.For more information, see Authorize requests to Azure Storage.
Date o x-ms-dateDate or x-ms-date Obligatorio.Required. Especifica la hora universal coordinada (UTC) de la solicitud.Specifies the Coordinated Universal Time (UTC) for the request. Para obtener más información, consulte autorización de solicitudes para Azure Storage.For more information, see Authorize requests to Azure Storage.
x-ms-version Obligatorio para todas las solicitudes autorizadas, es opcional para las solicitudes anónimas.Required for all authorized requests, optional for anonymous requests. Especifica la versión de la operación que se utiliza para esta solicitud.Specifies the version of the operation to use for this request. Para obtener más información, vea control de versiones de los servicios de Azure Storage.For more information, see Versioning for the Azure Storage Services.
x-ms-lease-id: <ID> Opcional.Optional. Si se especifica este encabezado, la operación Get Blob Properties se realizará solo si se cumplen las dos condiciones siguientes:If this header is specified, the Get Blob Properties operation will be performed only if both of the following conditions are met:

-La concesión del BLOB está activa actualmente.- The blob's lease is currently active.
-El identificador de concesión especificado en la solicitud coincide con el del BLOB.- The lease ID specified in the request matches that of the blob.

Si ambas condiciones no se cumplen, la solicitud producirá un error y la operación Get Blob Properties generará un error con el código de estado 412 (Error de condición previa).If both of these conditions are not met, the request will fail and the Get Blob Properties operation will fail with status code 412 (Precondition Failed).
x-ms-client-request-id Opcional.Optional. Proporciona un valor opaco generado por el cliente con un límite de 1 KiB de caracteres que se registra en los registros de análisis cuando el registro de análisis de almacenamiento está habilitado.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor.Using this header is highly recommended for correlating client-side activities with requests received by the server. Para obtener más información, consulte acerca del registro de Storage Analytics y el registro de Azure: uso de registros para realizar un seguimiento de las solicitudes de almacenamiento.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

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.This operation also supports the use of conditional headers to return blob properties and metadata only if a specified condition is met. Para obtener más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Service.For more information, see Specifying Conditional Headers for Blob Service Operations.

Encabezados de solicitud (claves de cifrado proporcionadas por el cliente)Request Headers (Customer-provided encryption keys)

A partir de la versión 2019-02-02, se pueden especificar los siguientes encabezados en la solicitud para leer un BLOB cifrado con una clave proporcionada por el cliente.Beginning with version 2019-02-02, the following headers may be specified on the request to read a blob encrypted with a customer-provided key. El cifrado con una clave proporcionada por el cliente (y el conjunto de encabezados correspondiente) es opcional.Encryption with a customer-provided key (and the corresponding set of headers) is optional. Si un BLOB se ha cifrado previamente con una clave proporcionada por el cliente, estos encabezados deben incluirse en la solicitud para completar correctamente la operación de lectura.If a blob has previously been encrypted with a customer-provided key, then these headers must be included on the request to complete the read operation successfully.

Encabezado de solicitudRequest header DescripciónDescription
x-ms-encryption-key Obligatorio.Required. La clave de cifrado AES-256 codificada en Base64.The Base64-encoded AES-256 encryption key.
x-ms-encryption-key-sha256 Opcional.Optional. El hash SHA256 con codificación Base64 de la clave de cifrado.The Base64-encoded SHA256 hash of the encryption key.
x-ms-encryption-algorithm: AES256 Obligatorio.Required. Especifica el algoritmo que se va a usar para el cifrado.Specifies the algorithm to use for encryption. El valor de este encabezado debe ser AES256 .The value of this header must be AES256.

Cuerpo de la solicitudRequest Body

Ninguno.None.

ResponseResponse

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.The response includes an HTTP status code and a set of response headers.

Código de estadoStatus Code

Una operación correcta devuelve el código de estado 200 Correcto.A successful operation returns status code 200 (OK).

Para obtener información sobre los códigos de estado, vea códigos de estado y de error.For information about status codes, see Status and Error Codes.

Encabezados de respuestaResponse Headers

La respuesta para esta operación incluye los encabezados siguientes.The response for this operation includes the following headers. La respuesta también puede incluir otros encabezados HTTP estándar.The response may also include additional standard HTTP headers. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

Encabezado de respuestaResponse header DescripciónDescription
Last-Modified La fecha y la hora en la que se modificó por última vez el blob.The date/time that the blob was last modified. El formato de la fecha sigue las convenciones de RFC 1123.The date format follows RFC 1123. Para obtener más información, vea representación de valores de Date-Time en encabezados.For more information, see Representation of Date-Time Values in Headers.

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.Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last modified time of the blob.
x-ms-creation-time Versión 2017-11-09 y versiones más recientes.Version 2017-11-09 and newer. Fecha y hora en que se creó el BLOB.The date/time at which the blob was created. El formato de la fecha sigue las convenciones de RFC 1123.The date format follows RFC 1123. Para obtener más información, vea representación de valores de Date-Time en encabezados.For more information, see Representation of Date-Time Values in Headers.
x-ms-meta-name:value Conjunto de pares nombre-valor que se corresponden con los metadatos definidos por el usuario asociados a este blob.A set of name-value pairs that correspond to the user-defined metadata associated with this blob.
x-ms-tag-count Versión 2019-12-12 o posterior.Version 2019-12-12 or newer. Si el BLOB tiene etiquetas, devuelve el número de etiquetas almacenadas en el BLOB.If the blob has any tags, returns the number of tags stored on the blob. No se devuelve este encabezado si no hay ninguna etiqueta en el BLOB.This header is not returned if there are no tags on the blob.
x-ms-blob-type:<BlockBlob&#124;PageBlob&#124;AppendBlob> El tipo de blob.The blob type.
x-ms-copy-completion-time:<datetime> Versión 2012-02-12 y versiones más recientes.Version 2012-02-12 and newer. Hora de finalización del último intento de la operación Copy Blob en la que este blob era el blob de destino.Conclusion time of the last attempted Copy Blob operation where this blob was the destination blob. Este valor puede especificar la hora de un intento de copia completado, anulado o con errores.This value can specify the time of a completed, aborted, or failed copy attempt. Este encabezado no aparece si hay una copia pendiente, si el blob no ha sido nunca el destino de una operación Copy Blob, o si el blob se ha modificado después de una operación Copy Blob terminada mediante Set Blob Properties, Put Blob o Put Block List.This header does not appear if a copy is pending, if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-status-description: <error string> Versión 2012-02-12 y versiones más recientes. Solo aparece cuando x-ms-copy-status es failed o pending.Version 2012-02-12 and newer, only appears when x-ms-copy-status is failed or pending. Describe la causa del error recuperable o irrecuperable que se ha producido en la operación de copia.Describes cause of fatal or non-fatal copy operation failure. Este encabezado no aparece si el blob no ha sido nunca el destino de una operación Copy Blob, o si el blob se ha modificado después de una operación Copy Blob terminada mediante Set Blob Properties, Put Blob o Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-id: <id> Versión 2012-02-12 y versiones más recientes.Version 2012-02-12 and newer. Identificador de cadena del último intento de la operación Copy Blob en la que este blob era el blob de destino.String identifier for the last attempted Copy Blob operation where this blob was the destination blob. Este encabezado no aparece si el blob no ha sido nunca el destino de una operación Copy Blob, o si el blob se ha modificado después de una operación Copy Blob terminada mediante Set Blob Properties, Put Blob o Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-progress: <bytes copied/bytes total> Versión 2012-02-12 y versiones más recientes.Version 2012-02-12 and newer. Contiene el número de bytes copiados y el número total de bytes existentes en el origen en el último intento de la operación Copy Blob en la que este blob era el blob de destino.Contains the number of bytes copied and the total bytes in the source in the last attempted Copy Blob operation where this blob was the destination blob. Puede mostrar entre 0 y Content-Length bytes copiados.Can show between 0 and Content-Length bytes copied. Este encabezado no aparece si el blob no ha sido nunca el destino de una operación Copy Blob, o si el blob se ha modificado después de una operación Copy Blob terminada mediante Set Blob Properties, Put Blob o Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-source: url Versión 2012-02-12 y versiones más recientes.Version 2012-02-12 and newer. Dirección URL de hasta 2 KiB de longitud que especifica el BLOB de origen usado en la última operación de intento en la Copy Blob que este BLOB era el BLOB de destino.URL up to 2 KiB in length that specifies the source blob used in the last attempted Copy Blob operation where this blob was the destination blob. Este encabezado no aparece si el blob no ha sido nunca el destino de una operación Copy Blob, o si el blob se ha modificado después de una operación Copy Blob terminada mediante Set Blob Properties, Put Blob o Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-copy-status: <pending &#124; success &#124; aborted &#124; failed> Versión 2012-02-12 y versiones más recientes.Version 2012-02-12 and newer. Estado de la operación de copia identificado por x-ms-copy-id. Puede tener estos valores:State of the copy operation identified by x-ms-copy-id, with these values:

- success: Copia completada correctamente.- success: Copy completed successfully.
- pending: La copia está en curso.- pending: Copy is in progress. 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.Check x-ms-copy-status-description if intermittent, non-fatal errors impede copy progress but don’t cause failure.
- aborted: Ha finalizado la copia Abort Copy Blob .- aborted: Copy was ended by Abort Copy Blob.
- failed: Error al copiar.- failed: Copy failed. Para obtener información sobre los errores, vea x-ms-copy-status-description.See x-ms-copy-status-description for failure details.

Este encabezado no aparece si el blob no ha sido nunca el destino de una operación Copy Blob, o si el blob se ha modificado después de una operación Copy Blob terminada mediante Set Blob Properties, Put Blob o Put Block List.This header does not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a completed Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
x-ms-incremental-copy: true Versión 2016-05-31 y versiones más recientes.Version 2016-05-31 and newer. Se incluye si el BLOB es de copia incremental.Included if the blob is incremental copy blob.
x-ms-copy-destination-snapshot:<datetime> Versión 2016-05-31 y versiones más recientes.Version 2016-05-31 and newer. Se incluye si el BLOB es una copia incremental o una instantánea de copia incremental, si x-ms-copy-status es correcto.Included if the blob is incremental copy blob or incremental copy snapshot, if x-ms-copy-status is success. Hora de la instantánea de la última instantánea de copia incremental correcta para este BLOB.Snapshot time of the last successful incremental copy snapshot for this blob.
x-ms-lease-duration: <infinite &#124; fixed> Cuando se concede un blob, especifica si la concesión es de duración infinita o fija.When a blob is leased, specifies whether the lease is of infinite or fixed duration. Se incluye en las solicitudes que usan la versión 2012-02-12 y las versiones más recientes.Included for requests using version 2012-02-12 and newer.
x-ms-lease-state: <available &#124; leased &#124; expired &#124; breaking &#124; broken> Estado de concesión del blob.Lease state of the blob. Se incluye para las solicitudes realizadas con la versión 2012-02-12 y versiones más recientes.Included for requests made using version 2012-02-12 and newer.
x-ms-lease-status:<locked&#124; unlocked> El estado de concesión del blob.The lease status of the blob.
Content-Length Tamaño del blob en bytes.The size of the blob in bytes. Para un blob en páginas, este encabezado devuelve el valor del encabezado x-ms-blob-content-length que está almacenado en el blob.For a page blob, this header returns the value of the x-ms-blob-content-length header that is stored with the blob.
Content-Type Tipo de contenido especificado para el blob.The content type specified for the blob. Si no se especificó ningún tipo de contenido, el tipo de contenido predeterminado es application/octet-stream.If no content type was specified, the default content type is application/octet-stream.
Etag La ETag contiene un valor que se puede utilizar para realizar operaciones condicionales.The ETag contains a value that you can use to perform operations conditionally. Consulte especificar encabezados condicionales para las operaciones de BLOB Service para obtener más información.See Specifying Conditional Headers for Blob Service Operations for more information. Si la versión de la solicitud es 2011-08-18 o una más reciente, el valor ETag estará entre comillas.If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
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.If the Content-MD5 header has been set for the blob, this response header is returned so that the client can check for message content integrity.

En la versión 2012-02-12 y en las versiones más recientes, Put Blob establece el valor MD5 de un blob en bloques incluso si la solicitud Put Blob no incluye un encabezado MD5.In version 2012-02-12 and newer, Put Blob sets a block blob’s MD5 value even when the Put Blob request doesn’t include an MD5 header.
Content-Encoding Si anteriormente se estableció el encabezado de solicitud Content-Encoding para el blob, se devuelve ese valor en el encabezado.If the Content-Encoding request header has previously been set for the blob, that value is returned in this header.
Content-Language Si anteriormente se estableció el encabezado de solicitud Content-Language para el blob, se devuelve ese valor en el encabezado.If the Content-Language request header has previously been set for the blob, that value is returned in this header.
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.If the Content-Disposition request header has previously been set for the blob, that value is returned in this header, for requests against version 2013-08-15 and later.

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.The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. Por ejemplo, si se establece en attachment, indica que el agente de usuario no debe mostrar la respuesta, sino que debe mostrar en su lugar un cuadro de diálogo Guardar como.For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog.
Cache-Control Si anteriormente se estableció el encabezado de solicitud Cache-Control para el blob, se devuelve ese valor en el encabezado.If the Cache-Control request header has previously been set for the blob, that value is returned in this header.
x-ms-blob-sequence-number El número de secuencia actual de un blob en páginas.The current sequence number for a page blob.

Este encabezado no se devuelve para blobs en bloques o blobs en anexos.This header is not returned for block blobs or append blobs.

Este encabezado no se devuelve para los blobs en bloques.This header is not returned for block blobs.
x-ms-request-id Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Para obtener más información, consulte solución de problemas de las operaciones de API.For more information, see Troubleshooting API Operations.
x-ms-version Indica la versión del servicio Blob utilizado para ejecutar la solicitud.Indicates the version of the Blob service used to execute the request. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones posteriores.This header is returned for requests made against version 2009-09-19 and later.

Este encabezado también se devuelve para las solicitudes anónimas sin una versión especificada si el contenedor se marcó para acceso público utilizando la versión 2009-09-19 del servicio Blob.This header is also returned for anonymous requests without a version specified if the container was marked for public access using the 2009-09-19 version of the Blob service.
Date Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
Accept-Ranges: bytes Indica que el servicio admite solicitudes de contenido parcial de blobs.Indicates that the service supports requests for partial blob content. Se incluye para las solicitudes realizadas con la versión 2013-08-15 y versiones más recientes.Included for requests made using version 2013-08-15 and newer.
x-ms-blob-committed-block-count El número de bloques confirmados presentes en el BLOB.The number of committed blocks present in the blob. Este encabezado solo se devuelve para los blobs en anexos.This header is returned only for append blobs.
x-ms-server-encrypted: true/false Versión 2015-12-11 o posterior.Version 2015-12-11 or newer. El valor de este encabezado se establece en true si los datos del BLOB y los metadatos de la aplicación se cifran completamente mediante el algoritmo especificado.The value of this header is set to true if the blob data and application metadata are completely encrypted using the specified algorithm. De lo contrario, el valor se establece en false (cuando el BLOB está sin cifrar o si solo se cifran partes de los metadatos de la aplicación o BLOB).Otherwise, the value is set to false (when the blob is unencrypted, or if only parts of the blob/application metadata are encrypted).
x-ms-encryption-key-sha256 Versión 2019-02-02 o posterior.Version 2019-02-02 or newer. Se devuelve este encabezado si el BLOB se cifra con una clave proporcionada por el cliente.This header is returned if the blob is encrypted with a customer-provided key.
x-ms-encryption-scope Versión 2019-02-02 o posterior.Version 2019-02-02 or newer. Este encabezado se devuelve si el BLOB se cifra con un ámbito de cifrado.This header is returned if the blob is encrypted with an encryption scope.
x-ms-access-tier Versión 2017-04-17 o posterior.Version 2017-04-17 or newer. El nivel de BLOB en páginas en una cuenta de Premium Storage o un nivel de BLOB en bloques en la cuenta de BLOB Storage o de uso general V2.The tier of page blob on a premium storage account or tier of block blob on blob storage or general purpose v2 account. Para obtener una lista de los niveles de BLOB en páginas Premium permitidos, consulte Premium Storage de alto rendimiento y discos administrados para máquinas virtuales.For a list of allowed premium page blob tiers, see High-performance Premium Storage and managed disks for VMs. En el caso de la cuenta de BLOB Storage o de uso general V2, los valores válidos son Hot / Cool / Archive .For blob storage or general purpose v2 account, valid values are Hot/Cool/Archive. Para obtener información detallada sobre el nivel de blobs en bloques de cuentas de blobs estándar , vea niveles de almacenamiento de archivo, esporádico yfrecuente.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-access-tier-inferred: true Versión 2017-04-17 y versiones más recientes.Version 2017-04-17 and newer. Solo para blobs en páginas en una cuenta de Premium Storage.For page blobs on a premium storage account only. Si el nivel de acceso no se establece explícitamente en el BLOB, el nivel se deduce según su longitud de contenido y este encabezado se devolverá con el true valor.If the access tier is not explicitly set on the blob, the tier is inferred based on its content length and this header will be returned with true value. En el caso de los blobs en bloques en Blob Storage o en la cuenta de uso general V2, si el BLOB no tiene establecido el nivel de acceso, deduciremos el nivel de las propiedades de la cuenta de almacenamiento.For block blobs on Blob Storage or general purpose v2 account, if the blob does not have the access tier set then we infer the tier from the storage account properties. Este encabezado solo se establece si se infiere el nivel de BLOB en bloques.This header is set only if the block blob tier is inferred
x-ms-archive-status Versión 2017-04-17 o posterior.Version 2017-04-17 or newer. 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-cool .For blob storage or general purpose v2 account, valid values are rehydrate-pending-to-hot/rehydrate-pending-to-cool. Si el BLOB se está rehidratando y no se completa, se devuelve este encabezado que indica que el rehidratamiento está pendiente y también indica el nivel de destino.If the blob is being rehydrated and is not complete then this header is returned indicating that rehydrate is pending and also tells the destination tier. Para obtener información detallada sobre el nivel de blobs en bloques de cuentas de blobs estándar , vea niveles de almacenamiento de archivo, esporádico yfrecuente.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-access-tier-change-time Versión 2017-04-17 o posterior.Version 2017-04-17 or newer. Esto proporciona el último nivel de tiempo que se cambió en el objeto.This gives the last time tier was changed on the object. Este encabezado solo se devuelve si se ha establecido el nivel en el BLOB en bloques.This header is returned only if tier on block blob was ever set. El formato de la fecha sigue las convenciones de RFC 1123.The date format follows RFC 1123. Para obtener más información, vea representación de valores de Date-Time en encabezados.For more information, see Representation of Date-Time Values in Headers. Para obtener información detallada sobre el nivel de blobs en bloques de cuentas de blobs estándar , vea niveles de almacenamiento de archivo, esporádico yfrecuente.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-client-request-id Este encabezado se puede usar para solucionar problemas de las solicitudes y las respuestas correspondientes.This header can be used to troubleshoot requests and corresponding responses. 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 tiene como máximo 1024 caracteres ASCII visibles.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. Si el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.
x-ms-rehydrate-priority Versión 2019-12-12 o posterior.Version 2019-12-12 or newer. Si un objeto está en estado rehidratado pendiente, este encabezado se devuelve con la prioridad de rehidratación.If an object is in rehydrate pending state then this header is returned with priority of rehydrate. Los valores válidos son High / Standard .Valid values are High/Standard. Para obtener información detallada sobre el nivel de blobs en bloques de cuentas de blobs estándar , vea niveles de almacenamiento de archivo, esporádico yfrecuente.For detailed information about standard blob account block blob level tiering see Hot, cool and archive storage tiers.
x-ms-or-{policy-id}_{rule-id} Versión 2019-12-12 o posterior, devuelta solo para blobs en bloques.Version 2019-12-12 or newer, returned only for block blobs. policy-id es un valor de GUID que representa el identificador de una directiva de replicación de objetos en la cuenta de almacenamiento.policy-id is a guid value representing the identifier of an object replication policy on the storage account. rule-id es un valor de GUID que representa el identificador de una regla de directiva en el contenedor de blobs.rule-id is a guid value which represents the identifier of a policy rule on the blob container. Si la cuenta está ObjectReplication habilitada, el valor de este encabezado representa el estado de replicación del BLOB con la Directiva y los identificadores de regla dados, complete o bien failed .If the account is ObjectReplication enabled, the value of this header represents the replication status of blob with the given policy and rule identifiers, either complete or failed.
x-ms-or-policy-id Versión 2019-12-12 o posterior, devuelta solo para blobs en bloques.Version 2019-12-12 or newer, returned only for block blobs. Si la cuenta está ObjectReplication habilitada, el valor de este encabezado representa la Directiva que rige la replicación.If the account is ObjectReplication enabled, the value of this header represents the policy that governs the replication.
x-ms-last-access-time Versión 2020-02-10 o posterior.Version 2020-02-10 or newer. Indica la última vez que se tuvo acceso a los datos del BLOB en función de la Directiva de seguimiento de tiempo de acceso del último acceso de la cuenta de almacenamiento.Indicates the last time when the blob's data was accessed based on the storage account's last access time tracking policy. El encabezado no se devolverá si la cuenta de almacenamiento no tiene una directiva de seguimiento de tiempo de acceso más reciente o la Directiva está deshabilitada.The header will not be returned if the storage account does not have a last access time tracking policy, or the policy is disabled. Para obtener información sobre cómo establecer la Directiva de seguimiento de tiempo de acceso del último acceso de la cuenta de almacenamiento, consulte API de BLOB Service.For information about setting the storage account's last access time tracking policy, see Blob Service API.

Cuerpo de la respuestaResponse Body

Ninguno.None.

Respuesta de ejemploSample 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>  
  

AuthorizationAuthorization

Si la se establece lista de control de acceso (ACL) del contenedor para permitir el acceso anónimo al blob, cualquier cliente puede llamar a esta operación.If the container's access control list (ACL) is set to allow anonymous access to the blob, any client may call this operation. Si el contenedor es privado, esta operación la puede realizar el propietario de la cuenta y cualquiera que disponga de una firma de acceso compartido con permiso para leer el blob.If the container is private, this operation can be performed by the account owner and by anyone with a Shared Access Signature that has permission to read the blob.

ObservacionesRemarks

Para determinar si una operación Copy Blob se ha completado, primero compruebe que el valor del encabezado x-ms-copy-id coincide con el identificador de copia proporcionado por la llamada original a Copy Blob.To determine if a Copy Blob operation has completed, first check that the x-ms-copy-id header value matches the copy ID provided by the original call to Copy Blob. Si se produce esta coincidencia, significa que ninguna otra aplicación ha anulado la copia y ha iniciado una nueva operación Copy Blob.A match assures that another application did not abort the copy and start a new Copy Blob operation. A continuación, compruebe el encabezado x-ms-copy-status: success.Then check for the x-ms-copy-status: success header. Sin embargo, tenga en cuenta que todas las operaciones de escritura que se realizan en un blob, excepto las operaciones Lease, Put Page y Put Block quitan de él todas las propiedades x-ms-copy-*.However, be aware that all write operations on a blob except Lease, Put Page and Put Block operations remove all x-ms-copy-* properties from the blob. Además, las operaciones Copy Blob que utilizan versiones anteriores a 2012-02-12 tampoco copian estas propiedades.These properties are also not copied by Copy Blob operations that use versions before 2012-02-12.

x-ms-copy-status-description contiene más información sobre el error de Copy Blob.x-ms-copy-status-description contains more information about the Copy Blob failure. En la tabla siguiente se muestran los valores de x-ms-copy-status-description y su significado.The following table shows x-ms-copy-status-description values and their meaning.

En la tabla siguiente se describen los tres campos de cada valor de x-ms-copy-status-description.The following table describes the three fields of every x-ms-copy-status-description value.

ComponenteComponent DescripciónDescription
Código de estado HTTPHTTP status code Número entero de 3 dígitos estándar que especifica el error.Standard 3-digit integer specifying the failure.
Código de errorError code Palabra clave que describe el error que proporciona Azure en el elemento <ErrorCode > .Keyword describing error that is provided by Azure in the <ErrorCode> element. Si no aparece ningún > elemento ErrorCode <, se usa una palabra clave que contiene el texto de error estándar asociado al código de estado http de 3 dígitos en la especificación http.If no <ErrorCode> element appears, a keyword containing standard error text associated with the 3-digit HTTP status code in the HTTP specification is used. Consulte los códigos de error comunesde la API de REST.See Common REST API Error Codes.
InformaciónInformation Descripción detallada del error, entre comillas.Detailed description of failure, in quotes.

En la tabla siguiente se describen los valores de x-ms-copy-status y x-ms-copy-status-description en escenarios de error comunes.The following table describes the x-ms-copy-status and x-ms-copy-status-description values of common failure scenarios.

Importante

El texto de la descripción mostrado aquí puede cambiar sin previo aviso, incluso antes de un cambio de versión, por lo que no debe usarlo literalmente para detectar condiciones de error.Description text shown here can change without warning, even without a version change, so do not rely on matching this exact text.

EscenarioScenario Valor de x-ms-copy-statusx-ms-copy-status value Valor de x-ms-copy-status-descriptionx-ms-copy-status-description value
Operación de copia completada correctamente.Copy operation completed successfully. successsuccess emptyempty
El usuario ha anulado la operación de copia antes de que se haya completado.User aborted copy operation before it completed. abortedaborted emptyempty
Se produjo un error al leer el blob de origen durante una operación de copia, pero la operación se volverá a intentar.A failure occurred when reading from the source blob during a copy operation, but the operation will be retried. pendingpending 502 BadGateway "Al leer el origen se encontró un error que se puede reintentar.502 BadGateway "Encountered a retryable error when reading the source. Se volverá a intentar.Will retry. Hora del error: <hora > "Time of failure: <time>"
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.A failure occurred when writing to the destination blob of a copy operation, but the operation will be retried. pendingpending 500 InternalServerError "Se encontró un error que se puede volver a intentar.500 InternalServerError "Encountered a retryable error. Se volverá a intentar.Will retry. Hora del error: <hora > "Time of failure: <time>"
Se produjo un error irrecuperable al leer el blob de origen durante una operación de copia.An unrecoverable failure occurred when reading from the source blob of a copy operation. con erroresfailed 404 ResourceNotFound "Error en la copia al leer el origen."404 ResourceNotFound "Copy failed when reading the source." Nota: Al notificar este error subyacente, Azure vuelve ResourceNotFound en el elemento <ErrorCode > .Note: When reporting this underlying error, Azure returns ResourceNotFound in the <ErrorCode> element. Si no aparecía ningún > elemento <ErrorCode en la respuesta, aparecerá una representación de cadena estándar del estado de http como NotFound .If no <ErrorCode> element appeared in the response, a standard string representation of the HTTP status such as NotFound would appear.
El tiempo de espera que limita todas las operaciones de copia realizadas.The timeout period limiting all copy operations elapsed. (En la actualidad, el tiempo de espera es de 2 semanas).(Currently the timeout period is 2 weeks.) con erroresfailed 500 OperationCancelled "La copia superó el tiempo máximo permitido."500 OperationCancelled "The copy exceeded the maximum allowed time."
La operación de copia produjo errores muy frecuentes al leer del origen y no alcanzó la relación mínima entre intentos y operaciones correctas.The copy operation failed too often when reading from the source, and didn’t meet a minimum ratio of attempts to successes. (Este tiempo de espera impide que se produzcan reintentos en un origen deficiente durante 2 semanas antes de que se produzca un error).(This timeout prevents retrying a very poor source over 2 weeks before failing). con erroresfailed 500 OperationCancelled "Error en la copia al leer el origen."500 OperationCancelled "The copy failed when reading the source."

x-ms-last-access-time realiza un seguimiento de la hora a la que se obtuvo acceso a los datos del BLOB en función de la Directiva de seguimiento de tiempo de acceso de la cuenta de almacenamiento.x-ms-last-access-time tracks the time when the blob's data was accessed based on the storage account's last access time tracking policy. El acceso a los metadatos de un BLOB no cambia su hora de último acceso.Accessing a blob's metadata does not change its last access time.

Vea tambiénSee also

Autorizar solicitudes para Azure Storage Authorize requests to Azure Storage
Códigos de estado y de error Status and Error Codes
Códigos de error del servicio BLOBBlob Service Error Codes