PutBucketTransferAcceleration - Object Storage Service

Operasi ini digunakan untuk mengonfigurasi percepatan transfer pada sebuah bucket. Setelah diaktifkan, pengguna global dapat mengakses objek dengan lebih cepat. Fitur ini ideal untuk skenario yang melibatkan transfer data jarak jauh serta untuk mengunduh atau mengunggah objek berukuran gigabyte hingga terabyte.

Catatan penggunaan

Setelah mengaktifkan percepatan transfer, Anda dapat menggunakan titik akhir percepatan selain titik akhir default untuk mengakses bucket. Kecepatan akses hanya ditingkatkan saat menggunakan titik akhir percepatan.
Penggunaan titik akhir percepatan akan dikenakan biaya tambahan. Untuk detail lebih lanjut, lihat Biaya Percepatan Transfer.

Untuk informasi lebih lanjut tentang fitur ini, lihat Percepatan Transfer.

Izin

Secara default, akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API	Aksi	Definisi
PutBucketTransferAcceleration	oss:PutBucketTransferAcceleration	Mengonfigurasi percepatan transfer untuk sebuah bucket.

Struktur permintaan

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

Parameter permintaan

Parameter

Tipe

Diperlukan

Contoh

Deskripsi

TransferAccelerationConfiguration

Container

N/A

Kontainer yang digunakan untuk menyimpan konfigurasi percepatan transfer.

Enabled

String

true

Menentukan apakah akan mengaktifkan percepatan transfer untuk bucket. Nilai valid:

true: menunjukkan bahwa permintaan dikirim untuk mengaktifkan percepatan transfer untuk bucket.
false: menunjukkan bahwa permintaan dikirim untuk menonaktifkan percepatan transfer untuk bucket.

Penting

Percepatan transfer mulai berlaku dalam waktu 30 menit setelah diaktifkan.

Untuk informasi lebih lanjut tentang header permintaan umum seperti Authorization dan Content-Length, lihat Header Permintaan Umum.

Header respons

Semua header dalam respons terhadap permintaan PutBucketTransferAcceleration adalah header respons umum, seperti x-oss-request-id dan Date. Untuk detail lebih lanjut, lihat Header Respons Umum.

Contoh

Contoh Permintaan

Berikut adalah contoh permintaan untuk mengaktifkan percepatan transfer pada bucket bernama examplebucket:

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>

Contoh Respons

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 SDKs

Anda dapat menggunakan OSS SDK berikut untuk memanggil operasi PutBucketTransferAcceleration:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketTransferAcceleration, lihat put-bucket-transfer-acceleration.

Kode kesalahan

Kode kesalahan	Status HTTP	Deskripsi
AccessDenied	404	Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk melakukan operasi PutBucketTransferAcceleration. Hanya pengguna yang diberikan izin oss:PutBucketTransferAcceleration yang dapat mengonfigurasi percepatan transfer untuk bucket.
MalformedXML	400	Pesan kesalahan yang dikembalikan karena permintaan tidak dalam format XML yang valid. Sebagai contoh, bidang Enabled dalam permintaan diatur ke nilai selain true atau false.