Operations on the FileService

The FileService resource provides Azure Files specific management settings that apply to all of the file shares in the storage account. The FileService resource is a child of the storage account resource, and a storage account only ever has one FileService resource, called default.

There are two ways to interact the FileService resource:

  • (Recommended) The storage resource provider (Microsoft.Storage), which provides a control plane API to manage through Azure Resource Manager.
  • (Legacy) The FileREST API, which provides additional HTTPS endpoints to manage the FileService.

Unless you have a specific reason, you should use the control plane API (the storage resource provider) for all management activities. APIs to manage the FileService are exposed through the data plane for legacy reasons. Data plane APIs that do management actions are fully supported, and acceptable for use in the following circumstances:

  • You have a legacy application or service that is already using these APIs.
  • You have very high scale requirements; the control plane API provided by the storage resource provider has much lower scale guarantees than the FileREST API.

New parameters and actions on the FileService may not be added to the data plane REST SDKs, even if they are exposed in FileREST. Use the control plane SDKs to access parameters and actions.

To learn more about Azure Files' API surface area, see Azure Files REST API.

Management APIs

This section contains the following topics.

Action Control plane API (Microsoft.Storage) Data plane API (FileREST) Available on SMB file shares Available on NFS file shares
Get FileService Get File Service Properties Yes Yes
Set FileService File Services - Set Service Properties Set File Service Properties Yes Yes
Preflight File Request -- Preflight File Request Yes Yes

See also