Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:PutBucketTransferAcceleration

Son Güncelleme:Oct 01, 2026

Bir paket için transfer hızlandırmayı yapılandırır. Transfer hızlandırma etkinleştirildiğinde, dünya çapındaki kullanıcılar nesnelere daha hızlı erişebilir. Bu özellik; uzun mesafeli veri aktarımı ile gigabayt veya terabayt boyutundaki büyük nesnelerin yüklenmesi ve indirilmesi senaryoları için uygundur.

Kullanım notları

  • Bir paket için transfer hızlandırmayı etkinleştirdiğinizde, varsayılan uç noktaya ek olarak bir hızlandırma uç noktası kullanılabilir hale gelir. Erişim hızı yalnızca hızlandırma uç noktasını kullandığınızda artar.

  • Hızlandırma uç noktasını kullanarak bir pakete eriştiğinizde transfer hızlandırma ücretleri yansıtılır. Daha fazla bilgi için bkz. Transfer hızlandırma ücretleri.

Transfer hızlandırma hakkında daha fazla bilgi için bkz. Transfer hızlandırma kullanarak OSS'e erişim.

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tam yetkilere sahiptir. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rolleri varsayılan olarak herhangi bir izne sahip değildir. Alibaba Cloud hesabı veya hesap yöneticisi, işlem izinlerini RAM ilkeleri veya Paket İlkesi aracılığıyla vermelidir.


API


Eylem


Açıklama


PutBucketTransferAcceleration


oss:PutBucketTransferAcceleration


Bir paket için transfer hızlandırmayı yapılandırır.

İstek yapısı

PUT /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

İstek parametreleri

Parametre

Tür

Zorunlu

Örnek

Açıklama

TransferAccelerationConfiguration

Konteyner

Evet

Yok

Transfer hızlandırma yapılandırmasını depolayan konteyner.

Enabled

Dize

Evet

true

Paket için transfer hızlandırmanın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Paket için transfer hızlandırmayı etkinleştirir.

  • false: Paket için transfer hızlandırmayı devre dışı bırakır.

Önemli

Transfer hızlandırma, etkinleştirildikten sonra 30 dakika içinde kullanıma hazır hale gelir.

PutBucketTransferAcceleration isteklerinde Authorization ve Content-Length gibi ortak istek üstbilgileri hakkında daha fazla bilgi için bkz. Ortak istek üstbilgileri.

Yanıt üstbilgileri

Yanıt, x-oss-request-id ve Date gibi yalnızca ortak yanıt üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Örnekler

  • Örnek istekler

    Aşağıdaki istek, examplebucket adlı bir paket için transfer hızlandırmayı etkinleştirir:

    PUT /?transferAcceleration HTTP/1.1
    Date: Fri, 30 Apr 2021 13:08:38 GMT
    Content-Length: 443
    Content-Type: application/xml
    Host: examplebucket.oss.aliyuncs.com
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    <TransferAccelerationConfiguration>
      <Enabled>true</Enabled>
    </TransferAccelerationConfiguration>
  • Örnek yanıtlar

    HTTP/1.1 200 OK
    x-oss-request-id: 534B371674A4D890****
    Date: Thu, 17 Apr 2025 13:08:38 GMT
    Content-Length: 443
    Connection: keep-alive
    Server: AliyunOSS

OSS SDK'ları

Bu işlemi çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz:

ossutil

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

Hata kodları


Hata kodu


HTTP durum kodu


Açıklama


AccessDenied


404


MalformedXML


400


İstek gövdesi geçerli bir XML değil. Örneğin, Enabled alanı true veya false dışında bir değere ayarlanmış.