Задание свойств файла
Операция Set File Properties задает системные свойства файла. Эта операция поддерживается в версии 2025-05-05 и более поздних версий для общих папок с включенным протоколом NFS.
Доступность протокола
| Протокол общей папки с включенным доступом | Доступный |
|---|---|
| SMB |
|
| NFS |
|
Просьба
Запрос Set File Properties создается следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS.
| Метод | URI запроса | ВЕРСИЯ HTTP |
|---|---|---|
| КЛАСТЬ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties |
HTTP/1.1 |
Замените компоненты пути, отображаемые в URI запроса собственным, следующим образом:
| Компонент path | Описание |
|---|---|
myaccount |
Имя учетной записи хранения. |
myshare |
Имя общей папки. |
mydirectorypath |
Необязательный. Путь к родительскому каталогу. |
myfile |
Имя файла. |
Сведения об ограничениях именования путей см. в разделе Имя и справочные ресурсы, каталоги, файлы и метаданные.
Параметры URI
В URI запроса можно указать следующие дополнительные параметры:
| Параметр | Описание |
|---|---|
timeout |
Необязательный. Параметр timeout выражается в секундах. Дополнительные сведения см. в разделе Настройка времени ожидания операций службы файлов. |
Заголовки запросов
Обязательные и необязательные заголовки запросов описаны в следующих таблицах:
Общие заголовки запросов
| Заголовок запроса | Описание |
|---|---|
Authorization |
Обязательно. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure. |
Date или x-ms-date |
Обязательно. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure. |
x-ms-version |
Требуется для всех авторизованных запросов. Указывает версию операции, используемой для этого запроса. Эта операция поддерживается в версии 2025-05-05 и более поздних версий для общих папок с включенным протоколом NFS. Дополнительные сведения см. в разделе Управление версиями служб хранилища Azure. |
x-ms-cache-control |
Необязательный. Изменяет строку управления кэшем для файла. Если это свойство не указано в запросе, свойство очищается для файла. Последующие вызовы Get File Properties не возвращают это свойство, если только он не установлен явным образом в файле. |
x-ms-content-type |
Необязательный. Задает тип контента файла. Если это свойство не указано в запросе, свойство очищается для файла. Последующие вызовы Get File Properties не возвращают это свойство, если только он не установлен явным образом в файле. |
x-ms-content-md5 |
Необязательный. Задает хэш MD5 файла. Если это свойство не указано в запросе, свойство очищается для файла. Последующие вызовы Get File Properties не возвращают это свойство, если только он не установлен явным образом в файле. |
x-ms-content-encoding |
Необязательный. Задает кодировку содержимого файла. Если это свойство не указано в запросе, свойство очищается для файла. Последующие вызовы Get File Properties не возвращают это свойство, если только он не установлен явным образом в файле. |
x-ms-content-language |
Необязательный. Задает язык содержимого файла. Если это свойство не указано в запросе, свойство очищается для файла. Последующие вызовы Get File Properties не возвращают это свойство, если только он не установлен явным образом в файле. |
x-ms-content-disposition |
Необязательный. Задает заголовок Content-Disposition файла.Если это свойство не указано в запросе, свойство очищается для файла. Последующие вызовы Get File Properties не возвращают это свойство, если только он не установлен явным образом в файле. |
x-ms-content-length: bytes |
Необязательный. Изменяет размер файла до указанного размера. Если указанное значение байта меньше текущего размера файла, все диапазоны выше указанного значения байта очищаются. |
x-ms-file-creation-time: { preserve ¦ <DateTime> } |
Требуется версия 2019-02-02–2021-04-10. Необязательно, версия 2021-06-08 и более поздняя. Свойство времени создания в формате UTC для файла. Значение preserve можно передать для сохранения существующего значения без изменений. Значение по умолчанию — preserve. |
x-ms-file-last-write-time: { preserve ¦ <DateTime> } |
Требуется версия 2019-02-02–2021-04-10. Необязательно, версия 2021-06-08 и более поздняя. Последнее свойство записи в формате UTC для файла. Значение preserve можно передать для сохранения существующего значения без изменений. Если preserve указан и размер файла изменен, время последней записи обновляется до текущего времени. Если размер файла изменен, но указан явный метка времени, используется явная метка времени. Значение по умолчанию — preserve. |
x-ms-lease-id:<ID> |
Требуется, если файл имеет активную аренду. Доступно для версии 2019-02-02 и более поздних версий. Этот заголовок игнорируется, если файл находится в общей папке с включенным протоколом NFS, который не поддерживает аренду файлов. |
x-ms-client-request-id |
Необязательный. Предоставляет созданное клиентом непрозрачное значение с ограничением символов 1-kibibyte (KiB), записанным в журналах при настройке ведения журнала. Настоятельно рекомендуется использовать этот заголовок для сопоставления действий на стороне клиента с запросами, получаемыми сервером. Дополнительные сведения см. в статье Monitor Azure Files. |
x-ms-file-request-intent |
Требуется, если заголовок Authorization указывает токен OAuth. Допустимое значение равно backup. Этот заголовок указывает, что Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action или Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action следует предоставить, если они включены в политику RBAC, назначенную удостоверению, авторизованному с помощью заголовка Authorization. Доступно для версии 2022-11-02 и более поздних версий. |
x-ms-allow-trailing-dot: { <Boolean> } |
Необязательный. Версия 2022-11-02 и более поздних версий. Логическое значение указывает, следует ли обрезать конечную точку в URL-адресе запроса. Этот заголовок игнорируется, если целевой объект находится в общей папке с включенным протоколом NFS, который поддерживает конечную точку по умолчанию. Дополнительные сведения см. в разделе Именование и ссылки на общие папки, каталоги, файлы и метаданные. |
Только заголовки запросов SMB
| Заголовок запроса | Описание |
|---|---|
x-ms-file-change-time: { now ¦ <DateTime> } |
Необязательный. Версия 2021-06-08 и более поздних версий. Свойство времени изменения координированного универсального времени (UTC) для файла, отформатированное в формате ISO 8601. Значение now можно использовать для указания времени запроса. Значение по умолчанию — now. |
x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> } |
В версиях 2019-02-02–2021-04-10 этот заголовок требуется, если x-ms-file-permission-key не указан. По состоянию на версию 2021-06-08 оба заголовка являются необязательными. Это разрешение является дескриптором безопасности для файла, указанного в языке определения дескриптора безопасности (SDDL) или (версия 2024-11-04 или более поздней) в формате дескриптора безопасности в кодировке Base64 двоичном формате дескриптора безопасности. Можно указать формат, используемый с заголовком x-ms-file-permission-format. Этот заголовок можно использовать, если размер разрешений составляет 8 кибибайт (KiB) или меньше. В противном случае можно использовать x-ms-file-permission-key. Если он указан, он должен иметь владельца, группу и список управления доступом (DACL). Значение preserve можно передать для сохранения существующего значения без изменений.примечание. Можно указать x-ms-file-permission или x-ms-file-permission-key. Если ни заголовок не указан, используется значение по умолчанию preserve. |
x-ms-file-permission-format: { sddl ¦ binary } |
Необязательный. Версия 2024-11-04 или более поздняя. Указывает, является ли значение, переданное в x-ms-file-permission, в SDDL или в двоичном формате. Если x-ms-file-permission задано значение preserve, этот заголовок не должен быть задан. Если x-ms-file-permission задано любое другое значение, отличное от preserve, и если этот заголовок не задан, используется значение по умолчанию sddl. |
x-ms-file-permission-key: <PermissionKey> |
В версиях 2019-02-02–2021-04-10 этот заголовок требуется, если x-ms-file-permission не указан. По состоянию на версию 2021-06-08 оба заголовка являются необязательными. Ключ разрешения, заданного для файла. Это можно создать с помощью API Create-Permission.примечание. Можно указать x-ms-file-permission или x-ms-file-permission-key. Если ни заголовок не указан, значение по умолчанию preserve используется для заголовка x-ms-file-permission. |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
Требуется версия 2019-02-02–2021-04-10. Необязательно, версия 2021-06-08 и более поздняя. Атрибуты файловой системы, заданные в файле. См. список доступных атрибутов . Значение preserve можно передать для сохранения существующего значения без изменений. Значение по умолчанию — preserve. |
Только заголовки запросов NFS
Текст запроса
Никакой.
Ответ
Ответ включает код состояния HTTP и набор заголовков ответа.
Код состояния
Успешная операция возвращает код состояния 200 (ОК). Сведения о кодах состояния см. в коды состояния и коды ошибок. Сведения о кодах состояния см. в коды состояния и коды ошибок.
Заголовки ответа
Ответ для этой операции содержит заголовки в следующих таблицах. Ответ также может включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.
Общие заголовки ответов
| Заголовок ответа | Описание |
|---|---|
ETag |
Содержит значение, представляющее версию файла. Значение заключено в кавычки. |
Last-Modified |
Возвращает дату и время последнего изменения файла. Формат даты следует RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Любая операция, которая изменяет каталог или его свойства, обновляет время последнего изменения. Операции с файлами не влияют на время последнего изменения каталога. |
x-ms-request-id |
Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API. |
x-ms-version |
Указывает версию службы файлов, используемую для выполнения запроса. |
Date или x-ms-date |
Значение даты и времени в формате UTC, созданное службой, указывающее время, когда был инициирован ответ. |
x-ms-request-server-encrypted: true/false |
Версия 2017-04-17 и более поздних версий. Для этого заголовка задано значение true, если содержимое запроса успешно зашифровано с помощью указанного алгоритма. В противном случае значение равно false. |
x-ms-file-creation-time |
Версия 2019-02-02 и более поздних версий. Значение даты и времени в формате UTC, представляющее свойство времени создания файла. |
x-ms-file-last-write-time |
Версия 2019-02-02 и более поздних версий. Значение даты и времени в формате UTC, представляющее свойство времени последней записи для файла. |
x-ms-file-change-time |
Версия 2019-02-02 и более поздних версий. Значение даты и времени в формате UTC, представляющее свойство времени изменения для файла. |
x-ms-client-request-id |
Можно использовать для устранения неполадок запросов и соответствующих ответов. Значение этого заголовка равно значению заголовка x-ms-client-request-id, если оно присутствует в запросе, а значение содержит не более 1024 видимых символов ASCII. Если в запросе отсутствует заголовок x-ms-client-request-id, он не будет присутствовать в ответе. |
Заголовки ответов SMB только
| Заголовок ответа | Описание |
|---|---|
x-ms-file-permission-key |
Версия 2019-02-02 и более поздних версий. Ключ разрешения файла. |
x-ms-file-attributes |
Версия 2019-02-02 и более поздних версий. Атрибуты файловой системы файла. Дополнительные сведения см. в списке доступных атрибутов. |
Заголовки ответов NFS только
Текст ответа
Никакой.
Авторизация
Только владелец учетной записи может вызвать эту операцию.
Атрибуты файловой системы
| Атрибут | Атрибут файла Win32 | Определение |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | Файл, доступный только для чтения. Приложения могут считывать файл, но не могут записывать в него или удалять его. |
| Скрытый | FILE_ATTRIBUTE_HIDDEN | Файл скрыт. Он не включен в обычный список каталогов. |
| Система | FILE_ATTRIBUTE_SYSTEM | Файл, который операционная система использует часть или использует исключительно. |
| Никакой | FILE_ATTRIBUTE_NORMAL | Файл, который не имеет других атрибутов. Этот атрибут действителен только в том случае, если он используется отдельно. |
| Архив | FILE_ATTRIBUTE_ARCHIVE | Файл, который является архивным файлом. Приложения обычно используют этот атрибут для пометки файлов для резервного копирования или удаления. |
| Временный | FILE_ATTRIBUTE_TEMPORARY | Файл, используемый для временного хранилища. |
| Автономный | FILE_ATTRIBUTE_OFFLINE | Данные файла недоступны немедленно. Этот атрибут файловой системы представлен в основном для обеспечения совместимости с Windows. Файлы Azure не поддерживают параметры автономного хранилища. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Файл не индексируется службой индексирования содержимого. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Поток данных пользователя не считывается с помощью средства проверки целостности фоновых данных. Этот атрибут файловой системы представлен в основном для обеспечения совместимости с Windows. |
Разрешения ФАЙЛА POSIX (режим)
Разрешения POSIX-файла можно указать в 12-разрядном числовом формате или в символьном формате rwx. Примеры:
- "0644" или "rw-r-r--": пользователь (владелец файла) имеет разрешение на чтение, запись. Группа имеет разрешение на чтение. Другие имеют разрешение на чтение.
- "0755" или "rwxr-xr-x": пользователь (владелец файла) имеет разрешение на чтение, запись и выполнение. Группа имеет разрешение на чтение и выполнение. Другие имеют разрешение на чтение и выполнение.
Числовый восьмеричный формат
Три наименьших октальных числа представляют разрешения для владельца или пользователя, группы и других пользователей и указываются с помощью восьмеричного числа (0-7), сформированного с помощью побитового сочетания "4" (чтение), "2" (запись), "1" (выполнение). Наибольшее число порядка (0–7) используется для указания сочетания разрешений "4" (SetUID), "2" (SetGID), "1" (StickyBit).
| Формат | Разрешение |
|---|---|
| 0700 | Пользователь (владелец файла) имеет разрешение на чтение, запись и выполнение. |
| 0400 | У пользователя есть разрешение на чтение. |
| 0200 | У пользователя есть разрешение на запись. |
| 0100 | У пользователя есть разрешение на выполнение. |
| 0070 | Группа имеет разрешение на чтение, запись и выполнение. |
| 0040 | Группа имеет разрешение на чтение. |
| 0020 | Группа имеет разрешение на запись. |
| 0010 | Группа имеет разрешение на выполнение. |
| 0007 | Другие пользователи имеют разрешение на чтение, запись и выполнение. |
| 0004 | Другие имеют разрешение на чтение. |
| 0002 | Другие имеют разрешение на запись. |
| 0001 | Другие имеют разрешение на выполнение. |
| 4000 | Задайте эффективный идентификатор пользователя в файле. |
| 2000 | Задайте действующий идентификатор группы в файле. |
| 1000 | Задайте для указания, что файл можно удалить или переименовать только владельцем файла, владельцем каталога или корневым пользователем. |
Символьный формат rwx
Разрешения для владельца или пользователя, группы и других пользователей указываются с помощью сочетания символов "r" (чтение), "w" (запись) и "x" (выполнение).
| Формат | Разрешение |
|---|---|
| rwx------ | Пользователь (владелец файла) имеет разрешение на чтение, запись и выполнение. |
| r-------- | У пользователя есть разрешение на чтение. |
| -w------- | У пользователя есть разрешение на запись. |
| --x------ | У пользователя есть разрешение на выполнение. |
| ---rwx--- | Группа имеет разрешение на чтение, запись и выполнение. |
| ---r----- | Группа имеет разрешение на чтение. |
| ----w---- | Группа имеет разрешение на запись. |
| -----x--- | Группа имеет разрешение на выполнение. |
| ------rwx | Другие пользователи имеют разрешение на чтение, запись и выполнение. |
| ------r-- | Другие имеют разрешение на чтение. |
| -------w- | Другие имеют разрешение на запись. |
| --------x | Другие имеют разрешение на выполнение. |
Замечания
Семантика обновления свойств файла выглядит следующим образом:
Размер файла изменяется только в том случае, если запрос задает значение заголовка
x-ms-content-length.Если запрос задает только
x-ms-content-lengthи никакие другие свойства:- Если файл находится в общей папке с включенным протоколом SMB, то никакие другие свойства файла не изменяются.
- Если файл находится в общей папке с включенным протоколом NFS, время изменения файла и время последней записи изменяются.
Если в запросе задано одно или несколько следующих свойств, все эти свойства устанавливаются вместе. Если значение не указано для указанного свойства, если задано по крайней мере одно из следующих свойств, это свойство очищается для файла.
x-ms-cache-controlx-ms-content-typex-ms-content-md5x-ms-content-encodingx-ms-content-language
Заметка
Предыдущие свойства файла отличаются от свойств файловой системы, доступных клиентам SMB. Клиенты SMB не могут считывать, записывать или изменять эти значения свойств.
Set File properties не поддерживается в моментальном снимке общего ресурса, который является копией общего ресурса только для чтения. Попытка выполнить эту операцию на моментальном снимке общего ресурса завершается ошибкой 400 (InvalidQueryParameterValue).
Если файл имеет активную аренду, клиент должен указать действительный идентификатор аренды для запроса на запись свойств в файл. Если клиент не указывает идентификатор аренды или указывает недопустимый идентификатор аренды, служба файлов возвращает код состояния 412 (сбой предварительных условий). Если клиент задает идентификатор аренды, но файл не имеет активной аренды, служба файлов также возвращает код состояния 412 (сбой предварительных условий).