Установка свойств общего ресурса
Операция Set Share Properties
задает свойства для указанной общей папки Azure. Хотя эта операция полностью поддерживается, она является устаревшей операцией управления. Рекомендуется использовать операцию "Общие папки — обновление ", предоставляемую поставщиком ресурсов хранилища (Microsoft.Storage). Дополнительные сведения о программном взаимодействии с ресурсами с помощью поставщика ресурсов хранилища см. в разделе Операции с FileShare
ресурсами FileShare.
Доступность протокола
Включенный протокол общей папки | Доступно |
---|---|
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 и более поздних версиях. Указывает максимальный размер общей папки в гибибайтах (ГиБ). |
x-ms-access-tier |
Необязательный элемент. Поддерживается в версии 2019-12-12 и более поздних версиях. Указывает уровень доступа общей папки. Допустимые значения: TransactionOptimized , Hot и Cool . Подробные сведения о разных уровнях файловых ресурсов см. в разделе Файлы Azure уровнях хранилища. |
x-ms-root-squash: <NoRootSquash | RootSquash | AllSquash> |
Необязательный элемент. Поддерживается в версии 2020-02-10 и более поздних. Указывает поведение корневого сжатия в общей папке при включении NFS. Если он не указан, по умолчанию используется значение NoRootSquash .
|
x-ms-client-request-id |
Необязательный элемент. Предоставляет созданное клиентом непрозрачное значение с ограничением в 1 кибибайт (КиБ), которое записывается в журналы Аналитика Службы хранилища при настройке ведения журнала. Мы настоятельно рекомендуем использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в разделе Мониторинг Хранилище BLOB-объектов Azure. |
x-ms-lease-id:<ID> |
Требуется, если в целевой общей папке есть активная аренда. Доступно для версии 2020-02-10 и более поздних версий. Если запрос не содержит идентификатор аренды или он недопустим, операция завершается ошибкой с кодом состояния 412 (сбой условия). Если этот заголовок указан и в общей папке назначения сейчас нет активной аренды, операция завершается ошибкой с кодом состояния 412 (сбой условия). |
Текст запроса
Нет.
Пример запроса
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
не поддерживается для snapshot общей папки. Попытка выполнить эту операцию в общей snapshot завершится ошибкой с кодом состояния 400 (InvalidQueryParameterValue).