全部产品
Search
文档中心

Object Storage Service:PutBucketRequestPayment

更新时间:Jul 02, 2025

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:

  • BucketOwner: biaya permintaan dan lalu lintas dibayar oleh pemilik bucket.

  • Requester: biaya permintaan dan lalu lintas dibayar oleh pemohon.

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 GMT

SDK

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

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.