Mengaktifkan pembayaran-per-permintaan pada sebuah bucket.
Catatan penggunaan
Secara default, akun Alibaba Cloud memiliki izin untuk mengaktifkan pembayaran-per-permintaan pada sebuah bucket. Untuk mengaktifkannya menggunakan RAM user atau Security Token Service (STS), Anda memerlukan izin
oss:PutBucketRequestPayment. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke RAM user.Setelah pembayaran-per-permintaan diaktifkan, pengguna anonim tidak dapat mengakses bucket tersebut. Pemohon harus menyertakan informasi autentikasi. OSS akan mengidentifikasi pemohon berdasarkan informasi yang diberikan dan menagih biaya permintaan serta lalu lintas kepada pemohon. Jika pemohon menggunakan RAM user dari akun Alibaba Cloud, akun induk RAM user tersebut akan dikenakan biaya atas permintaan dan lalu lintas yang dihasilkan.
Saat pembayaran-per-permintaan diaktifkan, pemohon harus menentukan header x-oss-request-payer:requester dalam permintaan POST, GET, atau HEAD. Header ini menunjukkan bahwa pemohon memahami mereka bertanggung jawab atas biaya permintaan dan data yang diunduh. Jika tidak, permintaan tidak dapat diautentikasi. Pemilik bucket tidak perlu menentukan header ini saat mengakses bucket. Pemilik bucket tetap dikenakan biaya untuk permintaan dan lalu lintas yang dihasilkan.
Sintaksis perintah
ossutil api put-bucket-request-payment --bucket value --request-payment-configuration value [flags]Parameter | Tipe | Deskripsi |
--bucket | string | Nama bucket. |
--request-payment-configuration | string | Kontainer yang menyimpan konfigurasi pembayaran-per-permintaan. |
Perintah put-bucket-request-payment sesuai dengan operasi PutBucketRequestPayment. Untuk detail parameter dalam operasi PutBucketRequestPayment, lihat PutBucketRequestPayment.
--request-payment-configuration
Opsi konfigurasi --request-payment-configuration mendukung format XML dan JSON. Jika nilai opsi tersebut mencakup awalan file://, konfigurasi akan dibaca dari file konfigurasi.
Format XML:
<RequestPaymentConfiguration> <Payer>string</Payer> </RequestPaymentConfiguration>Format JSON:
{ "Payer": "string" }
Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah Global.
Contoh
Contoh berikut menunjukkan cara mengaktifkan pembayaran-per-permintaan pada bucket bernama examplebucket.
Buat file konfigurasi bernama request-payment-configuration.xml dan tambahkan kode berikut ke file konfigurasi:
<?xml version="1.0" encoding="UTF-8"?> <RequestPaymentConfiguration> <Payer>Requester</Payer> </RequestPaymentConfiguration>Contoh perintah:
ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration file://request-payment-configuration.xmlBuat file konfigurasi bernama request-payment-configuration.json dan tambahkan kode berikut ke file konfigurasi:
{ "Payer": "Requester" }Contoh perintah:
ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration file://request-payment-configuration.jsonKonfigurasikan parameter dalam perintah berikut dalam format JSON:
ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration "{\"Payer\":\"Requester\"}"