大网数据广告活动
Web 标准与前端开发

PUT

· 52CE 我爱测

**HTTP `PUT` 请求方法**创建一个新的资源或用请求的有效载荷替换目标资源的表示。

HTTP PUT 请求方法创建一个新的资源或用请求的有效载荷替换目标资源的表示。

PUT 与 POST 方法的区别是,PUT 方法是幂等的:调用一次与连续调用多次效果是相同的(即没有副作用),而连续调用多次相同的 POST 方法可能会有副作用,比如多次提交同一订单。

<table class="properties"> <tbody> <tr> <th scope="row">请求是否有主体</th> <td>是</td> </tr> <tr> <th scope="row">成功的响应是否有主体</th> <td>可能有</td> </tr> <tr> <th scope="row">Safe/HTTP</th> <td>否</td> </tr> <tr> <th scope="row">Idempotent</th> <td>是</td> </tr> <tr> <th scope="row">Cacheable</th> <td>否</td> </tr> <tr> <th scope="row"> 允许在 <a href="/zh-CN/docs/Learn_web_development/Extensions/Forms">HTML 表单</a>中使用 </th> <td>不允许</td> </tr> </tbody> </table>

语法

PUT /new.html HTTP/1.1

示例

请求

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

<p>新文件</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

规范

浏览器兼容性

参见

  • 201
  • 204

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。