バケットはオブジェクトを格納するためのコンテナーです。すべてのオブジェクトはバケットに格納する必要があります。このトピックでは、バケットの作成方法について説明します。
注意事項
このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。同じリージョン内の他の Alibaba Cloud サービスから OSS にアクセスするには、内部エンドポイントを使用します。サポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
2025年10月13日 10:00 (UTC+08:00) から、OSS はすべてのリージョンで段階的な調整を実施し、API、OSS SDK、または ossutil を使用して作成された新しいバケットで、デフォルトで パブリックアクセスのブロック を有効にします。各リージョンで調整が有効になる正確な時間については、[公式発表] 新規作成バケットのパブリックアクセスブロック設定の調整をご参照ください。パブリックアクセスのブロックが有効になると、パブリック ACL (パブリック読み取りおよびパブリック読み取り/書き込み) やパブリックアクセスを許可するバケットポリシーなど、パブリックアクセス権限を設定できなくなります。ビジネスでパブリックアクセスが必要な場合は、バケットの作成後にこの機能を無効にできます。
権限
デフォルトでは、Alibaba Cloud アカウントは完全な権限を持っています。Alibaba Cloud アカウント配下の RAM ユーザーまたは RAM ロールは、デフォルトではいかなる権限も持っていません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシー または バケットポリシー を通じて操作権限を付与する必要があります。
API | アクション | 定義 |
PutBucket |
| バケットを作成します。 |
| バケットの作成後、バケット ACL を変更するにはこの権限が必要です。 |
サンプルコード
次のコードは、examplebucket という名前のバケットを作成する方法の例を示しています。
const OSS = require('ali-oss');
const client = new OSS({
// バケットが配置されているリージョンを指定します。たとえば、バケットが中国 (杭州) リージョンにある場合は、リージョンを oss-cn-hangzhou に設定します。
region: 'yourregion',
// 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
accessKeyId: process.env.OSS_ACCESS_KEY_ID,
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
authorizationV4: true,
// バケット名を指定します。
bucket: 'yourBucketName',
});
// バケットを作成します。
async function putBucket() {
try {
const options = {
storageClass: 'Standard', // バケットのデフォルトのストレージクラスは標準ストレージです。ストレージクラスをアーカイブストレージに設定するには、Standard を Archive に置き換えます。
acl: 'private', // バケットのデフォルトのアクセス制御リスト (ACL) は非公開です。ACL を公開読み取りに設定するには、private を public-read に置き換えます。
dataRedundancyType: 'LRS' // バケットのデフォルトのデータディザスタリカバリタイプはローカル冗長ストレージ (LRS) です。データディザスタリカバリタイプをゾーン冗長ストレージ (ZRS) に設定するには、LRS を ZRS に置き換えます。
}
// バケット名を指定します。
const result = await client.putBucket('examplebucket', options);
console.log(result);
} catch (err) {
console.log(err);
}
}
putBucket(); 関連ドキュメント
バケットを作成するための API 操作の詳細については、「PutBucket」をご参照ください。