Операции с ресурсом FileShare
Ресурс FileShare предоставляет интерфейс управления для общей папки Azure, который позволяет управлять именем общей папки, включенным протоколом, выделенным размером (квотой) и т. д. Ресурс FileShare является дочерним по отношению к ресурсу FileService , а учетная запись хранения может содержать неограниченное количество общих папок в зависимости от ограничений ресурсов учетной записи хранения.
Взаимодействовать с FileShare ресурсами можно двумя способами:
- (Рекомендуется) Поставщик ресурсов хранилища (Microsoft.Storage), который предоставляет API уровня управления для управления с помощью Azure Resource Manager.
- (Устаревшая версия) API FileREST, который предоставляет дополнительные конечные точки HTTPS для управления
FileShares.
Если у вас нет определенной причины, для всех действий по управлению следует использовать API уровня управления (поставщик ресурсов хранилища). API для управления FileShares предоставляются через плоскость данных по устаревшим причинам. API плоскости данных, выполняющие действия по управлению, полностью поддерживаются и допустимы для использования в следующих случаях:
- У вас есть устаревшее приложение или служба, которые уже используют эти API.
- У вас очень высокие требования к масштабированию. API элемента управления, предоставляемый поставщиком ресурсов хранилища, имеет гораздо более низкие гарантии масштабирования, чем API FileREST.
Новые параметры и действия в FileService могут не добавляться в пакеты REST SDK для плоскости данных, даже если они предоставляются в FileREST. Используйте пакеты SDK для уровня управления для доступа к параметрам и действиям.
Дополнительные сведения о контактной области API Файлы Azure см. в статье Файлы Azure REST API.
API управления
| Действие | API уровня управления (Microsoft.Storage) | API плоскости данных (FileREST) | Доступно в общих папках SMB | Доступно в общих папках NFS |
|---|---|---|---|---|
Создайте FileShare |
Общие папки — Create | Создание общей папки |
|
|
Delete FileShare |
Общие папки — удаление | Удалить общий ресурс |
|
|
Get FileShare |
Общие папки — получение |
|
|
|
Аренды FileShare |
Общие папки — аренда | Общая папка аренды |
|
|
Вывод объектов FileShares |
Общие папки — список | Список общих папок |
|
|
Восстановить FileShare |
Общие папки — восстановление | Восстановление общей папки |
|
|
Обновление FileShare |
Общие папки — обновление |
-
Задание свойств общего ресурса - Настройка общих метаданных |
|
|
Моментальный снимок FileShare |
-- | хранилище моментальных снимков |
|
|
Получение FileShare хранимых политик доступа |
-- | Получение списка управления доступом для общего ресурса |
|
|
Настройка FileShare хранимых политик доступа |
-- | Настройка списка ACL общего доступа |
|
|
API данных
| Действие | API | Доступно в общих папках SMB | Доступно в общих папках NFS |
|---|---|---|---|
| Create разрешения на список управления доступом | Разрешение Create |
|
|
| Получение разрешения на список управления доступом | Получение разрешения |
|
|