mbコマンドを実行してバケットを作成します。Run the mb command to create a bucket - Object Storage Service

バケットは、Object Storage Service (OSS) に保存されているオブジェクトのコンテナです。オブジェクトをOSSにアップロードする前に、バケットを作成する必要があります。このトピックでは、mbコマンドを使用してバケットを作成する方法について説明します。

使用上の注意

バケットを作成するには、oss:PutBucket権限が必要です。詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。詳細は、「ossutilコマンドリファレンス」をご参照ください。

コマンドでオプションを指定してバケットを作成する

コマンド構文

ossutil mb oss://bucketname 
[--acl <value>]
[--storage-class <value>]
[--redundancy-type <value>]

次の表に、コマンド構文のパラメーターとオプションを示します。

パラメータ /オプション	説明
bucketname	作成するバケットの名前。バケット名は OSS 内でグローバルに一意である必要があります。バケットの名前は、バケットの作成後に変更することはできません。
-- acl	バケットのアクセス制御リスト (ACL) 。有効な値： private (デフォルト): バケット内のオブジェクトに対して読み取りおよび書き込み操作を実行できるのは、バケット所有者のみです。他のユーザーはバケット内のオブジェクトにアクセスできません。 public-read: バケット内のオブジェクトに対して書き込み操作を実行できるのは、バケット所有者のみです。匿名ユーザーを含むすべてのユーザーは、バケット内のオブジェクトに対して読み取り操作を実行できます。これにより、バケット内のデータへの不正アクセスと高額の料金が発生する可能性があります。バケットのACLをパブリック読み取りに設定する場合は、注意して続行してください。 public-read-write: 匿名ユーザーを含むすべてのユーザーが、バケット内のオブジェクトに対して読み取りおよび書き込み操作を実行できます。これにより、バケット内のデータに予期しないアクセスが発生する可能性があり、予期しない料金が請求される可能性があります。ユーザーが禁止されているデータまたは情報をアップロードすると、あなたの法的権利が侵害される可能性があります。必要な場合を除き、このパラメーターをpublic-read-writeに設定しないことをお勧めします。
-- ストレージクラス	バケットのストレージクラス。有効な値：標準 (デフォルト): このストレージクラスは、頻繁にアクセスされるデータに適しています。 IA: 低頻度アクセス (IA) ストレージクラスは、月に1回または2回アクセスされるデータなど、アクセス頻度の低いデータに適しています。 IAオブジェクトの最小保存期間は30日、最小課金サイズは64 KBです。 IAオブジェクトにリアルタイムでアクセスできます。 IAオブジェクトにアクセスすると、データ取得料金が発生します。アーカイブ: このストレージクラスは、長期間保存する必要があるデータに適しています。アーカイブオブジェクトの最小保存期間は60日、最小課金サイズは64 KBです。オブジェクトにアクセスする前に、アーカイブオブジェクトを復元する必要があります。 Archiveオブジェクトを復元するには約1分かかります。アーカイブオブジェクトの復元には、データ取得料金が発生します。 ColdArchive: このストレージクラスは、ほとんどアクセスされないデータの長期保存に適しています。 Cold Archiveオブジェクトの最小保存期間は180日、最小課金サイズは64 KBです。オブジェクトにアクセスする前に、Cold Archiveオブジェクトを復元する必要があります。 Cold Archiveオブジェクトの復元に必要な時間は、オブジェクトのサイズと復元モードによって異なります。 Cold Archiveオブジェクトの復元には、データ取得料金が発生します。説明 CloudBoxでOSSを使用する場合、標準ストレージクラスのみがサポートされます。ストレージクラスの詳細については、「概要」をご参照ください。
-- redundancyタイプ	バケットの冗長タイプを指定します。有効な値： LRS (デフォルト): バケットの冗長タイプをローカル冗長ストレージ (LRS) に設定した場合、OSSは同じゾーン内の異なるデバイス間で各オブジェクトのコピーを保存します。このように、OSSは、2つのストレージデバイスが同時に破損した場合でも、データの信頼性と可用性を保証します。 ZRS: バケットの冗長タイプをゾーン冗長ストレージ (ZRS) に設定した場合、OSSは同じリージョンの複数のゾーンにデータの複数のコピーを保存します。ゾーンが使用できなくなっても、データにアクセスできます。重要 ZRSは、中国 (深セン) 、中国 (北京) 、中国 (杭州) 、中国 (上海) 、中国 (香港) 、シンガポール、インドネシア (ジャカルタ) の各リージョンでサポートされています。 ZRSはストレージコストを増加させ、有効にした後は無効にできません。この冗長タイプを選択するときは注意してください。 CloudBoxでOSSを使用する場合、このパラメーターはサポートされていません。

例

次のコマンドを実行して、examplebucketという名前のバケットを作成できます。
```
ossutil mb oss://examplebucket
```
バケットを作成するリージョンを指定しない場合、バケットはossutil構成ファイルで指定されたエンドポイントにマップされるリージョンに作成されます。たとえば、設定ファイルのエンドポイントが https://oss-cn-hangzhou.aliyuncs.com の場合、バケットは中国 (杭州) リージョンに作成されます。
次のコマンドを実行して、examplebucketという名前のバケットを作成し、バケットのACLをprivate、ストレージクラスをIA、冗長タイプをZRSに設定します。
```
ossutil mb oss://examplebucket --acl private --storage-class IA --redundancy-type ZRS
```
次のサンプル出力が表示されている場合、examplebucketバケットが作成されます。
```
0.335189(s) elapsed
```

コマンドで指定したXMLファイルに基づいてバケットを作成する

コマンド構文

ossutil mb oss://bucketname local_xml_file

次の表に、コマンド構文のパラメーターを示します。

パラメーター	説明
bucketname	作成するバケットの名前。
local_xml_ファイル	バケット設定を含むローカルファイルパス。例: `localfile.xml`

例

localfile. XMLファイルのxml形式のバケット設定を指定します。

<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>    
    <StorageClass>IA</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>
</CreateBucketConfiguration>

ローカルファイルパスからバケット設定を読み取り、作成するバケットに設定を追加します。
```
ossutil mb oss://examplebucket localfile.xml
```

一般的なオプション

ossutilを使用して別のリージョンにあるバケットに切り替える場合は、-eオプションを追加して、バケットが配置されているリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、-iオプションを追加して指定されたアカウントのAccessKey IDを指定し、-kオプションを追加して指定されたアカウントのAccessKey secretを指定します。

たとえば、次のコマンドを実行して、中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントに属するexamplebucketという名前のバケットを作成できます。

ossutil mb oss://examplebucket -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

共通オプションの詳細については、「共通オプション」をご参照ください。