Set Blob Properties

  • Artículo

La operación Set Blob Properties establece las propiedades del sistema en el blob.

Solicitud

La solicitud Set Blob Properties se puede construir como sigue. Se recomienda usar HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento:

URI de solicitud de método PUT Versión de HTTP
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

URI de servicio de almacenamiento emulado

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

URI de solicitud de método PUT Versión de HTTP
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

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

Parámetros del identificador URI

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

Parámetro Descripción
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 (todos los tipos de blobs)

En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales para todos los tipos de blobs.

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
x-ms-version Obligatorio para todas las solicitudes autorizadas. 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-blob-cache-control Opcional. Modifica la cadena de control de caché para el blob.

Si esta propiedad no se especifica en la solicitud, la propiedad se borra para el blob. Las llamadas posteriores a Get Blob Properties no devuelven esta propiedad, a menos que se establezca explícitamente en el blob de nuevo.
x-ms-blob-content-type Opcional. Establece el tipo de contenido del blob.

Si esta propiedad no se especifica en la solicitud, la propiedad se borra para el blob. Las llamadas posteriores a Get Blob Properties no devuelven esta propiedad, a menos que se establezca explícitamente en el blob de nuevo.
x-ms-blob-content-md5 Opcional. Establece el hash MD5 del blob.

Si esta propiedad no se especifica en la solicitud, la propiedad se borra para el blob. Las llamadas posteriores a Get Blob Properties no devuelven esta propiedad, a menos que se establezca explícitamente en el blob de nuevo.
x-ms-blob-content-encoding Opcional. Establece la codificación del contenido del blob.

Si esta propiedad no se especifica en la solicitud, la propiedad se borra para el blob. Las llamadas posteriores a Get Blob Properties no devuelven esta propiedad, a menos que se establezca explícitamente en el blob de nuevo.
x-ms-blob-content-language Opcional. Establece el idioma del contenido del blob.

Si esta propiedad no se especifica en la solicitud, la propiedad se borra para el blob. Las llamadas posteriores a Get Blob Properties no devuelven esta propiedad, a menos que se establezca explícitamente en el blob de nuevo.
x-ms-lease-id:<ID> Obligatorio si el blob tiene una concesión activa. Para realizar esta operación en un blob con una concesión activa, especifique el identificador de concesión válido de este encabezado.
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 cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor. Para obtener más información, vea Supervisar Azure Blob Storage.
x-ms-blob-content-disposition Opcional. Establece el encabezado Content-Disposition del blob. Disponible para 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 de respuesta y se puede usar para adjuntar metadatos adicionales. Por ejemplo, si 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 con un nombre de archivo distinto del nombre de blob especificado.

La respuesta de las operaciones Get Blob y Get Blob Properties incluye el content-disposition encabezado .
Origin Opcional. Especifica el origen del que se emitirá la solicitud. La presencia de este encabezado da lugar a encabezados de uso compartido de recursos entre orígenes (CORS) en la respuesta. Para más información, consulte Compatibilidad con CORS (uso compartido de recursos entre orígenes) para los servicios de Azure Storage.

Esta operación también admite el uso de encabezados condicionales que permiten establecer las propiedades del blob solo si se cumple una condición especificada. Para más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Storage.

Encabezados de solicitud (solo blobs en páginas)

En la tabla siguiente se describen los encabezados de solicitud que solo se aplican a las operaciones en blobs en páginas:

Encabezado de solicitud Descripción
x-ms-blob-content-length: byte value Opcional. Cambia el tamaño de un blob en páginas por el tamaño especificado. Si el valor especificado es menor que el tamaño actual del blob, se borran todos los blobs en páginas con valores mayores que el valor especificado.

Esta propiedad no se puede usar para cambiar el tamaño de un blob en bloques o un blob en anexos. Establecer esta propiedad para un blob en bloques o un blob en anexos devuelve el código de estado 400 (solicitud incorrecta).
x-ms-sequence-number-action: {max, update, increment} Opcional, pero necesario si se establece el encabezado x-ms-blob-sequence-number para la solicitud. Esta propiedad solo se aplica a los blobs en páginas.

Esta propiedad indica el modo en que el servicio debe modificar el número de secuencia del blob. Especifique una de las opciones siguientes para esta propiedad:

- max: establece que el número de secuencia sea el mayor del valor incluido con la solicitud y el valor almacenado actualmente para el blob.
- update: establece el número de secuencia en el valor que se incluye con la solicitud.
- increment: incrementa el valor del número de secuencia en 1. Si especifica esta opción, no incluya .x-ms-blob-sequence-number header Si lo hace, se devuelve el código de estado 400 (solicitud incorrecta).
x-ms-blob-sequence-number: <num> Opcional, pero necesario si la propiedad x-ms-sequence-number-action se establece en max o update. Esta propiedad solo se aplica a los blobs en páginas.

La propiedad establece el número de secuencia del blob. El número de secuencia es una propiedad controlada por el usuario que se puede utilizar para hacer un seguimiento de las solicitudes y administrar los problemas de simultaneidad. Para obtener más información, consulte la operación Put Page .

Use esta propiedad junto con x-ms-sequence-number-action para actualizar el número de secuencia del blob al valor especificado o al superior de los valores especificados con la solicitud o almacenados actualmente con el blob. Este encabezado no se debe especificar si x-ms-sequence-number-action se establece incrementen , en cuyo caso el servicio incrementa automáticamente el número de secuencia en uno.

Para establecer el número de secuencia en un valor elegido por usted, esta propiedad se debe especificar en la solicitud junto con x-ms-sequence-number-action.

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

Encabezados de respuesta

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

Sintaxis Descripción
ETag Contiene un valor que puede usar para realizar operaciones condicionalmente. Consulte Especificación de encabezados condicionales para las operaciones de Blob Storage para obtener más información. Si la versión de la solicitud es 2011-08-18 o posterior, el valor ETag se incluye entre comillas.
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 de escritura realizada en el blob (incluidas las actualizaciones de los metadatos o las propiedades del blob) cambia la hora de la última modificación del blob.
x-ms-blob-sequence-number Si el blob es un blob en páginas, con este encabezado se devuelve el número de secuencia actual del blob.
x-ms-request-id Identifica de forma única la solicitud que se realizó y se puede usar para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión de Blob Storage que se usó para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y posteriores.
Date Valor de fecha y hora UTC generado por el servicio, que indica la hora a la que se inició la respuesta.
Access-Control-Allow-Origin Se devuelve si la solicitud incluye un encabezado Origin y se ha habilitado CORS con una regla de coincidencia. Si hay una coincidencia, este encabezado devuelve el valor del encabezado de solicitud de origen.
Access-Control-Expose-Headers Se devuelve si la solicitud incluye un encabezado Origin y se ha habilitado CORS con una regla de coincidencia. Devuelve la lista de encabezados de respuesta que se van a exponer al cliente o el emisor de la solicitud.
Access-Control-Allow-Credentials Se devuelve si la solicitud incluye un Origin encabezado y CORS está habilitado con una regla coincidente que no permite todos los orígenes. El encabezado se establecerá en true.
x-ms-client-request-id Se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado si está presente en la solicitud y el valor no contiene más de 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, no estará presente en la respuesta.

Response body

Ninguno.

Authorization

Se requiere autorización al llamar a cualquier operación de acceso a datos en Azure Storage. Puede autorizar la Set Blob Properties operación como se describe a continuación.

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 o entidad de servicio de Microsoft Entra para llamar a la Set 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

La semántica para actualizar las propiedades de un blob es la siguiente:

  • El número de secuencia de un blob en páginas solo se actualiza si la solicitud cumple alguna de las condiciones siguientes:

    • La solicitud establece en x-ms-sequence-number-actionmax o update, y especifica un valor para el x-ms-blob-sequence-number encabezado .

    • La solicitud establece en x-ms-sequence-number-actionincrement, que indica que el servicio debe incrementar el número de secuencia en uno.

  • El tamaño de un blob en páginas únicamente se modifica si la solicitud especifica un valor para el encabezado x-ms-content-length.

  • Para cambiar el tamaño de un blob en páginas en una cuenta de premium storage, el nuevo tamaño no debe superar la longitud de contenido permitida por el nivel existente. Llame a Set Blob Tier (Establecer nivel de blob ) antes de cambiar el tamaño del blob. Para obtener una lista de los niveles y la longitud de contenido permitida, consulte Almacenamiento Premium de alto rendimiento y discos administrados para máquinas virtuales.

  • Si una solicitud establece solo x-ms-blob-sequence-number o x-ms-content-length, no se modifica ninguna de las otras propiedades del blob.

  • Si se establece una o varias de las siguientes propiedades en la solicitud, todas las propiedades se establecen juntas. Si no se proporciona un valor para una propiedad cuando se establece al menos uno de ellos, esa propiedad se borra para el blob.

    • x-ms-blob-cache-control
    • x-ms-blob-content-type
    • x-ms-blob-content-md5
    • x-ms-blob-content-encoding
    • x-ms-blob-content-language
    • x-ms-blob-content-disposition

Nota

Para una firma de acceso compartido (SAS), puede invalidar determinadas propiedades almacenadas para el blob especificando parámetros de consulta como parte de la firma de acceso compartido. Estas propiedades incluyen cache-control, content-type, content-encoding, content-language y content-disposition. Para más información, consulte Creación de una SAS de servicio.

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 Set Blob Properties las solicitudes basadas en el tipo de cuenta de almacenamiento:

Operación Tipo de cuenta de almacenamiento Categoría de facturación
Set Blob Properties Blobs en bloques Premium
De uso general, estándar, v2		 Otras operaciones
Set Blob Properties De uso general, estándar, v1 Operaciones de escritura

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

Consulte también