PUT request method

Cú pháp

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

<request-target>

Xác định tài nguyên đích của yêu cầu khi kết hợp với thông tin được cung cấp trong tiêu đề Host. Đây là đường dẫn tuyệt đối (ví dụ: /path/to/file.html) trong các yêu cầu đến máy chủ gốc, và là URL tuyệt đối trong các yêu cầu đến proxy (ví dụ: http://www.example.com/path/to/file.html).

<query> Optional

Thành phần truy vấn tùy chọn được đặt trước dấu hỏi ?. Thường được dùng để mang thông tin nhận dạng dưới dạng các cặp key=value.

Ví dụ

Tạo tài nguyên thành công

Yêu cầu PUT sau đây yêu cầu tạo một tài nguyên tại example.com/new.html với nội dung <p>New File</p>:

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

<p>New File</p>

Nếu tài nguyên đích chưa có biểu diễn hiện tại và yêu cầu PUT tạo thành công một biểu diễn, thì máy chủ gốc phải gửi phản hồi 201 Created:

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

Nếu tài nguyên đích đã có biểu diễn hiện tại và biểu diễn đó được sửa đổi thành công theo trạng thái trong yêu cầu, máy chủ gốc phải gửi 200 OK hoặc 204 No Content để cho biết hoàn thành yêu cầu thành công:

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

Đặc tả

Khả năng tương thích với trình duyệt

Trình duyệt không sử dụng phương thức PUT cho các hành động do người dùng khởi tạo, vì vậy "khả năng tương thích với trình duyệt" không áp dụng ở đây. Nhà phát triển có thể thiết lập phương thức yêu cầu này bằng fetch().

Xem thêm

• Các phương thức yêu cầu HTTP
• Mã trạng thái phản hồi HTTP
• Tiêu đề HTTP
• Mã trạng thái phản hồi 201 Created, 204 No Content