Object Storage Service:put-bucket-request-payment

Observações de uso

• Por padrão, uma conta Alibaba Cloud tem permissão para ative o pagamento pelo solicitante em um bucket. Para executar essa operação com um usuário RAM ou Security Token Service (STS), você precisa da permissão oss:PutBucketRequestPayment. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.

• Ao ative o pagamento pelo solicitante em um bucket, usuários anônimos perdem o acesso. Os solicitantes devem fornecer informações de autenticação para que o OSS possa identificá-los e cobrar as taxas de requisição e tráfego. Se o solicitante utilizar um usuário RAM, a conta Alibaba Cloud proprietária desse usuário será cobrada pelas requisições e pelo tráfego gerado.

• Quando o pagamento pelo solicitante está ativo, os solicitantes precisam incluir o cabeçalho x-oss-request-payer:requester nas requisições POST, GET ou HEAD para confirmar que serão cobrados pelas requisições e pelos dados baixados. Sem esse cabeçalho, a autenticação das requisições falha. O proprietário do bucket não precisa incluir esse cabeçalho e é cobrado pelas taxas de requisição e tráfego ao acessar o bucket.

Sintaxe do comando

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

--request-payment-configuration

A opção --request-payment-configuration aceita formatos XML e JSON. Se o valor contiver o prefixo file://, o sistema lerá a configuração de um arquivo.

• Formato XML:

  <RequestPaymentConfiguration>
    <Payer>string</Payer>
  </RequestPaymentConfiguration>

• Formato json:

  {
    "Payer": "string"
  }

Exemplos

Ative o pagamento pelo solicitante para um bucket chamado examplebucket.

• Crie um arquivo de configuração chamado request-payment-configuration.xml e adicione o seguinte código:

  <?xml version="1.0" encoding="UTF-8"?>
  <RequestPaymentConfiguration>
    <Payer>Requester</Payer>
  </RequestPaymentConfiguration>

  Comando de exemplo:

  ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration file://request-payment-configuration.xml

• Crie um arquivo de configuração chamado request-payment-configuration.json e adicione o seguinte código:

  {
    "Payer": "Requester"
  }

  Comando de exemplo:

  ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration file://request-payment-configuration.json

• Configure os parâmetros diretamente no comando usando o formato json:

  ossutil api put-bucket-request-payment --bucket examplebucket --request-payment-configuration "{\"Payer\":\"Requester\"}"