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 yourAccessKeyID -k yourAccessKeySecret

关于此命令的其他通用选项的更多信息，请参见通用选项。