Operasi ini digunakan untuk mengaktifkan pembayaran-per-permintaan pada sebuah bucket.
Catatan penggunaan
Perhatikan hal-hal berikut saat mengaktifkan pembayaran-per-permintaan untuk sebuah bucket:
Akses dari pengguna anonim ditolak
Jika pembayaran-per-permintaan diaktifkan untuk sebuah bucket, pengguna anonim tidak diizinkan mengakses bucket tersebut. Pemohon harus menyertakan informasi autentikasi kepada OSS agar OSS dapat mengidentifikasi dan menagih pemohon atas permintaan serta lalu lintas yang dihasilkan.
Jika pemohon menggunakan Peran RAM dari akun Alibaba Cloud untuk meminta data, OSS akan menagih akun Alibaba Cloud tersebut atas permintaan yang dikirim oleh pemohon dan lalu lintas yang dihasilkan.
Pemohon harus menentukan header x-oss-request-payer dalam permintaan
Jika pembayaran-per-permintaan diaktifkan untuk sebuah bucket, pemohon harus menentukan header x-oss-request-payer:requester dalam permintaan POST, GET, atau HEAD. Header ini menunjukkan bahwa pemohon memahami bahwa mereka akan dikenakan biaya untuk permintaan dan data yang diunduh. Jika pemohon tidak menentukan header x-oss-request-payer dalam permintaan ke bucket dengan pembayaran-per-permintaan diaktifkan, permintaan tersebut gagal melewati autentikasi.
Pemilik bucket tidak perlu menentukan header x-oss-request-payer dalam permintaan yang dikirim untuk mengakses bucket mereka. Dalam hal ini, pemilik bucket dikenakan biaya untuk permintaan yang dikirim dan lalu lintas yang dihasilkan.
Struktur permintaan
PUT /? requestPayment HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue
<? xml version="1.0" encoding="UTF-8"? >
<RequestPaymentConfiguration>
<Payer>Requester</Payer>
</RequestPaymentConfiguration>Header permintaan
Permintaan PutBucketRequestPayment hanya mencakup header permintaan umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.
Elemen permintaan
Elemen | Tipe | Diperlukan | Deskripsi |
RequestPaymentConfiguration | Container | Ya | Kontainer yang menyimpan konfigurasi pembayaran-per-permintaan. Node anak: Payer |
Payer | String | Ya | Pembayar biaya permintaan dan lalu lintas. Nilai valid:
Node induk: RequestPaymentConfiguration |
Header respons
Respons untuk permintaan PutBucketRequestPayment hanya mencakup header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.
Contoh
Contoh Permintaan
PUT /? requestPayment
Content-Length: 83
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 23 Jul 2019 01:33:47 GMT
Authorization: OSS qn6q**************:77Dv****************
<RequestPaymentConfiguration>
<Payer>Requester</Payer>
</RequestPaymentConfiguration>Contoh Respons
200 (OK)
content-length: 0
x-oss-request-id: 5D3663FBB007B79097FC****
date: Tue, 23 Jul 2019 01:33:47 GMTSDK
ossutil
Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketRequestPayment, lihat put-bucket-request-payment.
Kode kesalahan
Kode kesalahan | Status HTTP | Deskripsi |
NoSuchBucket | 404 | Pesan kesalahan yang dikembalikan karena bucket yang ditentukan tidak ada. |