Object Storage Service:PutBucketRequestPayment

Catatan penggunaan

Perhatikan hal-hal berikut saat mengonfigurasi bayar-per-permintaan untuk bucket:

• Akses dari pengguna anonim ditolak

  Jika Anda mengaktifkan bayar-per-permintaan untuk bucket, pengguna anonim tidak diizinkan mengakses bucket tersebut. Pemohon harus menyediakan informasi autentikasi kepada OSS agar OSS dapat mengidentifikasi dan menagih pemohon atas permintaan serta lalu lintas yang dihasilkan.

  Jika pemohon mengasumsikan peran RAM dari Akun Alibaba Cloud untuk meminta data, OSS akan menagih Akun Alibaba Cloud tersebut atas permintaan dan lalu lintas yang dihasilkan oleh pemohon.

• Pemohon harus menentukan header x-oss-request-payer dalam permintaan

  Jika Anda mengaktifkan bayar-per-permintaan untuk bucket, pemohon harus menyertakan header x-oss-request-payer:requester dalam permintaan POST, GET, atau HEAD. Header ini menunjukkan bahwa pemohon memahami bahwa mereka akan dikenai biaya atas permintaan dan data yang diunduh. Jika header x-oss-request-payer tidak disertakan dalam permintaan ke bucket dengan bayar-per-permintaan yang diaktifkan, permintaan tersebut gagal melewati autentikasi.

  Pemilik bucket tidak perlu menyertakan header x-oss-request-payer saat mengakses bucket milik mereka. Dalam hal ini, pemilik bucket akan dikenai biaya atas permintaan 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 berisi header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Elemen permintaan

Header respons

Respons untuk permintaan PutBucketRequestPayment hanya berisi header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

Contoh

PUT /?requestPayment
Content-Length: 83
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 01:33:47 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<RequestPaymentConfiguration>
  <Payer>Requester</Payer>
</RequestPaymentConfiguration>

200 (OK)
content-length: 0
x-oss-request-id: 5D3663FBB007B79097FC****
date: Tue, 23 Jul 2019 01:33:47 GMT

OSS SDK

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi PutBucketRequestPayment, lihat put-bucket-request-payment.

Kode error