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 um armazenamento de blobs ou em uma conta de uso geral v2. A camada de um blob de páginas premium (P4/P15//P30P40/P50///P60P6P10/P20) determina o tamanho, o IOPS e a largura de banda permitidos do blob. A camada de um blob de blocos determina o HotColdArchive/Cool//tipo de armazenamento. Essa 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 frequentes, esporádicas e de arquivos.

Solicitação

Você pode construir a solicitação da Set Blob Tier seguinte maneira. Recomendamos que você use HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento e substitua myblob pelo nome do blob para o qual a camada deve ser alterada.

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

Parâmetros do URI

Você pode especificar os seguintes parâmetros adicionais no URI da solicitação:

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

Cabeçalhos da solicitação

Os cabeçalhos de solicitação obrigatórios e opcionais são descritos na tabela a seguir:

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 saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
Date ou x-ms-date	Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
x-ms-access-tier	Obrigatórios. Indica a camada a ser definida no blob. Para obter uma lista das camadas de blob de páginas premium permitidas, consulte Discos gerenciados e Armazenamento Premium de alto desempenho para VMs. Para armazenamento de blobs ou conta de uso geral v2, os valores válidos são Hot, Cool, Colde Archive. Nota:Cold A camada tem suporte para a versão 2021-12-02 e posterior. Para obter informações detalhadas sobre as camadas de nível de blob da conta de blob padrão , consulte Camadas de armazenamento frequentes, esporádicas e de arquivos.
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 de 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 Análise de Armazenamento registro em log.
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 apenas uma vez para versões anteriores a 2020-06-12; esse cabeçalho será ignorado nas solicitações subsequentes. A configuração de prioridade padrão é Standard. A partir da versão 2020-06-12, a prioridade de reidratação pode ser atualizada após ter sido definida anteriormente. A configuração de prioridade pode ser alterada de Standard para High chamando Definir Camada de Blob com esse cabeçalho definido High como e definindo x-ms-access-tier como o mesmo valor definido anteriormente. A configuração de prioridade não pode ser reduzida de High para Standard.

Essa operação também dá suporte ao uso de cabeçalhos condicionais para colocar o blob em camadas somente se uma condição especificada for atendida. Para obter mais informações, consulte Especificar cabeçalhos condicionais para operações de Armazenamento de Blobs.

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 retornará status código 200 (OK) se a nova camada entrar em vigor imediatamente ou status código 202 (Aceito) se a transição para a nova camada estiver pendente.

Para contas de armazenamento Premium, a operação de blob de páginas retorna status código 200 (OK).

Para blobs de blocos, os códigos de status HTTP retornados, com base nas camadas atuais e solicitadas do blob, são descritos na tabela a seguir:

Camada	Definir como camada de acesso frequente	Definir como camada esporádica	Definir como camada fria	Definir como camada de arquivos
Blob na camada quente	200	200	200	200
Blob na camada esporádica	200	200	200	200
Blob na camada fria	200	200	200	200
Blob na camada de arquivos	202	202	202	200
Blob na camada de arquivos, reidratar para quente	202	409	409	409
Blob na camada de arquivo morto, reidratar para esfriar	409	202	409	409
Blob na camada de arquivos, reidratar para frio	409	409	202	409

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

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos a seguir. 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	Identifica exclusivamente a solicitação que foi feita e pode ser usada para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
x-ms-version	A versão do Armazenamento de Blobs que foi usada para executar a solicitação. Esse cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e mais recente.
x-ms-client-request-id	Pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho será igual ao valor do x-ms-client-request-id cabeçalho se ele estiver presente na solicitação e o valor não contiver mais de 1.024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, ele não estará presente na resposta.

Autorização

A autorização é necessária ao chamar qualquer operação de acesso a dados no Armazenamento do Azure. Você pode autorizar a Set Blob Tier operação, conforme descrito abaixo.

Importante

A Microsoft recomenda usar Microsoft Entra ID com identidades gerenciadas para autorizar solicitações ao Armazenamento do Azure. Microsoft Entra ID fornece segurança superior e facilidade de uso em comparação com a autorização de Chave Compartilhada.

Microsoft Entra ID (recomendado)

O Armazenamento do Azure dá suporte ao uso de Microsoft Entra ID para autorizar solicitações para dados de blob. Com Microsoft Entra ID, você pode usar o RBAC (controle de acesso baseado em função) do Azure para conceder permissões a uma entidade de segurança. A entidade de segurança pode ser um usuário, grupo, entidade de serviço de aplicativo ou identidade gerenciada do Azure. A entidade de segurança é autenticada por Microsoft Entra ID para retornar um token OAuth 2.0. Em seguida, o token pode ser usado para autorizar uma solicitação no serviço de Blob.

Para saber mais sobre a autorização usando Microsoft Entra ID, consulte Autorizar o acesso a blobs usando Microsoft Entra ID.

Permissões

Veja abaixo a ação RBAC necessária para um usuário Microsoft Entra, grupo, identidade gerenciada ou entidade de serviço para chamar a Set Blob Tier operação e a função RBAC interna do Azure com menos privilégios que inclui esta ação:

• Ação RBAC do Azure:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
• Função interna com privilégios mínimos:Colaborador de Dados do Blob de Armazenamento

Para saber mais sobre como atribuir funções usando o RBAC do Azure, confira Atribuir uma função do Azure para acesso aos dados de blob.

SAS (assinaturas de acesso compartilhado)

Uma SAS (assinatura de acesso compartilhado) fornece acesso delegado seguro aos recursos em uma conta de armazenamento. Com uma SAS, você tem controle granular sobre como um cliente pode acessar dados. Você pode especificar qual recurso o cliente pode acessar, quais permissões eles têm para esses recursos e por quanto tempo a SAS é válida.

A Set Blob Tier operação dá suporte a três tipos de assinaturas de acesso compartilhado: SAS de delegação de usuário, SAS de serviço e SAS de conta.

Como prática recomendada de segurança, recomendamos que você use Microsoft Entra credenciais em vez da chave da conta de armazenamento, que pode ser comprometida com mais facilidade. Se o design do aplicativo exigir assinaturas de acesso compartilhado, use Microsoft Entra credenciais para criar uma SAS de delegação de usuário, quando possível.

Quando o acesso à Chave Compartilhada não for permitido para a conta de armazenamento, um token SAS de serviço ou um token SAS de conta não será permitido em uma solicitação para o Armazenamento de Blobs. Para saber mais, confira Entender como a não permissão de Chave Compartilhada afeta tokens SAS.

SAS de delegação do usuário

Uma SAS de delegação de usuário é protegida com Microsoft Entra credenciais e também pelas permissões especificadas para a SAS.

Chamar a Set Blob Tier operação usando um token SAS delegado a um recurso de contêiner ou blob requer a permissão Gravar (w) como parte do token SAS de delegação do usuário.

Para saber mais sobre a SAS de delegação de usuário, consulte Create uma SAS de delegação de usuário.

SAS de serviço

Uma SAS de serviço é protegida com a chave da conta de armazenamento. Uma SAS de serviço delega acesso a um recurso em um único serviço de Armazenamento do Azure, como o armazenamento de blobs.

Chamar a Set Blob Tier operação usando um token SAS delegado a um recurso de contêiner ou blob requer a permissão Gravar (w) como parte do token SAS de serviço.

Para saber mais sobre a SAS de serviço, consulte Create uma SAS de serviço.

SAS de Conta

Uma SAS de conta é protegida com a chave da conta de armazenamento. Uma SAS de conta delega acesso a recursos em um ou mais dos serviços de armazenamento. Todas as operações disponíveis através de uma SAS de serviço ou de delegação do usuário também estão disponíveis por meio de uma SAS de conta.

A tabela a seguir indica o tipo de recurso assinado e as permissões assinadas a serem especificadas ao delegar o acesso:

Operação	Serviço assinado	Tipo de recurso assinado	Permissão assinada
Definir camada do Blob	Blob (b)	Objeto (o)	Gravação (w)

Para saber mais sobre a SAS da conta, consulte Create uma SAS de conta.

Chave compartilhada

A Set Blob Tier operação dá suporte à autorização de Chave Compartilhada. A autorização com chaves de conta não é recomendada para a maioria dos cenários, pois é menos segura.

A Microsoft recomenda não permitir a autorização de Chave Compartilhada para a conta de armazenamento quando possível. Para obter mais informações, consulte Impedir autorização com chave compartilhada.

Comentários

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

• A nova camada de blob não pode ser menor do que a existente.
• A nova camada de blob deve ser capaz de acomodar o comprimento do conteúdo do blob. Para obter uma lista de camadas e seu comprimento de conteúdo permitido, consulte Armazenamento premium de alto desempenho e discos gerenciados para VMs.

Definir a camada do blob de blocos em uma conta do Armazenamento de Blobs ou de uso geral v2 tem as seguintes restrições:

• A definição de uma camada em um instantâneo é permitida a partir da versão REST 2019-12-12.
• Instantâneos em camadas não archive podem ser reidratados novamente no instantâneo. Ou seja, o instantâneo não pode ser trazido de volta para uma hot camada ou cool . A única maneira de recuperar os dados de um archive instantâneo ou versão é copiá-los para um novo blob.
• Se a versão for um blob raiz, ela poderá ser reidratada de volta para hot ou cool.
• Instantâneos ou versões em um archive estado não têm permissão para serem promovidos à raiz.
• Quando o controle de versão estiver habilitado, a exclusão de um blob raiz quando ele estiver em um estado pendente de reidratação resultará no cancelamento da reidratação e a versão estará em um archive estado.
• Se um blob for substituído quando estiver em um estado pendente de reidratação e excluído de forma reversível, ele resultará no cancelamento da reidratação e a versão do instantâneo excluído temporariamente estará em um archive estado.

A lista de camadas com suporte não é restrita pela versão da 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 frequente, esporádico e de arquivos.

Cobrança

As solicitações de preços podem ser originadas de clientes que usam APIs de Armazenamento de Blobs, diretamente por meio da API REST do Armazenamento de Blobs ou de uma biblioteca de clientes do Armazenamento do Azure. Essas solicitações acumulam encargos por transação. O tipo de transação afeta a forma como a conta é cobrada. Por exemplo, as transações de leitura se acumulam em uma categoria de cobrança diferente das transações de gravação. A tabela a seguir mostra a categoria de cobrança para Set Blob Tier solicitações com base no tipo de conta de armazenamento:

Operação	Tipo de conta de armazenamento	Categoria de cobrança
Definir Camada de Blob (camada para baixo)	Blob de blocos Premium Uso geral v2 Standard	Operações de gravação
Definir Camada de Blob (camada para cima)	Blob de blocos Premium Uso geral v2 Standard	Operações de leitura

Para saber mais sobre os preços da categoria de cobrança especificada, confira Preços Armazenamento de Blobs do Azure.

Confira também

Autorizar solicitações para o Armazenamento do Azure
Status e códigos de erro
Códigos de erro do Armazenamento de Blobs
Definir tempos limite para operações de Armazenamento de Blobs