PUT

HTTP PUT 메서드는 요청 페이로드를 사용해 새로운 리소스를 생성하거나, 대상 리소스를 나타내는 데이터를 대체합니다.

PUTPOST의 차이는 멱등성으로, PUT은 멱등성을 가집니다. PUT은 한 번을 보내도, 여러 번을 연속으로 보내도 같은 효과를 보입니다. 즉, 부수 효과가 없습니다.

요청에 본문 존재
성공 응답에 본문 존재 아니오
안전함 아니오
멱등성
캐시 가능 (en-US) 아니오
HTML 양식에서 사용 가능 아니오

구문

PUT /new.html HTTP/1.1

예제

요청

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

명세

명세 제목
RFC 7231, section 4.3.4: PUT Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

브라우저 호환성

BCD tables only load in the browser

같이 보기