Object Storage Service:Create a bucket

Kullanım notları

• Örneklerde China (Hangzhou) bölgesi (cn-hangzhou) ve genel uç nokta kullanılmaktadır. Aynı bölgedeki diğer Alibaba Cloud hizmetlerinden OSS'e erişmek için dahili uç noktayı kullanın. Bölgelere göre uç nokta eşleştirmeleri için bkz. Bölgeler ve uç noktalar.

• 13 Ekim 2025, 10:00 (UTC+8) tarihinden itibaren API, OSS SDK'ları veya ossutil aracılığıyla oluşturulan yeni paketler için Block Public Access özelliği varsayılan olarak etkinleştirilir. Dağıtım aşamalı olarak bölgelere yayılır; zaman çizelgesi için bkz. [[Official Announcement] Adjustment to public access blocking configurations for newly created buckets](https://www.alibabacloud.com/en/notice/block_public_access_enabled_by_default_for_buckets_created_by_calling_api_operations_using_oss_sdks_482). Block Public Access etkin olduğunda genel ACL'ler (genel okuma veya genel okuma/yazma) ya da genel erişime izin veren paket ilkeleri ayarlayamazsınız. Kullanım durumunuz genel erişim gerektiriyorsa bu özelliği paket oluşturulduktan sonra devre dışı bırakın.

Ön koşullar

Başlamadan önce aşağıdakilerin hazır olduğundan emin olun:

• OSS SDK for Python V1 (oss2) yüklü olmalıdır.

• API erişimi veya rutin bakım ve işlemler için oluşturulmuş bir Resource Access Management (RAM) kullanıcısı ile bu kullanıcının AccessKey ID ve AccessKey Secret bilgileri mevcuttur.

Bir Alibaba Cloud hesap AccessKey'i tüm API işlemleri için tam yetkilere sahiptir ve bu durum güvenlik riski oluşturur. API erişimi için bunun yerine bir RAM kullanıcısının AccessKey bilgisini kullanın. RAM kullanıcısı oluşturmak için RAM konsoluna giriş yapın.

Paket oluşturma

Aşağıdaki örnek, varsayılan ayarlarla examplebucket adlı bir paket oluşturur.

# -*- coding: utf-8 -*-
import oss2

# An Alibaba Cloud account AccessKey has full permissions for all API operations, which poses a security risk.
# Use a RAM user's AccessKey for API access or routine O&M. To create a RAM user, log in to the RAM console.
auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')

# Endpoint format: https://oss-{region-id}.aliyuncs.com
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')

# Create the bucket.
bucket.create_bucket()

Özel ayarlarla paket oluşturma

Oluşturma sırasında depolama sınıfını, ACL'yi (Erişim Kontrol Listesi) veya veri yedeklilik türünü belirtmek için bir BucketCreateConfig nesnesi iletin.

Aşağıdaki örnek, Standard depolama sınıfı, private ACL ve zone-redundant storage (ZRS) veri yedeklilik türüne sahip bir paket oluşturur.

# -*- 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)

Her parametre için desteklenen değerler şunlardır:

Sonraki adımlar

• Tam örnek kod için bkz. GitHub örneği.

• Altta yatan API işlemi için bkz. PutBucket.