Получение свойств файла
Операция Get File Properties возвращает все пользовательские метаданные, стандартные свойства HTTP и системные свойства файла. Он не возвращает содержимое файла. Эта операция поддерживается в версии 2025-05-05 и более поздних версий для общих папок с включенным протоколом NFS.
Доступность протокола
| Протокол общей папки с включенным доступом | Доступный |
|---|---|
| SMB |
|
| NFS |
|
Просьба
Запрос Get File Properties создается следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS.
| Метод | URI запроса | ВЕРСИЯ HTTP |
|---|---|---|
HEAD |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
HEAD |
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime> |
HTTP/1.1 |
Замените компоненты пути, отображаемые в URI запроса собственным, следующим образом:
| Компонент path | Описание |
|---|---|
myaccount |
Имя учетной записи хранения. |
myshare |
Имя общей папки. |
mydirectorypath |
Необязательный. Путь к родительскому каталогу. |
myfile |
Имя файла. |
Сведения об ограничениях именования путей см. в разделе Имя и справочные ресурсы, каталоги, файлы и метаданные.
Параметры URI
В URI запроса можно указать следующие дополнительные параметры:
| Параметр | Описание |
|---|---|
sharesnapshot |
Необязательный. Версия 2017-04-17 и более поздних версий. Параметр sharesnapshot — это непрозрачное значение DateTime, указывающее моментальный снимок общего ресурса для запроса свойств файла. |
timeout |
Необязательный. Параметр timeout выражается в секундах. Дополнительные сведения см. в статье Настройка времени ожидания операций службы "Файлы Azure". |
Заголовки запросов
Обязательные и необязательные заголовки запросов описаны в следующих таблицах:
Общие заголовки запросов
| Заголовок запроса | Описание |
|---|---|
| Авторизация | Обязательно. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure. |
Date или x-ms-date |
Обязательно. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure. |
x-ms-version |
Требуется для всех авторизованных запросов. Указывает версию операции, используемой для этого запроса. Эта операция поддерживается в версии 2025-05-05 и более поздних версий для общих папок с включенным протоколом NFS. Дополнительные сведения см. в разделе Управление версиями служб хранилища Azure. |
x-ms-lease-id:<ID> |
Необязательный. Версия 2019-02-02 и более поздних версий. Если заголовок указан, операция выполняется только в том случае, если аренда файла в настоящее время активна, а идентификатор аренды, указанный в запросе, соответствует идентификатору аренды файла. Если это не соответствует, операция завершается ошибкой с кодом состояния 412 (сбой предварительных условий). Этот заголовок игнорируется, если файл находится в общей папке с включенным протоколом NFS, который не поддерживает аренду файлов. |
x-ms-client-request-id |
Необязательный. Предоставляет созданное клиентом непрозрачное значение с ограничением символов 1-kibibyte (KiB), которое записывается в журналы аналитики при включении ведения журнала аналитики службы хранилища Azure. Настоятельно рекомендуется использовать этот заголовок при сопоставлении действий на стороне клиента с запросами, полученными сервером. Дополнительные сведения см. в статье Monitorхранилища BLOB-объектов Azure. |
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
Никакой.
Только заголовки запросов NFS
Никакой.
Текст запроса
Никакой.
Ответ
Ответ включает код состояния HTTP и набор заголовков ответа.
Код состояния
Успешная операция возвращает код состояния 200 (ОК). Сведения о кодах состояния см. в коды состояния и коды ошибок.
Заголовки ответа
Ответ для этой операции содержит заголовки в следующих таблицах. Ответ также может включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.
Общие заголовки ответов
| Заголовок ответа | Описание |
|---|---|
Last-Modified |
Возвращает дату и время последнего изменения файла. Формат даты следует RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Любая операция, которая изменяет файл или его свойства, обновляет время последнего изменения. |
x-ms-meta-name:value |
Набор пар "имя-значение", связанных с этим файлом в качестве пользовательских метаданных. |
x-ms-type: <File> |
Возвращает тип File. Зарезервировано для дальнейшего использования. |
Content-Length |
Размер файла в байтах. Этот заголовок возвращает значение заголовка x-ms-content-length, хранящегося в файле. |
Content-Type |
Тип контента, указанный для файла. Если тип контента не указан, тип контента по умолчанию application/octet-stream. |
ETag |
ETag содержит значение, которое можно использовать для условного выполнения операций. Значение заключено в кавычки. |
Content-MD5 |
Если для файла задан заголовок Content-MD5, возвращается заголовок ответа Content-MD5, чтобы клиент смог проверить целостность содержимого сообщения. |
Content-Encoding |
Если заголовок запроса Content-Encoding ранее был задан для файла, значение Content-Encoding возвращается в этом заголовке. |
Content-Language |
Если заголовок запроса Content-Language ранее был задан для файла, значение Content-Language возвращается в этом заголовке. |
Cache-Control |
Если заголовок запроса Cache-Control ранее был задан для файла, значение Cache-Control возвращается в этом заголовке. |
Content-Disposition |
Возвращает значение, указанное для заголовка x-ms-content-disposition, и указывает способ обработки ответа.Поле заголовка ответа Content-Disposition передает дополнительные сведения о том, как обрабатывать полезные данные ответа, и его можно использовать для присоединения дополнительных метаданных. Например, если задано значение attachment, Content-Disposition указывает, что пользователь-агент не должен отображать ответ, но вместо него должно отображаться окно "Сохранить как". |
x-ms-request-id |
Уникально идентифицирует выполненный запрос и может использоваться для устранения неполадок запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API. |
x-ms-version |
Указывает версию службы, которая использовалась для выполнения запроса. |
Date |
Значение даты и времени в формате UTC, созданное службой, указывающее время, когда был инициирован ответ. |
x-ms-copy-completion-time:<datetime> |
Версия 2015-02-21 и более поздних версий. Время завершения последней попытки операции копирования файла, где этот файл был целевым файлом. Это значение может указать время завершения, прерывания или неудачной попытки копирования. Этот заголовок не отображается, если копия ожидается, если этот файл никогда не был назначением в операции копирования файла или если этот файл был изменен после завершения операции копирования файла с помощью задать свойства файла или создать файл. |
x-ms-copy-status-description: <error string> |
Версия 2015-02-21 и более поздних версий. Отображается только в том случае, если x-ms-copy-statusне удалось или ожидающих. В ней описывается причина неустранимая или неустранимая ошибка операции копирования. Этот заголовок не отображается, если копия ожидается, если этот файл никогда не был назначением в операции копирования файла или если этот файл был изменен после завершения операции копирования файла с помощью задать свойства файла или создать файл. |
x-ms-copy-id: <id> |
Версия 2015-02-21 и более поздних версий. Строковый идентификатор последней попытки операции копирования файла, где этот файл был целевым файлом. Этот заголовок не отображается, если этот файл никогда не был назначением в операции копирования файла или если этот файл был изменен после завершения операции копирования файла с помощью задания свойств файла или создания файла. |
x-ms-copy-progress: <bytes copied/bytes total> |
Версия 2015-02-21 и более поздних версий. Содержит количество скопированных байтов и общее число байтов в источнике в последней попытке операции копирования файла, где этот файл был целевым файлом. Может отображаться от 0 до количества скопированных Content-Length байтов. Этот заголовок не отображается, если этот файл никогда не был назначением в операции копирования файла или если этот файл был изменен после завершения операции копирования файла с помощью задания свойств файла или создания файла. |
x-ms-copy-source: url |
Версия 2015-02-21 и более поздних версий. URL-адрес до 2 КБ символов, указывающий исходный файл, который использовался в последней попытке операции копирования файла, где этот файл был целевым файлом. Этот заголовок не отображается, если этот файл никогда не был назначением в операции копирования файла или если этот файл был изменен после завершения операции копирования файла с помощью задания свойств файла или создания файла. |
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> |
Версия 2015-02-21 и более поздних версий. Состояние операции копирования, определяемой x-ms-copy-id, со следующими значениями:- успешно выполнено копирования. - ожидание: выполняется копирование. Проверьте x-ms-copy-status-description, если периодические ошибки, неустранимые ошибки препятствуют выполнению копирования, но не вызывают сбоя.- прервано: копирование было завершено файла прерывания. - произошел сбой: сбой копирования. Дополнительные сведения о сбое см. в x-ms-copy-status-description.Этот заголовок не отображается, если этот файл никогда не был назначением в операции копирования файла или если этот файл был изменен после завершения операции копирования файла с помощью задания свойств файла или создания файла. |
x-ms-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-file-file-id |
Версия 2019-02-02 и более поздних версий. Идентификатор файла. |
x-ms-file-parent-id |
Версия 2019-02-02 и более поздних версий. Идентификатор родительского файла файла. |
x-ms-lease-duration:infinite |
Версия 2019-02-02 и более поздних версий. При аренде файла указывает, что арендная плата имеет бесконечную длительность. |
x-ms-lease-state:<available;leased;broken> |
Версия 2019-02-02 и более поздних версий. При аренде файла указывает состояние аренды файла. |
x-ms-lease-status:<locked;unlocked> |
Версия 2019-02-02 и более поздних версий. При аренде файла указывает состояние аренды файла. |
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 только
Текст ответа
Никакой.
Пример ответа
Response Status:
HTTP/1.1 200 OK
Response Headers:
x-ms-type: File
x-ms-meta-m1: v1
x-ms-meta-m2: v2
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: <date>
x-ms-version: 2019-02-02
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6
x-ms-copy-source: <url>
x-ms-copy-status: success
x-ms-copy-progress: 11/11
x-ms-copy-completion-time: <date>
x-ms-lease-duration: infinite
x-ms-lease-state: leased
x-ms-lease-status: locked
Авторизация
Только владелец учетной записи может вызвать эту операцию.
Атрибуты файловой системы
| Атрибут | Атрибут файла 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 | Другие имеют разрешение на выполнение. |