バケットは、オブジェクトをOSS (Object Storage Service) に格納するために使用されるコンテナーです。 オブジェクトをOSSにアップロードする前に、バケットを作成する必要があります。 このトピックでは、mbコマンドを使用してバケットを作成する方法について説明します。
説明 このトピックでは、64ビットLinuxシステムに基づくサンプルコマンドラインを提供します。 他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。 詳細については、「ossutilの使用を開始する」をご参照ください。
コマンドで指定されたオプションに基づいてバケットを作成する
コマンド構文
. /ossutil64 mb oss:// bucketname
[-- acl <value>]
[-- storage-class <value>]
[-- redundancy-type <value>]
次の表に、上記のステートメントで使用されるパラメーターを示します。
パラメーター | 説明 |
bucketname | 作成するバケットの名前。 バケット名は OSS 内でグローバルに一意である必要があります。 バケットの名前は、バケットの作成後に変更することはできません。 |
-- acl | バケットのアクセス制御リスト (ACL) 。 デフォルト値: private。 有効な値: private: バケット内のオブジェクトに対して読み取りおよび書き込み操作を実行できるのは、バケット所有者のみです。 他のユーザーはバケット内のオブジェクトにアクセスできません。 public-read: バケット内のオブジェクトに対して書き込み操作を実行できるのは、バケット所有者のみです。 匿名ユーザーを含む他のユーザーは、バケット内のオブジェクトに対してのみ読み取り操作を実行できます。 これにより、オブジェクトへの不正アクセスと高い料金が発生する可能性があります。 ユーザーが禁止されているデータや情報をオブジェクトにアップロードすると、正当な利益や権利が侵害される可能性があります。 必要な場合を除き、このパラメーターをpublic-readに設定しないことを推奨します。 public-read-write: 匿名ユーザーを含むすべてのユーザーが、バケット内のオブジェクトに対して読み取りおよび書き込み操作を実行できます。 これにより、バケット内のデータへの不正アクセスと高額の料金が発生する可能性があります。 このパラメーターをpublic-read-writeに設定する場合は、注意してください。
|
-- ストレージクラス | バケットのストレージクラス。 デフォルト値: Standard。 有効な値: 標準: このストレージクラスは、頻繁にアクセスされるデータに適しています。 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オブジェクトを復元すると、データ取得料金が発生します。
ストレージクラスの詳細については、「概要」をご参照ください。 |
-- redundancyタイプ | バケットの冗長タイプ。 デフォルト値: LRS。 有効な値: LRS: バケットの冗長タイプをローカル冗長ストレージ (LRS) に設定した場合、OSSは同じゾーン内の異なるデバイス間で各オブジェクトのコピーを保存します。 このように、OSSは、2つのストレージデバイスが同時に破損した場合でも、データの信頼性と可用性を保証します。 ZRS: ZRSは、同じリージョンの複数のゾーンにデータの複数のコピーを保存します。 ゾーンが使用できなくなっても、データにアクセスできます。
説明 ゾーン冗長ストレージ (ZRS) は、中国 (深セン) 、中国 (北京) 、中国 (杭州) 、中国 (上海) 、中国 (香港) 、シンガポール、インドネシア (ジャカルタ) の各リージョンでサポートされています。 ZRSには追加料金が請求されます。 この機能は、有効化後は無効にできません。 この機能を有効にするときは注意してください。 |
例
次のコマンドを実行して、examplebucketという名前のバケットを作成できます。
. /ossutil64 mb oss:// examplebucket
バケットを作成するリージョンを指定しない場合、バケットはossutil構成ファイルのエンドポイントで指定されたリージョンに作成されます。 たとえば、設定ファイルで指定されたエンドポイントがhttps://oss-cn-hangzhou.aliyuncs.com
の場合、バケットは中国 (杭州) リージョンに作成されます。
次のコマンドを実行して、examplebucketという名前のバケットを作成し、バケットのACLをprivate、ストレージクラスをIA、冗長タイプをZRSに設定します。
. /ossutil64 mb oss:// examplebucket -- acl private -- ストレージクラスIA -- 冗長タイプZRS
次の出力が表示された場合、examplebucketバケットが作成されます。
0.335189経過
コマンドで指定されたXML構造に基づいてバケットを作成します。
コマンド構文
. /ossutil64 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を使用してローカルファイルパスからバケット設定を取得し、作成するバケットに設定を追加できます。
. /ossutil64 mb oss:// examplebucket localfile.xml
一般的なオプション
ossutilを使用して別のリージョンにあるバケットに切り替える場合は、コマンドに -eオプションを追加して、指定したバケットがあるリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、コマンドに -iオプションを追加して、指定されたアカウントのAccessKey IDを指定し、コマンドに -kオプションを追加して、指定されたアカウントのAccessKeyシークレットを指定します。
たとえば、次のコマンドを実行して、中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントに属するexamplebucketという名前のバケットを作成できます。
. /ossutil64 mb oss:// examplebucket -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****
同期コマンドに使用できるその他の一般的なオプションの詳細については、「オプションの表示」をご参照ください。