Todos os produtos
Search
Central de documentação

Object Storage Service:request-payment

Última atualização: Sep 21, 2026

Ao ativar o pagamento pelo solicitante em um bucket, os solicitantes pagam as taxas de requisição e tráfego geradas ao acessar os objetos no bucket. O proprietário do bucket continua responsável pelo pagamento das taxas de armazenamento dos objetos. Para compartilhar seus dados sem precisar pagar pelas requisições de terceiros, use o comando request-payment e ative o pagamento pelo solicitante no seu bucket.

Notas de uso

  • Para ativar o pagamento pelo solicitante em um bucket, é necessário ter a permissão oss:PutBucketRequestPayment. Para consultar as configurações de pagamento pelo solicitante de um bucket, é necessário ter a permissão oss:GetBucketRequestPayment. Para obter mais informações, consulte Grant a custom policy.

  • A partir do ossutil 1.6.16, use ossutil diretamente como o nome do binário na linha de comando. Não é necessário atualizar o nome do binário com base no sistema operacional. Para versões do ossutil anteriores a 1.6.16, atualize o nome do binário de acordo com o sistema operacional. Para saber mais, consulte ossutil command reference.

  • Para obter mais detalhes sobre o pagamento pelo solicitante, consulte Pay-by-requester.

Ative o pagamento pelo solicitante em um bucket

  • Sintaxe do comando

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

    A tabela a seguir descreve os parâmetros do comando.

    Parâmetro

    Descrição

    bucketname

    O nome do bucket no qual você deseja ativar o pagamento pelo solicitante.

    payment

    O método de pagamento para as taxas geradas quando usuários de terceiros acessam dados no bucket.

    Valores válidos:

    • Requester: Os solicitantes pagam as taxas geradas ao acessar objetos no bucket.

      Usuários anônimos não podem acessar um bucket com o pagamento pelo solicitante ativado. Os solicitantes devem fornecer informações de autenticação. O OSS pode identificar os solicitantes com base nas informações fornecidas. Dessa forma, os solicitantes pagam as taxas de requisição e tráfego. Se um solicitante usar um usuário RAM de uma conta Alibaba Cloud para solicitar dados, a conta Alibaba Cloud à qual o usuário RAM pertence pagará as taxas das requisições enviadas e do tráfego gerado.

    • BucketOwner: O proprietário do bucket paga as taxas geradas quando os solicitantes acessam objetos no bucket.

  • Exemplos

    Para ativar o pagamento pelo solicitante em um bucket chamado examplebucket, execute o seguinte comando:

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

    Para desativar o pagamento pelo solicitante em um bucket chamado examplebucket, execute o comando abaixo:

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

    Se uma saída semelhante for exibida, o pagamento pelo solicitante no bucket foi ativado ou desativado.

    0.106852(s) elapsed

Consulte as configurações de pagamento pelo solicitante de um bucket

  • Sintaxe do comando

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

    Na sintaxe, bucketname especifica o bucket cujas configurações de pagamento pelo solicitante você deseja consultar.

  • Exemplos

    Para consultar as configurações de pagamento pelo solicitante de um bucket chamado examplebucket, execute o seguinte comando:

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

    A saída de exemplo a seguir indica que o pagamento pelo solicitante está ativado no bucket:

    Requester
    0.072024(s) elapsed

Opções comuns

Para acessar um bucket em uma região diferente, especifique o endpoint usando -e. Para acessar um bucket pertencente a uma conta Alibaba Cloud diferente, use -i para o AccessKeyID (accesskey id) e -k para o AccessKeySecret (AccessKey).

Por exemplo, para ativar o pagamento pelo solicitante em um bucket chamado testbucket, localizado na região China (Shanghai) e pertencente a outra conta Alibaba Cloud, execute o seguinte comando:

ossutil request-payment --method put oss://testbucket -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Common options.