File Services - List

Служба:

Storage Resource Provider

Версия API:

2026-04-01

Вывод списка всех файловых служб в учетных записях хранения

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices?api-version=2026-04-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Имя учетной записи хранения в указанной группе ресурсов. Имена учетных записей хранения должны быть от 3 до 24 символов длиной и использовать только цифры и строчные буквы.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	FileServiceItems	Операция Azure успешно завершена.
Other Status Codes	CloudError	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

ListFileServices

Образец запроса

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices?api-version=2026-04-01

Пример ответа

Код состояния:

200

{
  "value": [
    {
      "name": "default",
      "type": "Microsoft.Storage/storageAccounts/fileServices",
      "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
      "properties": {
        "cors": {
          "corsRules": [
            {
              "allowedHeaders": [
                "x-ms-meta-abc",
                "x-ms-meta-data*",
                "x-ms-meta-target*"
              ],
              "allowedMethods": [
                "GET",
                "HEAD",
                "POST",
                "OPTIONS",
                "MERGE",
                "PUT"
              ],
              "allowedOrigins": [
                "http://www.contoso.com",
                "http://www.fabrikam.com"
              ],
              "exposedHeaders": [
                "x-ms-meta-*"
              ],
              "maxAgeInSeconds": 100
            },
            {
              "allowedHeaders": [
                "*"
              ],
              "allowedMethods": [
                "GET"
              ],
              "allowedOrigins": [
                "*"
              ],
              "exposedHeaders": [
                "*"
              ],
              "maxAgeInSeconds": 2
            },
            {
              "allowedHeaders": [
                "x-ms-meta-12345675754564*"
              ],
              "allowedMethods": [
                "GET",
                "PUT"
              ],
              "allowedOrigins": [
                "http://www.abc23.com",
                "https://www.fabrikam.com/*"
              ],
              "exposedHeaders": [
                "x-ms-meta-abc",
                "x-ms-meta-data*",
                "x-ms-meta-target*"
              ],
              "maxAgeInSeconds": 2000
            }
          ]
        }
      },
      "sku": {
        "name": "Standard_GRS",
        "tier": "Standard"
      }
    }
  ]
}

Определения

Имя	Описание
AllowedMethods
CloudError	Ответ об ошибке из службы хранилища.
CloudErrorBody	Ответ об ошибке из службы хранилища.
CorsRule	Задает правило CORS для службы BLOB-объектов.
CorsRules	Задает правила CORS. В запрос можно включить до пяти элементов CorsRule.
createdByType	Тип удостоверения, создавшего ресурс.
DeleteRetentionPolicy	Свойства службы для обратимого удаления.
EncryptionInTransit	Шифрование при передаче.
FileServiceItems
FileServiceProperties	Свойства служб файлов в учетной записи хранения.
Multichannel	Параметр multichannel. Применяется только к FileStorage класса Premium.
NfsSetting	Настройка для протокола NFS
ProtocolSettings	Параметры протокола для файловой службы
Sku	Номер SKU учетной записи хранения.
SkuName	Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.
SkuTier	Уровень SKU. Это основано на имени SKU.
SmbSetting	Настройка протокола SMB
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

AllowedMethods

Перечисление

Значение	Описание
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

CloudError

Объект

Ответ об ошибке из службы хранилища.

Имя	Тип	Описание
error	CloudErrorBody	Ответ об ошибке из службы хранилища.

CloudErrorBody

Объект

Ответ об ошибке из службы хранилища.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
details	CloudErrorBody[]	Список дополнительных сведений об ошибке.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target	string	Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

CorsRule

Объект

Задает правило CORS для службы BLOB-объектов.

Имя	Тип	Описание
allowedHeaders	string[]	Требуется, если элемент CorsRule присутствует. Список заголовков, которым разрешено быть частью запроса между источниками.
allowedMethods	AllowedMethods[]	Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником.
allowedOrigins	string[]	Требуется, если элемент CorsRule присутствует. Список доменов происхождения, которые будут разрешены через CORS или *, чтобы разрешить все домены
exposedHeaders	string[]	Требуется, если элемент CorsRule присутствует. Список заголовков ответов для предоставления клиентам CORS.
maxAgeInSeconds	integer (int32)	Требуется, если элемент CorsRule присутствует. Количество секунд, в течение которых клиент или браузер должен кэшировать предварительный ответ.

CorsRules

Объект

Задает правила CORS. В запрос можно включить до пяти элементов CorsRule.

Имя	Тип	Описание
corsRules	CorsRule[]	Список правил CORS. В запрос можно включить до пяти элементов CorsRule.

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

DeleteRetentionPolicy

Объект

Свойства службы для обратимого удаления.

Имя	Тип	Описание
allowPermanentDelete	boolean	Это свойство, если задано значение true, разрешает удаление обратимо удаленных версий и моментальных снимков больших двоичных объектов. Это свойство нельзя использовать политику восстановления BLOB-объектов. Это свойство применяется только к службе BLOB-объектов и не применяется к контейнерам или общей папке.
days	integer (int32) minimum: 1 maximum: 365	Указывает количество дней хранения удаленного элемента. Минимальное указанное значение может иметь значение 1, а максимальное значение — 365.
enabled	boolean	Указывает, включена ли функция DeleteRetentionPolicy.

EncryptionInTransit

Объект

Шифрование при передаче.

Имя	Тип	Описание
required	boolean	Указывает, требуется ли шифрование при передаче

FileServiceItems

Объект

Имя	Тип	Описание
value	FileServiceProperties[]	Список возвращаемых файловых служб.

FileServiceProperties

Объект

Свойства служб файлов в учетной записи хранения.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties.cors	CorsRules	Задает правила CORS для службы файлов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, а CORS будет отключен для службы файлов.
properties.protocolSettings	ProtocolSettings	Параметры протокола для файловой службы
properties.shareDeleteRetentionPolicy	DeleteRetentionPolicy	Свойства файловой службы для обратимого удаления общего ресурса.
sku	Sku	Имя и уровень артикула.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
type	string	Тип ресурса. Например, «Microsoft. Compute/virtualMachines» или «Microsoft. Аккаунты хранения/хранения»

Multichannel

Объект

Параметр multichannel. Применяется только к FileStorage класса Premium.

Имя	Тип	Описание
enabled	boolean	Указывает, включена ли мультиканель

NfsSetting

Объект

Настройка для протокола NFS

Имя	Тип	Описание
encryptionInTransit	EncryptionInTransit	Шифрование при передаче.

ProtocolSettings

Объект

Параметры протокола для файловой службы

Имя	Тип	Описание
nfs	NfsSetting	Настройка для протокола NFS
smb	SmbSetting	Настройка протокола SMB

Sku

Объект

Номер SKU учетной записи хранения.

Имя	Тип	Описание
name	SkuName	Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.
tier	SkuTier	Уровень SKU. Это основано на имени SKU.

SkuName

Перечисление

Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.

Значение	Описание
Standard_LRS
Standard_GRS
Standard_RAGRS
Standard_ZRS
Premium_LRS
Premium_ZRS
Standard_GZRS
Standard_RAGZRS
StandardV2_LRS
StandardV2_GRS
StandardV2_ZRS
StandardV2_GZRS
PremiumV2_LRS
PremiumV2_ZRS

SkuTier

Перечисление

Уровень SKU. Это основано на имени SKU.

Значение	Описание
Standard
Premium

SmbSetting

Объект

Настройка протокола SMB

Имя	Тип	Описание
authenticationMethods	string	Методы проверки подлинности SMB, поддерживаемые сервером. Допустимые значения: NTLMv2, Kerberos. Должен передаваться в виде строки с разделителем ";".
channelEncryption	string	Шифрование каналов SMB, поддерживаемого сервером. Допустимые значения: AES-128-CCM, AES-128-GCM, AES-256-GCM. Должен передаваться в виде строки с разделителем ";".
encryptionInTransit	EncryptionInTransit	Шифрование при передаче.
kerberosTicketEncryption	string	Шифрование билетов Kerberos, поддерживаемого сервером. Допустимые значения: RC4-HMAC, AES-256. Должен передаваться в виде строки с разделителем ";"
multichannel	Multichannel	Параметр multichannel. Применяется только к FileStorage класса Premium.
versions	string	Версии протокола SMB, поддерживаемые сервером. Допустимые значения: SMB2.1, SMB3.0, SMB3.1.1. Должен передаваться в виде строки с разделителем ";".

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.