Skip to content

[WFR] on #251 #617

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 34 additions & 30 deletions ja/learn/admin/REST/rest-bucket-flush.dita
Original file line number Diff line number Diff line change
@@ -1,76 +1,80 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference xml:lang="en-us" id="rest-bucket-flush">
<title>Flushing buckets</title>
<reference xml:lang="ja" id="rest-bucket-flush">
<title>bucketのフラッシュ</title>
<shortdesc>To flush all buckets, use the <codeph>POST
/pools/default/buckets/default/controller/doFlush</codeph> HTTP method and URI.</shortdesc>

<refbody>
<section><title>Description</title>
<section><title>説明</title>

<p>The <codeph>doFlush</codeph> operation empties the contents of the specified bucket, deleting
all stored data. The operation only succeeds if flush is enabled on configured bucket.</p>
<p>
<codeph>doFlush</codeph>オペレーションは指定のbucketのコンテンツを格納されているデータを全て削除し空にします。
設定したbucketでflushが有効な場合のみ、操作が成功します。
</p>

<note type="warning">This operation is data destructive. The service makes no attempt to confirm or double check
the request. Client applications using this are advised to double check with the end user
before sending such a request. You can control and limit the ability to flush individual
buckets by setting the <codeph>flushEnabled</codeph> parameter on a bucket in Couchbase Web Console or via
<codeph>cbepctl flush_param</codeph>.</note>
<note type="warning">
このオペレーションはデータを破棄します。サービスは実行確認したり、ダブルチェックのリクエストをしようとしません。
これを使用してクライアントアプリケーションはそのようなリクエストを送信する前にエンドユーザとダブルチェックすることを推奨します。
Couchbase Web コンソール内でbucket上の<codeph>flushEnabled</codeph>パラメータを設定したり、<codeph>cbepctl flush_param</codeph>を通して、個別のbucketのフラッシュする機能を制限したりコントロールすることが出来ます。</note>

<p>Parameters and payload data are ignored, but the request must including the authorization
header if the system has been secured.</p>
<p>
パラメータやペイロードデータは無視されますが、システムが保護されている場合、リクエストは認証ヘッダを含む必要があります。
</p>

<note type="important">The flush request may lead to significant disk activity as the data in the bucket is deleted
from the database. The high disk utilization may affect the performance of your server until
the data has been successfully deleted. </note>
<note type="important">
フラッシュリクエストはbucket内のデータがデータベースが削除されるのと同じくらいのかなりのディスクアクティビティになる可能性があります。
データが正常に削除されるまで、高いディスク使用率はサーバのパフォーマンスに影響をあたえる可能性があります。
</note>

<note type="note">The flush request is not transmitted over XDCR replication configurations;.
The remote bucket is not flushed. </note>
<p>Couchbase Server returns a HTTP 404 response if the URI is invalid or if it does not
correspond to an active bucket in the system.</p>
<note type="note">
フラッシュリクエストはXDCRレプリケーション構成上で送信されません。リモートbucketはフラッシュされません。
</note>
<p>
Couchbase Serverは、URLが無効だったり、システム上の有効なbucketと一致しない場合、HTTP 404 レスポンスを返します。
</p>
</section>


<section><title>HTTP method and URI</title>
<section><title>HTTPメソッドとURI</title>
<codeblock>POST /pools/default/buckets/default/controller/doFlush</codeblock>
</section>

<section><title>Syntax</title>
<p>Curl request syntax:</p>
<section><title>シンタックス</title>
<p>Curlリクエストシンタックス:</p>
<codeblock>curl -X POST -u [admin]:[password]
http://[localhost]:8091/pools/default/buckets/default/controller/doFlush
</codeblock>

<p>Raw HTTP request syntax:</p>
<p>Raw HTTPリクエストシンタックス:</p>
<codeblock>POST /pools/default/buckets/default/controller/doFlush
Host: localhost:8091
Authorization: Basic xxxxxxxxxxxxxxxxxxx
</codeblock>
</section>

<section><title>Example</title>
<p>Curl request example:</p>
<section><title></title>
<p>Curlリクエスト例:</p>
<codeblock>
curl -X POST 'http://admin:password@localhost:8091/pools/default/buckets/default/controller/doFlush'
</codeblock>

<p>Raw HTTP request example:</p>
<p>Raw HTTPリクエスト例:</p>
<codeblock>POST /pools/default/buckets/default/controller/doFlush
Host: 10.5.2.54:8091
Authorization: Basic xxxxxxxxxxxxxxxxxxx
</codeblock>
</section>


<section><title>Response codes</title>
<section><title>レスポンスコード</title>
<p>If the flush is successful, the HTTP response code is <codeph>200</codeph> is returned.</p>
<codeblock>HTTP/1.1 200 OK</codeblock>

<p>If flushing is disable for the specified bucket, a 400 response code is returned with the
bucket status. For example:</p>
<p>指定したbucketでフラッシュが無効だった場合、レスポンスコード400と一緒にbucketの状態が返ってきます。例:</p>
<codeblock>{"_":"Flush is disabled for the bucket"}</codeblock>

<p>If the bucket does not exist, a 404 response code is returned.</p>
<p>bucketが存在しなかった場合、レスポンスコード404が返ってきます。</p>
<codeblock>404 Not Found</codeblock>
</section>

Expand Down