Azure Files REST API

Azure Files proporciona recursos compartidos de archivos hospedados en la nube a los que puede acceder ("montaje") mediante protocolos de 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 del sistema de archivos local, como las que puede realizar mediante . Las interfaces de System.IO de NET o los métodos open/read/write de Python. Esto significa que las aplicaciones y, lo que es importante, 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 de en el almacenamiento local.

Azure Files también proporciona una API REST, a menudo denominada API FileREST, que proporciona otro método de acceso a los datos almacenados en recursos compartidos de archivos de Azure. A diferencia de SMB y NFS, que permiten el acceso transparente a recursos compartidos de archivos remotos mediante las API del sistema de archivos nativo, el protocolo FileREST proporciona un método diferente de acceso a los datos del recurso compartido de archivos. Para usar la API de FileREST, cree solicitudes HTTPS en los puntos de conexión HTTPS de FileREST. Puede escribir código para crear solicitudes HTTPS usted mismo, pero la manera esperada de consumir la API de FileREST es a través de los SDK de Azure, que proporcionan API de lenguaje idiomático para lenguajes populares como C#, Java, Python, JavaScript, Go, etc.

Dado que la API de FileREST se diseñó específicamente para Azure Files, le permite acceder a características de Azure Files que no son accesibles a través de SMB o NFS, y realizar determinadas operaciones, como copiar, de forma más eficaz que a través de SMB/NFS. La naturaleza sin estado de HTTPS hace que la API fileREST sea útil para su uso en servicios en la nube o aplicaciones que necesitan acceder a muchos recursos compartidos de archivos de Azure, como servicios de valor agregado o aplicaciones que se pueden adjuntar al recurso compartido de archivos de Azure para agregar alguna funcionalidad. Esto puede incluir antivirus, copia de seguridad, administración de datos o productos de replicación. Por ejemplo, Azure File Sync y Azure Backup son importantes servicios de valor agregado propio que usan ampliamente la API FileREST para agregar valor sobre un recurso compartido de archivos de Azure propiedad del cliente.

Como regla general, debe considerar el uso de la API FileREST si va a crear aplicaciones o servicios de valor agregado, especialmente si proporciona dichos servicios de valor añadido a los clientes. Si va a crear una aplicación de línea de negocio, especialmente una que los usuarios finales usarán en un recurso compartido de archivos de Azure montado, puede usar SMB/NFS o FileREST; sin embargo, es posible que el uso de SMB/NFS proporcione una ruta de acceso más sencilla, ya que le permiten usar las API nativas del sistema de archivos. Si tiene una aplicación existente que se ha escrito en las API del sistema de archivos nativas, 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 del Azure Resource Manager, a veces abreviado como ARM, que proporciona una manera común de exponer los recursos de Azure para que los administra el cliente. La unidad de administración de nivel superior, o recurso de seguimiento en Azure Files y otros servicios de almacenamiento, como Blob Storage, es la cuenta de almacenamiento. 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 de proxy, que permiten la administración de los servicios de almacenamiento agrupados en la cuenta de almacenamiento. Por Azure Files, hay dos recursos de proxy pertinentes:

  • El recurso, que proporciona Azure Files configuración específica que se aplica a todos los recursos compartidos de FileService archivos de la cuenta de almacenamiento. El recurso es un recurso secundario de la cuenta de almacenamiento de la que se realiza el seguimiento y una cuenta de almacenamiento solo tiene FileService un FileService recurso, denominado default .

  • Recurso, FileShare que representa un recurso compartido de archivos (o una instantánea de un recurso compartido de archivos). El FileShare recurso es un elemento secundario del recurso y puede contener un número infinito de recursos FileService compartidos de archivos. Aunque puede contener un número infinito de recursos, el uso de un número muy grande no es una buena idea, ya que todo lo que hay dentro de una cuenta de almacenamiento comparte un grupo definido de E/S, ancho de banda y otros FileService FileShare 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:

Por motivos heredados, las operaciones en los objetos y también se FileService pueden realizar a través del plano de FileShare datos. Se trata de un artefacto de Azure Files de Azure Resource Manager y, aunque estas API son totalmente compatibles, debe preferir usar las API del proveedor de recursos de almacenamiento para administrar Azure Files por varias razones:

  • Las operaciones expuestas Azure Resource Manager usar Azure AD para la autenticación y autorización, lo que le permite administrar Azure Files con control de acceso basado en rol (RBAC). Puede autorizar a la aplicación o servicio a llamar mediante programación a estas API con una Azure AD de servicio.

  • Azure Resource Manager se puede llamar a las API de forma imperativa, mediante la API REST directamente o a través de un SDK, o mediante declaración, declarando qué recursos se deben implementar mediante plantillas de Azure. En el caso de los recursos que se deben crear repetidamente juntos, las implementaciones de servicio, etc., el uso de plantillas puede simplificar considerablemente el trabajo necesario.

Aunque se prefiere usar el proveedor de recursos de almacenamiento para administrar los recursos de almacenamiento, en los casos que requieran una escala alta, como una carga de trabajo que crea o modifica miles de recursos compartidos de archivos dentro de la misma cuenta de almacenamiento, el uso de las API de administración del plano de datos de FileREST será el más eficaz.

Plano de datos

Azure Files proporciona un sistema de archivos jerárquico para datos no estructurados ("archivos"). La API de 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:

Vea también