Skip to content

[WFR] on #250 #612

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
83 changes: 45 additions & 38 deletions ja/learn/admin/REST/rest-bucket-delete.dita
Original file line number Diff line number Diff line change
@@ -1,34 +1,40 @@
<?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-delete">
<title>Deleting buckets</title>
<shortdesc>To delete buckets, use the <codeph>DELETE /pools/default/buckets/[bucket-name]</codeph>
HTTP method and URI.</shortdesc>
<reference xml:lang="ja" id="rest-bucket-delete">
<title>bucketの削除</title>
<shortdesc>bucketを削除する時は、<codeph>DELETE /pools/default/buckets/[bucket-name]</codeph>HTTPメソッドとURIを使用します。</shortdesc>

<refbody>

<section><title>Description</title>
<p>Bucket deletion is a synchronous operation. When a cluster has multiple servers, some servers
might not be able to delete the bucket within the standard 30 second timeout period.</p>
<section><title>説明</title>
<p>
Bucketの削除は同期処理です。クラスタに複数サーバがある場合、いくつかのサーバで標準的なタイムアウトの30秒以内にbucketの削除ができない場合があります。
</p>
<ul>
<li>If the bucket is deleted on all servers within the standard timeout of 30 seconds,
a <codeph>200</codeph> response code is returned. </li>
<li>If the bucket is not deleted on all servers within the 30 second timeout,
a <codeph>500</codeph> error code is returned.</li>
<li>If the bucket is not deleted on all servers and another request is made to delete the bucket,
a <codeph>404</codeph> error code is returned.</li>
<li>If the bucket is not deleted on all servers and a request is made to crate a new bucket with the same name,
an error might be returned indicating that the bucket is still being deleted.</li>
<li>
標準的なタイムアウトの30秒以内に全てのサーバでbucketが削除された場合、レスポンスコード<codeph>200</codeph> が返ってきます。
</li>
<li>
30秒のタイムアウト以内に全てのサーバでbucketの削除が終わらなかった場合、エラーコード <codeph>500</codeph> が返ってきます。
</li>
<li>
bucketが全てのサーバで削除されず、他のリクエストでbucketが削除されていた場合、エラーコード <codeph>404</codeph> が返ってきます。
</li>
<li>
bucketが全てのサーバでの削除されず、同じ名前で新しいbucketを作成するリクエストがあった場合、bucketがまだ削除中であることを示すエラーが返ってくる事があります。
</li>
</ul>

<note type="warning"> This operation is data destructive.
The service makes no attempt to double check with the user.
It simply moves forward.
Clients applications performing the delete operation are advised to double
check with the end user before sending the request.</note>
<note type="warning">
この操作はデータを破壊します。
サービスはユーザとダブルチェックは行いません。
後戻りすることは出来ません。
クライアントアプリケーションでの削除操作はエンドユーザとのダブルチェックを行ったあとに実行することをおすすめします。
</note>
</section>

<section><title>HTTP method and URI</title>
<section>
<title>HTTPメソッドとURI</title>

<codeblock>DELETE /pools/default/buckets/[bucket-name]</codeblock>
<table>
Expand All @@ -37,15 +43,15 @@
<colspec colname="col2"/>
<tbody>
<row>
<entry><b>Request data</b></entry>
<entry><b>レスポンスデータ</b></entry>
<entry>None</entry>
</row>
<row>
<entry><b>Response data</b></entry>
<entry><b>レスポンスデータ</b></entry>
<entry>None</entry>
</row>
<row>
<entry><b>Authentication required</b></entry>
<entry><b>認証の要・不要</b></entry>
<entry>Yes</entry>
</row>
</tbody>
Expand All @@ -56,24 +62,24 @@

</section>

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

<p>Raw HTTP request syntax:</p>
<p>Raw HTTPリクエストシンタックス:</p>
<codeblock>DELETE /pools/default/buckets/[bucket-name]
Host: [localhost]:8091
Authorization: Basic xxxxxxxxxxxxxxxxxxx
</codeblock>
</section>

<section><title>Example</title>
<p>Curl request example to delete the bucket named myTestBucket:</p>
<section><title></title>
<p>myTestBucketという名前のbucketを削除するときのCurlリクエスト例:</p>
<codeblock>curl -u Administrator:password
http://10.5.2.54:8091/pools/default/buckets/myTestBucket</codeblock>

<p>Raw HTTP request example to delete the bucket named myTestBucket:</p>
<p>myTestBucketという名前のbucketを削除するときのRaw HTTPリクエスト例:</p>
<codeblock>DELETE /pools/default/buckets/myTestBucket
Host: 10.5.2.54:8091
Authorization: Basic xxxxxxxxxxxxxxxxxxx
Expand All @@ -82,37 +88,38 @@ Authorization: Basic xxxxxxxxxxxxxxxxxxx



<section><title>Response codes</title>
<section>
<title>レスポンスコード</title>
<table>
<tgroup cols="2">
<colspec colname="col1" colwidth="1*"/>
<colspec colname="col2" colwidth="2.85*"/>
<thead>
<row>
<entry>Response codes</entry>
<entry>Description</entry>
<entry>レスポンスコード</entry>
<entry>説明</entry>
</row>
</thead>
<tbody>
<row>
<entry>200</entry>
<entry>OK Bucket Deleted on all nodes</entry>
<entry>全てのノードでbucketが削除できた</entry>
</row>
<row>
<entry>401</entry>
<entry>Unauthorized</entry>
<entry>認証失敗</entry>
</row>
<row>
<entry>404</entry>
<entry>Object Not Found</entry>
<entry>オブジェクトが見つからない</entry>
</row>
<row>
<entry>500</entry>
<entry>Bucket could not be deleted on all nodes</entry>
<entry>Bucketが全てのノード上で削除されなかった</entry>
</row>
<row>
<entry>503</entry>
<entry>Buckets cannot be deleted during a rebalance</entry>
<entry>リバランス中でbucketが削除できなかった</entry>
</row>
</tbody>
</tgroup>
Expand Down