Use esta operação para ativar o pagamento por solicitante em um bucket.
Observações de uso
Ao ativar o pagamento por solicitante em um bucket, considere os seguintes pontos:
-
Rejeição de acesso de usuários anônimos
Se você ativar 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 possa identificá-los e cobrar as solicitaçõ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 as solicitações enviadas e o tráfego gerado.
-
Especificação obrigatória do cabeçalho x-oss-request-payer
Com o pagamento por solicitante ativado no bucket, especifique o cabeçalho x-oss-request-payer:requester nas solicitações POST, GET ou HEAD. Esse cabeçalho indica que os solicitantes concordam em pagar pelas solicitações e pelos dados baixados. Se o cabeçalho x-oss-request-payer não for especificado em solicitações enviadas a um bucket com esse recurso ativado, a autenticação falhará.
Proprietários do bucket não precisam especificar o cabeçalho x-oss-request-payer ao acessar seus próprios buckets. Nesse cenário, os proprietários pagam pelas solicitações que enviam e pelo tráfego resultante.
Estrutura da solicitaçã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 solicitação
As solicitações PutBucketRequestPayment contêm apenas cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de solicitação.
Elementos da solicitação
Elemento | Tipo | Obrigatório | Descrição |
RequestPaymentConfiguration | Contêiner | Sim | Contêiner que armazena as configurações de pagamento por solicitante. Nó filho: Payer |
Payer | String | Sim | Define quem paga as taxas de solicitação e tráfego. Valores válidos:
Nó pai: RequestPaymentConfiguration |
Cabeçalhos da resposta
As respostas para solicitações PutBucketRequestPayment contêm apenas cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.
Exemplos
Exemplo de solicitação
PUT /? requestPayment
Content-Length: 83
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 23 Jul 2019 01:33:47 GMT
Authorization: OSS qn6q**************:77Dv****************
<RequestPaymentConfiguration>
<Payer>Requester</Payer>
</RequestPaymentConfiguration>Exemplo de resposta
200 (OK)
content-length: 0
x-oss-request-id: 5D3663FBB007B79097FC****
date: Tue, 23 Jul 2019 01:33:47 GMTSDK
Use os SDKs do OSS nas linguagens de programação a seguir para chamar a operação PutBucketRequestPayment:
ossutil
Para obter detalhes sobre o comando do ossutil correspondente à operação PutBucketRequestPayment, consulte put-bucket-request-payment.
Códigos de erro
|
Código de erro |
Código de status HTTP |
Descrição |
|
NoSuchBucket |
404 |
O bucket especificado não existe. |