initial commit

1 files changed, 105 insertions, 0 deletions

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
+---
+<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>