Put Blob

Artigo
02/03/2024

A Put Blob operação cria um novo blob de bloco, página ou acréscimo ou atualiza o conteúdo de um blob de blocos existente. A Put Blob operação substituirá todo o conteúdo de um blob existente com o mesmo nome.

Ao atualizar um blob de blocos existente, você substitui todos os metadados existentes no blob. O conteúdo do blob existente é substituído pelo conteúdo do novo blob. Não há suporte para atualizações parciais com Put Blob. Para executar uma atualização parcial do conteúdo de um blob de blocos, use a operação Colocar Lista de Blocos .

Você pode criar um blob de acréscimo nas versões 2015-02-21 e posteriores apenas.

Uma chamada para um Put Blob para criar um blob de páginas ou um blob de acréscimo inicializa apenas o blob. Se o blob já existir, o conteúdo será limpo. Para adicionar conteúdo a um blob de páginas, chame a operação Colocar Página . Para adicionar conteúdo a um blob de acréscimo, chame a operação Anexar Bloco .

Solicitação

Você pode construir a solicitação da Put Blob seguinte maneira. Recomendamos que você use HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento:

URI de solicitação do método PUT	Versão HTTP
`https://myaccount.blob.core.windows.net/mycontainer/myblob`	HTTP/1.1

Solicitação de serviço de armazenamento emulado

Ao fazer uma solicitação no serviço de armazenamento emulado, especifique o nome do host do emulador e a porta do serviço Blob como 127.0.0.1:10000, seguido pelo nome da conta de armazenamento emulada:

URI de solicitação do método PUT	Versão HTTP
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

O emulador de armazenamento dá suporte apenas a tamanhos de blob de até 2 gibibytes (GiB).

Para obter mais informações, consulte Usar o emulador Azurite para desenvolvimento local do armazenamento do Azure.

Parâmetros do URI

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

Parâmetro	Descrição
`timeout`	Opcional. O parâmetro `timeout` é expresso em segundos. Para obter mais informações, consulte Definir tempos limite para operações do serviço Blob.

Cabeçalhos de solicitação (todos os tipos de blob)

Os cabeçalhos de solicitação obrigatórios e opcionais para todos os tipos de blob 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 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-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.
`Content-Length`	Obrigatórios. O comprimento da solicitação. Para um blob de páginas ou um blob de acréscimo, o valor desse cabeçalho deve ser definido como zero, pois Put Blob é usado apenas para inicializar o blob. Para gravar conteúdo em um blob de páginas existente, chame Put Page. Para gravar conteúdo em um blob de acréscimo, chame Append Block.
`Content-Type`	Opcional. O tipo de conteúdo MIME do blob. O tipo padrão é `application/octet-stream`.
`Content-Encoding`	Opcional. Especifica quais codificações de conteúdo foram aplicadas ao blob. Esse valor é retornado ao cliente quando a operação Obter Blob é executada no recurso de blob. Quando esse valor é retornado, o cliente pode usá-lo para decodificar o conteúdo do blob.
`Content-Language`	Opcional. Especifica as linguagens naturais usadas por esse recurso.
`Content-MD5`	Opcional. Um hash MD5 do conteúdo do blob. O hash é usado para verificar a integridade do blob durante o transporte. Quando esse cabeçalho é especificado, o serviço de armazenamento verifica o hash que chegou em relação ao que foi enviado. Se os dois hashes não corresponderem, a operação falhará com o código de erro 400 (Solicitação inválida). Quando o cabeçalho é omitido na versão 2012-02-12 ou posterior, o Armazenamento de Blobs gera um hash MD5. Os resultados de Obter Blob, Obter Propriedades de Blob e Listar Blobs incluem o hash MD5.
`x-ms-content-crc64`	Opcional. Um hash CRC64 do conteúdo do blob. O hash é usado para verificar a integridade do blob durante o transporte. Quando esse cabeçalho é especificado, o serviço de armazenamento verifica o hash que chegou em relação ao que foi enviado. Se os dois hashes não corresponderem, a operação falhará com o código de erro 400 (Solicitação inválida). Esse cabeçalho tem suporte nas versões 02-02-2019 e posteriores. Se os cabeçalhos Content-MD5 e x-ms-content-crc64 estiverem presentes, a solicitação falhará com um 400 (Solicitação Incorreta).
`Cache-Control`	Opcional. O Armazenamento de Blobs armazena esse valor, mas não o usa nem o modifica.
`x-ms-blob-content-type`	Opcional. Defina o tipo de conteúdo do blob.
`x-ms-blob-content-encoding`	Opcional. Defina a codificação do conteúdo do blob.
`x-ms-blob-content-language`	Opcional. Defina o idioma do conteúdo do blob.
`x-ms-blob-content-md5`	Opcional. Defina o hash MD5 do blob. Para BlockBlob, esse cabeçalho tem precedência ao `Content-MD5` verificar a integridade do blob durante o transporte. Para PageBlob e AppendBlob, esse cabeçalho define diretamente o hash MD5 do blob.
`x-ms-blob-cache-control`	Opcional. Define o controle de cache do blob.
`x-ms-blob-type: <BlockBlob ¦ PageBlob ¦ AppendBlob>`	Obrigatórios. Especifica o tipo de blob a ser criado: blob de blocos, blob de páginas ou blob de acréscimo. O suporte para criar um blob de acréscimo só está disponível na versão 2015-02-21 e posterior.
`x-ms-meta-name:value`	Opcional. Pares de nome-valor associados ao blob como metadados. Observação: a partir da versão 2009-09-19, os nomes de metadados devem seguir as regras de nomenclatura para identificadores C#.
`x-ms-encryption-scope`	Opcional. Indica o escopo de criptografia a ser usado para criptografar o conteúdo da solicitação. Esse cabeçalho tem suporte nas versões 2019-02-02 e posteriores.
`x-ms-encryption-context`	Opcional. O padrão é "Vazio". Se o valor for definido, ele definirá metadados do sistema de blob. Comprimento máximo-1024. Válido somente quando o Namespace Hierárquico está habilitado para a conta. Esse cabeçalho tem suporte nas versões 2021-08-06 e posteriores.
`x-ms-tags`	Opcional. Define as marcas codificadas de cadeia de caracteres de consulta fornecidas no blob. Confira os Comentários para obter informações adicionais. Com suporte na versão 2019-12-12 e posterior.
`x-ms-lease-id:<ID>`	Obrigatório se o blob tiver uma concessão ativa. Para executar essa operação em um blob com uma concessão ativa, especifique a ID de concessão válida para esse cabeçalho.
`x-ms-blob-content-disposition`	Opcional. Define o cabeçalho `Content-Disposition` do blob. Disponível para versões 2013-08-15 e posteriores. O `Content-Disposition` campo de cabeçalho de resposta transmite informações adicionais sobre como processar a carga de resposta e você pode usá-la para anexar metadados adicionais. Por exemplo, se o cabeçalho estiver definido como `attachment`, ele indicará que o usuário-agente não deve exibir a resposta. Em vez disso, ele deve exibir uma caixa de diálogo Salvar como com um nome de arquivo diferente do nome do blob especificado. A resposta das operações Obter Propriedades de Blob e Obter Blob inclui o `content-disposition` cabeçalho.
`Origin`	Opcional. Especifica a origem da qual a solicitação será emitida. A presença desse cabeçalho resulta em recursos de origens cruzadas compartilhando (CORS) cabeçalhos na resposta. Para obter mais informações, consulte Suporte do CORS 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 KiB (1 kibibyte) registrado nos logs de análise quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o log de análise de armazenamento.
`x-ms-access-tier`	Opcional. A camada a ser definida no blob. Para blobs de páginas em uma conta Armazenamento Premium somente com a versão 2017-04-17 e posterior. Para obter uma lista completa de camadas compatíveis com blob de páginas, consulte Armazenamento premium de alto desempenho e discos gerenciados para VMs (máquinas virtuais). Para blobs de blocos, com suporte no armazenamento de blobs ou contas de uso geral v2 somente com a versão 2018-11-09 e posterior. Os valores válidos para camadas de blob de blocos são `Hot`, `Cool`, `Cold`e `Archive`. Observação: `Cold` a camada tem suporte para a versão 2021-12-02 e posterior. Para obter informações detalhadas sobre camadas de blob de blocos, consulte Camadas de armazenamento frequente, esporádico e de arquivos.
`x-ms-immutability-policy-until-date`	Versão 2020-06-12 e posterior. Especifica a data de retenção até a data a ser definida no blob. Essa é a data até a qual o blob pode ser protegido contra modificação ou exclusão. Segue RFC1123 formato.
`x-ms-immutability-policy-mode`	Versão 2020-06-12 e posterior. Especifica o modo de política de imutabilidade a ser definido no blob. Os valores válidos são `unlocked` e `locked`. Com `unlocked`o , os usuários podem alterar a política aumentando ou diminuindo a data de retenção até a data. Com `locked`, essas ações são proibidas.
`x-ms-legal-hold`	Versão 2020-06-12 e posterior. Especifica a retenção legal a ser definida no blob. Os valores válidos são `true` e `false`.
`x-ms-expiry-option`	Opcional. Versão 2023-08-03 e posterior. Especifica a opção de data de validade da solicitação. Para obter mais informações, consulte ExpirayOption. Esse cabeçalho é válido para contas com namespace hierárquico habilitado.
`x-ms-expiry-time`	Opcional. Versão 2023-08-03 e posterior. Especifica a hora em que o blob está definido para expirar. O formato da data de validade varia de acordo `x-ms-expiry-option`com . Para obter mais informações, consulte ExpirayOption. Esse cabeçalho é válido para contas com namespace hierárquico habilitado.

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

Cabeçalhos de solicitação (somente blobs de página)

Os cabeçalhos de solicitação aplicáveis somente a operações em blobs de página são descritos na tabela a seguir:

Cabeçalho da solicitação	Descrição
`x-ms-blob-content-length: bytes`	Necessário para blobs de páginas. Esse cabeçalho especifica o tamanho máximo para o blob de página, até 8 tebibytes (TiB). O tamanho do blob de páginas deve ser alinhado a um limite de 512 bytes. Se esse cabeçalho for especificado para um blob de blocos ou um blob de acréscimo, o Armazenamento de Blobs retornará status código 400 (Solicitação Incorreta).
`x-ms-blob-sequence-number: <num>`	Opcional. Defina para blobs de página apenas. O número de sequência é um valor controlado pelo usuário que você pode usar para rastrear solicitações. O valor do número de sequência deve ser de 0 a 2^{^63} – 1. O valor padrão é 0.
`x-ms-access-tier`	Versão 2017-04-17 e posterior. Para blobs de páginas somente em uma conta de armazenamento premium. Especifica a camada a ser definida no blob. Para obter uma lista completa de camadas com suporte, consulte Armazenamento premium de alto desempenho e discos gerenciados para VMs.
`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 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.

Cabeçalhos de solicitação (chaves de criptografia fornecidas pelo cliente)

A partir da versão 2019-02-02, os cabeçalhos a seguir podem ser especificados na solicitação para criptografar um blob com uma chave fornecida pelo cliente. A criptografia com uma chave fornecida pelo cliente (e o conjunto correspondente de cabeçalhos) é opcional.

Cabeçalho da solicitação	Descrição
`x-ms-encryption-key`	Obrigatórios. A chave de criptografia AES-256 codificada em Base64.
`x-ms-encryption-key-sha256`	Obrigatórios. O hash SHA256 codificado em Base64 da chave de criptografia.
`x-ms-encryption-algorithm: AES256`	Obrigatórios. Especifica o algoritmo a ser usado para criptografia. O valor deste cabeçalho deve ser `AES256`.

Corpo da solicitação

Para um blob de blocos, o corpo da solicitação tem o conteúdo do blob.

Para um blob de páginas ou um blob de acréscimo, o corpo da solicitação está vazio.

Solicitação de exemplo

O exemplo a seguir mostra uma solicitação para criar um blob de blocos:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 11  
  
Request Body:  
hello world

Esta solicitação de exemplo cria um blob de páginas e especifica seu tamanho máximo como 1.024 bytes. Para adicionar conteúdo a um blob de páginas, você deve chamar Put Page:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/mypageblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: PageBlob  
x-ms-blob-content-length: 1024  
x-ms-blob-sequence-number: 0  
Authorization: SharedKey   
Origin: http://contoso.com  
Vary: Origin  
myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

Esta solicitação de exemplo cria um blob de acréscimo. Para adicionar conteúdo ao blob de acréscimo, você deve chamar Append Block:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myappendblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-type: AppendBlob  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Origin: http://contoso.com  
Vary: Origin  
Content-Length: 0

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 201 (Criado).

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 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 de resposta	Descrição
`ETag`	Contém um valor que o cliente pode usar para executar operações condicionais `PUT` usando o cabeçalho da solicitação `If-Match` . Se a versão da solicitação for 2011-08-18 ou posterior, o valor ETag será colocado entre aspas.
`Last-Modified`	A data/hora em que o blob foi modificado pela última vez. O formato da data segue RFC 1123. Para obter mais informações, consulte Representar valores de data/hora em cabeçalhos. Qualquer operação de gravação no blob (incluindo atualizações nos metadados ou nas propriedades do blob), altera a hora da última modificação do blob.
`Content-MD5`	Retornado para um blob de blocos para que o cliente possa marcar a integridade do conteúdo da mensagem. O `Content-MD5` valor retornado é calculado pelo Armazenamento de Blobs. Na versão 2012-02-12 e posterior, esse cabeçalho é retornado mesmo quando a solicitação não inclui `Content-MD5` cabeçalhos ou `x-ms-blob-content-md5` .
`x-ms-content-crc64`	Retornado para um blob de blocos para que o cliente possa marcar a integridade do conteúdo da mensagem. O `x-ms-content-crc64` valor retornado é calculado pelo Armazenamento de Blobs. Esse cabeçalho sempre é retornado a partir da versão 2019-02-02.
`x-ms-request-id`	Identifica exclusivamente a solicitação que foi feita e você pode usá-la para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
`x-ms-version`	Indica a versão do Armazenamento de Blobs que foi usada para executar a solicitação. Retornado para solicitações feitas na versão 2009-09-19 e posterior.
`Date`	Um valor de data/hora UTC gerado pelo serviço, que indica a hora em que a resposta foi iniciada.
`Access-Control-Allow-Origin`	Retornado se a solicitação incluir um cabeçalho `Origin` e CORS estiver habilitado com uma regra de correspondência. Esse cabeçalho retornará o valor do cabeçalho de solicitação de origem se houver uma correspondência.
`Access-Control-Expose-Headers`	Retornado se a solicitação incluir um cabeçalho `Origin` e CORS estiver habilitado com uma regra de correspondência. Retorna a lista de cabeçalhos de resposta que devem ser expostos ao cliente ou ao emissor da solicitação.
`Access-Control-Allow-Credentials`	Retornado se a solicitação incluir um `Origin` cabeçalho e CORS estiver habilitado com uma regra correspondente que não permita todas as origens. Esse cabeçalho é definido como true.
`x-ms-request-server-encrypted: true/false`	Versão 2015-12-11 e posterior. O valor desse cabeçalho será definido `true` como se o conteúdo da solicitação for criptografado com êxito usando o algoritmo especificado. Caso contrário, o valor é `false`.
`x-ms-encryption-key-sha256`	Versão 2019-02-02 e posterior. Retornado se a solicitação usou uma chave fornecida pelo cliente para criptografia, para que o cliente possa garantir que o conteúdo da solicitação seja criptografado com êxito usando a chave fornecida.
`x-ms-encryption-scope`	Versão 2019-02-02 e posterior. Retornado se a solicitação usou um escopo de criptografia, para que o cliente possa garantir que o conteúdo da solicitação seja criptografado com êxito usando o escopo de criptografia.
`x-ms-version-id: <DateTime>`	Versão 2019-12-12 e posterior. Esse cabeçalho retorna um valor opaco `DateTime` que identifica exclusivamente o blob. O valor desse cabeçalho indica a versão do blob e pode ser usado em solicitações subsequentes para acessar o blob.

Corpo da resposta

Nenhum.

Resposta de exemplo

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>

Autorização

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

Se uma solicitação especificar marcas com o cabeçalho da x-ms-tags solicitação, o chamador deverá atender aos requisitos de autorização da operação Definir Marcas de Blob .

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.

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 Put Blob operação e a função RBAC interna do Azure com menos privilégios que inclui esta ação:

Ação rbac do Azure:
- Create novo blob de blocos: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Create blob de blocos novo ou substituído: 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.

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 Put Blob 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 Put Blob operação usando um token SAS delegado a um recurso de contêiner ou blob requer a seguinte permissão como parte do token SAS de delegação do usuário:

Operação	Permissão assinada
Colocar Blob (criar um novo blob de blocos)	Create (c) ou Gravação (w)
Colocar Blob (substituir o blob de blocos existente)	Gravação (w)

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 Put Blob operação usando um token SAS delegado a um recurso de contêiner ou blob requer a permissão a seguir como parte do token SAS de serviço.

Operação	Permissão assinada
Colocar Blob (criar um novo blob de blocos)	Create (c) ou Gravação (w)
Colocar Blob (substituir o blob de blocos existente)	Gravação (w)

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
Colocar Blob (criar um novo blob de blocos)	Blob (b)	Objeto (o)	Create (c) ou Gravação (w)
Colocar Blob (substituir o blob de blocos existente)	Blob (b)	Objeto (o)	Gravação (w)

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

Comentários

Ao criar um blob, você deve especificar se ele é um blob de blocos, blob de acréscimo ou blob de página especificando o valor do x-ms-blob-type cabeçalho. Depois que um blob for criado, o tipo do blob não poderá ser alterado, a menos que ele seja excluído e recriado.

A tabela a seguir descreve os tamanhos máximos permitidos de bloco e blob, por versão de serviço:

Versão do serviço	Tamanho máximo do bloco (via `Put Block`)	Tamanho máximo do blob (via `Put Block List`)	Tamanho máximo do blob por meio de operação de gravação única (via `Put Blob`)
Versão 12/12/2019 e posterior	4.000 mebibytes (MiB)	Aproximadamente 190,7 TiB (4.000 MiB × 50.000 blocos)	5.000 MiB
Versões 2016-05-31 a 2019-07-07	100 MiB	Aproximadamente 4,75 TiB (100 MiB × 50.000 blocos)	256 MiB
Versões anteriores a 2016-05-31	4 MiB	Aproximadamente 195 GiB (4 MiB × 50.000 blocos)	64 MiB

Se você tentar carregar um blob de blocos maior que o tamanho máximo permitido para essa versão de serviço ou um blob de página maior que 8 TiB, o serviço retornará status código 413 (Entidade de Solicitação Muito Grande). O Armazenamento de Blobs também retorna informações adicionais sobre o erro na resposta, incluindo o tamanho máximo permitido do blob, em bytes.

Para criar um novo blob de páginas, primeiro inicialize o blob chamando Put Blobe especifique seu tamanho máximo, até 8 TiB. Ao criar um blob de páginas, não inclua conteúdo no corpo da solicitação. Depois que o blob tiver sido criado, chame Colocar Página para adicionar conteúdo ao blob ou modificá-lo.

Para criar um novo blob de acréscimo, chame Put Blob para criá-lo com um comprimento de conteúdo de 0 bytes. Depois que o blob de acréscimo for criado, chame Append Block para adicionar conteúdo ao final dele.

Se você chamar Put Blob para substituir um blob existente com o mesmo nome, todos os instantâneos associados ao blob original serão mantidos. Para remover instantâneos associados, primeiro chame Excluir Blob e chame Put Blob para recriar o blob.

Propriedades personalizadas do blob

Um blob tem propriedades personalizadas (definidas por meio de cabeçalhos) que você pode usar para armazenar valores associados a cabeçalhos HTTP padrão. Posteriormente, você pode ler esses valores chamando Obter Propriedades do Blob ou modificá-los chamando Definir Propriedades de Blob. Os cabeçalhos de propriedade personalizada e o cabeçalho HTTP padrão correspondente são listados na seguinte tabela:

Cabeçalho HTTP	Cabeçalho da propriedade personalizada do blob
`Content-Type`	`x-ms-blob-content-type`
`Content-Encoding`	`x-ms-blob-content-encoding`
`Content-Language`	`x-ms-blob-content-language`
`Content-MD5`	`x-ms-blob-content-md5`
`Cache-Control`	`x-ms-blob-cache-control`

A semântica para definir ou persistir esses valores de propriedade com o blob é a seguinte:

Se o cliente especificar um cabeçalho de propriedade personalizada, conforme indicado pelo prefixo x-ms-blob, esse valor será armazenado com o blob.
Se o cliente especificar um cabeçalho HTTP padrão, mas não o cabeçalho de propriedade personalizado, o valor será armazenado na propriedade personalizada correspondente associada ao blob e será retornado por uma chamada para Get Blob Properties. Por exemplo, se o cliente definir o cabeçalho Content-Type na solicitação, esse valor será armazenado na propriedade x-ms-blob-content-type do blob.
Se o cliente definir o cabeçalho HTTP padrão e o cabeçalho de propriedade correspondente na mesma solicitação, a solicitação PUT usará o valor fornecido para o cabeçalho HTTP padrão, mas o valor especificado para o cabeçalho de propriedade personalizada será mantido com o blob e retornado por solicitações GET subsequentes.

Se as marcas forem fornecidas no x-ms-tags cabeçalho, elas deverão ser codificadas em cadeia de caracteres de consulta. As chaves de marca e os valores devem estar em conformidade com os requisitos de nomenclatura e comprimento, conforme especificado em Set Blob Tags. Além disso, o x-ms-tags cabeçalho pode conter até 2kb de marcas. Se mais marcas forem necessárias, use a operação Definir Marcas de Blob .

Se o blob tiver uma concessão ativa, o cliente deverá especificar uma ID de concessão válida na solicitação para substituir o blob. Se o cliente não especificar uma ID de concessão ou especificar uma ID de concessão inválida, o Armazenamento de Blobs retornará status código 412 (Falha na pré-condição). Se o cliente especificar uma ID de concessão, mas o blob não tiver uma concessão ativa, o Armazenamento de Blobs também retornará status código 412 (Falha na pré-condição). Se o cliente especificar uma ID de concessão em um blob que ainda não existe, o Armazenamento de Blobs retornará status código 412 (Falha de Pré-condição) para solicitações feitas na versão 2013-08-15 e posterior. Para versões anteriores a 2013-08-15, o Armazenamento de Blobs retorna status código 201 (Criado).

Se um blob existente com uma concessão ativa for substituído por uma Put Blob operação, a concessão persistirá no blob atualizado até que ele expire ou seja liberado.

Uma Put Blob operação tem permissão de 10 minutos por MiB para ser concluída. Se a operação estiver demorando mais de 10 minutos por MiB em média, a operação atingirá o tempo limite.

A substituição de um archive blob falha e a substituição de um hot blob ou cool herda a camada do blob antigo se um x-ms-access-tier cabeçalho não for fornecido.

ExpiraçãoOption

Você pode enviar os valores a seguir como um x-ms-expiry-option cabeçalho. Esse cabeçalho não diferencia maiúsculas de minúsculas.

Opção de expiração	Descrição
`RelativeToNow`	Define a data de validade em relação à hora atual. `x-ms-expiry-time` deve ser especificado como o número de milissegundos a serem decorridos do momento atual.
`Absolute`	`x-ms-expiry-time` deve ser especificado como um tempo absoluto, no formato RFC 1123.
`NeverExpire`	Define o blob para nunca expirar ou remove a data de validade atual. `x-ms-expiry-time` não deve ser especificado.

A semântica para definir uma data de validade em um blob é a seguinte:

Set Expiry pode ser definido apenas em um blob e não em um diretório.
Set Expiry com um expiryTime no passado não é permitido.
ExpiryTime não pode ser especificado com um expiryOption valor de Never.

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 Put Blob solicitações com base no tipo de conta de armazenamento:

Operação	Tipo de conta de armazenamento	Categoria de cobrança
Put Blob	Blob de blocos Premium Uso geral v2 Standard Uso geral v1 Standard	Operações de gravação

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

Confira também

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

Compartilhar via