Compartir a través de

API REST de Azure Files

  • Artículo

Azure Files proporciona recursos compartidos de archivos en la nube hospedados a los que puede acceder (montar) mediante protocolos del sistema de archivos estándar del sector, como SMB y NFS. Al montar un recurso compartido de archivos en el equipo mediante SMB o NFS, el sistema operativo redirige las solicitudes de API para el sistema de archivos local. El redireccionamiento incluye solicitudes de API locales que se realizan mediante interfaces de .NET System.IO o métodos de apertura, lectura o escritura de Python. Esto significa que los usuarios de estas aplicaciones no necesitan hacer nada especial o incluso saber que sus datos están en un recurso compartido de archivos remoto en lugar del almacenamiento local.

Azure Files también proporciona una API REST, que a menudo se denomina API FileREST. Para usar la API FileREST, cree solicitudes HTTPS en los puntos de conexión HTTPS de FileREST. Puede escribir código para crear solicitudes HTTPS usted mismo, pero proporcionamos SDK de Azure que usan la API FileREST para usted, proporcionando un contenedor de lenguaje a través de la API FileREST en lenguajes populares, como C#, Java, Python, JavaScript y Go.

Dado que la API fileREST se diseñó específicamente para Azure Files, le permite acceder a características de Azure Files a las que no se puede acceder a través de SMB o NFS. También le permite realizar determinadas operaciones, como copiar, de forma más eficaz que a través de SMB o NFS.

La naturaleza sin estado de HTTPS hace que la API fileREST sea útil para los servicios en la nube o las aplicaciones que necesitan acceder a muchos recursos compartidos de archivos de Azure. Por ejemplo, puede adjuntar servicios o aplicaciones de valor agregado a un recurso compartido de archivos de Azure para agregar una funcionalidad. Estos servicios o aplicaciones pueden incluir antivirus, copias de seguridad, administración de datos o productos de replicación. Azure File Sync y Azure Backup son servicios de Microsoft importantes que usan ampliamente la API FileREST para agregar valor sobre un recurso compartido de archivos de Azure propiedad del cliente.

Considere la posibilidad de usar la API FileREST si va a crear servicios o aplicaciones de valor añadido, especialmente si proporciona esos servicios a los clientes. Si va a construir una aplicación de línea de negocio, especialmente una que los usuarios usarán en un recurso compartido de archivos de Azure montado, puede usar SMB/NFS o FileREST. Sin embargo, es posible que encuentre que el uso de SMB o NFS proporciona una ruta de acceso más sencilla porque esos protocolos le permiten usar las API del sistema de archivos nativos.

Si tiene una aplicación existente escrita con las API del sistema de archivos nativos, no es necesario volver a escribirla para aprovechar las ventajas de Azure Files. La propuesta de valor clave de Azure Files expone las API nativas del sistema de archivos mediante el uso de SMB o NFS.

Para obtener más información sobre Azure Files, incluida la implementación, las redes y la configuración de identidad, consulte:

Plano de control

En Azure, el plano de control se proporciona a través de Azure Resource Manager, que proporciona una manera común de exponer los recursos de Azure que administrará el cliente. La unidad de administración de nivel superior es la cuenta de almacenamiento. La cuenta de almacenamiento es un recurso de seguimiento en Azure Files y otros servicios de almacenamiento, como Azure Blob Storage.

El proveedor de recursos de almacenamiento administra la cuenta de almacenamiento, que tiene el espacio de nombres Microsoft.Storage. El proveedor de recursos de almacenamiento también expone la administración de recursos secundarios o recursos proxy que permiten la administración de los servicios de almacenamiento agrupados en la cuenta de almacenamiento. Para Azure Files, hay dos recursos de proxy pertinentes:

  • Recurso FileService. Proporciona una configuración específica de Azure Files que se aplican a todos los recursos compartidos de archivos de la cuenta de almacenamiento. El FileService recurso es un elemento secundario de la cuenta de almacenamiento. Una cuenta de almacenamiento siempre tiene solo un FileService recurso: default.

  • Recurso FileShare. Representa un recurso compartido de archivos o una instantánea de un recurso compartido de archivos. El FileShare recurso es un elemento secundario del FileService recurso y puede contener un número infinito de recursos compartidos de archivos.

Aunque un FileService recurso puede contener un número infinito de recursos, el uso de FileShare un número muy grande no es una buena idea porque todo lo que hay dentro de una cuenta de almacenamiento comparte un grupo definido de E/S, ancho de banda y otros límites. Para más información, consulte Objetivos de escalabilidad y rendimiento de Azure Files.

Para obtener información sobre cómo llamar a las API del plano de control, consulte:

Las operaciones en los FileService objetos y FileShare también se pueden realizar a través del plano de datos. Se trata de un artefacto de Azure Files predatar azure Resource Manager. Aunque estas API son totalmente compatibles, en la mayoría de los casos debe usar las API del proveedor de recursos de almacenamiento para administrar Azure Files por estos motivos:

  • Las operaciones expuestas a través de Azure Resource Manager usan Microsoft Entra ID para la autenticación y autorización, por lo que puede administrar Azure Files mediante el control de acceso basado en rol (RBAC). Puede autorizar la aplicación o el servicio para llamar mediante programación a estas API con una entidad de servicio de Microsoft Entra.

  • Puede llamar a las API de Azure Resource Manager de forma imperativa, ya sea a través de la API REST directamente o a través de un SDK. O bien, puede llamarlas mediante declaración declarativa mediante la declaración de los recursos que se deben implementar mediante plantillas de Azure. Para los recursos que deben crearse repetidamente juntos (por ejemplo, en implementaciones de servicio), el uso de plantillas puede simplificar considerablemente el trabajo necesario.

  • Aunque se recomienda usar el proveedor de recursos de almacenamiento para administrar los recursos de almacenamiento, el uso de las API de administración del plano de datos FileREST le proporcionará un mejor rendimiento en los casos que requieren una escala alta. Un ejemplo de este caso es una carga de trabajo que crea o modifica miles de recursos compartidos de archivos dentro de la misma cuenta de almacenamiento.

    • Microsoft.Storage storageAccounts/fileServices/shares desencadena una operación del plano de control a través del proveedor de recursos de almacenamiento.
    • Microsoft.Storage storageAccounts/fileServices/fileshares es una operación del plano de datos. Establecer roles de nivel de recurso compartido, como Lector de recursos compartidos SMB de datos de archivos de almacenamiento , debe ser una operación de plano de datos y debe usar este recurso.

Plano de datos

Azure Files proporciona un sistema de archivos jerárquico para datos no estructurados. La API FileREST modela los dos objetos importantes en el espacio del sistema de archivos: archivos y directorios. Para obtener información sobre cómo llamar a las API de FileREST, consulte:

Consulte también