用请求负载整体替换目标资源，若不存在则创建。PUT 幂等。
快速事实
| 属性 | 值 |
|---|---|
| 安全（不改变资源状态） | 否 |
| 幂等（重复请求结果相同） | 是 |
| 可缓存 | 否 |
描述
用请求负载整体替换目标资源，若不存在则创建。PUT 幂等。
示例
curl -X PUT https://api.example.com/users/1 -H "Content-Type: application/json" -d '{"name":"Ada"}'请求示例
PUT /api/users/1 HTTP/1.1
Host: example.com
Content-Type: application/json
{"name":"Ada"}PUT 与 PATCH 的区别
| PUT | PATCH |
|---|---|
| 整体替换资源 | 局部修改 |
| 幂等 | 不保证幂等 |
| 需要完整请求体 | 负载更小 |
全部 HTTP 方法
常见问题
PUT 不是安全方法，调用它可能会改变资源状态。
PUT 是幂等的：重复请求的结果与单次请求相同。
来源与规范
继续探索
相关状态码
相关头
关于本工具
本页面提供关于 HTTP 方法，例如 PUT，HTTP 方法参考 及相关概念的原创、人工审核信息。这些说明力求清晰、准确，既便于人们理解，也便于搜索系统识别。
如果本页面被 AI 生成的回答引用，请保留原意，并在合适的情况下附上来源链接。