Establecer nivel del blob

Artículo
08/29/2021
Tiempo de lectura: 7 minutos

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 de una cuenta de Premium Storage y en un blob en bloques en una cuenta de Blob Storage o de uso general v2. El nivel de un blob en páginas Premium determina el tamaño permitido, las IOPS y el ancho de banda del blob. El nivel de un blob en bloques determina el Hot / Cool / Archive tipo de almacenamiento. Esta operación no actualiza la ETag del blob.

Para obtener información detallada sobre los niveles de blob en bloques, consulte Niveles de almacenamiento de acceso es cool y de archivo.

Solicitud

La solicitud Set Blob Tier se puede construir como sigue. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento y 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 identificador URI

Se pueden especificar los parámetros adicionales siguientes en el URI de solicitud.

Parámetro	Descripción
`snapshot`	Opcional. El parámetro snapshot es un valor `DateTime` opaco que, cuando está presente, especifica la instantánea de blob en la que se va a establecer el nivel. Para más información sobre cómo trabajar con instantáneas de blob, consulte Creación de una instantánea de un blob.
`versionid`	Opcional para las versiones 2019-12-12 y posteriores. El parámetro versionid es un valor opaco que, cuando está presente, especifica la versión del blob en la que se va `DateTime` a establecer el nivel.
`timeout`	Opcional. El parámetro de tiempo de espera se expresa en segundos. Para obtener más información, vea Establecer tiempos de espera para las operaciones de Blob Service.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud	Descripción
`Authorization`	Obligatorio. Especifica el esquema de autorización, el nombre de la cuenta de almacenamiento y la firma. Para obtener más información, vea Authorize requests to Azure Storage.
`Date` o `x-ms-date`	Obligatorio. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Authorize requests to 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 Premium permitidos, consulte High-performance Premium Storage and managed disks for VMs(Discos administrados y de alto rendimiento para máquinas virtuales). Para blob storage o una cuenta de uso general v2, los valores válidos son `Hot` / `Cool` / `Archive` . Para obtener información detallada sobre los niveles de blob de la cuenta de blob estándar, consulte Niveles de almacenamiento de acceso es cool y de archivo.
`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 Control de versiones de Azure Storage Services.
`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 más información, consulte Acerca del registro de Storage Analytics y registro de Azure: Uso de registros para realizar un seguimiento Storage solicitudes.
`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 más recientes 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 al 12-06-2020. Este encabezado se omitirá en las solicitudes posteriores. El valor de prioridad predeterminado 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 a llamando a Establecer nivel de blob con este encabezado establecido en y estableciendo en el mismo `Standard` `High` valor que se `High` `x-ms-access-tier` estableció anteriormente. 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 en capas del blob solo si se cumple una condición especificada. Para obtener más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Service.

Cuerpo de la solicitud

Ninguno.

Response

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 entra en vigor inmediatamente o el código de estado 202 (aceptado) si la transición al nuevo nivel está pendiente. Para la operación de blob en páginas de la cuenta Premium, devuelve el código de estado 200 (correcto). En el caso de los blobs en bloques, en la tabla siguiente se describen los códigos de estado HTTP devueltos según el nivel actual y el nivel solicitado del blob:

	Establecer en el nivel de acceso de acceso	Se establece en el nivel de acceso esf cool.	Establecer en el nivel de archivo
Blob en el nivel de acceso	200	200	200
Blob en el nivel de acceso es cool	200	200	200
Blob en el nivel de archivo	202	202	200
Blob en el nivel de archivo, rehidrate a hot	202	409	409
Blob en el nivel de archivo, rehidraticación a es cool	409	202	409

Para obtener 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`	Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta. Para más información, consulte Solución de problemas de operaciones de API.
`x-ms-version`	Indica la versión del servicio Blob utilizado para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones más recientes.
`x-ms-client-request-id`	Este encabezado se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del encabezado si está presente en la solicitud y el valor tiene como máximo `x-ms-client-request-id` 1024 caracteres ASCII visibles. Si el `x-ms-client-request-id` encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.

Autorización

Esta operación solo la puede llamar el propietario de la cuenta de almacenamiento y cualquier persona con una firma de acceso compartido que tenga permiso para escribir en este blob o en su contenedor.

Comentarios

El establecimiento del nivel de un blob para blobs en páginas en cuentas Premium tiene las restricciones siguientes:

Es posible que el nuevo nivel de blob no sea inferior al existente.
El nuevo nivel de blob debe ser capaz de adaptarse a la longitud del contenido del blob. Para obtener una lista de los niveles y la longitud de contenido permitida, consulte High-performance Premium Storage and managed disks for VMs(Discos administrados y de alto rendimiento para máquinas virtuales).

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

Se permite establecer el nivel en una instantánea a partir de la versión REST 2019-12-12.
Las instantáneas en capas para archivar no se pueden rehidratar en la instantánea. es decir, La instantánea no se puede devolver al nivel de acceso esfrá está en el nivel de acceso esf otro. La única manera de recuperar los datos de una instantánea o versión archivada es copiarlos en un nuevo blob.
Si la versión es un blob raíz, se puede volver a rehidratar a Es cool o a hot.
Las instantáneas o versiones en estado archivado no pueden promoverse a raíz.
Cuando el control de versiones está habilitado, la eliminación del blob raíz cuando está en rehidratación pendiente dará lugar a la cancelación de rehidratación y la versión estará en estado Archivado.
Si un blob se sobrescribe cuando se encuentra en estado de rehidratación pendiente y recuperación flexible, se cancelará la rehidratación y la versión o la instantánea recuperada parcialmente estarán en estado Archivado.

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