Introducción al desarrollo de aplicaciones con Azure Files

2025-06-23

En este artículo se proporciona información general sobre el desarrollo de aplicaciones con Azure Files y le ayuda a decidir qué enfoque se basa mejor en las necesidades de la aplicación.

Se aplica a

Modelo de administración	Modelo de facturación	Nivel multimedia	Redundancia
Microsoft.Storage	Aprovisionado v2	HDD (estándar)	Local (LRS)
Microsoft.Storage	Aprovisionado v2	HDD (estándar)	Zona (ZRS)
Microsoft.Storage	Aprovisionado v2	HDD (estándar)	Geo (GRS)
Microsoft.Storage	Aprovisionado v2	HDD (estándar)	GeoZone (GZRS)
Microsoft.Storage	Aprovisionado v1	SSD (Premium)	Local (LRS)
Microsoft.Storage	Aprovisionado v1	SSD (Premium)	Zona (ZRS)
Microsoft.Storage	Pago por uso	HDD (estándar)	Local (LRS)
Microsoft.Storage	Pago por uso	HDD (estándar)	Zona (ZRS)
Microsoft.Storage	Pago por uso	HDD (estándar)	Geo (GRS)
Microsoft.Storage	Pago por uso	HDD (estándar)	GeoZone (GZRS)

Acerca del desarrollo de aplicaciones con Azure Files

Azure Files ofrece varias maneras para que los desarrolladores accedan a datos y administren recursos en recursos compartidos de archivos de Azure. En la tabla siguiente se enumeran los enfoques, se resume cómo funcionan y se proporcionan instrucciones sobre cuándo usar cada enfoque:

Enfoque	Cómo funciona	Cuándo usar
Bibliotecas de E/S de archivos estándar	Usa llamadas API de nivel de sistema operativo a través de recursos compartidos de archivos de Azure montados mediante los protocolos estándar del bloque de mensajes del servidor (SMB) y del sistema de archivos de red (NFS) estándar del sector. Al montar un recurso compartido de archivos mediante SMB/NFS, puede usar bibliotecas de E/S de archivos para un lenguaje de programación o un marco, como `System.IO` para .NET, `os` y `io` para Python, `java.io` y `java.nio` para Java o `fs` para JavaScript (Node.js).	Tiene aplicaciones de línea de negocio con código existente que usa E/S de archivos estándar y no quiere volver a escribir código para que la aplicación funcione con un recurso compartido de archivos de Azure.
FileREST API	Llama directamente a los puntos de conexión HTTPS para interactuar con los datos almacenados en Azure Files. Proporciona control mediante programación sobre los recursos compartidos de archivos. El SDK de Azure proporciona bibliotecas cliente que se basan en la API FileREST, lo que le permite interactuar con las operaciones de la API fileREST a través de paradigmas conocidos del lenguaje de programación.	Está creando servicios y aplicaciones en la nube agregados de valor para los clientes y quiere usar características avanzadas que no están disponibles a través de protocolos nativos.
API REST del proveedor de recursos de almacenamiento	Usa Azure Resource Manager (ARM) para administrar cuentas de almacenamiento y recursos compartidos de archivos. Llama a los puntos de conexión de la API REST para varias operaciones de administración de recursos.	La aplicación o el servicio deben realizar tareas de administración de recursos, como crear, eliminar o actualizar cuentas de almacenamiento o recursos compartidos de archivos.

Bibliotecas de E/S de archivos estándar

Las bibliotecas de E/S de archivos son la manera más común de acceder a los recursos de Azure Files y trabajar con ellos. Al montar un recurso compartido de archivos mediante SMB o NFS, el sistema operativo redirige las solicitudes de API para el sistema de archivos local. Este enfoque le permite usar bibliotecas de E/S de archivos estándar para su lenguaje de programación o marco preferido, como System.IO para .NET y osio para Python java.io , y java.nio para Java, o fs para JavaScript (Node.js).

Considere la posibilidad de usar bibliotecas de E/S de archivos cuando la aplicación requiera:

Compatibilidad de aplicaciones: Ideal para aplicaciones de línea de negocio con código existente que ya usa E/S de archivos estándar. No es necesario volver a escribir código para que la aplicación funcione con un recurso compartido de archivos de Azure.
Facilidad de uso: Los desarrolladores conocen bien las bibliotecas de E/S de archivos estándar y fáciles de usar. Una propuesta de valor clave de Azure Files es que expone las API nativas del sistema de archivos a través de SMB y NFS.

Otras consideraciones:

Acceso a la red: SMB se comunica a través del puerto 445 y NFS se comunica a través del puerto 2049. Asegúrese de que estos puertos no están bloqueados desde la máquina cliente. Para más información, consulte Consideraciones de redes para Azure Files.

FileREST API

La API FileREST proporciona acceso mediante programación a Azure Files. Permite llamar a puntos de conexión HTTPS para realizar operaciones en comparticiones de archivos, directorios y archivos. La API FileREST está diseñada para alta escalabilidad y características avanzadas que podrían no estar disponibles a través de protocolos nativos. El SDK de Azure proporciona bibliotecas cliente que se basan en la API FileREST.

Considere la posibilidad de usar las bibliotecas cliente FileREST API y File Share si la aplicación requiere:

Características avanzadas: Acceso a las operaciones y características que no están disponibles a través de protocolos nativos.
Integraciones en la nube personalizadas: Cree servicios personalizados de valor agregado, como copia de seguridad, antivirus o administración de datos, que interactúan directamente con Azure Files.
Optimización del rendimiento: Beneficiarse de las ventajas de rendimiento en escenarios a gran escala mediante operaciones de plano de datos.

La API FileREST modela Azure Files como una jerarquía de recursos y se recomienda para las operaciones que se realizan en el nivel de directorio o archivo . Para obtener más información sobre las bibliotecas cliente específicas del lenguaje que se basan en la API FileREST, consulte bibliotecas para el acceso a datos.

API REST del proveedor de recursos de almacenamiento

El proveedor de recursos de Azure Storage es un servicio basado en Azure Resource Manager y admite métodos declarativos (plantillas) e imperativos (llamada a API directa). La API REST del proveedor de recursos de Azure Storage proporciona acceso mediante programación a los recursos de Azure Storage, incluidos los recursos compartidos de archivos. El SDK de Azure proporciona bibliotecas de administración que se basan en la API REST del proveedor de recursos de Azure Storage.

Se recomienda el proveedor de recursos de almacenamiento para las operaciones que se realizan en el servicio de archivos o en el nivel de recurso compartido de archivos . Para más información sobre las bibliotecas de administración específicas del lenguaje que se basan en la API REST del proveedor de recursos de Azure Storage, consulte las bibliotecas para la administración de recursos.

Bibliotecas del SDK de Azure para Azure Files

El SDK de Azure proporciona dos conjuntos de bibliotecas para trabajar con recursos de Azure Files. Un conjunto de bibliotecas se basa en la API FileREST y está diseñado para controlar las operaciones de acceso a datos en el nivel de directorio o archivo . Estas bibliotecas a veces se conocen como el plano de datos. Otro conjunto de bibliotecas se basa en la API REST del proveedor de recursos de Azure Storage y está diseñado para controlar las operaciones de administración de recursos en el servicio de archivos o el nivel de recurso compartido de archivos . Estas bibliotecas se conocen a veces como plano de control (o plano de administración).

Bibliotecas para el acceso a datos

Las bibliotecas del plano de datos están diseñadas para controlar las operaciones de acceso a datos en el nivel de directorio o archivo . En las secciones siguientes se muestra la biblioteca cliente de recursos compartidos de archivos para .NET, Java, Python, JavaScript y Go.