Definir camada de Blob

Artigo
01/23/2025

A operação Set Blob Tier define a camada de acesso em um blob. A operação é permitida em um blob de página em uma conta de armazenamento premium e em um blob de bloco em um armazenamento de blob ou conta v2 de uso geral. A camada de blob de página premium (P4/P6/P10/P15/P20/P30/P40/P50/P60) determina o tamanho, IOPS e largura de banda permitidos do blob. A camada de um blob de bloco determina Hot/Cool/Cold/Archive tipo de armazenamento. Esta operação não atualiza o ETag do blob.

Para obter informações detalhadas sobre a hierarquização em nível de blob de bloco, consulte Níveis de armazenamento quentes, frios e de arquivamento.

Solicitar

Você pode construir a solicitação Set Blob Tier da 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	Solicitar URI	Versão HTTP
`PUT`	`https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier`	HTTP/1.1

Parâmetros de URI

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

Parâmetro	Descrição
`snapshot`	Opcional. O parâmetro snapshot é um valor de `DateTime` opaco 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 Criar um instantâneo de um de blob
`versionid`	Opcional para a versão 2019-12-12 e posterior. O parâmetro `versionid` é um valor `DateTime` opaco que, quando presente, especifica a versão do blob para 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 Blob.

Cabeçalhos de 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`	Necessário. 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 Armazenamento do Azure.
`Date` ou `x-ms-date`	Necessário. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure.
`x-ms-access-tier`	Necessário. Indica a camada a ser definida no blob. Para obter uma lista de camadas de blob de página premium permitidas, consulte Armazenamento Premium de alto desempenho e discos gerenciados para VMs. Para armazenamento de blob ou conta v2 de uso geral, os valores válidos são `Hot`, `Cool`, `Cold`e `Archive`. Nota:`Cold` camada é suportada para a versão 2021-12-02 e posterior. Para obter informações detalhadas sobre a hierarquização de nível de blob de conta de blob padrão, consulte Níveis de armazenamento quentes, legais e de arquivamento.
`x-ms-version`	Obrigatório para todos os pedidos autorizados. Especifica a versão da operação a ser usada para essa 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 recomendado para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o registro em log do Storage Analytics.
`x-ms-rehydrate-priority`	Opcional. Indica a prioridade com a qual hidratar um blob arquivado. Suportado na versão 2019-02-02 e mais recente para blobs de bloco. 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; Este cabeçalho será ignorado em pedidos 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 set Blob Tier com esse cabeçalho definido como `High` e definindo`x-ms-access-tier` com o mesmo valor definido anteriormente. A definição de prioridade não pode ser reduzida de `High` para `Standard`.

Esta operação também suporta o uso de cabeçalhos condicionais para hierarquizar o blob somente se uma condição especificada for atendida. Para obter mais informações, consulte Especificar cabeçalhos condicionais para operações de armazenamento de Blob.

Corpo do pedido

Nenhuma.

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 o código de status 202 (Aceito) se a transição para a nova camada estiver pendente.

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

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

Nível	Definir para o nível quente	Definir como nível frio	Definir como nível frio	Definir para a camada de arquivo morto
Blob no nível quente	200	200	200	200
Blob em nível legal	200	200	200	200
Blob na camada fria	200	200	200	200
Blob na camada de arquivo morto	202	202	202	200
Blob na camada de arquivo, reidratando para quente	202	409	409	409
Blob na camada de arquivo, reidratar para arrefecer	409	202	409	409
Blob em camada de arquivo, reidratando a 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 seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho da resposta	Descrição
`x-ms-request-id`	Identifica exclusivamente a solicitação que foi feita e pode ser usada para solucionar a solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
`x-ms-version`	A versão de armazenamento de Blob que foi usada para executar a solicitação. Este cabeçalho é retornado para solicitações feitas na versão 2009-09-19 e posterior.
`x-ms-client-request-id`	Pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho é igual ao valor do cabeçalho `x-ms-client-request-id` se ele estiver presente na solicitação e o valor não contiver mais de 1.024 caracteres ASCII visíveis. Se o cabeçalho `x-ms-client-request-id` 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 operação Set Blob Tier conforme descrito abaixo.

Importante

A Microsoft recomenda o uso do Microsoft Entra ID com identidades gerenciadas para autorizar solicitações ao Armazenamento do Azure. O Microsoft Entra ID oferece segurança superior e facilidade de uso em comparação com a autorização de chave compartilhada.

O Armazenamento do Azure dá suporte ao uso da ID do Microsoft Entra para autorizar solicitações de dados de blob. Com o Microsoft Entra ID, você pode usar o controle de acesso baseado em função do Azure (Azure RBAC) 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 pelo Microsoft Entra ID para retornar um token OAuth 2.0. O token pode ser usado para autorizar uma solicitação no serviço Blob.

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

Permissões

Abaixo estão listadas a ação RBAC necessária para que um usuário, grupo, identidade gerenciada ou entidade de serviço do Microsoft Entra chame a operação Set Blob Tier e a função interna menos privilegiada do RBAC do Azure que inclui essa ação:

ação RBAC do Azure:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
Função interna menos privilegiada:Contribuidor de Dados de Blob de Armazenamento

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

Uma assinatura de acesso compartilhado (SAS) fornece acesso delegado seguro a 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 ele tem para esses recursos e por quanto tempo o SAS é válido.

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

Como prática recomendada de segurança, recomendamos que você use as credenciais do Microsoft Entra em vez da chave da conta de armazenamento, que pode ser comprometida mais facilmente. Se o design do seu aplicativo exigir assinaturas de acesso compartilhado, use as credenciais do Microsoft Entra 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 ao Armazenamento de Blobs. Para saber mais, consulte Entender como a desativação da Chave Compartilhada afeta os tokens SAS.

Delegação de usuários SAS

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

Chamar a operação usando um token SAS delegado a um contêiner ou recurso de blob requer a permissão Write (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 Criar uma SAS de delegação de usuário.

Serviço SAS

Uma SAS de serviço é protegida com a chave da conta de armazenamento. Um 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 operação de usando um token SAS delegado a um contêiner ou recurso de blob requer a permissão Write (w) como parte do token SAS do serviço.

Para saber mais sobre o SAS de serviço, consulte Criar um serviço SAS.

Conta SAS

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

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

Funcionamento	Serviço assinado	Tipo de recurso assinado	Permissão assinada
Definir camada de Blob	Blob (b)	Objeto (o)	Escrever (w)

Para saber mais sobre a conta SAS, consulte Criar uma conta SAS.

Comentários

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

O novo nível de blob não pode ser inferior ao existente.
A nova camada de blob deve ser capaz de acomodar o comprimento do conteúdo do blob. Para obter uma lista de níveis e seu comprimento de conteúdo permitido, consulte Armazenamento premium de alto desempenho e discos gerenciados para VMs.

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

A definição de uma camada em um snapshot é permitida a partir da versão REST 2019-12-12.
Os snapshots hierarquizados para archive não podem ser reidratados novamente para o snapshot. Ou seja, o snapshot não pode ser trazido de volta para uma camada hot ou cool. A única maneira de recuperar os dados de um instantâneo ou versão archive é copiá-los para um novo blob.
Se a versão for um blob de raiz, ele pode ser reidratado de volta para hot ou cool.
Snapshots ou versões em um estado archive não podem ser promovidos para root.
Quando o controle de versão está habilitado, a exclusão de um blob de raiz quando ele estiver em um estado de reidratação pendente resultará no cancelamento da reidratação e a versão estará em um estado archive.
Se um blob for substituído quando estiver em um estado de reidratação pendente e excluído suavemente, isso resultará no cancelamento da reidratação, e a versão do instantâneo excluído suavemente estará em um estado archive.

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

Para blobs que usam criptografia fornecida pelo cliente, Set Blob Tier é suportada para a versão 2023-08-03 e posterior. Para versões anteriores a 2023-08-03, Set Blob Tier retorna o código de status 409 para blobs que usam criptografia fornecida pelo cliente.

Observação

Para obter informações detalhadas sobre a hierarquização em nível de blob de bloco, consulte Níveis de armazenamento quentes, frescos e de arquivamento.

Faturação

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

Funcionamento	Tipo de conta de armazenamento	Categoria de faturação
Definir camada de Blob (camada para baixo)	Blob de bloco premium Padrão de uso geral v2	Operações de gravação
Definir camada de Blob (camada acima)	Blob de bloco premium Padrão de uso geral v2	Operações de leitura

Para saber mais sobre os preços para a categoria de cobrança especificada, consulte de preços do armazenamento de Blob do Azure .

Ver também

Autorizar solicitações ao de Armazenamento do Azure
Códigos de status e de erro
códigos de erro de armazenamento de Blob
Definir tempos limite para operações de armazenamento de Blob

Partilhar via