全部產品
Search
文件中心

Object Storage Service:put-bucket-request-payment

更新時間:Sep 18, 2024

put-bucket-request-payment用於設定某個儲存空間(Bucket)的要求者付費模式。

注意事項

  • 阿里雲帳號預設擁有配置Bucket的要求者付費模式的許可權。如果您需要通過RAM使用者或者STS的方式進行添加修改,您必須擁有oss:PutBucketRequestPayment許可權。具體操作,請參見為RAM使用者授權自訂的權限原則

  • 如果您在Bucket上啟用了要求者付費模式,則不允許匿名訪問該Bucket。請求方必須提供身分識別驗證資訊,以便OSS能夠識別請求方,從而對請求方而非Bucket擁有者收取請求所產生的費用。當要求者是通過扮演阿里雲RAM角色來請求資料時,該角色所屬的賬戶將為此請求付費。

  • 如果您在Bucket上啟用了要求者付費模式,請求方必須在其請求中包含x-oss-request-payer:requester(在POST、GET和HEAD請求的Header資訊中),以表明請求方已知悉請求和資料下載將產生費用。否則,請求方無法通過驗證。資料擁有者訪問該Bucket時,可以不攜帶x-oss-request-payer要求標頭。資料擁有者作為要求者訪問該Bucket時,請求產生的費用由資料擁有者(也是要求者)來支付。

命令格式

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

參數

類型

說明

--bucket

string

Bucket的名稱。

--request-payment-configuration

string

請求付費配置的容器。

說明

put-bucket-request-payment命令對應API介面PutBucketRequestPayment。關於API中的具體參數含義,請參見PutBucketRequestPayment

--request-payment-configuration

--request-payment-configuration配置選項既支援XML文法也支援JSON文法,當選項值包含file://首碼時,表示從檔案中讀取配置。

  • XML文法:

    <RequestPaymentConfiguration>
      <Payer>string</Payer>
    </RequestPaymentConfiguration>
  • JSON文法:

    {
      "Payer": "string"
    }
說明

關於支援的全域命令列選項,請參見支援的全域命令列選項

使用樣本

以下樣本展示了如何為儲存空間examplebucket佈建要求者付費模式。

  • 使用XML設定檔,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
  • 使用JSON設定檔,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\"}"