バケットは、Object Storage Service (OSS) でオブジェクトを格納するためのコンテナです。このトピックでは、OSS SDK for Python V1 を使用してバケットを作成する方法について説明します。
注意事項
この例では、中国 (杭州) リージョン (
cn-hangzhou) とパブリックエンドポイントを使用します。同じリージョン内の他の Alibaba Cloud プロダクトから OSS にアクセスする場合は、代わりに内部エンドポイントを使用してください。リージョンごとのエンドポイントマッピングについては、「リージョンとエンドポイント」をご参照ください。2025年10月13日 10:00 (UTC+08:00) 以降、API、OSS SDK、または ossutil を介して作成された新しいバケットに対して、OSS はデフォルトで 公開アクセス禁止 を有効にします。この展開はリージョンごとに段階的に実施されます。スケジュールについては、「[公式発表] 新規作成バケットに対する公開アクセスブロック設定の調整について」をご参照ください。公開アクセス禁止が有効になっている場合、パブリック ACL (パブリック読み取りまたはパブリック読み取り/書き込み) や、パブリックアクセスを許可するバケットポリシーを設定することはできません。ご利用のユースケースでパブリックアクセスが必要な場合は、バケット作成後にこの機能を無効にしてください。
前提条件
作業を開始する前に、以下を確認してください:
OSS SDK for Python V1 (
oss2) がインストールされていることAPI アクセスまたは日常の O&M のために作成された Resource Access Management (RAM) ユーザー、およびその AccessKey ID と AccessKey Secret
Alibaba Cloud アカウント (root ユーザー) の AccessKey は、すべての API オペレーションに対する完全な権限を持っているため、セキュリティリスクがあります。代わりに、RAM ユーザーの AccessKey を使用して API にアクセスすることを推奨します。RAM ユーザーを作成するには、RAM コンソールにログインします。
バケットの作成
次の例では、examplebucket という名前のバケットをデフォルト設定で作成します。
# -*- coding: utf-8 -*-
import oss2
# Alibaba Cloud アカウント (root ユーザー) の AccessKey は、すべての API オペレーションに対する完全な権限を持っているため、セキュリティリスクがあります。
# API アクセスや日常の O&M には、RAM ユーザーの AccessKey を使用することを推奨します。RAM ユーザーを作成するには、RAM コンソールにログインしてください。
auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
# エンドポイントのフォーマット: https://oss-{region-id}.aliyuncs.com
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# バケットを作成します。
bucket.create_bucket()カスタム設定でのバケットの作成
作成時にストレージクラス、ACL (アクセスコントロールリスト)、またはデータ冗長タイプを指定するには、BucketCreateConfig オブジェクトを渡します。
次の例では、標準ストレージ、非公開 ACL、およびゾーン冗長ストレージ (ZRS) を使用してバケットを作成します。
# -*- coding: utf-8 -*-
import oss2
auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
bucket_config = oss2.models.BucketCreateConfig(
oss2.BUCKET_STORAGE_CLASS_STANDARD,
oss2.BUCKET_DATA_REDUNDANCY_TYPE_ZRS
)
bucket.create_bucket(oss2.BUCKET_ACL_PRIVATE, bucket_config)各パラメーターでサポートされている値は次のとおりです:
| パラメーター | 定数 | 値 |
|---|---|---|
| ストレージクラス | oss2.BUCKET_STORAGE_CLASS_STANDARD | 標準 |
| ACL | oss2.BUCKET_ACL_PRIVATE | 非公開 |
| データ冗長タイプ | oss2.BUCKET_DATA_REDUNDANCY_TYPE_ZRS | ゾーン冗長ストレージ (ZRS) |