Definir pagamentos do solicitante do bucket

Por padrão, os buckets não têm o recurso Pagamentos do solicitante ativado. Para ativar ou desativar Pagamentos do solicitante para um bucket existente, faça uma solicitação PUT com escopo para o bucket e use o parâmetro de string de consulta billing. Você precisa incluir um documento XML no corpo da solicitação que indique se você quer ativar ou desativar o recurso. Não é possível definir o Pagamentos do solicitante em um novo bucket que você está criando.

Você precisa ter a permissão storage.buckets.update para ativar ou desativar Pagamentos do solicitante em um bucket atual.

Parâmetros de string de consulta

Parâmetro Descrição Obrigatório
billing Usado ao ativar ou desativar Pagamentos do solicitante para um bucket. Se usado em uma solicitação PUT do bucket, o corpo da solicitação precisará especificar o status ativado ou desativado. Não

Consulte parâmetros de string de consulta de URL assinado para informações sobre os parâmetros incluídos ao criar e usar URLs assinados.

Cabeçalhos de solicitação

Veja cabeçalhos de solicitação comuns.

Elementos do corpo da solicitação

Os elementos do corpo da solicitação a seguir serão aplicáveis somente se você usar o parâmetro de string de consulta billing para ativar ou desativar Pagamentos do solicitante em um bucket atual.

Element Descrição
BillingConfiguration O contêiner de RequesterPayments.
RequesterPays O status a ser aplicado ao recurso Pagamentos do solicitante. Os valores aceitos são Enabled e Disabled.

Sintaxe da solicitação

PUT /?billing HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Authorization: AUTHENTICATION_STRING

<?xml version="1.0" encoding="UTF-8"?>
<BillingConfiguration>
  <RequesterPays>
     Enabled | Disabled
  </RequesterPays>
</BillingConfiguration>

Cabeçalhos de resposta

A solicitação pode retornar diversos cabeçalhos de resposta, dependendo dos cabeçalhos de solicitação usados.

Elementos do corpo da resposta

A resposta não inclui um documento XML no corpo da resposta.

Exemplo

O exemplo a seguir ativa Pagamentos do solicitante para um bucket chamado my-bucket.

Solicitação

PUT /?billing HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Thu, 12 Mar 2012 03:38:42 GMT
Content-Length: 121
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<BillingConfiguration>
  <RequesterPays>Enabled</RequesterPays>
</BillingConfiguration>

Resposta

HTTP/1.1 200 OK
Date: Thu, 12 Mar 2012 03:38:42 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 0
Content-Type: text/html