Object Storage Service:put-bucket-request-payment

使用上の注意

• デフォルトでは、Alibaba Cloudアカウントには、バケットのpay-By-requesterを有効にする権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してバケットのpay-by-requesterを有効にするには、oss:PutBucketRequestPayment権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

• バケットのpay-by-requesterを有効にすると、匿名ユーザーはバケットにアクセスできません。 リクエスターは認証情報を提供する必要があります。 OSSは、指定された情報に基づいてリクエスタを識別できます。 このように、要求者は要求およびトラフィック料金を請求される。 要求者がAlibaba CloudアカウントのRAMユーザーを使用してデータを要求する場合、RAMユーザーが属するAlibaba Cloudアカウントは、要求者から送信された要求と生成されたトラフィックに対して課金されます。

• バケットのpay-by-requesterを有効にする場合、リクエスターはPOST、GET、またはHEADリクエストでx-oss-request-payer:requesterヘッダーを指定する必要があります。 このヘッダーは、要求者が要求とダウンロードされたデータに対して課金されることを理解していることを示します。 それ以外の場合、リクエストは認証できません。 バケット所有者は、バケットにアクセスするために送信されるリクエストにx-oss-request-payerヘッダーを指定する必要はありません。 バケット所有者がバケットにアクセスすると、バケット所有者にはリクエスト料金とトラフィック料金が課金されます。

コマンド構文

ossutil api put-bucket-request-payment --bucket value --request-payment-configuration value [flags]

-- request-payment-configuration

-- request-payment-configuration設定オプションは、XML形式とJSON形式の両方をサポートします。 オプションの値にfile:// プレフィックスが含まれている場合、設定は設定ファイルから読み取られます。

• XML 形式：

  <RequestPaymentConfiguration>
    <Payer>string</Payer>
  </RequestPaymentConfiguration>

• JSON 形式：

  {
    "Payer": "string"
  }

例

次の例は、examplebucketという名前のバケットに対してpay-by-requesterを有効にする方法を示しています。

• request-payment-configuration.xmlという名前の構成ファイルを作成し、次のコードを構成ファイルに追加します。

  <?xml version="1.0" encoding="UTF-8"?>
  <RequestPaymentConfiguration>
    <Payer>Requester</Payer>
  </RequestPaymentConfiguration>

  サンプルコマンド:

  ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration file://request-payment-configuration.xml

• request-payment-configuration.jsonという名前の構成ファイルを作成し、次のコードを構成ファイルに追加します。

  {
    "Payer": "Requester"
  }

  サンプルコマンド:

  ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration file://request-payment-configuration.json

• 次のコマンドでパラメーターをJSON形式で設定します。

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