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


File Services - Set Service Properties

Задает свойства файловых служб в учетных записях хранения, включая правила CORS (Cross-Origin Resource Sharing).

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default?api-version=2025-06-01

Параметры URI

Имя В Обязательно Тип Описание
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

Имя учетной записи хранения в указанной группе ресурсов. Имена учетных записей хранения должны быть от 3 до 24 символов длиной и использовать только цифры и строчные буквы.

FileServicesName
path True

FileServicesName

Имя файловой службы в указанной учетной записи хранения. Имя файловой службы должно быть "default"

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Имя группы ресурсов в подписке пользователя. Имя не зависит от регистра.

subscriptionId
path True

string

minLength: 1

Идентификатор целевой подписки.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Текст запроса

Имя Тип Описание
properties.cors

CorsRules

Задает правила CORS для службы файлов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, а CORS будет отключен для службы файлов.

properties.protocolSettings

ProtocolSettings

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

properties.shareDeleteRetentionPolicy

DeleteRetentionPolicy

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

Ответы

Имя Тип Описание
200 OK

FileServiceProperties

OK — успешная установка свойств файловой службы учетной записи хранения.

Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

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

azure_auth

Поток OAuth2 Azure Active Directory

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

Области

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

Примеры

PutFileServices
PutFileServices_EnableSecureSmbFeatures
PutFileServices_EnableSMBMultichannel
PutFileServices_EncryptionInTransitRequired

PutFileServices

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

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2025-06-01

{
  "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*"
          ]
        }
      ]
    }
  }
}

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

{
  "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"
  }
}

PutFileServices_EnableSecureSmbFeatures

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

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2025-06-01

{
  "properties": {
    "protocolSettings": {
      "smb": {
        "versions": "SMB2.1;SMB3.0;SMB3.1.1",
        "authenticationMethods": "NTLMv2;Kerberos",
        "kerberosTicketEncryption": "RC4-HMAC;AES-256",
        "channelEncryption": "AES-128-CCM;AES-128-GCM;AES-256-GCM"
      }
    }
  }
}

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

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "protocolSettings": {
      "smb": {
        "versions": "SMB2.1;SMB3.0;SMB3.1.1",
        "authenticationMethods": "NTLMv2;Kerberos",
        "kerberosTicketEncryption": "RC4-HMAC;AES-256",
        "channelEncryption": "AES-128-CCM;AES-128-GCM;AES-256-GCM"
      }
    }
  },
  "sku": {
    "name": "Premium_LRS",
    "tier": "Premium"
  }
}

PutFileServices_EnableSMBMultichannel

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

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2025-06-01

{
  "properties": {
    "protocolSettings": {
      "smb": {
        "multichannel": {
          "enabled": true
        }
      }
    }
  }
}

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

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "protocolSettings": {
      "smb": {
        "multichannel": {
          "enabled": true
        }
      }
    }
  },
  "sku": {
    "name": "Premium_LRS",
    "tier": "Premium"
  }
}

PutFileServices_EncryptionInTransitRequired

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

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2025-06-01

{
  "properties": {
    "protocolSettings": {
      "smb": {
        "encryptionInTransit": {
          "required": true
        }
      },
      "nfs": {
        "encryptionInTransit": {
          "required": true
        }
      }
    }
  }
}

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

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "protocolSettings": {
      "smb": {
        "encryptionInTransit": {
          "required": true
        }
      },
      "nfs": {
        "encryptionInTransit": {
          "required": true
        }
      }
    }
  },
  "sku": {
    "name": "Premium_LRS",
    "tier": "Premium"
  }
}

Определения

Имя Описание
AllowedMethods

Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником.

CloudError

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

CloudErrorBody

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

CorsRule

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

CorsRules

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

DeleteRetentionPolicy

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

EncryptionInTransit

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

FileServiceProperties

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

FileServicesName

Имя файловой службы в указанной учетной записи хранения. Имя файловой службы должно быть "default"

Multichannel

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

NfsSetting

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

ProtocolSettings

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

Sku

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

SkuName

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

SkuTier

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

SmbSetting

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

AllowedMethods

Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником.

Значение Описание
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

Требуется, если элемент CorsRule присутствует. Количество секунд, в течение которых клиент или браузер должен кэшировать предварительный ответ.

CorsRules

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

Имя Тип Описание
corsRules

CorsRule[]

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

DeleteRetentionPolicy

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

Имя Тип Описание
allowPermanentDelete

boolean

Это свойство, если задано значение true, разрешает удаление обратимо удаленных версий и моментальных снимков больших двоичных объектов. Это свойство нельзя использовать политику восстановления BLOB-объектов. Это свойство применяется только к службе BLOB-объектов и не применяется к контейнерам или общей папке.

days

integer

minimum: 1
maximum: 365

Указывает количество дней хранения удаленного элемента. Минимальное указанное значение может иметь значение 1, а максимальное значение — 365.

enabled

boolean

Указывает, включена ли функция DeleteRetentionPolicy.

EncryptionInTransit

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

Имя Тип Описание
required

boolean

Указывает, требуется ли шифрование при передаче

FileServiceProperties

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

Имя Тип Описание
id

string

Полный идентификатор ресурса для ресурса. Пример - /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

Имя и уровень артикула.

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

FileServicesName

Имя файловой службы в указанной учетной записи хранения. Имя файловой службы должно быть "default"

Значение Описание
default

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. Должен передаваться в виде строки с разделителем ";".