Tüm Ürünler
Search

Bu Ürün

    Object Storage Service:PutBucket

    Belge Merkezi

    Object Storage Service:PutBucket

    Son Güncelleme:Oct 13, 2026

    Bir paket oluşturmak için PutBucket işlemini çağırın.

    Notlar

    • Bir Alibaba Cloud hesabı, her bölgede en fazla 100 paket oluşturabilir.

    • Her bölgenin kendine ait bir uç noktası bulunur. Her bölgeye ait uç noktalar hakkında daha fazla bilgi için bkz. Endpoints.

    • Aynı paket için PutBucket işlemini birden çok kez çağırırsanız ilk çağrı paketi oluşturur, sonraki çağrılar ise paket ACL'si gibi meta verilerini değiştirir. Bu durum paket meta verilerinin üzerine yazılmasına neden olabilir. Dikkatli olun.

    • 13 Ekim 2025 tarihinde saat 10:00:00'dan (UTC+8) itibaren OSS, tüm bölgelerde API işlemleri çağrılarak veya OSS SDK'ları ya da ossutil kullanılarak oluşturulan paketler için genel erişimi engellemeyi kademeli olarak varsayılan hale getirir. Değişikliğin her bölgede yürürlüğe gireceği zaman için bkz. Announcement.

    İzinler

    Varsayılan olarak bir Alibaba Cloud hesabının tam izinleri vardır. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rollerinde varsayılan olarak herhangi bir izin bulunmaz. Alibaba Cloud hesabı veya hesap yöneticisi, işlem izinlerini RAM policies veya Bucket Policy aracılığıyla vermelidir.

    API

    Action

    Description

    PutBucket

    oss:PutBucket

    Creates a bucket.

    oss:PutBucketAcl

    After creating a bucket, this permission is required to modify the bucket ACL.

    İstek sözdizimi

    PUT / HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
x-oss-acl: Permission
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>

    İstek üstbilgileri

    Name

    Type

    Required

    Example

    Description

    bucket

    String

    Yes

    examplebucket

    Paketin adı. Paket adlandırma kuralları aşağıdaki gibidir:

    • Ad yalnızca küçük harfler, rakamlar ve tire (-) içerebilir.

    • Ad küçük bir harf veya rakamla başlamalı ve bitmelidir.

    • Ad 3 ila 63 karakter uzunluğunda olmalıdır.

    x-oss-acl

    String

    No

    private

    Paketin erişim kontrol listesi (ACL). Geçerli değerler:

    • public-read-write: Genel okuma ve yazma izinleri verir.

    • public-read: Public Read

    • private (varsayılan)

    Paket ACL'leri hakkında daha fazla bilgi için bkz. Set bucket ACLs.

    x-oss-resource-group-id

    String

    No

    rg-aek27tc****

    Kaynak grubunun kimliği.

    • İsteğe bu üstbilgiyi ekler ve bir kaynak grubu kimliği belirtirseniz oluşturulan paket belirtilen kaynak grubuna ait olur.

      Kaynak grubu kimliğini rg-default-id olarak ayarlarsanız oluşturulan paket varsayılan kaynak grubuna ait olur.

    • İsteğe bu üstbilgiyi eklemezseniz oluşturulan paket varsayılan kaynak grubuna ait olur.

    Kaynak grubu kimliğini Resource Management konsolundan veya ListResourceGroups işlemini çağırarak alabilirsiniz. Daha fazla bilgi için bkz. View resource groups ve ListResourceGroups.

    x-oss-bucket-tagging

    String

    No

    k1=v1&k2=v2

    Paket etiketlerini belirtir.

    x-oss-hns-status

    String

    No

    disabled

    Paket için hiyerarşik ad alanı özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

    Hiyerarşik ad alanı özelliğini yalnızca paket oluştururken etkinleştirebilirsiniz. Mevcut bir paketin hiyerarşik ad alanı durumunu değiştiremezsiniz.

    • enabled: Enabled

      Bir paket için hiyerarşik ad alanı özelliğini etkinleştirdikten sonra pakette dizin oluşturma, silme ve yeniden adlandırma gibi dizin işlemleri yapabilirsiniz.

    • disabled (varsayılan): Özellik devre dışı bırakılır.

    x-oss-server-side-encryption

    String

    No

    AES256

    Varsayılan sunucu tarafı şifreleme yöntemini ayarlar.

    Geçerli değerler: KMS, AES256

    Not

    In OSS ON CloudBox scenarios, only AES256 is supported.

    KMS özelliğinin kullanılması KMS API çağrıları için küçük bir ücrete neden olur. Fiyatlandırma hakkında daha fazla bilgi için bkz. KMS pricing.

    Bölgeler arası çoğaltma sırasında hedef paketin varsayılan sunucu tarafı şifrelemesi etkinleştirilmişse ve çoğaltma kuralı bir ReplicaCMKID ile yapılandırılmışsa aşağıdaki durumlar geçerlidir:

    • Kaynak paketteki bir nesne şifrelenmemişse nesne çoğaltıldıktan sonra hedef paketin varsayılan şifreleme yöntemi kullanılarak şifrelenir.

    • Kaynak paketteki bir nesne SSE-KMS veya SSE-OSS kullanılarak şifrelenmişse nesne hedef pakette orijinal şifreleme yöntemini korur.

    Daha fazla bilgi için bkz. Cross-region replication with server-side encryption.

    x-oss-server-side-encryption-key-id

    String

    No

    9468da86-3509-4f8d-a61e-6eab1eac****

    KMS anahtarının kimliği. Bu üstbilgi yalnızca x-oss-server-side-encryption KMS olarak ayarlandığında gereklidir. Diğer durumlarda bu üstbilgi boş olmalıdır.

    If you use OSS on CloudBox, this parameter is not supported.

    Bu işlem ortak istek üstbilgilerini de içerir. Daha fazla bilgi için bkz. Common request headers.

    İstek öğeleri

    Name

    Type

    Required

    Example

    Description

    StorageClass

    String

    No

    Standard

    Paketin depolama sınıfı. Geçerli değerler:

    • Standard (varsayılan)

    • IA: Infrequent Access

    • Archive: Archive Storage

    • ColdArchive: Cold Archive

    • DeepColdArchive: Deep Cold Archive

    Üst düğüm: CreateBucketConfiguration

    Alt düğümler: Yok

    DataRedundancyType

    String

    No

    LRS

    Paketin veri yedeklilik türü. Geçerli değerler:

    • LRS (varsayılan)

      Yerel olarak yedekli depolama (LRS), verilerinizin kopyalarını aynı alan içindeki farklı depolama cihazlarında saklar. Bu sayede iki depolama cihazı aynı anda hasar görse bile verilerin dayanıklılığı ve kullanılabilirliği sağlanır.

    • ZRS

      Alana göre yedekli depolama (ZRS) uses a data redundancy mechanism within multiple zones. ZRS stores the data of an object across multiple zones in the same region. If a zone becomes unavailable, you can still access the data.

    Üst düğüm: CreateBucketConfiguration

    Alt düğümler: Yok

    Yanıt üstbilgileri


    Name


    Type


    Example


    Description


    Location


    String


    /oss-example

    Paketin adresi. Değer, bir eğik çizgi (/) ve ardından paket adından oluşur.

    Varsayılan değer: Yok

    Yanıt ayrıca ortak yanıt üstbilgilerini de içerir. Daha fazla bilgi için bkz. Common response headers.

    Örnekler

    • Varsayılan kaynak grubunda bir paket oluşturun

      PUT / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 03:15:40 GMT
x-oss-acl: private
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>    
</CreateBucketConfiguration>

    • Örnek yanıt

      HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
Location: /oss-example

    • Belirli bir kaynak grubunda bir paket oluşturun

      Örnek istek

      PUT / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 03:15:40 GMT
x-oss-acl: private
x-oss-resource-group-id: rg-aek27tc********
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<CreateBucketConfiguration>
    <StorageClass>Standard</StorageClass>
</CreateBucketConfiguration>

      Örnek yanıt

      HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri, 24 Feb 2017 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
Location: /oss-example

    SDK

    PutBucket işlemini aşağıdaki programlama dilleri için OSS SDK'larını kullanarak çağırabilirsiniz:

    ossutil komut satırı aracı

    PutBucket işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. put-bucket.

    Hata kodları

    Error code

    HTTP status code

    Description

    InvalidBucketName

    400

    Paket adı adlandırma kurallarına uymuyor.

    AccessDenied

    403

    Hatanın olası nedenleri şunlardır:

    • PutBucket isteğine kullanıcı kimlik doğrulama bilgileri dahil edilmemiş.

    • Gerekli izinlere sahip değilsiniz.

    TooManyBuckets

    400

    Oluşturulan paket sayısı üst sınırı aşıyor. Bir Alibaba Cloud hesabı aynı bölgede en fazla 100 paket oluşturabilir.

    BucketAlreadyExists

    409

    • Bir paket silindiyse aynı ada sahip bir paket oluşturma için gereken süre koşulu karşılanmıyor.

      Kısa süre önce silinen bir paket tarafından kullanılan ada sahip bir paket oluşturmaya çalışıyorsunuz. Bir paket silindikten sonra aynı ada sahip bir paket oluşturmadan önce birkaç saat (genellikle 4 ila 8 saat) beklemeniz gerekir.

    • Mevcut bir paketle aynı ada sahip bir paket oluşturmak için RAM kullanıcısı veya STS gibi yöntemler kullanarak PutBucket işlemini çağırıyorsunuz.

      Aynı ada sahip bir paketi yalnızca orijinal Alibaba Cloud hesabı yeniden oluşturabilir.

    • PutBucketAcl işlemini çağırma izniniz yok. Çağrı yapan kişinin bir paket ilkesi veya RAM ilkesi kullanılarak oss:PutBucketAcl izniyle yetkilendirildiğinden emin olun.

    • Mevcut bir paketin hiyerarşik ad alanı durumunu değiştirmeye çalışıyorsunuz. Hiyerarşik ad alanı özelliğini yalnızca paket oluştururken etkinleştirebilirsiniz.