Bibliotecas de cliente do Armazenamento do Azure para .NET

  • Artigo

As bibliotecas de clientes do Armazenamento do Azure para .NET oferecem uma interface fácil de usar para fazer chamadas ao Armazenamento do Azure. Para obter mais informações sobre o Armazenamento do Azure, consulte Introdução ao Armazenamento do Azure.

Bibliotecas para acesso a dados

A versão mais recente da biblioteca de clientes do Armazenamento do Azure para acesso a dados é a versão 12.x.x. A Microsoft recomenda usar a versão 12.x.x para novos aplicativos.

Se você não puder atualizar aplicativos existentes para a versão 12.x.x, a Microsoft recomenda usar a versão 11.x.x.

Versão 12.x.x

As bibliotecas de cliente versão 12.x.x para .NET fazem parte do SDK do Azure para .NET. O código-fonte das bibliotecas de cliente do Armazenamento do Azure para .NET está disponível no GitHub.

Use as seguintes bibliotecas da versão 12.x.x para trabalhar com blobs, arquivos e filas:

Biblioteca Referência Pacote Fonte
Azure.Storage.Blobs.Batch NuGet GitHub
Azure.Storage.Blobs Referência NuGet GitHub
Azure.Storage.Common NuGet GitHub
Azure.Storage.Files.DataLake Referência NuGet GitHub
Azure.Storage.Files.Shares Referência NuGet GitHub
Azure.Storage.Queues Referência NuGet GitHub

Versão 11.x.x

O código-fonte das bibliotecas de cliente do Armazenamento do Azure para .NET está disponível no GitHub.

Use as seguintes bibliotecas da versão 11.x.x para trabalhar com blobs, arquivos e filas:

Biblioteca Referência Pacote Fonte
Microsoft.Azure.Storage.Blob Referência NuGet GitHub
Microsoft.Azure.Storage.Common NuGet GitHub
Microsoft.Azure.Storage.File Referência NuGet GitHub
Microsoft.Azure.Storage.Queue Referência NuGet GitHub

Bibliotecas para gerenciamento de recursos

A versão mais recente da biblioteca de clientes do Armazenamento do Azure para gerenciamento de recursos é a versão 1.x.x. A Microsoft recomenda usar a versão 1.x.x para novos aplicativos.

Se você não puder atualizar aplicativos existentes para a versão 1.x.x, a Microsoft recomenda usar a versão 25.x.x.

Versão 1.x.x

Use a seguinte biblioteca versão 1.x.x para trabalhar com o provedor de recursos do Armazenamento do Azure:

Biblioteca Referência Pacote Fonte
Azure.ResourceManager.Storage Referência NuGet GitHub

Versão 25.x.x

Use a seguinte biblioteca versão 25.x.x para trabalhar com o provedor de recursos do Armazenamento do Azure:

Biblioteca Referência Pacote Fonte
Microsoft.Azure.Management.Storage Referência NuGet GitHub

Problemas conhecidos

Esta seção detalha os problemas conhecidos das bibliotecas de clientes do Armazenamento do Azure para .NET.

Mensagem de erro InvalidHeaderValue ao usar a versão beta do SDK

Em cenários raros, os aplicativos que atualizaram para a versão beta mais recente ou geralmente disponível do SDK podem receber uma InvalidHeaderValue mensagem de erro. Esse problema pode ocorrer ao usar qualquer uma das bibliotecas de Armazenamento. A mensagem de erro é semelhante ao seguinte exemplo:

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?><Error><Code>InvalidHeaderValue</Code><Message>The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z</Message><HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue></Error>

Se você tiver atualizado para a versão beta mais recente ou geralmente disponível do SDK e tiver esse erro, é recomendável fazer downgrade para a versão anterior geralmente disponível do SDK para ver se o problema é resolvido. Se o problema persistir ou se a recomendação não for viável, abra um tíquete de suporte para explorar outras opções.