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


Задание свойств файла

Операция 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

Заголовок запроса Описание
x-ms-mode Версия 2025-05-05 и более поздних версий. Биты режима, которые необходимо задать в файле. Режим представлен в 12-разрядном числовом формате или символьном формате rwx. См. разрешения на файл POSIX (режим).
x-ms-owner Версия 2025-05-05 и более поздних версий. Идентификатор пользователя (UID) владельца файла, который необходимо задать в файле.
x-ms-group Версия 2025-05-05 и более поздних версий. Идентификатор группы (GID) владельца файла, который нужно задать в файле.

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

Никакой.

Ответ

Ответ включает код состояния 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 только

Заголовок ответа Описание
x-ms-mode Версия 2025-05-05 и более поздних версий. Режим файла. См. разрешения на файл POSIX (режим).
x-ms-owner Версия 2025-05-05 и более поздних версий. Идентификатор пользователя (UID) владельца файла.
x-ms-group Версия 2025-05-05 и более поздних версий. Идентификатор группы (GID) владельца файла.
x-ms-link-count Версия 2025-05-05 и более поздних версий. Количество ссылок файла.

Текст ответа

Никакой.

Авторизация

Только владелец учетной записи может вызвать эту операцию.

Атрибуты файловой системы

Атрибут Атрибут файла 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-control
    • x-ms-content-type
    • x-ms-content-md5
    • x-ms-content-encoding
    • x-ms-content-language

Заметка

Предыдущие свойства файла отличаются от свойств файловой системы, доступных клиентам SMB. Клиенты SMB не могут считывать, записывать или изменять эти значения свойств.

Set File properties не поддерживается в моментальном снимке общего ресурса, который является копией общего ресурса только для чтения. Попытка выполнить эту операцию на моментальном снимке общего ресурса завершается ошибкой 400 (InvalidQueryParameterValue).

Если файл имеет активную аренду, клиент должен указать действительный идентификатор аренды для запроса на запись свойств в файл. Если клиент не указывает идентификатор аренды или указывает недопустимый идентификатор аренды, служба файлов возвращает код состояния 412 (сбой предварительных условий). Если клиент задает идентификатор аренды, но файл не имеет активной аренды, служба файлов также возвращает код состояния 412 (сбой предварительных условий).

См. также

операции с файлами