File Services - Get Service Properties
Получает свойства файловых служб в учетных записях хранения, включая правила CORS (Cross-Origin Resource Sharing).
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default?api-version=2025-06-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
Имя учетной записи хранения в указанной группе ресурсов. Имена учетных записей хранения должны быть от 3 до 24 символов длиной и использовать только цифры и строчные буквы. |
|
File
|
path | True |
Имя файловой службы в указанной учетной записи хранения. Имя файловой службы должно быть "default" |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Имя группы ресурсов в подписке пользователя. Имя не зависит от регистра. |
|
subscription
|
path | True |
string minLength: 1 |
Идентификатор целевой подписки. |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
OK — возвращены свойства файловой службы учетной записи хранения. |
|
| Other Status Codes |
Ответ на ошибку, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
GetFileServices
Образец запроса
Пример ответа
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
"name": "default",
"type": "Microsoft.Storage/storageAccounts/fileServices",
"properties": {
"cors": {
"corsRules": [
{
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"maxAgeInSeconds": 100,
"exposedHeaders": [
"x-ms-meta-*"
],
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
]
},
{
"allowedOrigins": [
"*"
],
"allowedMethods": [
"GET"
],
"maxAgeInSeconds": 2,
"exposedHeaders": [
"*"
],
"allowedHeaders": [
"*"
]
},
{
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"allowedMethods": [
"GET",
"PUT"
],
"maxAgeInSeconds": 2000,
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedHeaders": [
"x-ms-meta-12345675754564*"
]
}
]
}
},
"sku": {
"name": "Standard_GRS",
"tier": "Standard"
}
}
Определения
| Имя | Описание |
|---|---|
|
Allowed |
Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником. |
|
Cloud |
Ответ об ошибке из службы хранилища. |
|
Cloud |
Ответ об ошибке из службы хранилища. |
|
Cors |
Задает правило CORS для службы BLOB-объектов. |
|
Cors |
Задает правила CORS. В запрос можно включить до пяти элементов CorsRule. |
|
Delete |
Свойства службы для обратимого удаления. |
|
Encryption |
Шифрование при передаче. |
|
File |
Свойства служб файлов в учетной записи хранения. |
|
File |
Имя файловой службы в указанной учетной записи хранения. Имя файловой службы должно быть "default" |
| Multichannel |
Параметр multichannel. Применяется только к FileStorage класса Premium. |
|
Nfs |
Настройка для протокола NFS |
|
Protocol |
Параметры протокола для файловой службы |
| Sku |
Номер SKU учетной записи хранения. |
|
Sku |
Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType. |
|
Sku |
Уровень SKU. Это основано на имени SKU. |
|
Smb |
Настройка протокола SMB |
AllowedMethods
Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником.
| Значение | Описание |
|---|---|
| DELETE | |
| GET | |
| HEAD | |
| MERGE | |
| POST | |
| OPTIONS | |
| PUT | |
| PATCH | |
| CONNECT | |
| TRACE |
CloudError
Ответ об ошибке из службы хранилища.
| Имя | Тип | Описание |
|---|---|---|
| error |
Ответ об ошибке из службы хранилища. |
CloudErrorBody
Ответ об ошибке из службы хранилища.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования. |
| details |
Список дополнительных сведений об ошибке. |
|
| message |
string |
Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе. |
| target |
string |
Целевой объект конкретной ошибки. Например, имя свойства в ошибке. |
CorsRule
Задает правило CORS для службы BLOB-объектов.
| Имя | Тип | Описание |
|---|---|---|
| allowedHeaders |
string[] |
Требуется, если элемент CorsRule присутствует. Список заголовков, которым разрешено быть частью запроса между источниками. |
| allowedMethods |
Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником. |
|
| allowedOrigins |
string[] |
Требуется, если элемент CorsRule присутствует. Список доменов происхождения, которые будут разрешены через CORS или *, чтобы разрешить все домены |
| exposedHeaders |
string[] |
Требуется, если элемент CorsRule присутствует. Список заголовков ответов для предоставления клиентам CORS. |
| maxAgeInSeconds |
integer |
Требуется, если элемент CorsRule присутствует. Количество секунд, в течение которых клиент или браузер должен кэшировать предварительный ответ. |
CorsRules
Задает правила CORS. В запрос можно включить до пяти элементов CorsRule.
| Имя | Тип | Описание |
|---|---|---|
| corsRules |
Cors |
Список правил CORS. В запрос можно включить до пяти элементов CorsRule. |
DeleteRetentionPolicy
Свойства службы для обратимого удаления.
| Имя | Тип | Описание |
|---|---|---|
| allowPermanentDelete |
boolean |
Это свойство, если задано значение true, разрешает удаление обратимо удаленных версий и моментальных снимков больших двоичных объектов. Это свойство нельзя использовать политику восстановления BLOB-объектов. Это свойство применяется только к службе BLOB-объектов и не применяется к контейнерам или общей папке. |
| days |
integer minimum: 1maximum: 365 |
Указывает количество дней хранения удаленного элемента. Минимальное указанное значение может иметь значение 1, а максимальное значение — 365. |
| enabled |
boolean |
Указывает, включена ли функция DeleteRetentionPolicy. |
EncryptionInTransit
Шифрование при передаче.
| Имя | Тип | Описание |
|---|---|---|
| required |
boolean |
Указывает, требуется ли шифрование при передаче |
FileServiceProperties
Свойства служб файлов в учетной записи хранения.
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
Имя ресурса |
| properties.cors |
Задает правила CORS для службы файлов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, а CORS будет отключен для службы файлов. |
|
| properties.protocolSettings |
Параметры протокола для файловой службы |
|
| properties.shareDeleteRetentionPolicy |
Свойства файловой службы для обратимого удаления общего ресурса. |
|
| sku |
Имя и уровень артикула. |
|
| type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
FileServicesName
Имя файловой службы в указанной учетной записи хранения. Имя файловой службы должно быть "default"
| Значение | Описание |
|---|---|
| default |
Multichannel
Параметр multichannel. Применяется только к FileStorage класса Premium.
| Имя | Тип | Описание |
|---|---|---|
| enabled |
boolean |
Указывает, включена ли мультиканель |
NfsSetting
Настройка для протокола NFS
| Имя | Тип | Описание |
|---|---|---|
| encryptionInTransit |
Шифрование при передаче. |
ProtocolSettings
Параметры протокола для файловой службы
| Имя | Тип | Описание |
|---|---|---|
| nfs |
Настройка для протокола NFS |
|
| smb |
Настройка протокола SMB |
Sku
Номер SKU учетной записи хранения.
| Имя | Тип | Описание |
|---|---|---|
| name |
Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType. |
|
| tier |
Уровень 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 |
Шифрование при передаче. |
|
| kerberosTicketEncryption |
string |
Шифрование билетов Kerberos, поддерживаемого сервером. Допустимые значения: RC4-HMAC, AES-256. Должен передаваться в виде строки с разделителем ";" |
| multichannel |
Параметр multichannel. Применяется только к FileStorage класса Premium. |
|
| versions |
string |
Версии протокола SMB, поддерживаемые сервером. Допустимые значения: SMB2.1, SMB3.0, SMB3.1.1. Должен передаваться в виде строки с разделителем ";". |