Задание свойств общего ресурса
Операция Set Share Properties задает свойства для указанной общей папки Azure. Хотя эта операция полностью поддерживается, это устаревшая операция управления. Рекомендуется использовать общих папок . Обновление операции, предоставляемой поставщиком ресурсов хранилища (Microsoft.Storage). Дополнительные сведения о программном взаимодействии с ресурсами FileShare с помощью поставщика ресурсов хранилища см. в статье Operations on FileShare resources.
Доступность протокола
| Протокол общей папки с включенным доступом | Доступный |
|---|---|
| SMB |
|
| NFS |
|
Просьба
Можно создать запрос Set Share Properties следующим образом. Мы рекомендуем HTTPS. Замените myaccount именем учетной записи хранения.
| Метод | URI запроса | ВЕРСИЯ HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties |
HTTP/1.1 |
Замените компоненты пути, отображаемые в URI запроса собственным, следующим образом:
| Компонент path | Описание |
|---|---|
myaccount |
Имя учетной записи хранения. |
myshare |
Имя общей папки. |
Дополнительные сведения об ограничениях именования путей см. в разделе Именование и ссылка на общие папки, каталоги, файлы и метаданные.
Параметры URI
В URI запроса можно указать следующие дополнительные параметры:
| Параметр | Описание |
|---|---|
timeout |
Необязательный. Выражено в секундах. Дополнительные сведения см. в статье Установка времени ожидания для операций с файлами Azure. |
Заголовки запросов
В следующей таблице описаны обязательные и необязательные заголовки запросов:
| Заголовок запроса | Описание |
|---|---|
Authorization |
Обязательно. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure. |
Date или x-ms-date |
Обязательно. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure. |
x-ms-version |
Требуется для всех авторизованных запросов. Указывает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями служб хранилища Azure. |
x-ms-share-quota |
Необязательный. Поддерживается в версии 2015-02-21 и более поздних версий. Указывает максимальный размер общей папки в гибибайтах (GiB). |
x-ms-access-tier |
Необязательный. Поддерживается в версии 2019-12-12 и более поздних версий. Указывает уровень доступа общей папки. Допустимые значения: TransactionOptimized, Hotи Cool. Подробные сведения о уровне общей папки см. в уровнях хранилища файлов Azure. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Необязательный. Поддерживается в версии 2020-02-10 и более поздних версий. Указывает поведение корневого скваширования в общей папке при включении NFS.
|
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Необязательный. Поддерживается в версии 2024-08-04 и более поздних версий. Указывает, должен ли виртуальный каталог моментального снимка быть доступен в корне точки подключения общего ресурса при включении NFS. |
x-ms-client-request-id |
Необязательный. Предоставляет созданное клиентом непрозрачное значение с ограничением символов 1-kibibyte (KiB), записанным в журналах Аналитики хранилища при настройке ведения журнала. Настоятельно рекомендуется использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Monitorхранилища BLOB-объектов Azure. |
x-ms-lease-id:<ID> |
Требуется, если у целевой общей папки есть активная аренда. Доступно для версии 2020-02-10 и более поздних версий. Если запрос не включает идентификатор аренды или недействителен, операция завершается ошибкой с кодом состояния 412 (сбой предварительных условий). Если этот заголовок указан и целевой файловый ресурс в настоящее время не имеет активной аренды, операция завершается ошибкой с кодом состояния 412 (сбой предварительных условий). |
x-ms-share-paid-bursting-enabled: <true \| false> |
Необязательный. Поддерживается в версии 2024-11-04 и более поздних версий. Разрешено только для общих папок класса Premium (общие папки в типе учетной записи хранения FileStorage). Это свойство можно использовать для включения или отключения платного ускорения. Если свойство не указано, общий ресурс будет сохранять его существующее состояние активации с ускорением оплаты. |
x-ms-share-paid-bursting-max-iops |
Необязательный. Поддерживается в версии 2024-11-04 и более поздних версий. Разрешено только для общих папок класса Premium. Целое число, представляющее максимальное число операций ввода-вывода в секунду( операций ввода-вывода), разрешенных для общей папки. Если платный всплеск еще не включен в общей папке: поведение идентично заголовку x-ms-share-paid-bursting-max-iops в Create Share. Значение по умолчанию, если не указано максимально допустимое число операций ввода-вывода в секунду для общей папки. Если этот заголовок задан, x-ms-share-paid-bursting-enabled также должно быть задано значение true.Если платная вспышка уже включена в общей папке: x-ms-share-paid-bursting-max-iops можно использовать для обновления максимального количества платных операций ввода-вывода в секунду для общей папки.
x-ms-share-paid-bursting-enabled не требуется задавать в этом случае. Если для x-ms-share-paid-bursting-enabled задано значение true, но x-ms-share-paid-bursting-max-iops не задано, максимальный объем платных операций ввода-вывода в секунду останется неизменным. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Необязательный. Поддерживается в версии 2024-11-04 и более поздних версий. Разрешено только для общих папок класса Premium. Целое число, представляющее максимальное количество платных мебибайтов в секунду (MiB/s), допустимое для общей папки. Если платный всплеск еще не включен в общей папке: поведение идентично заголовку x-ms-share-paid-bursting-max-bandwidth-mibps в Create Share. Значение по умолчанию, если не указано максимально допустимое значение MiB/s для общей папки. Если этот заголовок задан, x-ms-share-paid-bursting-enabled также должно быть задано значение true.Если платная вспышка уже включена в общей папке: x-ms-share-paid-bursting-max-bandwidth-mibps можно использовать для обновления максимальной оплаты МиБ/с для общей папки.
x-ms-share-paid-bursting-enabled не требуется задавать в этом случае. Если для x-ms-share-paid-bursting-enabled задано значение true, но x-ms-share-paid-bursting-max-bandwidth-mibps не задано, максимальная платная пропускная способность будет оставаться неизменной. |
Текст запроса
Никакой.
Пример запроса
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=properties
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
Authorization: SharedKey myaccount: Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00Jdjid0Q=
x-ms-share-quota: 55
x-ms-root-squash: RootSquash
Ответ
Ответ включает код состояния HTTP и набор заголовков ответа.
Код состояния
Успешная операция возвращает код состояния 200 (ОК).
Сведения о кодах состояния см. в коды состояния и коды ошибок.
Заголовки ответа
Ответ для этой операции содержит следующие заголовки. Ответ также может включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.
| Заголовок ответа | Описание |
|---|---|
Last-Modified |
Возвращает дату и время последнего изменения общей папки. Формат даты следует RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Любая операция, которая изменяет общую папку или его свойства, обновляет время последнего изменения. Операции с файлами не влияют на время последнего изменения общей папки. |
ETag |
Содержит значение, представляющее версию общей папки в виде строки с кавычками. |
x-ms-request-id |
Уникально идентифицирует выполненный запрос. Его также можно использовать для устранения неполадок запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API. |
x-ms-version |
Указывает версию файлов Azure, которая используется для выполнения запроса. |
Date или x-ms-date |
Значение даты и времени в формате UTC, указывающее время отправки ответа службой. |
x-ms-client-request-id |
Можно использовать для устранения неполадок запросов и соответствующих ответов. Значение этого заголовка равно значению заголовка x-ms-client-request-id, если оно присутствует в запросе, а значение — не более 1024 видимых символов ASCII. Если в запросе отсутствует заголовок x-ms-client-request-id, этот заголовок не будет присутствовать в ответе. |
Текст ответа
Никакой.
Авторизация
Только владелец учетной записи может вызвать эту операцию.
Замечания
Дополнительные сведения о настройке квоты общего ресурса см. в разделе Создание общего ресурса.
Если квота общего ресурса будет меньше размера данных в общей папке, операция завершится успешно. Тем не менее, вы не сможете добавлять дополнительные данные в общую папку, пока объем данных в общей папке не будет сокращен ниже квоты. Вы можете уменьшить объем данных, удалив или сжимая файлы.
Set Share Properties не поддерживается для моментального снимка общего ресурса. Попытка выполнить эту операцию на моментальном снимке общего ресурса завершится ошибкой с кодом состояния 400 (InvalidQueryParameterValue).
Если задать заголовок x-ms-enable-snapshot-virtual-directory-access для общих папок NFS, повторно подключите общую папку, чтобы наблюдать за обновленным поведением.