Azure.Storage.Blobs.Specialized Namespace

O AppendBlobClient permite manipular blobs de acréscimo do Armazenamento do Azure.

Um blob de acréscimo é composto por blocos e é otimizado para operações de acréscimo. Quando você modifica um blob de acréscimo, os blocos são adicionados somente ao final do blob por meio da Azure.Storage.Blobs.Specialized.AppendBlobClient.AppendBlockAsync(System.IO.Stream,System.Byte[],Azure.Storage.Blobs.Models.AppendBlobRequestConditions,System.IProgress{System.Int64},System.Threading.CancellationToken) operação . Não há suporte para atualização ou exclusão de blocos existentes. Ao contrário de um blob de blocos, um blob de acréscimo não expõe suas IDs de bloco.

Cada bloco em um blob de acréscimo pode ter um tamanho diferente. A partir do x-ms-version 2022-11-02, o tamanho máximo do acréscimo é de 100 MB. Para versões anteriores, o tamanho máximo do acréscimo é de 4 MB. Os blobs de acréscimo podem incluir até 50.000 blocos.

O BlobBaseClient permite manipular os blobs do Armazenamento do Azure.

Um BlobBatch permite que você faça o lote de várias operações do Armazenamento do Azure em uma única solicitação por meio de SubmitBatch(BlobBatch, Boolean, CancellationToken).

Para obter mais informações, consulte Lote de Blobs.

O BlobBatchClient permite que você faça o lote de várias operações do Armazenamento do Azure em uma única solicitação.

O BlobLeaseClient permite manipular concessões do Armazenamento do Azure em contêineres e blobs.

O BlockBlobClient permite manipular blobs de blocos do Armazenamento do Azure.

Os blobs de bloco permitem atualizar blobs grandes eficientemente. Os blobs de bloco são compostos de blocos, e cada um deles é identificado por uma ID de bloco. Crie ou modifique um blob de bloco gravando um conjunto de blocos e confirmando-os pelas suas IDs de bloco. Cada bloco pode ter um tamanho diferente, até um máximo de 4.000 MB (100 MB para solicitações que usam versões REST antes de 2019-12-12 e 4 MB para solicitações que usam versões REST antes de 2016-05-31), e um blob de blocos pode incluir até 50.000 blocos. O tamanho máximo de um blob de blocos é, portanto, aproximadamente 190,73 TiB (4.000 MB X 50.000 blocos). Se você estiver escrevendo um blob de blocos que não tenha mais de 5.000 MB de tamanho, poderá carregá-lo em sua totalidade com uma única operação de gravação; consulte UploadAsync(Stream, BlobUploadOptions, CancellationToken).

Ao carregar um bloco em um blob na sua conta de armazenamento, ele é associado ao blob de bloco especificado, mas não se torna parte do blob até que você confirme uma lista de blocos que inclua a nova ID do bloco. Os novos blocos permanecem em um estado não confirmado até que sejam especificamente confirmados ou descartados. A gravação de um bloco não atualiza a hora em que um blob existente foi modificado pela última vez.

Os blobs de bloco incluem recursos que ajudam a gerenciar arquivos grandes pelas redes. Com um blob de bloco, é possível carregar vários blocos paralelamente para diminuir o tempo de carregamento. Cada bloco pode incluir um hash MD5 para verificar a transferência, para que você possa acompanhar o progresso do upload e reenançar blocos conforme necessário. Você pode carregar blocos em qualquer ordem e determinar sua sequência na etapa final de compromisso da lista de blocos. Também é possível carregar um novo bloco para substituir um bloco não confirmado existente da mesma ID de bloco. Você tem uma semana para confirmar blocos em um blob antes de eles serem descartados. Todos os blocos não confirmados também são descartados quando uma operação de confirmação da lista de blocos ocorre, mas não os inclui.

Você pode modificar um blob de bloco existente inserindo, substituindo ou excluindo blocos existentes. Após carregar os blocos que foram alterados, é possível confirmar uma nova versão do blob ao confirmar os novos blocos com os blocos existentes que deseja manter usando uma única operação de confirmação. Para inserir o mesmo intervalo de bytes em dois locais diferentes do blob confirmado, você pode confirmar o mesmo bloco em dois locais dentro da mesma operação de confirmação. Para qualquer operação de confirmação, se qualquer bloco não for encontrado, toda a operação de compromisso falhará com um erro e o blob não será modificado. Qualquer confirmação de bloco substitui as propriedades e os metadados existentes do blob, além de descartar todos os blocos não confirmados.

As IDs de bloco são cadeias de caracteres de comprimento igual em um blob. O código de cliente do bloco geralmente usa a codificação de base 64 para padronizar cadeias de caracteres em tamanhos iguais. Ao usar a codificação de base 64, a cadeia de caracteres pré-codificada deve ter 64 bytes ou menos. Os valores da ID de bloco podem ser duplicados em blobs diferentes. Um blob pode ter até 100.000 blocos não confirmados, com um tamanho total máximo de aproximadamente 381,46 TiB (4.000 MB x 100.000 blocos)

Se você gravar um bloco para um blob que não existe, um novo blob de bloco será criado, com um comprimento de zero bytes. Esse blob aparecerá em listas de blobs que incluem blobs não confirmados. Se você não confirmar nenhum bloco para esse blob, ele e seus blocos não confirmados serão descartados uma semana após o último carregamento bem-sucedido do bloco. Todos os blocos não confirmados também são descartados quando um novo blob de mesmo nome é criado usando uma única etapa (em vez do processo de upload e confirmação de bloco de duas etapas).

O PageBlobClient permite manipular blobs de páginas do Armazenamento do Azure.

Blobs de página são uma coleção de páginas de 512 bytes otimizadas para leitura aleatória e operações de gravação. Para criar um blob de página, inicialize-o e especifique o tamanho máximo que ele terá. Para adicionar ou atualizar o conteúdo de um blob de página, grave uma página, ou páginas, especificando um deslocamento e um intervalo que se alinhem aos limites de página de 512 bytes. Uma gravação em um blob de página pode substituir apenas uma página, algumas páginas, ou até 4 MB do blob de página. As gravações nos blobs de página acontecem in-loco e são imediatamente confirmadas no blob. O tamanho máximo de um blob de páginas é de 8 TB.

Fornece opções avançadas de configuração de cliente para se conectar a Armazenamento de Blobs do Azure.

Adicione métodos fáceis de descobrir a para BlobContainerClient criar AppendBlobClient instâncias.