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


Получение свойств каталога

Операция Get Directory Properties возвращает все системные свойства указанного каталога, а также можно использовать для проверки существования каталога. Возвращаемые данные не включают файлы в каталог или в подкаталогах. Эта операция поддерживается в версии 2025-05-05 и более поздних версий для общих папок с включенным протоколом NFS.

Доступность протокола

Протокол общей папки с включенным доступом Доступный
SMB Да
NFS Да

Просьба

Запрос Get Directory Properties создается следующим образом. Рекомендуется использовать ПРОТОКОЛ HTTPS.

Метод URI запроса ВЕРСИЯ HTTP
GET/HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
GET/HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> HTTP/1.1

Замените компоненты пути, отображаемые в URI запроса собственным, следующим образом:

Компонент path Описание
myaccount Имя учетной записи хранения.
myshare Имя общей папки.
myparentdirectorypath Необязательный. Путь к родительскому каталогу.
mydirectory Имя каталога.

Сведения об ограничениях именования путей см. в разделе Имя и справочные ресурсы, каталоги, файлы и метаданные.

Параметры URI

В URI запроса можно указать следующие дополнительные параметры:

Параметр Описание
sharesnapshot Необязательный. Версия 2017-04-17 и более поздних версий. Параметр sharesnapshot — это непрозрачное значение DateTime, указывающее моментальный снимок общего ресурса для запроса свойств каталога.
timeout Необязательный. Параметр timeout выражается в секундах. Дополнительные сведения см. в статье Настройка времени ожидания операций службы "Файлы Azure".

Заголовки запросов

Обязательные и необязательные заголовки запросов описаны в следующих таблицах:

Общие заголовки запросов

Заголовок запроса Описание
Authorization Обязательно. Указывает схему авторизации, имя учетной записи и подпись. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
Date или x-ms-date Обязательно. Указывает универсальное время (UTC) для запроса. Дополнительные сведения см. в статье Авторизация запросов к службе хранилища Azure.
x-ms-version Требуется для всех авторизованных запросов. Указывает версию операции, используемой для этого запроса. Эта операция поддерживается в версии 2025-05-05 и более поздних версий для общих папок с включенным протоколом NFS.

Дополнительные сведения см. в разделе Управление версиями служб хранилища Azure.
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

Никакой.

Только заголовки запросов NFS

Никакой.

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

Никакой.

Пример запроса

HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Код состояния

Успешная операция возвращает код состояния 200 (ОК). Сведения о кодах состояния см. в коды состояния и коды ошибок.

Заголовки ответа

Ответ для этой операции содержит заголовки в следующих таблицах. Ответ также может включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Общие заголовки ответов

Заголовок ответа Описание
ETag ETag содержит значение, которое можно использовать для условного выполнения операций. Значение заключено в кавычки.
Last-Modified Возвращает дату и время последнего изменения каталога. Формат даты следует RFC 1123. Дополнительные сведения см. в разделе Представление значений даты и времени в заголовках. Операции с файлами в каталоге не влияют на время последнего изменения каталога.
x-ms-meta-name:value Набор пар "имя-значение", содержащих метаданные каталога.
x-ms-request-id Возвращает уникальный идентификатор запроса, который поможет устранить неполадки запроса. Дополнительные сведения см. в статье Устранение неполадок с операциями API.
x-ms-version Указывает версию службы, которая использовалась для выполнения запроса.
Date Значение даты и времени в формате UTC, созданное службой, указывающее время, когда был инициирован ответ.
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-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-file-file-type Версия 2025-05-05 и более поздних версий. Тип файла, возможные значения: Directory.

Текст ответа

Никакой.

Пример ответа

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  

Авторизация

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

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

Атрибут Атрибут файла 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 Другие имеют разрешение на выполнение.

Замечания

Если указанный путь к каталогу не существует, запрос завершается ошибкой с кодом состояния 404 (не найден).

См. также

операции с каталогами