Definir camada do Blob

A Set Blob Tier operação define a camada de acesso em um 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. A camada de um blob de páginas Premium determina o tamanho permitido, o IOPS e a largura de banda do blob. A camada de um blob de blocos determina o Hot / Cool / Archive tipo de armazenamento. Esta operação não atualiza a ETag do blob.

Para obter informações detalhadas sobre camadas de nível de blob de blocos, consulte camadas de armazenamento quentes, frias e de arquivo morto.

Solicitação

A solicitação Set Blob Tier pode ser criada da seguinte maneira. HTTPS é recomendado. Substitua myaccount pelo nome da sua conta de armazenamento e myblob pelo nome do blob para o qual a camada deve ser alterada.

Método URI da solicitação Versão de HTTP
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier HTTP/1.1

Parâmetros de URI

Os seguintes parâmetros adicionais podem ser especificados no URI de solicitação.

Parâmetro Descrição
snapshot Opcional. O parâmetro de instantâneo é um DateTime valor opaco que, quando presente, especifica o instantâneo de blob no qual definir a camada. Para obter mais informações sobre como trabalhar com instantâneos de BLOB, consulte criando um instantâneo de um blob
versionid Opcional para as versões 2019-12-12 e mais recentes. O parâmetro VersionId é um DateTime valor opaco que, quando presente, especifica a versão do blob no qual definir a camada.
timeout Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte definindo tempos limite para operações do serviço blob.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação Descrição
Authorization Obrigatórios. Especifica o esquema de autorização, o nome da conta de armazenamento e a assinatura. para obter mais informações, consulte autorizar solicitações para o Azure Armazenamento.
Date ou x-ms-date Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. para obter mais informações, consulte autorizar solicitações para o Azure Armazenamento.
x-ms-access-tier Obrigatórios. Indica a camada a ser definida no BLOB. para obter uma lista de camadas de blob de páginas premium permitidas, consulte Premium de alto desempenho Armazenamento e managed disks para VMs. Para o armazenamento de BLOBs ou a conta de uso geral v2, os valores válidos são 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.
x-ms-version Necessário para todas as solicitações autorizadas. Especifica a versão da operação a ser usada para esta solicitação. para obter mais informações, consulte controle de versão para os serviços de Armazenamento do Azure.
x-ms-client-request-id Opcional. 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. O uso desse cabeçalho é altamente recomendável para correlacionar as atividades do lado do cliente com as solicitações recebidas pelo servidor. para obter mais informações, consulte sobre log de Análise de Armazenamento e log do Azure: usando Logs para rastrear Armazenamento solicitações.
x-ms-rehydrate-priority Opcional. Indica a prioridade com a qual reidratar um blob arquivado. Com suporte na versão 2019-02-02 e mais recente para BLOBs de blocos. Os valores válidos são High / Standard . A prioridade pode ser definida em um blob somente uma vez para versões anteriores a 2020-06-12; Esse cabeçalho será ignorado em solicitações subsequentes. A configuração de prioridade padrão é Standard .

A partir da versão 2020-06-12, a prioridade reidratação pode ser atualizada após ter sido definida anteriormente. A configuração de prioridade pode ser alterada de Standard para High chamando Set Blob Tier com esse cabeçalho definido como High e definindo como x-ms-access-tier o mesmo valor definido anteriormente. A configuração de prioridade não pode ser diminuída de High para 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. Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Corpo da solicitação

Nenhum.

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Código de status

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 operação de blob de página de conta Premium retorna o código de status 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:

Definir como camada quente Definir como camada fria Definir para camada de arquivo morto
Blob na camada quente 200 200 200
Blob na camada fria 200 200 200
Blob na camada de arquivo morto 202 202 200
Blob na camada de arquivo, reidratar para quente 202 409 409
Blob na camada de arquivamento, reidratar a frio 409 202 409

Para obter informações sobre códigos de status, consulte status e códigos de erro.

Cabeçalhos de resposta

A resposta para essa operação inclui os cabeçalhos abaixo. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de Resposta Descrição
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. Para obter mais informações, consulte Solucionando problemas de operações de API.
x-ms-version Indica a versão do serviço Blob usado para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas em relação à versão 2009-09-19 e mais recente.
x-ms-client-request-id Esse cabeçalho pode ser usado para solucionar problemas de solicitações e respostas correspondentes. 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. 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.

Autorização

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.

Comentários

Definir a camada de um blob para BLOBs de páginas em contas Premium tem as seguintes restrições:

Definir a camada do blob de blocos em um armazenamento de BLOBs ou conta de uso geral V2 tem as seguintes restrições:

  • A definição de camada em um instantâneo é permitida iniciando a versão REST 2019-12-12.
  • Os instantâneos em camadas para o arquivo morto não podem ser realimentados no instantâneo. ou seja o instantâneo não pode ser retornado para a camada quente/fria. Somente uma maneira de recuperar os dados de um instantâneo arquivado ou versão é copiá-los para um novo BLOB.
  • Se a versão for um blob raiz, isso poderá ser realimentado para quente ou esporádico.
  • Os instantâneos ou as versões no estado Arquivado não podem ser promovidos para a raiz.
  • 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.
  • 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.

A lista de camadas com suporte não é restrita pela versão de solicitação e novas camadas podem ser adicionadas no futuro.

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.

Consulte Também

autorizar solicitações para o Azure Armazenamento
Status e códigos de erro
Códigos de erro do serviço blob
Configurando os tempos limite para operações de serviço do Blob