全部产品
Search
文档中心

Object Storage Service:put-bucket-request-payment

更新时间:Jul 02, 2025

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.

Catatan

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"
    }
Catatan

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.xml
  • Buat 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.json
  • Konfigurasikan parameter dalam perintah berikut dalam format JSON:

    ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration "{\"Payer\":\"Requester\"}"