Метод HTTP PUT создает новый ресурс или заменяет представление целевого ресурса содержимым запроса content.

Разница между PUT и POST заключается в том, что PUT является идемпотентным: один вызов ничем не отличается от нескольких последовательных вызовов (побочных эффектов нет).

Синтаксис

PUT <request-target>["?"<query>] HTTP/1.1

<request-target>

Определяет целевой ресурс запроса в сочетании с информацией из заголовка Host. В запросах к исходному серверу это абсолютный путь (например, /path/to/file.html), а в запросах к прокси — абсолютный URL (например, http://www.example.com/path/to/file.html).

<query> Необязательно

Необязательный компонент запроса, перед которым ставится вопросительный знак ?. Часто используется для передачи идентифицирующей информации в виде пар key=value.

Примеры

Успешное создание ресурса

Следующий запрос PUT предназначен для создания ресурса по адресу example.com/new.html с содержимым <p>New File</p>:

PUT /new.html HTTP/1.1
Host: example.com
Content-type: text/html
Content-length: 16

<p>New File</p>

Если целевой ресурс не имеет текущего представления и запрос PUT успешно создает его, исходный сервер должен отправить ответ 201 Created:

HTTP/1.1 201 Created
Content-Location: /new.html

Если целевой ресурс имеет текущее представление и это представление успешно изменено в соответствии с состоянием, указанным в запросе, исходный сервер должен отправить ответ 200 OK или 204 No Content, чтобы сообщить об успешном выполнении запроса:

HTTP/1.1 204 No Content
Content-Location: /existing.html

Спецификации

Совместимость с браузерами

Браузер не использует метод PUT для действий, инициированных пользователем, поэтому понятие «совместимость с браузерами» здесь неприменимо. Разработчики могут задать этот метод запроса с помощью fetch().

См. также

• Методы HTTP-запросов
• Коды состояния HTTP-ответов
• Заголовки HTTP
• Статусы ответа 201 Created и 204 No Content