PUT

HTTP 的 PUT 请求方法用于创建一个新的资源,或者用请求的 内容替换目标资源的表示。

PUTPOST 之间的区别在于 PUT 是幂等的:调用一次或多次连续调用具有相同的效果(即没有副作用),而连续的相同 POST 请求可能会产生额外的影响,类似于多次下订单。

请求是否有主体
成功的响应是否有主体 可能
安全
幂等
可缓存
HTML 表单 中允许使用

语法

http
PUT /new.html HTTP/1.1

示例

请求

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

<p>New File</p>

响应

如果目标资源没有当前表示,并且 PUT 请求成功创建了一个表示,则源服务器必须通过发送 201已创建)响应来通知用户代理。

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

如果目标资源确实有当前表示,并且该表示根据所包含表示的状态成功修改,则源服务器必须发送 200OK)或 204无内容)响应,以指示请求已成功完成。

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

规范

规范
HTTP 语义
# PUT

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅