From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/http/methods/patch/index.html | 105 +++++++++++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 files/ja/web/http/methods/patch/index.html (limited to 'files/ja/web/http/methods/patch') diff --git a/files/ja/web/http/methods/patch/index.html b/files/ja/web/http/methods/patch/index.html new file mode 100644 index 0000000000..16f60f9a2a --- /dev/null +++ b/files/ja/web/http/methods/patch/index.html @@ -0,0 +1,105 @@ +--- +title: PATCH +slug: Web/HTTP/Methods/PATCH +tags: + - HTTP + - Reference + - リクエストメソッド +translation_of: Web/HTTP/Methods/PATCH +--- +
{{HTTPSidebar}}
+ +

HTTP の PATCH リクエストメソッドは、リソースへの部分的な変更を適用します。

+ +

PATCH は {{Glossary("CRUD")}} に見られる "update" の概念にやや類似しています（一般的に、 HTTP は {{Glossary("CRUD")}} とは異なり、両者は混同するべきではありません）。

+ +

PATCH リクエストは、リソースをどのように修正するかの指示のセットと考えられます。これは {{HTTPMethod("PUT")}} がリソースの完全な表現を送るのと対照的です。

+ +

PATCH はべき等であるとは限りませんが、そうなる可能性もあります。この点は、常にべき等である {{HTTPMethod("PUT")}} とは対照的です。「べき等」という言葉は、同じリクエストを何度繰り返しても、リソースが同じ状態になることを意味します。 例えば、自動インクリメントするカウンタフィールドがリソースの不可欠な部分である場合、 {{HTTPMethod("PUT")}} は自然にそれを上書きしますが（すべてを上書きするので）、 PATCH は必ずしもそうとは限りません。

+ +

PATCH は（{{HTTPMethod("PUT")}} のように）他のリソースに対して副作用が発生する場合があります。

+ +

サーバーが PATCH に対応しているかどうかを調べるために、サーバーは {{HTTPHeader("Allow")}} または {{HTTPHeader("Access-Control-Allow-Methods")}} （CORS の場合）レスポンスヘッダーのリストに追加することで対応状況を知らせることができます。

+ +

PATCH が許可されていることを示すもう1つの（暗黙の）識別方法は、サーバーが受け付けるパッチ文書の形式を指定する {{HTTPHeader("Accept-Patch")}} があることです。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
リクエストの本文あり
成功時のレスポンスの本文あり
{{Glossary("Safe", "安全性")}}なし
{{Glossary("Idempotent", "べき等性")}}なし
{{Glossary("Cacheable", "キャッシュ")}}不可
HTML フォームformsでの利用不可
+ +

構文

+ +
PATCH /file.txt HTTP/1.1
+
+ +

例

+ +

リクエスト

+ +
PATCH /file.txt HTTP/1.1
+Host: www.example.com
+Content-Type: application/example
+If-Match: "e0023aa4e"
+Content-Length: 100
+
+[変更の記述]
+ +

レスポンス

+ +

成功応答は 2xx ステータスコードで示されます。

+ +

この例の場合、本文が含まれていないため {{HTTPStatus("204")}} コードで成功応答が示されます。もし {{HTTPStatus("200")}} コードであれば本文が含まる可能性があります。 

+ +
HTTP/1.1 204 No Content
+Content-Location: /file.txt
+ETag: "e0023aa4f"
+ +

仕様書

+ + + + + + + + + + + + + + +
仕様書題名
{{RFC("5789", "PATCH")}}PATCH Method for HTTP
+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf