Quando o pagamento pelo solicitante é ativado para um bucket, o solicitante paga as taxas de requisição e tráfego, e o proprietário do bucket paga apenas os custos de armazenamento. Esse recurso é útil para compartilhar dados sem gerar taxas adicionais de requisição e tráfego.
Observações de uso
O código de exemplo neste tópico usa o ID da região
cn-hangzhouda região China (Hangzhou) e o endpoint público. Para acessar o OSS a partir de outros services da Alibaba Cloud na mesma região, use o endpoint interno. Para obter mais informações sobre as regiões e endpoints do OSS, consulte Regions and endpoints.Neste tópico, as credenciais de acesso são obtidas a partir de variáveis de ambiente. Para obter mais informações, consulte Configure access credentials.
Para ativar o pagamento pelo solicitante, você deve ter a permissão
oss:PutBucketRequestPayment. Para consultar as configurações de pagamento pelo solicitante, você deve ter a permissãooss:GetBucketRequestPayment. Para obter mais informações, consulte Common examples of RAM policies.
Método
Ative o pagamento pelo solicitante para um bucket
func (c *Client) PutBucketRequestPayment(ctx context.Context, request *PutBucketRequestPaymentRequest, optFns ...func(*Options)) (*PutBucketRequestPaymentResult, error)
Consulte as configurações de pagamento pelo solicitante de um bucket
func (c *Client) GetBucketRequestPayment(ctx context.Context, request *GetBucketRequestPaymentRequest, optFns ...func(*Options)) (*GetBucketRequestPaymentResult, error)
Parâmetros da requisição
|
Parâmetro |
Tipo |
Descrição |
|
ctx |
context.Context |
O contexto da requisição. Com ele, especifique a duração total da requisição. |
|
request |
*PutBucketRequestPaymentRequest |
Os parâmetros da requisição. Para obter mais informações, consulte PutBucketRequestPaymentRequest. |
|
*GetBucketRequestPaymentRequest |
Os parâmetros da requisição. Para obter mais informações, consulte GetBucketRequestPaymentRequest. |
|
|
optFns |
...func(*Options) |
Opcional. Parâmetros no nível da operação. Para obter mais informações, consulte Options. |
Parâmetros de resposta
|
Parâmetro de resposta |
Tipo |
Descrição |
|
result |
*PutBucketRequestPaymentResult |
A resposta. Válido quando err é nil. Para obter mais informações, consulte PutBucketRequestPaymentResult. |
|
*GetBucketRequestPaymentResult |
A resposta. Válido quando err é nil. Para obter mais informações, consulte GetBucketRequestPaymentResult. |
|
|
err |
error |
A mensagem de erro. Um valor não nil indica que a requisição falhou. |
Exemplos
Ative o pagamento pelo solicitante
Consulte as configurações de pagamento pelo solicitante de um bucket
Referências
Para o código de exemplo completo para ativar o pagamento pelo solicitante, visite o GitHub.
Para a referência da API para ativar o pagamento pelo solicitante, visite PutBucketRequestPayment.
Para o código de exemplo completo para consultar as configurações de pagamento pelo solicitante de um bucket, visite o GitHub.
Para a referência da API para consultar as configurações de pagamento pelo solicitante, visite GetBucketRequestPayment.