Get Blob MetadataGet Blob Metadata

La operación Get Blob Metadata devuelve todos los metadatos definidos por el usuario para el blob o la instantánea especificados.The Get Blob Metadata operation returns all user-defined metadata for the specified blob or snapshot.

SolicitudRequest

La solicitud Get Blob Metadata se puede construir como sigue.The Get Blob Metadata 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 GET o HEADGET or HEAD Method Request URI Versión HTTPHTTP Version
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata&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 GET o HEADGET or HEAD Method Request URI Versión HTTPHTTP Version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=metadata 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 la 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 Metadata se realizará solo si se cumplen las dos condiciones siguientes:If this header is specified, the Get Blob Metadata 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 Metadata 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 Metadata 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 para obtener la operación de metadatos del blob solo si se cumple una condición especificada.This operation also supports the use of conditional headers to get the blob's metadata operation 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.

RespuestaResponse

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
x-ms-meta-name:value Devuelve un valor de metadatos para el contenedor.Returns a metadata value for the container.
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 fecha y hora 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.
ETag La ETag del blob.The ETag for the blob. 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.
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.
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.

Cuerpo de la respuestaResponse Body

Ninguno.None.

AuthorizationAuthorization

Esta operación la puede realizar el propietario de la cuenta o cualquiera que utilice una firma de acceso compartido con permiso para leer el blob.This operation can be performed by the account owner or by anyone using a Shared Access Signature that has permission to read the blob. Si se ha establecido la ACL del contenedor para permitir el acceso anónimo, cualquier cliente puede llamar a esta operación.If the container's ACL is set to allow anonymous access, any client may call this operation.

ObservacionesRemarks

Ninguno.None.

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