Establecer nivel del blob

Artículo
02/03/2024

La Set Blob Tier operación establece el nivel de acceso en un blob. La operación se permite en un blob en páginas en una cuenta de Premium Storage y en un blob en bloques en una cuenta de almacenamiento de blobs o de uso general v2. Un nivel de blob en páginas Premium (P4/P15//P30P40/P50///P60P6P10/P20) determina el tamaño permitido, IOPS y ancho de banda del blob. El nivel de un blob en bloques determina el HotColdArchive/Cool//tipo de almacenamiento. Esta operación no actualiza la ETag del blob.

Para obtener información detallada sobre los niveles de nivel de blob en bloques, consulte Niveles de almacenamiento de acceso frecuente , esporádico y de archivo.

Solicitud

Puede construir la solicitud de la Set Blob Tier siguiente manera. Se recomienda usar HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento y reemplace myblob por el nombre del blob para el que se va a cambiar el nivel.

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

Parámetros del identificador URI

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

Parámetro	Descripción
`snapshot`	Opcional. El parámetro snapshot es un valor opaco `DateTime` en el que, cuando está presente, especifica la instantánea de blob en la que se va a establecer un nivel. Para más información sobre cómo trabajar con instantáneas de blob, consulte Create una instantánea de un blob.
`versionid`	Opcional para la versión 2019-12-12 y posteriores. El `versionid` parámetro es un valor opaco `DateTime` en el que, cuando está presente, especifica la versión del blob en la que se va a establecer un nivel.
`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

Los encabezados de solicitud obligatorios y opcionales se describen en la tabla siguiente:

Encabezado de solicitud	Descripción
`Authorization`	Necesario. Especifica el esquema de autorización, el nombre de la cuenta de almacenamiento 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-access-tier`	Necesario. Indica el nivel que se va a establecer en el blob. Para obtener una lista de los niveles de blob en páginas Premium permitidos, consulte Discos administrados y Premium Storage de alto rendimiento para máquinas virtuales. En el caso de la cuenta de almacenamiento de blobs o de uso general v2, los valores válidos son `Hot`, `Cool`, `Cold`y `Archive`. Nota:`Cold` tier es compatible con la versión 2021-12-02 y posteriores. Para obtener información detallada sobre los niveles de blob de la cuenta de blob estándar, consulte Niveles de almacenamiento de acceso frecuente , esporádico y de archivo.
`x-ms-version`	Necesario para todas las solicitudes autorizadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para más información, consulte Control de versiones para los servicios de Azure Storage.
`x-ms-client-request-id`	Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kB 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 para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, consulte Acerca del registro de Storage Analytics.
`x-ms-rehydrate-priority`	Opcional. Indica la prioridad con la que rehidratar un blob archivado. Compatible con la versión 2019-02-02 y versiones posteriores para blobs en bloques. Los valores válidos son `High`/`Standard`. La prioridad se puede establecer en un blob solo una vez para las versiones anteriores a 2020-06-12; este encabezado se omitirá en las solicitudes posteriores. La configuración de prioridad predeterminada es `Standard`. A partir de la versión 2020-06-12, la prioridad de rehidratación se puede actualizar después de que se estableció anteriormente. La configuración de prioridad se puede cambiar de `Standard` a `High` llamando a Establecer nivel de blob con este encabezado establecido `High` en y estableciendo `x-ms-access-tier` en el mismo valor que antes establecido. La configuración de prioridad no se puede reducir de `High` a `Standard`.

Esta operación también admite el uso de encabezados condicionales para organizar el 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.

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 (OK) si el nuevo nivel surte efecto inmediatamente o el código de estado 202 (aceptado) si la transición al nuevo nivel está pendiente.

En el caso de las cuentas de Premium Storage, la operación de blob en páginas devuelve el código de estado 200 (correcto).

En el caso de los blobs en bloques, los códigos de estado HTTP que se devuelven, en función de los niveles actuales y solicitados del blob, se describen en la tabla siguiente:

Nivel	Establecer en el nivel de acceso frecuente	Establecer en el nivel de acceso esporádico	Se establece en el nivel en frío.	Establecer en el nivel de archivo
Blob en el nivel de acceso frecuente	200	200	200	200
Blob en el nivel de acceso esporádico	200	200	200	200
Blob en el nivel de acceso esporádico	200	200	200	200
Blob en el nivel de archivo	202	202	202	200
Blob en el nivel de archivo, rehidratación a frecuente	202	409	409	409
Blob en el nivel de archivo, rehidratación de acceso esporádico	409	202	409	409
Blob en el nivel de archivo, rehidratación en frío	409	409	202	409

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.

Encabezado de respuesta	Descripción
`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`	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 versiones posteriores.
`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.

Authorization

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

Importante

Microsoft recomienda usar Microsoft Entra ID con identidades administradas para autorizar solicitudes a Azure Storage. Microsoft Entra ID proporciona una mayor seguridad y facilidad de uso en comparación con la autorización de clave compartida.

Azure Storage admite el uso de Microsoft Entra ID para autorizar solicitudes a datos de blobs. Con Microsoft Entra ID, puede usar el control de acceso basado en rol de Azure (RBAC de Azure) para conceder permisos a una entidad de seguridad. La entidad de seguridad puede ser un usuario, un grupo, una entidad de servicio de aplicación o una identidad administrada de Azure. La entidad de seguridad se autentica mediante Microsoft Entra ID para devolver un token de OAuth 2.0. Después, el token se puede usar para autorizar una solicitud en Blob service.

Para más información sobre la autorización mediante Microsoft Entra ID, consulte Autorización del acceso a blobs mediante Microsoft Entra ID.

Permisos

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

Acción RBAC de Azure:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Rol integrado con privilegios mínimos:Colaborador de datos de Storage Blob

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.

Una firma de acceso compartido (SAS) proporciona acceso delegado seguro a los recursos de una cuenta de almacenamiento. Con una SAS, tiene un control granular sobre cómo un cliente puede acceder a los datos. Puede especificar a qué recurso puede tener acceso el cliente, a qué permisos tienen esos recursos y cuánto tiempo es válido la SAS.

La Set Blob Tier operación admite tres tipos de firmas de acceso compartido: SAS de delegación de usuarios, SAS de servicio y SAS de cuenta.

Como procedimiento recomendado de seguridad, se recomienda usar Microsoft Entra credenciales en lugar de la clave de la cuenta de almacenamiento, lo que se puede poner en peligro más fácilmente. Si el diseño de la aplicación requiere firmas de acceso compartido, use Microsoft Entra credenciales para crear una SAS de delegación de usuarios, siempre que sea posible.

Cuando no se permite el acceso a la clave compartida para la cuenta de almacenamiento, no se permitirá un token de SAS de servicio o un token de SAS de cuenta en una solicitud a Blob Storage. Para más información, consulte Descripción de cómo no permitir la clave compartida afecta a los tokens de SAS.

SAS de delegación de usuarios

Una SAS de delegación de usuarios se protege con credenciales de Microsoft Entra y también con los permisos especificados para la SAS.

Llamar a la Set Blob Tier operación mediante un token de SAS delegado en un contenedor o recurso de blob requiere el permiso De escritura (w) como parte del token de SAS de delegación de usuarios.

Para más información sobre la SAS de delegación de usuarios, consulte Create una SAS de delegación de usuarios.

SAS de servicio

Una SAS de servicio está protegida con la clave de cuenta de almacenamiento. Una SAS de servicio delega el acceso a un recurso en un único servicio de Azure Storage, como Blob Storage.

Llamar a la Set Blob Tier operación mediante un token de SAS delegado en un contenedor o recurso de blob requiere el permiso De escritura (w) como parte del token de SAS de servicio.

Para más información sobre la SAS de servicio, consulte Create una SAS de servicio.

SAS de cuenta

Una SAS de cuenta está protegida con la clave de cuenta de almacenamiento. SAS de cuenta delega el acceso a los recursos en uno o varios de los servicios de almacenamiento. Todas las operaciones disponibles con una SAS de servicio o delegación de usuarios están también disponibles con una SAS de cuenta.

En la tabla siguiente se indica el tipo de recurso firmado y los permisos firmados que se deben especificar al delegar el acceso:

Operación	Servicio firmado	Tipo de recurso firmado	Permiso firmado
Establecer nivel del blob	Blob (b)	Objeto (o)	Escritura (w)

Para más información sobre la SAS de la cuenta, consulte Create una SAS de cuenta.

Comentarios

Establecer el nivel de un blob para blobs en páginas en cuentas Premium tiene las restricciones siguientes:

El nuevo nivel de blob no puede ser inferior al existente.
El nuevo nivel de blob debe ser capaz de dar cabida a la longitud del contenido del blob. Para obtener una lista de los niveles y su longitud de contenido permitida, consulte Almacenamiento premium de alto rendimiento y discos administrados para máquinas virtuales.

Establecer el nivel del blob en bloques en una cuenta de Blob Storage o de uso general v2 tiene las restricciones siguientes:

El establecimiento de un nivel en una instantánea se permite a partir de la versión REST 2019-12-12.
Las instantáneas que están en archive capas para no se pueden rehidratar de nuevo en la instantánea. Es decir, la instantánea no se puede devolver a un hot nivel o cool . La única manera de recuperar los datos de una archive instantánea o versión es copiarlos en un nuevo blob.
Si la versión es un blob raíz, se puede rehidratar de nuevo a hot o cool.
Las instantáneas o versiones de un archive estado no se pueden promover a la raíz.
Cuando el control de versiones está habilitado, la eliminación de un blob raíz cuando se encuentra en un estado rehidratado pendiente dará lugar a la cancelación de la rehidratación y la versión estará en un archive estado.
Si se sobrescribe un blob cuando se encuentra en estado de rehidratación y eliminación temporal, se cancelará la rehidratación y la versión de la instantánea eliminada temporalmente estará en un archive estado.

La lista de niveles admitidos no está restringida por la versión de la solicitud y se pueden agregar nuevos niveles en el futuro.

Nota

Para obtener información detallada sobre el nivel de blob en bloques, consulte Niveles de almacenamiento de acceso frecuente , esporádico y de archivo.

Facturación

Las solicitudes de precios se pueden originar en clientes que usan las API de Blob Storage, ya sea directamente a través de la API rest de Blob Storage o de 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 Tier las solicitudes basadas en el tipo de cuenta de almacenamiento:

Operación	Tipo de cuenta de almacenamiento	Categoría de facturación
Establecer el nivel de blob (nivel descendente)	Blobs en bloques Premium De uso general, estándar, v2	Operaciones de escritura
Configuración del nivel de blob (nivel superior)	Blobs en bloques Premium De uso general, estándar, v2	Lee operaciones.

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

Consulte también

Autorización de solicitudes a Azure Storage
Estado y códigos de error
Códigos de error de Blob Storage
Establecimiento de tiempos de espera para las operaciones de Blob Storage

Compartir a través de