Definir camada do BlobSet Blob Tier

A Set Blob Tier operação define a camada de acesso em um blob.The Set Blob Tier operation sets the access tier on a blob. A operação é permitida em um blob de páginas em uma conta de armazenamento Premium e em um blob de blocos em uma conta de armazenamento de BLOBs ou de uso geral 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. A camada de um blob de páginas Premium determina o tamanho permitido, o IOPS e a largura de banda do blob.A premium page blob's tier determines the allowed size, IOPS, and bandwidth of the blob. A camada de um blob de blocos determina o Hot / Cool / Archive tipo de armazenamento.A block blob's tier determines Hot/Cool/Archive storage type. Esta operação não atualiza a ETag do blob.This operation does not update the blob's ETag.

Para obter informações detalhadas sobre camadas de nível de blob de blocos, consulte camadas de armazenamento quentes, frias e de arquivo morto.For detailed information about block blob level tiering see Hot, cool and archive storage tiers.

SolicitaçãoRequest

A solicitação Set Blob Tier pode ser criada da seguinte maneira.The Set Blob Tier request may be constructed as follows. HTTPS é recomendado.HTTPS is recommended. Substitua myaccount pelo nome da sua conta de armazenamento e myblob pelo nome do blob para o qual a camada deve ser alterada.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 da solicitaçãoRequest URI Versão de HTTPHTTP Version
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1HTTP/1.1

Parâmetros de URIURI Parameters

Os seguintes parâmetros adicionais podem ser especificados no URI de solicitação.The following additional parameters may be specified on the request URI.

ParâmetroParameter DescriçãoDescription
snapshot Opcional.Optional. O parâmetro de instantâneo é um DateTime valor opaco que, quando presente, especifica o instantâneo de blob no qual definir a camada.The snapshot parameter is an opaque DateTime value that, when present, specifies the blob snapshot to set tier on. Para obter mais informações sobre como trabalhar com instantâneos de BLOB, consulte criando um instantâneo de um blobFor more information on working with blob snapshots, see Creating a Snapshot of a Blob
versionid Opcional para as versões 2019-12-12 e mais recentes.Optional for versions 2019-12-12 and newer. O parâmetro VersionId é um DateTime valor opaco que, quando presente, especifica a versão do blob no qual definir a camada.The versionid parameter is an opaque DateTime value that, when present, specifies the version of the blob to set tier on.
timeout Opcional.Optional. O parâmetro timeout é expresso em segundos.The timeout parameter is expressed in seconds. Para obter mais informações, consulte definindo tempos limite para operações do serviço blob.For more information, see Setting Timeouts for Blob Service Operations.

Cabeçalhos de solicitaçãoRequest Headers

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.The following table describes required and optional request headers.

Cabeçalho da solicitaçãoRequest Header DescriçãoDescription
Authorization Obrigatórios.Required. Especifica o esquema de autorização, o nome da conta de armazenamento e a assinatura.Specifies the authorization scheme, storage account name, and signature. Para obter mais informações, consulte autorizar solicitações ao armazenamento do Azure.For more information, see Authorize requests to Azure Storage.
Date ou x-ms-dateDate or x-ms-date Necessário.Required. Especifica o UTC (Tempo Universal Coordenado) para a solicitação.Specifies the Coordinated Universal Time (UTC) for the request. Para obter mais informações, consulte autorizar solicitações ao armazenamento do Azure.For more information, see Authorize requests to Azure Storage.
x-ms-access-tier Necessário.Required. Indica a camada a ser definida no BLOB.Indicates the tier to be set on the blob. Para obter uma lista de camadas de blob de páginas Premium permitidas, consulte armazenamento Premium de alto desempenho e discos gerenciados para VMs.For a list of allowed premium page blob tiers, see High-performance Premium Storage and managed disks for VMs. Para o armazenamento de BLOBs ou a conta de uso geral v2, os valores válidos são Hot / Cool / Archive .For blob storage or general purpose v2 account, valid values are Hot/Cool/Archive. Para obter informações detalhadas sobre camadas de nível de blob de conta de blob padrão, consulte camadas de armazenamento quentes, frias e de arquivo morto.For detailed information about standard blob account blob level tiering see Hot, cool and archive storage tiers.
x-ms-version Necessário para todas as solicitações autorizadas.Required for all authorized requests. Especifica a versão da operação a ser usada para esta solicitação.Specifies the version of the operation to use for this request. Para obter mais informações, consulte controle de versão para os serviços de armazenamento do Azure.For more information, see Versioning for the Azure Storage Services.
x-ms-client-request-id Opcional.Optional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 kB que é registrado nos logs de análise quando o log da análise de armazenamento 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. O uso desse cabeçalho é altamente recomendável para correlacionar as atividades do lado do cliente com as solicitações recebidas pelo servidor.Using this header is highly recommended for correlating client-side activities with requests received by the server. Para obter mais informações, consulte sobre log de análise de armazenamento e log do Azure: usando logs para rastrear solicitações de armazenamento.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 a prioridade com a qual reidratar um blob arquivado.Indicates the priority with which to rehydrate an archived blob. Com suporte na versão 2019-02-02 e mais recente para BLOBs de blocos.Supported on version 2019-02-02 and newer for Block blobs. Os valores válidos são High / Standard .Valid values are High/Standard. A prioridade pode ser definida em um blob apenas uma vez.The priority can be set on a blob only once. Esse cabeçalho será ignorado em solicitações subsequentes para o mesmo BLOB.This header will be ignored on subsequent requests to the same blob. A prioridade padrão sem esse cabeçalho é Standard .Default priority without this header is Standard.

Essa operação também dará suporte ao uso de cabeçalhos condicionais para nivelar o blob somente se uma condição especificada for atendida.This operation also supports the use of conditional headers to tier the blob only if a specified condition is met. Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.For more information, see Specifying Conditional Headers for Blob Service Operations.

Corpo da solicitaçãoRequest Body

nenhuma.None.

RespostaResponse

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.The response includes an HTTP status code and a set of response headers.

Código de statusStatus Code

Uma operação bem-sucedida retorna o código de status 200 (OK) se a nova camada entrar em vigor imediatamente ou código de status 202 (aceito) se a transição para a nova camada estiver pendente.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. A operação de blob de página de conta Premium retorna o código de status 200 (OK).For premium account page blob operation returns status code 200 (OK). Para BLOBs de blocos, a tabela abaixo descreve os códigos de status http retornados com base na camada atual e na camada solicitada do blob:For block blobs, below table describes the http status codes returned based on current tier and requested tier of the blob:

Definida como HotSet to Hot Definida como CoolSet to Cool Definida como ArchiveSet to Archive
Blob na Hot camadaBlob in Hot Tier 200200 200200 200200
Blob na Cool camadaBlob in Cool Tier 200200 200200 200200
Blob na Archive camadaBlob in Archive Tier 202202 202202 200200
Blob na Archive camada reidratar para HotBlob in Archive tier rehydrating to Hot 202202 409409 409409
Blob na Archive camada reidratar para CoolBlob in Archive tier rehydrating to Cool 409409 202202 409409

Para obter informações sobre códigos de status, consulte status e códigos de erro.For information about status codes, see Status and Error Codes.

Cabeçalhos de respostaResponse Headers

A resposta para essa operação inclui os cabeçalhos abaixo.The response for this operation includes the headers below. A resposta também pode incluir cabeçalhos padrão HTTP adicionais.The response may also include additional standard HTTP headers. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

Cabeçalho de RespostaResponse Header DescriçãoDescription
x-ms-request-id Esse cabeçalho identifica a solicitação que foi feita de forma exclusiva e pode ser usado para solucionar problemas na solicitação.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Para obter mais informações, consulte Solucionando problemas de operações de API.For more information, see Troubleshooting API Operations.
x-ms-version Indica a versão do serviço Blob usado para executar a solicitação.Indicates the version of the Blob service used to execute the request. Esse cabeçalho é retornado para solicitações feitas em relação à versão 2009-09-19 e mais recente.This header is returned for requests made against version 2009-09-19 and newer.
x-ms-client-request-id Esse cabeçalho pode ser usado para solucionar problemas de solicitações e respostas correspondentes.This header can be used to troubleshoot requests and corresponding responses. O valor desse cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente na solicitação e o valor for de no máximo 1024 caracteres ASCII visíveis.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. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, esse cabeçalho não estará presente na resposta.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

AutorizaçãoAuthorization

Essa operação só pode ser chamada pelo proprietário da conta de armazenamento e por qualquer pessoa com uma assinatura de acesso compartilhado que tenha permissão para gravar nesse BLOB ou em seu contêiner.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.

ComentáriosRemarks

Definir a camada de um blob para BLOBs de páginas em contas Premium tem as seguintes restrições:Setting a blob's tier for page blobs in premium accounts have the following restrictions:

Definir a camada do blob de blocos em um armazenamento de BLOBs ou conta de uso geral V2 tem as seguintes restrições:Setting the block blob's tier on a blob storage or general purpose v2 account have the following restrictions:

  • A definição de camada em um instantâneo é permitida iniciando a versão REST 2019-12-12.Setting tier on a snapshot is allowed starting REST version 2019-12-12.
  • Os instantâneos em camadas para o arquivo morto não podem ser realimentados no instantâneo.Snapshots tiered to archive cannot be rehydrated back into the snapshot. ou sejai.e o instantâneo não pode ser retornado para a camada quente/fria.the snapshot cannot be brought back to Hot/Cool tier. Somente uma maneira de recuperar os dados de um instantâneo arquivado ou versão é copiá-los para um novo BLOB.Only way to retrieve the data from an archived snapshot or version is to copy that to a new blob.
  • Se a versão for um blob raiz, isso poderá ser realimentado para quente ou esporádico.If the version is a root blob then that can be rehydrated back to Hot or Cool.
  • Os instantâneos ou as versões no estado Arquivado não podem ser promovidos para a raiz.Snapshots or Versions in archived state are not allowed to be promoted to root.
  • Quando o controle de versão está habilitado, a exclusão do blob raiz quando em reidratar pendente resultará no cancelamento de reidratar e a versão estará no estado arquivado.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.
  • Se um blob for substituído quando estiver no estado reidratar Pending e SoftDeleted, ele resultará em cancelamento de reidratar e a versão ou o instantâneo de SoftDeleted estará no estado arquivado.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.

A lista de camadas com suporte não é restrita pela versão de solicitação e novas camadas podem ser adicionadas no futuro.The list of supported tiers is not restricted by the request version, and new tiers may be added in the future.

Observação

Para obter informações detalhadas sobre camadas de nível de blob de blocos, consulte camadas de armazenamento quentes, frias e de arquivo morto.For detailed information about block blob level tiering see Hot, cool and archive storage tiers.

Consulte TambémSee Also

Autorizar solicitações ao armazenamento do Azure Authorize requests to Azure Storage
Status e códigos de erro Status and Error Codes
Códigos de erro do serviço blob Blob Service Error Codes
Configurando os tempos limite para operações de serviço do BlobSetting Timeouts for Blob Service Operations