全部產品
Search
文件中心

Object Storage Service:request-payment(要求者付費)

更新時間:Jul 31, 2024

要求者付費模式是指由要求者支付訪問儲存空間(Bucket)內資料時產生的費用,而Bucket擁有者僅支付儲存費用。當您希望共用資料,但又不希望支付因共用資料產生的額外費用時,您可以使用request-payment命令佈建要求者付費模式。

注意事項

  • 要佈建要求者付費模式,您必須具有oss:PutBucketRequestPayment許可權;要擷取要求者付費模式,您必須具有oss:GetBucketRequestPayment許可權。具體操作,請參見為RAM使用者授權自訂的權限原則

  • 從ossutil 1.6.16版本開始,命令列中Binary名稱支援直接使用ossutil,您無需根據系統重新整理Binary名稱。如果您的ossutil版本低於1.6.16,則需要根據系統重新整理Binary名稱。更多資訊,請參見命令列工具ossutil命令參考

  • 關於要求者付費模式的更多資訊,請參見開啟要求者付費模式

佈建要求者付費模式

  • 命令格式

    ossutil request-payment --method put oss://bucketname payment

    參數說明如下:

    參數

    說明

    bucketname

    填寫待佈建要求者付費模式的目標Bucket名稱。

    payment

    第三方使用者訪問目標Bucket內的資料產生費用時的付費模式。

    取值如下:

    • Requester:訪問此Bucket內的資料產生的所有費用由要求者支付。

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

    • BucketOwner:訪問此Bucket內資源產生的所有費用由Bucket擁有者支付。

  • 使用樣本

    為目標儲存空間examplebucket佈建要求者付費模式。

    ossutil request-payment --method put oss://examplebucket Requester

    為目標儲存空間examplebucket設定Bucket擁有者付費模式。

    ossutil request-payment --method put oss://examplebucket BucketOwner

    以下輸出結果表明已成功佈建要求付費模式。

    0.106852(s) elapsed

擷取要求者付費模式

  • 命令格式

    ossutil request-payment --method get oss://bucketname

    bucketname填寫待擷取要求者付費模式的目標Bucket。

  • 使用樣本

    擷取目標儲存空間examplebucket的要求者付費模式。

    ossutil request-payment --method get oss://examplebucket

    以下輸出結果表明examplebucket已開啟要求者付費模式。

    Requester
    0.072024(s) elapsed

通用選項

當您需要通過命令列工具ossutil切換至另一個地區的Bucket時,可以通過-e選項指定該Bucket所屬的Endpoint。當您需要通過命令列工具ossutil切換至另一個阿里雲帳號下的Bucket時,可以通過-i選項指定該帳號的AccessKey ID,並通過-k選項指定該帳號的AccessKey Secret。

例如您需要為另一個阿里雲帳號下,華東2(上海)地區名為testbucket的儲存空間開啟要求者付費模式,命令如下:

ossutil request-payment --method put oss://testbucket -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****

關於此命令的其他通用選項的更多資訊,請參見通用選項