Object Storage Service:PutBucketRequestPayment

Observações de uso

Ao configurar o pagamento por solicitante em um bucket, observe os seguintes pontos:

• Rejeição de acesso de usuários anônimos

  Se você ative o pagamento por solicitante em um bucket, usuários anônimos não poderão acessá-lo. Os solicitantes devem fornecer informações de autenticação ao OSS para que o serviço identifique e cobre as requisições e o tráfego gerado.

  Caso um solicitante assuma uma função RAM de uma conta Alibaba Cloud para solicitar dados, o OSS cobrará dessa conta pelas requisições enviadas e pelo tráfego gerado.

• Especificação obrigatória do cabeçalho x-oss-request-payer

  Quando o pagamento por solicitante estiver ativo em um bucket, os solicitantes precisam especifique o cabeçalho x-oss-request-payer:requester nas requisições POST, GET ou HEAD. Esse cabeçalho indica que os solicitantes concordam em pagar pelas requisições e pelos dados baixados. Se o cabeçalho x-oss-request-payer não for especificado em requisições enviadas a um bucket com pagamento por solicitante ativado, a autenticação falhará.

  Proprietários do bucket não precisam especifique o cabeçalho x-oss-request-payer ao acessar seus próprios buckets. Nesse cenário, os proprietários arcam com os custos das requisições que enviam e do tráfego correspondente.

Estrutura da requisição

PUT /?requestPayment HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<RequestPaymentConfiguration>
  <Payer>Requester</Payer>
</RequestPaymentConfiguration>

Cabeçalhos da requisição

As requisições PutBucketRequestPayment contêm apenas cabeçalhos comuns. Para mais informações, consulte Common request headers.

Elementos da requisição

Cabeçalhos da resposta

As respostas para requisições PutBucketRequestPayment contêm apenas cabeçalhos comuns. Para mais informações, consulte Common response headers.

Exemplos

PUT /?requestPayment
Content-Length: 83
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 01:33:47 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<RequestPaymentConfiguration>
  <Payer>Requester</Payer>
</RequestPaymentConfiguration>

200 (OK)
content-length: 0
x-oss-request-id: 5D3663FBB007B79097FC****
date: Tue, 23 Jul 2019 01:33:47 GMT

SDKs do OSS

ossutil

Para obter detalhes sobre o comando do ossutil correspondente à operação PutBucketRequestPayment, consulte put-bucket-request-payment.

Códigos de erro