Создание каталога

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

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

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

Просьба

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

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

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

Параметры URI

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

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

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

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

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

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

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

Никакой.

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

PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1  
  
Request headers:  
x-ms-version: 2014-02-14  
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT  
x-ms-meta-Category: Images  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

Ответ

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

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

Успешная операция возвращает код состояния 201 (создан). Дополнительные сведения о кодах состояния см. в коды состояния и коды ошибок.

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

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

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

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

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

Текст ответа

Никакой.

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

Response status:  
HTTP/1.1 201 Created  
  
Response headers:  
Transfer-Encoding: chunked  
Date: Mon, 27 Jan 2014 23:00:12 GMT  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT  
x-ms-version: 2014-02-14  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  

Авторизация

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

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

Разрешения ФАЙЛА 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).

Символьный формат rwx

Разрешения для владельца или пользователя, группы и других пользователей указываются с помощью сочетания символов "r" (чтение), "w" (запись) и "x" (выполнение).

Замечания

Если каталог с тем же именем удаляется при вызове Create Directory, сервер возвращает код состояния 409 (конфликт) и предоставляет дополнительные сведения об ошибке, указывающие на то, что каталог удаляется.

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

Невозможно создать иерархию каталогов с одной операцией Create Directory. Каталог можно создать только в том случае, если его непосредственный родительский объект уже существует, как указано в пути. Если родительский каталог не существует, операция завершается ошибкой с кодом состояния 412 (сбой предварительных условий).

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

См. также

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