Bibliotecas cliente de Azure Storage para .NET

  • Artículo

Las bibliotecas cliente de Azure Storage para .NET ofrecen una interfaz práctica para realizar llamadas a Azure Storage. Para más información sobre Azure Storage, consulte Introducción a Azure Storage.

Bibliotecas para el acceso a datos

La versión más reciente de la biblioteca cliente de Azure Storage para el acceso a datos es la versión 12.x.x. Microsoft recomienda usar la versión 12.x.x para las nuevas aplicaciones.

Si no puede actualizar las aplicaciones existentes a la versión 12.x.x, Microsoft recomienda usar la versión 11.x.x.

Versión 12.x.x

Las bibliotecas cliente de la versión 12.x.x para .NET forman parte del SDK de Azure para .NET. El código fuente de las bibliotecas cliente de Azure Storage para .NET está disponible en GitHub.

Use las bibliotecas 12.x.x.x siguientes para trabajar con blobs, archivos y colas:

Biblioteca Referencia Paquete Source
Azure.Storage.Blobs.Batch NuGet GitHub
Azure.Storage.Blobs Referencia NuGet GitHub
Azure.Storage.Common NuGet GitHub
Azure.Storage.Files.DataLake Referencia NuGet GitHub
Azure.Storage.Files.Shares Referencia NuGet GitHub
Azure.Storage.Queues Referencia NuGet GitHub

Versión 11.x.x.x

El código fuente de las bibliotecas cliente de Azure Storage para .NET está disponible en GitHub.

Use las siguientes bibliotecas de la versión 11.x.x para trabajar con blobs, archivos y colas:

Biblioteca Referencia Paquete Source
Microsoft.Azure.Storage.Blob Referencia NuGet GitHub
Microsoft.Azure.Storage.Common NuGet GitHub
Microsoft.Azure.Storage.File Referencia NuGet GitHub
Microsoft.Azure.Storage.Queue Referencia NuGet GitHub

Bibliotecas para la administración de recursos

La versión más reciente de la biblioteca cliente de Azure Storage para la administración de recursos es la versión 1.x.x. Microsoft recomienda usar la versión 1.x.x para las nuevas aplicaciones.

Si no puede actualizar las aplicaciones existentes a la versión 1.x.x, Microsoft recomienda usar la versión 25.x.x.

Versión 1.x.x

Use la biblioteca 1.x.x.x siguiente para trabajar con el proveedor de recursos de Azure Storage:

Biblioteca Referencia Paquete Source
Azure.ResourceManager.Storage Referencia NuGet GitHub

Versión 25.x.x

Use la biblioteca 25.x.x.x siguiente para trabajar con el proveedor de recursos de Azure Storage:

Biblioteca Referencia Paquete Source
Microsoft.Azure.Management.Storage Referencia NuGet GitHub

Problemas conocidos

En esta sección se detallan los problemas conocidos de las bibliotecas cliente de Azure Storage para .NET.

Mensaje de error InvalidHeaderValue al usar la versión beta del SDK

En escenarios poco frecuentes, las aplicaciones que se han actualizado a la versión beta más reciente o disponible con carácter general del SDK pueden recibir un InvalidHeaderValue mensaje de error. Este problema puede producirse al usar cualquiera de las bibliotecas de Storage. El mensaje de error es similar al ejemplo siguiente:

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>

Si ha actualizado a la versión beta más reciente o disponible con carácter general del SDK y experimenta este error, se recomienda cambiar a la versión anterior disponible con carácter general del SDK para ver si el problema se resuelve. Si el problema persiste o si la recomendación no es factible, abra una incidencia de soporte técnico para explorar más opciones.