Compartir a través de


Establecer el nivel de blob

La operación Set Blob Tier establece el nivel de acceso en un blob. La operación se permite en un blob en páginas de una cuenta de Premium Storage y en un blob en bloques en una cuenta de almacenamiento de blobs o de uso general v2. El nivel de un blob en páginas premium (P4/P6/P10/P15/P20/P30/P40/P50/P60) determina el tamaño permitido, las IOPS y el ancho de banda del blob. El nivel de un blob en bloques determina Hot/Cool/Cold/Archive tipo de almacenamiento. Esta operación no actualiza la etiqueta ETag del blob.

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

Pedir

Puede construir la solicitud Set Blob Tier de la 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 HTTP
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

Parámetros de URI

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

Parámetro Descripción
snapshot Opcional. El parámetro snapshot es un valor opaco DateTime 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 blobs, consulte Creación de una instantánea de un blob
versionid Opcional para la versión 2019-12-12 y posteriores. El parámetro versionid es un valor opaco DateTime 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 obtener más información, consulte Establecer 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 Obligatorio. Especifica el esquema de autorización, el nombre de la cuenta de almacenamiento y la firma. Para más información, consulte Autorizar solicitudes a Azure Storage.
Date o x-ms-date Obligatorio. Especifica la hora universal coordinada (UTC) de la solicitud. Para más información, consulte Autorizar solicitudes a Azure Storage.
x-ms-access-tier Obligatorio. Indica el nivel que se va a establecer en el blob. 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 el nivel de blob de la cuenta de blobs estándar, consulte niveles de almacenamiento 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 va a usar para esta solicitud. Para más información, consulte Control de versiones de 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. El uso de este encabezado es muy recomendable 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. Se admite en 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 en High y estableciendo x-ms-access-tier en el mismo valor establecido anteriormente. No se puede reducir la configuración de prioridad de High a Standard.

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

Cuerpo de la solicitud

Ninguno.

Respuesta

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Código de estado

Una operación correcta devuelve el código de estado 200 (CORRECTO) 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 nivel de acceso esporádico Establecer en el nivel de 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 frío 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 de esta operación incluye los siguientes encabezados. 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 .

Encabezado de respuesta Descripción
x-ms-request-id Identifica de forma única la solicitud realizada y se puede usar para solucionar problemas de la solicitud. Para obtener 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 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 encabezado x-ms-client-request-id si está presente en la solicitud y el valor no contiene más de 1024 caracteres ASCII visibles. Si el encabezado x-ms-client-request-id no está presente en la solicitud, no estará presente en la respuesta.

Autorización

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

Importante

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. Microsoft Entra ID autentica la entidad de seguridad para devolver un token de 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.

Permisos

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 Set Blob Tier 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.

Observaciones

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

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

  • Se permite establecer un nivel en una instantánea a partir de la versión rest 2019-12-12.
  • Las instantáneas que están en capas en archive no se pueden rehidratar de nuevo en la instantánea. Es decir, la instantánea no se puede volver a un nivel de hot o cool. La única manera de recuperar los datos de una instantánea o versión de archive 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 estado de archive no pueden promoverse 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 estado de archive.
  • Si se sobrescribe un blob cuando se encuentra en un estado de rehidratación pendiente y eliminado temporalmente, se cancelará la rehidratación y la versión de la instantánea eliminada temporalmente estará en un estado de archive.

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

En el caso de los blobs que usan el cifrado proporcionado por el cliente, Set Blob Tier es compatible con la versión 2023-08-03 y versiones posteriores. En el caso de las versiones anteriores a 2023-08-03, Set Blob Tier devuelve el código de estado 409 para los blobs que usan el cifrado proporcionado por el cliente.

Nota

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

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

Operación Tipo de cuenta de almacenamiento Categoría de facturación
Establecer el nivel de blob (nivel descendente) Blob en bloques Premium
Uso general estándar v2
Operaciones de escritura
Configuración del nivel de blob (nivel superior) Blob en bloques Premium
Uso general estándar v2
Operaciones de lectura

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

Consulte también

Autorizar solicitudes a Azure Storage
códigos de error y estado
códigos de error de Blob Storage
Establecer tiempos de espera para las operaciones de Blob Storage