Establecer nivel del blobSet Blob Tier

La Set Blob Tier operación establece el nivel de acceso en un BLOB.The Set Blob Tier operation sets the access tier on a 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 BLOB Storage o de uso general V2.The operation is allowed on a page blob in a premium storage account and on a block blob in a blob storage or general purpose v2 account. El nivel de un BLOB en páginas Premium determina el tamaño permitido, la e/s por segundo y el ancho de banda del BLOB.A premium page blob's tier determines the allowed size, IOPS, and bandwidth of the blob. El nivel de un BLOB en bloques determina el Hot / Cool / Archive tipo de almacenamiento.A block blob's tier determines Hot/Cool/Archive storage type. Esta operación no actualiza la ETag del BLOB.This operation does not update the blob's ETag.

Para obtener información detallada sobre el nivel de blobs en bloques , consulte niveles de almacenamiento de archivo, esporádico yfrecuente.For detailed information about block blob level tiering see Hot, cool and archive storage tiers.

SolicitudRequest

La solicitud Set Blob Tier se puede construir como sigue.The Set Blob Tier request may be constructed as follows. Se recomienda HTTPS.HTTPS is recommended. Reemplace mi cuenta por el nombre de la cuenta de almacenamiento y mi BLOB por el nombre del BLOB para el que se va a cambiar el nivel.Replace myaccount with the name of your storage account and myblob with the blob name for which the tier is to be changed.

MétodoMethod URI de la solicitudRequest URI Versión HTTPHTTP Version
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1HTTP/1.1

Parámetros de identificador 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 DateTime valor opaco que, cuando está presente, especifica la instantánea de BLOB en la que se va a establecer el nivel.The snapshot parameter is an opaque DateTime value that, when present, specifies the blob snapshot to set tier on. 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 para las versiones 2019-12-12 y posteriores.Optional for versions 2019-12-12 and newer. El parámetro VersionID es un DateTime valor opaco que, cuando está presente, especifica la versión del BLOB en el que se va a establecer el nivel.The versionid parameter is an opaque DateTime value that, when present, specifies the version of the blob to set tier on.
timeout Opcional.Optional. El parámetro de tiempo de espera 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 solicitudRequest Header DescripciónDescription
Authorization Necesario.Required. Especifica el esquema de autorización, el nombre de la cuenta de almacenamiento y la firma.Specifies the authorization scheme, storage 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 Necesario.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-access-tier Necesario.Required. Indica el nivel que se va a establecer en el BLOB.Indicates the tier to be set on the blob. Para obtener una lista de los niveles de BLOB en páginas Premium permitidos, consulte Premium Storage de alto rendimiento y discos administrados para máquinas virtuales.For a list of allowed premium page blob tiers, see High-performance Premium Storage and managed disks for VMs. En el caso de la cuenta de BLOB Storage o de uso general V2, los valores válidos son Hot / Cool / Archive .For blob storage or general purpose v2 account, valid values are Hot/Cool/Archive. Para obtener información detallada sobre el nivel de blobs de la cuenta de BLOB estándar , vea niveles de almacenamiento de archivo, esporádico yfrecuente.For detailed information about standard blob account blob level tiering see Hot, cool and archive storage tiers.
x-ms-version Obligatorio para todas las solicitudes autorizadas.Required for all authorized 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-client-request-id Opcional.Optional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kB que se graba 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-kB 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 see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.
x-ms-rehydrate-priority Opcional.Optional. Indica la prioridad con la que se rehidratará un BLOB archivado.Indicates the priority with which to rehydrate an archived blob. Se admite en la versión 2019-02-02 y versiones más recientes para blobs en bloques.Supported on version 2019-02-02 and newer for Block blobs. Los valores válidos son High / Standard .Valid values are High/Standard. La prioridad se puede establecer en un BLOB solo una vez.The priority can be set on a blob only once. Este encabezado se omitirá en las solicitudes posteriores al mismo BLOB.This header will be ignored on subsequent requests to the same blob. La prioridad predeterminada sin este encabezado es Standard .Default priority without this header is Standard.

Esta operación también admite el uso de encabezados condicionales para organizar el BLOB solo si se cumple una condición especificada.This operation also supports the use of conditional headers to tier the blob 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.

Cuerpo de la solicitudRequest Body

Ninguno.None.

ResponseResponse

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) si el nuevo nivel surte efecto inmediatamente, o el código de estado 202 (aceptado) si la transición al nuevo nivel está pendiente.A successful operation returns status code 200 (OK) if the new tier takes effect immediately, or status code 202 (Accepted) if the transition to the new tier is pending. En la página de la cuenta premium, la operación BLOB devuelve el código de estado 200 (correcto).For premium account page blob operation returns status code 200 (OK). En el caso de los blobs en bloques, debajo de la tabla se describen los códigos de estado http devueltos según el nivel actual y el nivel solicitado del BLOB:For block blobs, below table describes the http status codes returned based on current tier and requested tier of the blob:

Establézcala en HotSet to Hot Establézcala en CoolSet to Cool Establézcala en ArchiveSet to Archive
BLOB en el Hot nivelBlob in Hot Tier 200200 200200 200200
BLOB en el Cool nivelBlob in Cool Tier 200200 200200 200200
BLOB en el Archive nivelBlob in Archive Tier 202202 202202 200200
BLOB en el Archive nivel rehidratar HotBlob in Archive tier rehydrating to Hot 202202 409409 409409
BLOB en el Archive nivel rehidratar CoolBlob in Archive tier rehydrating to Cool 409409 202202 409409

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 headers below. 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-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 más recientes.This header is returned for requests made against version 2009-09-19 and newer.
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.

AuthorizationAuthorization

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.This operation can only be called by the storage account owner and by anyone with a Shared Access Signature that has permission to write to this blob or its container.

ObservacionesRemarks

La configuración de un nivel de BLOB para blobs en páginas en cuentas premium tiene las siguientes restricciones:Setting a blob's tier for page blobs in premium accounts have the following restrictions:

La configuración del nivel de blobs en bloques en una cuenta de BLOB Storage o de uso general V2 tiene las siguientes restricciones:Setting the block blob's tier on a blob storage or general purpose v2 account have the following restrictions:

  • Se permite el establecimiento del nivel en una instantánea a partir de la versión de REST 2019-12-12.Setting tier on a snapshot is allowed starting REST version 2019-12-12.
  • Las instantáneas en capas para archivar no se pueden volver a rehidratar en la instantánea.Snapshots tiered to archive cannot be rehydrated back into the snapshot. es decir,i.e no se puede devolver la instantánea al nivel de acceso frecuente o esporádico.the snapshot cannot be brought back to Hot/Cool tier. La única manera de recuperar los datos de una instantánea archivada o de una versión es copiarlos en un nuevo BLOB.Only way to retrieve the data from an archived snapshot or version is to copy that to a new blob.
  • Si la versión es un BLOB raíz, se puede rehidratar de nuevo a acceso frecuente o esporádico.If the version is a root blob then that can be rehydrated back to Hot or Cool.
  • No se permite la promoción de instantáneas o versiones en estado archivado a raíz.Snapshots or Versions in archived state are not allowed to be promoted to root.
  • Cuando está habilitado el control de versiones, la eliminación del BLOB de raíz cuando se encuentra en rehidratación pendiente provocará la cancelación de rehidratación y la versión tendrá el estado archivado.When versioning is enabled, delete of root blob when in rehydrate pending will result in cancellation of rehydrate and the version will be in Archived state.
  • Si se sobrescribe un BLOB cuando se encuentra en rehidratación pendiente y el estado softdeleted, se cancelará la cancelación del rehidratador y la versión o la instantánea de softdeleted estará en estado archivado.If a blob is overwritten when in rehydrate pending and softdeleted state, it will result in cancellation of rehydrate and the version or softdeleted snapshot will be in Archived state.

La lista de niveles admitidos no está restringida por la versión de la solicitud y los nuevos niveles se pueden agregar en el futuro.The list of supported tiers is not restricted by the request version, and new tiers may be added in the future.

Nota

Para obtener información detallada sobre el nivel de blobs en bloques , consulte niveles de almacenamiento de archivo, esporádico yfrecuente.For detailed information about block blob level tiering see Hot, cool and archive storage tiers.

Consulte 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 BLOB Blob Service Error Codes
Establecer los tiempos de espera para las operaciones del servicio BlobSetting Timeouts for Blob Service Operations