blob: 16f60f9a2ace6964bbbf6bc44262709eccc62194 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
---
title: PATCH
slug: Web/HTTP/Methods/PATCH
tags:
- HTTP
- Reference
- リクエストメソッド
translation_of: Web/HTTP/Methods/PATCH
---
<div>{{HTTPSidebar}}</div>
<p><strong>HTTP の <code>PATCH</code> リクエストメソッド</strong>は、リソースへの部分的な変更を適用します。</p>
<p><code>PATCH</code> は {{Glossary("CRUD")}} に見られる "update" の概念にやや類似しています（一般的に、 HTTP は {{Glossary("CRUD")}} とは異なり、両者は混同するべきではありません）。</p>
<p><code>PATCH</code> リクエストは、リソースをどのように修正するかの指示のセットと考えられます。これは {{HTTPMethod("PUT")}} がリソースの完全な表現を送るのと対照的です。</p>
<p><code>PATCH</code> はべき等であるとは限りませんが、そうなる可能性もあります。この点は、常にべき等である {{HTTPMethod("PUT")}} とは対照的です。「べき等」という言葉は、同じリクエストを何度繰り返しても、リソースが同じ状態になることを意味します。 例えば、自動インクリメントするカウンタフィールドがリソースの不可欠な部分である場合、 {{HTTPMethod("PUT")}} は自然にそれを上書きしますが（すべてを上書きするので）、 <code>PATCH</code> は必ずしもそうとは限りません。</p>
<p><code>PATCH</code> は（{{HTTPMethod("PUT")}} のように）他のリソースに対して副作用が発生する<em>場合があります</em>。</p>
<p>サーバーが <code>PATCH</code> に対応しているかどうかを調べるために、サーバーは {{HTTPHeader("Allow")}} または {{HTTPHeader("Access-Control-Allow-Methods")}} （<a href="/ja/docs/Web/HTTP/CORS">CORS</a> の場合）レスポンスヘッダーのリストに追加することで対応状況を知らせることができます。</p>
<p><code>PATCH</code> が許可されていることを示すもう1つの（暗黙の）識別方法は、サーバーが受け付けるパッチ文書の形式を指定する {{HTTPHeader("Accept-Patch")}} があることです。</p>
<table class="properties">
<tbody>
<tr>
<th scope="row">リクエストの本文</th>
<td>あり</td>
</tr>
<tr>
<th scope="row">成功時のレスポンスの本文</th>
<td>あり</td>
</tr>
<tr>
<th scope="row">{{Glossary("Safe", "安全性")}}</th>
<td>なし</td>
</tr>
<tr>
<th scope="row">{{Glossary("Idempotent", "べき等性")}}</th>
<td>なし</td>
</tr>
<tr>
<th scope="row">{{Glossary("Cacheable", "キャッシュ")}}</th>
<td>不可</td>
</tr>
<tr>
<th scope="row"><a href="/ja/docs/Web/Guide/HTML/Forms">HTML フォームforms</a>での利用</th>
<td>不可</td>
</tr>
</tbody>
</table>
<h2 id="Syntax" name="Syntax">構文</h2>
<pre class="syntaxbox">PATCH /file.txt HTTP/1.1
</pre>
<h2 id="Example" name="Example">例</h2>
<h3 id="Request" name="Request">リクエスト</h3>
<pre class="line-numbers language-html">PATCH /file.txt HTTP/1.1
Host: www.example.com
Content-Type: application/example
If-Match: "e0023aa4e"
Content-Length: 100
[変更の記述]</pre>
<h3 id="Response" name="Response">レスポンス</h3>
<p>成功応答は <a href="https://tools.ietf.org/html/rfc7231#section-6.3">2xx</a> ステータスコードで示されます。</p>
<p>この例の場合、本文が含まれていないため {{HTTPStatus("204")}} コードで成功応答が示されます。もし {{HTTPStatus("200")}} コードであれば本文が含まる可能性があります。 </p>
<pre class="newpage">HTTP/1.1 204 No Content
Content-Location: /file.txt
ETag: "e0023aa4f"</pre>
<h2 id="Specifications" name="Specifications">仕様書</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">仕様書</th>
<th scope="col">題名</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{RFC("5789", "PATCH")}}</td>
<td>PATCH Method for HTTP</td>
</tr>
</tbody>
</table>
<h2 id="See_also" name="See_also">関連情報</h2>
<ul>
<li>{{HTTPStatus("204")}}</li>
<li>{{HTTPHeader("Allow")}}, {{HTTPHeader("Access-Control-Allow-Methods")}}</li>
<li>{{HTTPHeader("Accept-Patch")}} – サーバーが受け入れる PATCH ドキュメントの形式を指定します。</li>
</ul>
|
