GetBucketTransferAcceleration - Object Storage Service

Operasi ini digunakan untuk menanyakan konfigurasi akselerasi transfer suatu bucket.

Catatan penggunaan

Hanya pemilik bucket atau pengguna RAM dengan izin oss:PutBucketTransferAcceleration yang dapat mengirimkan permintaan untuk menanyakan konfigurasi akselerasi transfer bucket.
Jika akselerasi transfer tidak dikonfigurasikan untuk bucket tempat permintaan GetBucketTransferAcceleration dikirim, maka tidak ada konfigurasi yang akan dikembalikan.

Untuk informasi lebih lanjut tentang akselerasi transfer, lihat Akselerasi Transfer di Panduan Pengembang.

Struktur permintaan

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

Parameter respons

Parameter

Tipe

Contoh

Deskripsi

TransferAccelerationConfiguration

Container

N/A

Kontainer yang digunakan untuk menyimpan konfigurasi akselerasi transfer.

Enabled

String

true

Status akselerasi transfer Nilai valid:

true: menunjukkan bahwa akselerasi transfer diaktifkan untuk bucket tersebut.
false: menunjukkan bahwa akselerasi transfer dinonaktifkan untuk bucket tersebut.

Untuk informasi lebih lanjut tentang header respons umum lainnya, seperti x-oss-request-id dan Date, yang terkandung dalam respons terhadap permintaan GetBucketTransferAcceleration, lihat Header Respons Umum.

Contoh

Permintaan Contoh

Permintaan berikut digunakan untuk menanyakan status akselerasi transfer dari bucket bernama examplebucket:

GET /?transferAcceleration HTTP/1.1
Date: Thu, 17 Apr 2025 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

Respons Contoh

Respons berikut menunjukkan bahwa akselerasi transfer diaktifkan untuk examplebucket:

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Fri , 30 Apr 2021 13:08:38 GMT
<TransferAccelerationConfiguration>
 <Enabled>true</Enabled>
</TransferAccelerationConfiguration>

SDK OSS

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil GetBucketTransferAcceleration:

ossutil

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

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
NoSuchTransferAccelerationConfiguration	404	Pesan kesalahan yang dikembalikan karena akselerasi transfer tidak dikonfigurasikan untuk bucket tersebut.