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\"}"