Run the mb command to create a bucket, 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 を直接使用できます。オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 ossutil 1.6.16 より前のバージョンでは、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。詳細については、「ossutil コマンドリファレンス」をご参照ください。
2025 年 10 月 13 日 10:00 (UTC + 08:00) から、OSS は全リージョンで段階的な調整を実施し、API、OSS SDK、または ossutil を使用して作成された新しいバケットに対して、デフォルトでパブリックアクセスブロックを有効にします。各リージョンで調整が有効になる正確な時間については、[公式発表] 新しく作成されたバケットのパブリックアクセスブロック設定の調整を参照してください。パブリックアクセスブロックが有効になると、パブリック ACL（パブリック読み取りおよびパブリック読み取り/書き込み）やパブリックアクセスを許可するバケットポリシーなど、パブリックアクセス権限を設定できなくなります。ビジネスでパブリックアクセスが必要な場合は、バケットの作成後にこの機能を無効にすることができます。

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

コマンド構文

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

次の表は、コマンド構文のパラメーターとオプションについて説明しています。

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

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

ossutil mb oss://examplebucket -e oss-cn-shanghai.aliyuncs.com -i LTAI****************  -k yourAccessKeySecret

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