Создание файла

Операция Create File создает новый файл или заменяет файл. Эта операция поддерживается в версии 2025-05-05 и более поздних версий для общих папок с включенным протоколом NFS. При вызове Create Fileфайл инициализируется только. Чтобы добавить содержимое в файл, вызовите операцию Put Range. Начиная с версии 2026-02-06, вы также можете создавать файл с содержанием до 4 МиБ с помощью Create File операции.

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

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

Просьба

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

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

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

Параметры URI

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

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

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

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

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

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

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

Ни одно из них Content-Length равно нолю. Требуется, если Content-Length заголовок установлен на ненулевый. Это поддерживается в версии 2026-02-06 и более позднее. Количество байт, указанных в теле запроса и заголовке Content-Length, должно совпадать для выполнения операции создания файла с данными. Максимальное количество байт, которые можно указать в теле запроса, составляет 4 МиБ.

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

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT  
Content-Type: text/plain; charset=UTF-8  
x-ms-content-length: 1024  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  

Примерный запрос с Content-Length заголовком

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1  
  
Request Headers:  
x-ms-version: 2026-02-06
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT  
Content-Type: text/plain; charset=UTF-8  
x-ms-content-length: 1024
Content-Length: 512
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  

Ответ

Ответ включает код состояния 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 File и указав максимальный размер до 4 ТиБ. При выполнении этой операции не включайте содержимое в текст запроса. После создания файла вызовите Put Range добавить содержимое в файл или изменить его.

Начиная с версии 2026-02-06 и выше, вы можете создать файл с данными до 4 МиБ, предоставив контент в теле запроса. После того как вы создали файл с данными, позвоните Put Range , чтобы добавить дополнительные данные или изменить его. Максимальный размер созданного файла — до 4 TiB.

Размер файла можно изменить, вызвав Set File Properties.

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

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

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

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

См. также

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