Definir camada de blob
A operação Set Blob Tier
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 v2 de uso geral. A camada de um blob de página premium (P4
/P6
/P10
/P15
/P20
/P30
/P40
/P50
/P60
) determina o tamanho permitido, o IOPS e a largura de banda do blob. A camada de um blob de blocos determina Hot
/Cool
/Cold
/Archive
tipo de armazenamento. Essa operação não atualiza a ETag do blob.
Para obter informações detalhadas sobre camadas no nível de blob de blocos, consulte camadas de armazenamento frequentes, esporádicas e de arquivos.
Pedir
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 | URI de solicitação | 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 da solicitação:
Parâmetro | Descrição |
---|---|
snapshot |
Opcional. O parâmetro de 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 Criar um instantâneo de um blob |
versionid |
Opcional para a versão 2019-12-12 e posterior. O parâmetro versionid é 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 de solicitação
Os cabeçalhos de solicitação obrigatórios e opcionais são descritos na tabela a seguir:
Cabeçalho de 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 UTC (Tempo Universal Coordenado) 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áginas premium permitidas, consulte Armazenamento Premium de alto desempenho e discos gerenciados para VMs. Para armazenamento de blobs ou conta de uso geral v2, os valores válidos são Hot , Cool , Cold e Archive .
Observação:Cold camada tem suporte para a versão 2021-12-02 e posterior. Para obter informações detalhadas sobre a camada 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 essa solicitação. Para obter mais informações, consulte Controle de Versão dos 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. Usar esse cabeçalho é altamente recomendável para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o log da Análise de Armazenamento. |
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 depois de definida anteriormente. A configuração de prioridade pode ser alterada de Standard para High chamando Definir camada de blob com esse cabeçalho definido como High e definindo x-ms-access-tier com 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á 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 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 quente | Definir como camada fria | Definir como camada fria | Definir como camada de arquivo morto |
---|---|---|---|---|
Blob na camada quente | 200 | 200 | 200 | 200 |
Blob na camada fria | 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 morto, reidrando para ativar | 202 | 409 | 409 | 409 |
Blob na camada de arquivo morto, reidrando para esfriar | 409 | 202 | 409 | 409 |
Blob na camada de arquivo morto, reidrando para frio | 409 | 409 | 202 | 409 |
Para obter mais informações sobre códigos de status, consulte Status e códigos de erro.
Cabeçalhos de resposta
A resposta dessa operação inclui os cabeçalhos a seguir. 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 de 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 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 de Set Blob Tier
, conforme descrito abaixo.
Importante
A Microsoft recomenda usar a ID do Microsoft Entra com identidades gerenciadas para autorizar solicitações ao Armazenamento do Azure. A ID do Microsoft Entra fornece 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 para dados de blob. Com a ID do Microsoft Entra, 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 pela ID do Microsoft Entra para retornar um token OAuth 2.0. Em seguida, o token pode ser usado para autorizar uma solicitação no serviço Blob.
Para saber mais sobre a autorização usando a ID do Microsoft Entra, consulte Autorizar o acesso a blobs usando a ID do Microsoft Entra.
Permissões
Veja abaixo 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 rbac interna do Azure com menos privilégios que inclua 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 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.
Observações
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 inferior à 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 para
archive
não podem ser reidratados novamente no instantâneo. Ou seja, o instantâneo não pode ser trazido de volta para uma camada dehot
oucool
. A única maneira de recuperar os dados de um instantâneo ou versãoarchive
é copiá-los para um novo blob. - Se a versão for um blob raiz, ela poderá ser reidratada novamente para
hot
oucool
. - Instantâneos ou versões em um estado
archive
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 reidração 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 pendente de reidração e de exclusão reversível, isso resultará no cancelamento da reidratação e a versão do instantâneo de exclusão reversível estará em um estado
archive
.
A lista de camadas com suporte 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, há suporte Set Blob Tier
para a versão 2023-08-03 e posterior. Para versões anteriores a 2023-08-03, Set Blob Tier
retorna 409
de código de status para blobs que usam criptografia fornecida pelo cliente.
Nota
Para obter informações detalhadas sobre camadas de nível de blob de blocos, consulte camadas de armazenamento frequentes, esporádicas e de arquivos.
Faturamento
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 solicitações Set Blob Tier
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 padrão v2 |
Operações de gravação |
Definir Camada de Blob (camada para cima) | Blob de blocos Premium Uso geral padrão v2 |
Operações de leitura |
Para saber mais sobre os preços da categoria de cobrança especificada, consulte de Preços do Armazenamento de Blobs do Azure.
Consulte 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