Object Storage Service:PutBucketRequestPayment

使用上の注意

バケットのリクエスタ支払いを設定する際は、次の点にご注意ください。

• 匿名ユーザーからのアクセスの拒否

  バケットのリクエスタ支払いを有効にすると、匿名ユーザーはそのバケットにアクセスできなくなります。OSS がリクエスタを識別し、リクエストとトラフィックに対して課金するために、リクエスタは認証情報を提供する必要があります。

  リクエスタが Alibaba Cloud アカウントの RAM ロールを引き受けてデータをリクエストした場合、OSS はそのリクエスタが送信したリクエストと生成されたトラフィックに対して、この Alibaba Cloud アカウントに課金します。

• リクエストでの x-oss-request-payer ヘッダーの指定

  バケットのリクエスタ支払いを有効にした場合、リクエスタは POST、GET、または HEAD リクエストで x-oss-request-payer:requester ヘッダーを指定する必要があります。このヘッダーは、リクエストとダウンロードされたデータに対して課金されることをリクエスタが理解している旨を示します。リクエスタ支払いが有効になっているバケットに送信されるリクエストにおいて、リクエスタが x-oss-request-payer ヘッダーを指定しない場合、そのリクエストは認証に失敗します。

  バケット所有者は、自身のバケットにアクセスするために送信するリクエストで x-oss-request-payer ヘッダーを指定する必要はありません。この場合、バケット所有者が送信したリクエストと、それによって生成されたトラフィックに対しては、バケット所有者に課金されます。

リクエスト構造

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>

リクエストヘッダー

PutBucketRequestPayment リクエストには、共通リクエストヘッダーのみが含まれます。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエスト要素

レスポンスヘッダー

PutBucketRequestPayment リクエストのレスポンスには、共通レスポンスヘッダーのみが含まれます。詳細については、「共通レスポンスヘッダー」をご参照ください。

例

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: Thu, 17 Apr 2025 01:33:47 GMT

OSS SDK

ossutil

PutBucketRequestPayment API に対応する ossutil コマンドの詳細については、「put-bucket-request-payment」をご参照ください。

エラーコード