Поделиться через


REST API для Файлов Azure

Файлы Azure предоставляет размещенные облачные общие папки, к которым можно получить доступ (подключиться) с помощью стандартных отраслевых протоколов файловой системы, таких как SMB и NFS. При подключении общей папки на компьютере с помощью SMB или NFS операционная система перенаправляет запросы API для локальной файловой системы. Перенаправление включает локальные запросы API, выполняемые с помощью интерфейсов .NET System.IO или открытых методов Python, чтения или записи. Это означает, что пользователям этих приложений не нужно делать ничего особенного или даже знать, что их данные относятся к удаленной общей папке, а не в локальном хранилище.

Файлы Azure также предоставляет REST API, который часто называется API FileREST. Чтобы использовать API FileREST, создайте HTTPS-запросы к конечным точкам HTTPS FileREST. Вы можете написать код для создания HTTPS-запросов самостоятельно, но мы предоставляем пакеты SDK Azure, которые используют API FileREST, предоставляя идиоматические языковые оболочки через API FileREST на популярных языках, таких как C#, Java, Python, JavaScript и Go.

Так как API FileREST был разработан специально для Файлы Azure, он позволяет получать доступ к функциям Файлы Azure, к которым вы не можете получить доступ через SMB или NFS. Он также позволяет выполнять определенные операции, такие как копирование, более эффективно, чем с помощью SMB или NFS.

HttpS без отслеживания состояния делает API FileREST полезным для облачных служб или приложений, которым требуется доступ ко многим файловым ресурсам Azure. Например, вы можете присоединить службы или приложения с добавленной стоимостью к общей папке Azure, чтобы добавить возможность. Эти службы или приложения могут включать антивирусные программы, продукты резервного копирования, управления данными или репликации. Синхронизация файлов Azure и Azure Backup — это важные службы Майкрософт, которые широко используют API FileREST для добавления ценности поверх общей папки Azure, принадлежащей клиенту.

Рекомендуется использовать API FileREST, если вы создаете службы или приложения с добавленной стоимостью, особенно если вы предоставляете эти службы клиентам. Если вы создаете бизнес-приложение, особенно то, которое пользователи будут использовать для подключенной общей папки Azure, можно использовать SMB/NFS или FileREST. Однако вы можете обнаружить, что использование SMB или NFS обеспечивает более простой путь, так как эти протоколы позволяют использовать собственные API файловой системы.

Если у вас есть приложение, написанное с помощью собственных API файловой системы, вам не нужно переписывать его, чтобы воспользоваться преимуществами Файлы Azure. Ключевым предложением Файлы Azure является предоставление собственных API файловой системы с помощью SMB или NFS.

Дополнительные сведения о Файлы Azure, включая развертывание, сеть и конфигурацию удостоверений, см. в следующих разделах:

Уровень управления

В Azure уровень управления предоставляется с помощью azure Resource Manager, который предоставляет общий способ предоставления ресурсов Azure, которыми будет управлять клиент. Единицей управления верхнего уровня является учетная запись хранения. Учетная запись хранения — это отслеживаемый ресурс в Файлы Azure и других службах хранения, таких как Хранилище BLOB-объектов Azure.

Учетной записью хранения управляет поставщик ресурсов хранилища, который имеет пространство имен Microsoft.Storage. Поставщик ресурсов хранилища также предоставляет управление дочерними ресурсами или прокси-ресурсами, которые позволяют управлять службами хранилища, объединенными в учетную запись хранения. Для Файлы Azure существуют два важных прокси-ресурса:

  • Ресурс FileService. Он предоставляет параметры, относящиеся к Файлы Azure, которые применяются ко всем общим папкам в учетной записи хранения. Ресурс FileService является дочерним для учетной записи хранения. Учетная запись хранения всегда имеет только один FileService ресурс: default.

  • Ресурс FileShare. Он представляет общую папку или snapshot общей папки. Ресурс FileShare является дочерним по отношению к ресурсу FileService и может содержать бесконечное количество общих папок.

FileService Хотя ресурс может содержать неограниченное количество FileShare ресурсов, использовать очень большое число не рекомендуется, так как все элементы в учетной записи хранения используют определенный пул операций ввода-вывода, пропускную способность и другие ограничения. Дополнительные сведения см. в статье Целевые показатели масштабируемости и производительности Файлов Azure.

Чтобы узнать, как вызывать API уровня управления, см. следующие статьи:

Операции с объектами FileService и FileShare также можно выполнять через плоскость данных. Это артефакт Файлы Azure, предшествующих Resource Manager Azure. Хотя эти API полностью поддерживаются, в большинстве случаев следует использовать API поставщика ресурсов хранилища для управления Файлы Azure по следующим причинам:

  • Операции, предоставляемые через Azure Resource Manager, используют Microsoft Entra ID для проверки подлинности и авторизации, поэтому вы можете управлять Файлы Azure с помощью управления доступом на основе ролей (RBAC). Вы можете авторизовать приложение или службу для программного вызова этих API с помощью Microsoft Entra субъекта-службы.

  • Api-интерфейсы Azure Resource Manager можно вызывать принудительно либо через REST API напрямую, либо с помощью пакета SDK. Вы также можете вызвать их декларативно, объявив, какие ресурсы необходимо развернуть с помощью шаблонов Azure. Для ресурсов, которые необходимо многократно создавать вместе (например, в развертываниях служб), использование шаблонов может значительно упростить необходимую работу.

  • Хотя мы рекомендуем использовать поставщик ресурсов хранилища для управления ресурсами хранилища, использование API-интерфейсов управления плоскостью данных FileREST обеспечит более высокую производительность в случаях, требующих большого масштаба. Примером такого случая является рабочая нагрузка, которая создает или изменяет тысячи общих папок в одной учетной записи хранения.

    • Microsoft.Storage storageAccounts/fileServices/shares активирует операцию уровня управления через поставщик ресурсов хранилища.
    • Microsoft.Storage storageAccounts/fileServices/fileshares — это операция плоскости данных. Установка ролей уровня общей папки, таких как читатель общих ресурсов SMB хранилища, должна выполняться в плоскости данных и использовать этот ресурс.

Плоскость данных

Файлы Azure предоставляет иерархическую файловую систему для неструктурированных данных. API FileREST моделирует два важных объекта в пространстве файловой системы: файлы и каталоги. Чтобы узнать, как вызывать API FileREST, см. следующие статьи:

См. также раздел