PUTメソッド(プットメソッド)とは | 意味や読み方など丁寧でわかりやすい用語解説

PUTメソッドは、HTTP (Hypertext Transfer Protocol) が提供する標準的なメソッドの一つであり、Web上のリソースを操作するために用いられる。主な用途は、特定のURI（Uniform Resource Identifier）が示すリソースを新規に作成するか、あるいは既存のリソースを完全に更新することである。このメソッドの大きな特徴は「冪等性」を持つ点にあり、同じPUTリクエストを複数回送信しても、サーバー側のリソースの状態は初回のリクエスト後と変わらない状態になる。これにより、ネットワークの不確実な状況下でも安全にリソースを操作できる。

PUTメソッドがリソースを操作する際の基本的な挙動は、指定されたURIにリソースが存在するか否かで異なる。もし指定されたURIに該当するリソースが存在しない場合、PUTメソッドはリクエストボディに含まれるデータを用いてそのURIに新しいリソースを新規作成する。この際、リクエストのURI自体が新しく作成されるリソースの識別子となるため、クライアント側がリソースのURIを決定して指定する必要がある。一方、もし指定されたURIに既にリソースが存在する場合、PUTメソッドはリクエストボディに含まれるデータで既存のリソース全体を上書きし、完全に置き換える。これは、既存のリソースの一部を修正するのではなく、リソース全体を新たな内容で置き換えるという点が重要である。

この「リソースの完全な置き換え」という特性は、同じHTTPメソッドであるPOSTメソッドとの明確な違いの一つとなる。POSTメソッドもリソースの作成に用いられることがあるが、POSTの場合は一般的にサーバー側で新しいリソースのURIが生成されることが多く、また特定のURIの子リソースを作成したり、サーバー上で処理をトリガーしたりするなど、用途がより広範である。対してPUTメソッドは、クライアントがリソースのURIを指定し、そのURIで特定されるリソース全体を正確に管理・操作する目的で使われる。

PUTメソッドの最も重要な特性である「冪等性」は、システムの信頼性を高める上で非常に有用だ。冪等性とは、ある操作を複数回実行しても、その結果が1回実行した場合と同じになる性質を指す。例えば、あるファイルをPUTメソッドでサーバーにアップロードする際、ネットワークの瞬断などによりリクエストが複数回送信されてしまったとしても、サーバー上のファイルは最初に送信されたデータで上書きされるだけであり、重複して作成されたり、データが不正になったりすることはない。これは、POSTメソッドが必ずしも冪等性を保証しないことと対照的である。POSTリクエストを複数回送信すると、その度に新しいリソースが作成されたり、同じデータが複数回処理されたりする可能性があるため、冪等性はエラー処理や再試行の戦略をシンプルにする上で極めて重要となる。

PUTメソッドのリクエストは、一般的に以下のような要素で構成される。リクエストラインにはPUTメソッドとターゲットURIが指定され、HTTPヘッダにはコンテンツタイプ（例えばJSON形式であればContent-Type: application/json）や認証情報などが含まれる。そして、リクエストボディには、作成または更新するリソースの具体的なデータが格納される。サーバーはこれらの情報を受け取り、処理を実行する。

PUTメソッドに対するサーバーからのレスポンスは、処理結果に応じてHTTPステータスコードで示される。新しいリソースが正常に作成された場合は「201 Created」が返されることが一般的だ。これは、リクエストが成功し、その結果として新しいリソースが作成されたことを意味する。既存のリソースが正常に更新された場合は「200 OK」または「204 No Content」が返されることが多い。「200 OK」はリクエストが成功し、レスポンスボディに処理結果などの情報が含まれることを示すが、PUTメソッドでは更新後のリソースをわざわざ返す必要がない場合が多いため、レスポンスボディを持たない「204 No Content」が用いられることもある。クライアントはこれらのステータスコードを確認することで、PUTリクエストが意図通りに処理されたかを判断する。

PUTメソッドの利用例としては、RESTful API設計において、ユーザープロファイルの更新や、特定の商品情報の更新などが挙げられる。例えば、PUT /users/123 というリクエストに、IDが123のユーザーの最新のプロファイルデータを含めることで、そのユーザーの情報を完全に更新できる。もしURI /users/123 に対応するユーザーが存在しなければ、新しいユーザーが作成されることになる。

注意点として、PUTメソッドはリソース全体を置き換えるため、リソースの一部だけを更新したい場合には不向きである。例えば、ユーザーのメールアドレスだけを更新したい場合に、PUTメソッドを使うと、メールアドレス以外のユーザープロファイルデータもすべて含めてリクエストボディに送信する必要がある。もし誤って一部のデータを含め忘れると、その項目がサーバー上のリソースから削除されてしまう可能性がある。このような部分的な更新には、HTTPのPATCHメソッドがより適している。PATCHメソッドは、リソースの特定の部分だけを変更するための指示を送信する。したがって、PUTメソッドを利用する際には、対象となるリソースがどのような粒度で更新されるべきかを慎重に検討する必要がある。

PUTメソッドは、リソースの作成と更新を明確かつ安全に行うための強力なツールであり、HTTPプロトコルにおけるデータ操作の基礎を理解する上で不可欠な要素である。その冪等性という特性と、クライアントがURIを決定するという原則は、堅牢なWebサービスやAPIを構築する上で非常に重要な意味を持つ。