Skip to content

Commit ec47828

Browse files
authored
Merge pull request #23 from rustfs/i18n/ja-full-translation
ja: add missing guides (access-token, bucket create/delete, object up…
2 parents b346944 + 8342fc5 commit ec47828

11 files changed

Lines changed: 334 additions & 0 deletions

docs/ja/guide/access-token.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: "RustFS アクセスキー管理"
3+
description: "RustFS アクセスキーの作成・利用・削除"
4+
---
5+
6+
# アクセスキー
7+
8+
RustFS のアクセスキーは、認証と操作の認可に用いられる中核クレデンシャルで、API や SDK の利用シナリオで有用です。本章では、RustFS アクセスキーの作成と削除について説明します。
9+
10+
前提条件:
11+
12+
- 利用可能な RustFS インスタンスがあること。インストールは「インストールガイド」(../../ja/installation/index.md)を参照してください。
13+
14+
## アクセスキーの作成
15+
16+
1. RustFS UI コンソールにログインします。
17+
1. 左側ナビゲーションで「アクセスキー」を選択します。
18+
1. アクセスキー画面右上の「アクセスキーを追加」をクリックします。
19+
1. 有効期限・名前・説明を入力し、「送信」をクリックします。
20+
1.(任意・推奨)作成後の画面で「コピー」または「エクスポート」を選択して保存しておきます。
21+
22+
![access key list page](images/access_token_creation.png)
23+
24+
## アクセスキーの削除
25+
26+
1. RustFS UI コンソールにログインします。
27+
1. 左側ナビゲーションで「アクセスキー」を選択します。
28+
1. 削除対象のアクセスキーを選択します。
29+
1. 対象行の「削除」ボタン、または右上の「選択項目を削除」で削除します。
30+
31+
![access key deletion](images/access_token_deletion.png)
Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
---
2+
title: "RustFS バケット管理"
3+
description: "RustFS バケットの作成・削除"
4+
---
5+
6+
# RustFS バケット
7+
8+
バケット(Bucket)は RustFS におけるデータの論理的なコンテナです。各バケットは一意の名前を持ち、複数のオブジェクト(Object)を格納できます。RustFS UI、`mc`(MinIO Client)、または API により、作成・削除・アップロード/ダウンロード等の操作が可能です。
9+
10+
## バケットの作成
11+
12+
前提条件:
13+
14+
- 利用可能な RustFS インスタンス(インストールは ../../installation/index.md を参照)
15+
16+
## RustFS UI で作成
17+
18+
1. RustFS UI コンソールにログイン
19+
1. ホーム左上の「バケット作成」を選択
20+
1. バケット名を入力し「作成」をクリック
21+
22+
![bucket creation](images/bucket-creation-by-ui.png)
23+
24+
### `mc` で作成
25+
26+
> `mc` のインストール/設定は「`mc` ガイド」(../mc.md)を参照
27+
28+
```
29+
# creat rustfs bucket
30+
mc mb rustfs/bucket-creation-by-mc
31+
Bucket created successfully `rustfs/bucket-creation-by-mc`.
32+
33+
# confirm bucket creation
34+
mc ls rustfs/bucket-creation-by-mc
35+
```
36+
37+
### API で作成
38+
39+
```
40+
PUT /{bucketName} HTTP/1.1
41+
```
42+
43+
例:
44+
45+
```
46+
curl --location --request PUT 'http://12.34.56.78:9000/bucket-creation-by-api' \
47+
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
48+
--header 'X-Amz-Date: 20250801T023519Z' \
49+
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=c2fb2ba5199a30ebcfa9976d0f35000ba274da3701327957e84ea0f3920288f2'
50+
```
51+
52+
RustFS UI で `bucket-creation-by-api` が作成されたことを確認できます。
53+
54+
## バケットの削除
55+
56+
注意:バケットは重要なコンポーネントです。削除により依存アプリがエラーとなる可能性があります。事前にデータのバックアップと不要確認を行ってください。
57+
58+
### RustFS UI で削除
59+
60+
1. RustFS UI コンソールにログイン
61+
1. ホームで削除対象のバケットを選択
62+
1. 右端の「削除」ボタンをクリック
63+
1. ダイアログで「確認」をクリック
64+
65+
![bucket deletion](images/bucket-deletion-on-ui.png)
66+
67+
### `mc` で削除
68+
69+
> `mc` のインストール/設定は「`mc` ガイド」(../mc.md)を参照
70+
71+
```
72+
# delete bucket
73+
mc rb rustfs/bucket-creation-by-mc
74+
Removed `rustfs/bucket-creation-by-mc` successfully.
75+
76+
# confirm bucket deletion
77+
mc ls rustfs/bucket-creation-by-mc
78+
mc: <ERROR> Unable to list folder. Bucket `bucket-creation-by-mc` does not exist.
79+
```
80+
81+
### API で削除
82+
83+
```
84+
DELETE /{bucketName} HTTP/1.1
85+
```
86+
87+
例:
88+
89+
```
90+
curl --location --request DELETE 'http://12.34.56.78:9000/bucket-creation-by-api' \
91+
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
92+
--header 'X-Amz-Date: 20250801T024406Z' \
93+
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=d0f6addf09fffd7eef75191e9d3209bb7188e6b004e9707238fc60ad7033edae'
94+
```
95+
96+
RustFS UI で `bucket-creation-by-api` が削除されたことを確認できます。
139 KB
Loading
65.3 KB
Loading
219 KB
Loading
342 KB
Loading
141 KB
Loading
Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
title: "RustFS オブジェクト管理"
3+
description: "オブジェクトの作成と削除"
4+
---
5+
6+
# RustFS オブジェクト
7+
8+
オブジェクト(Object)は RustFS における最小単位で、データ・メタデータ・一意キー(Object Key)を含みます。本章ではファイルのアップロード/削除を例に管理方法を説明します。
9+
10+
> 関連概念は「[コア概念](../../concepts/glossary.md)」を参照してください。
11+
12+
## オブジェクトの作成
13+
14+
前提条件:
15+
16+
- 利用可能な RustFS インスタンス(../../installation/index.md を参照)
17+
18+
[バケットを作成](bucket-create-and-delete.md)し、当該バケットにファイルをアップロードするとオブジェクトが作成されます。RustFS UI、`mc`、API のいずれでも可能です。
19+
20+
### RustFS UI でアップロード
21+
22+
1. RustFS UI コンソールにログイン
23+
1. 対象バケットを選択
24+
1. 右上の「新規ディレクトリ」「新規ファイル」「ファイル/フォルダをアップロード」を選択
25+
1. ローカルからアップロードする場合は「ファイル/フォルダをアップロード」→対象を選択→「アップロード開始」
26+
27+
![object creation from ui](images/upload_file_from_ui.png)
28+
29+
アップロード後、当該オブジェクトをクリックして詳細を確認できます。
30+
31+
![object details info](images/object_details_info.png)
32+
33+
### `mc` でアップロード
34+
35+
> `mc` のインストール/設定は「`mc` ガイド」(../mc.md)を参照
36+
37+
```
38+
# upload file
39+
mc cp 1.txt rustfs/bucket-creation-by-mc
40+
/tmp/1.txt: 13 B / 13 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 61 B/s 0s%
41+
42+
# confirm file uploaded
43+
mc ls rustfs/bucket-creation-by-mc
44+
[2025-08-01 10:01:08 CST] 13B 1.txt
45+
```
46+
47+
### API でアップロード
48+
49+
```
50+
PUT /{bucketName}/{objectName} HTTP/1.1
51+
```
52+
53+
例:
54+
55+
```
56+
curl --location --request PUT 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \
57+
--header 'Content-Type: text/plain' \
58+
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
59+
--header 'X-Amz-Date: 20250801T024840Z' \
60+
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=b7d8dc29ee34dfdf1f3e9e8e069892a8936f478586e7a2c90cf34f5b86d3a2dc' \
61+
--data-binary '@/path/to/password.txt'
62+
```
63+
64+
## オブジェクトの削除
65+
66+
UI、`mc`、API のいずれでも削除できます。上記で作成したファイルを削除すれば完了です。
67+
68+
## RustFS UI で削除
69+
70+
1. RustFS UI コンソールにログイン
71+
1. 対象バケットを選択
72+
1. 対象ファイルを選択
73+
1. 右上の「選択項目を削除」→ダイアログで「確認」
74+
75+
![object deletion from ui](images/delete_file_from_ui.png)
76+
77+
### `mc` で削除
78+
79+
```
80+
# delete file
81+
mc rm rustfs/bucket-creation-by-mc/1.txt
82+
Removed `rustfs/bucket-creation-by-mc/1.txt`.
83+
84+
# confirm deletion
85+
mc ls rustfs/bucket-creation-by-mc/1.txt
86+
```
87+
88+
### API で削除
89+
90+
```
91+
DELETE /{bucketName}/{objectName} HTTP/1.1
92+
```
93+
94+
例:
95+
96+
```
97+
curl --location --request DELETE 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \
98+
--header 'Content-Type: text/plain' \
99+
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
100+
--header 'X-Amz-Date: 20250801T030822Z' \
101+
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=1ee63bb0b699598602b2fdbd013e355a57bcb9991307a8ad41f6512e8afebf3a' \
102+
--data-binary '@/Users/jhma/Desktop/password.txt'
103+
```
189 KB
Loading
173 KB
Loading

0 commit comments

Comments
 (0)