A API XML do Cloud Storage usa vários cabeçalhos HTTP padrão, bem como vários cabeçalhos HTTP de extensão (personalizado). Vários métodos HTTP também são compatíveis com parâmetros de string de consulta. Os cabeçalhos e parâmetros são descritos abaixo.
Resumo dos parâmetros de string de consulta e cabeçalhos HTTP
A API XML usa os seguintes cabeçalhos HTTP padrão:
A API XML usa os seguintes cabeçalhos de extensão HTTP (personalizado):
A API XML usa os seguintes parâmetros de string de consulta:
Cabeçalhos HTTP padrão
Autorização
Um cabeçalho de solicitação que contém uma string usada para autenticar solicitações.
| Valid Values | Um identificador de autenticação ( Bearer | GOOG1
| AWS) seguido por um dos seguintes procedimentos:
|
| Exemplo | Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s- ... |
| Detalhes | Para mais informações sobre como usar esse cabeçalho, consulte Autenticação.
Observação: se suas solicitações estiverem sendo roteadas por meio de um proxy, talvez seja necessário verificar com o administrador da rede para garantir que o cabeçalho |
Cache-Control
Um cabeçalho de solicitação e resposta que especifica a configuração de controle de cache.
| Valid Values | Qualquer valor de controle de cache válido (consulte a especificação). |
| Exemplo | Cache-Control: public, max-age=6000 |
| Detalhes | Especifique o controle de cache apenas para objetos acessíveis a todos os usuários anônimos. Para ser acessível anonimamente, a ACL de um objeto precisa conceder a permissão READ ou FULL_CONTROL para AllUsers. Se um objeto for acessível a todos os usuários anônimos e você não especificar uma configuração de controle de cache, o Cloud Storage aplicará uma configuração de controle de cache de 3.600 segundos. Durante a exibição por XML, o Cloud Storage respeita o controle de cache do objeto, conforme definido pelos metadados. |
Content-Disposition
Um cabeçalho de solicitação e resposta que especifica informações de apresentação sobre os dados que estão sendo transmitidos.
| Valid Values | Qualquer valor de disposição de conteúdo válido (consulte a especificação). |
| Exemplo | Content-Disposition: attachment; filename=FILENAME |
| Detalhes | Se você definir o cabeçalho Content-Disposition ao fazer upload de um objeto, ele será veiculado no momento do download e depois interpretado por navegadores da Web e outros clientes HTTP. Um uso comum para Content-Disposition é a configuração como attachment;filename=FILENAMEt, normalmente fazendo com que o navegador da Web abra uma caixa de diálogo "Save As...". |
Content-Encoding
Um cabeçalho de solicitação e resposta que especifica o algoritmo de compactação de um objeto.
| Valid Values | Qualquer algoritmo de compactação válido (consulte a especificação). |
| Exemplo | Content-Encoding: gzip |
| Detalhes | O Cloud Storage não compacta nem descompacta objetos. Se você usar esse cabeçalho para especificar um algoritmo de tipo de compactação (por exemplo, deflate), o Cloud Storage preservará o cabeçalho, mas não compactará ou descompactará o objeto. |
Content-Language
É o código de idioma ISO 639-1 do conteúdo.
| Valid Values | Para ver uma lista de códigos de idioma, consulte a coluna ISO 639-1 de Códigos para a representação de nomes de idiomas. |
| Exemplo | Content-Language: en |
Content-Length
O tamanho (em bytes) do corpo da solicitação ou da resposta.
| Valid Values | Qualquer valor zero ou maior. |
| Exemplo | Content-Length: 1234 |
| Detalhes | Isso é necessário para todas as solicitações, exceto aquelas que usam a codificação de transferência fragmentada (consulte a especificação).
Se você não usar a codificação de transferência fragmentada e não incluir o cabeçalho Content-Length em uma solicitação, a solicitação falhará e o Cloud Storage responderá com um código de status 411 Size Required. |
Content-MD5
O resumo MD5 do corpo da solicitação.
| Valores válidos | Um resumo MD5 válido. |
| Exemplo | Content-MD5: iB94gawbwUSiZy5FuruIOQ== |
| Detalhes | Consulte a especificação.
O Cloud Storage pode usar isso para verificar a integridade de uma operação PUT. |
Content-Range
Um cabeçalho de solicitação ou resposta que especifica um intervalo de bytes.
| Valores válidos | Qualquer intervalo de bytes válido. |
| Exemplo | Content-Range: bytes 456-987/1234 |
| Detalhes | Em uma resposta, o cabeçalho Quando incluída como parte de uma solicitação de upload retomável, o Os intervalos de bytes são inclusivos; ou seja, Para ver mais detalhes, especialmente sobre as respostas de download, consulte a especificação. |
Content-Type
O tipo MIME da solicitação ou resposta.
| Valid Values | Qualquer tipo MIME válido (consulte a especificação). |
| Exemplo | Content-Type: text/html |
| Detalhes | Se você não especificar um tipo de conteúdo ao fazer o upload de um objeto, o sistema do Cloud Storage usará como padrão application/octet-stream quando veicular o objeto. |
Data
A data e a hora da solicitação ou resposta.
| Valid Values | Uma data e hora representadas no formato HTTP convencionais. Consulte a especificação. |
| Exemplo | Date: Wed, 16 Jun 2010 11:11:11 GMT |
| Detalhes | Quando usado para criar URLs assinados usando o processo de assinatura V2, o formato precisa estar no formato HTTP convencional.Consulte a seção 7.1.2 do . Ao usar o processo de assinatura V4, o formato deve estar no formato básico ISO 8601 YYYYMMDD'T'HHMMSS'Z' (em inglês). |
ETag
Um cabeçalho de resposta que contém a tag de entidade do objeto que está sendo acessado.
| Valid Values | Uma string de caracteres entre aspas. Para mais informações, consulte Hashes e ETags: práticas recomendadas. |
| Exemplos | ETag: "39a59594290b0f9a30662a56d695b71d"ETag: "-CKicn4fknbUCEAE=" |
| Detalhes | Consulte a especificação. |
Host
Um cabeçalho de solicitação que especifica o URI do Cloud Storage.
| Valid Values | Um formato válido para o URI. |
| Exemplo | Host: storage.googleapis.com |
| Detalhes | Para mais informações sobre URIs válidos, consulte Endpoints de solicitação e a especificação do host. |
If-Match
Um cabeçalho de solicitação que especifica uma tag de entidade (ETag).
| Valid Values | Uma tag de entidade válida. |
| Exemplo | If-Match: "881f7881ac1bc144a2672e45babb8839" |
| Detalhes | Apenas uma tag de entidade (não uma lista separada por vírgulas de tags de entidade) pode ser especificada.Você pode usar esse cabeçalho com os métodos HEAD Object e GET Object. Se a ETag especificada com esse cabeçalho for a mesma que a ETag do objeto, os metadados ou o objeto serão retornados. Se a ETag especificada com esse cabeçalho for diferente da ETag do objeto, os metadados ou o objeto não serão retornados e o Cloud Storage retornará um412 Falha na pré-condição. Para mais detalhes, consulte a especificação. |
If-Modified-Since
Um cabeçalho de solicitação que especifica uma data e hora.
| Valid Values | Data e hora representadas no formato HTTP convencional. |
| Exemplo | If-Modified-Since: Fri, 19 Feb 2010 22:04:23 GMT |
| Detalhes | É possível usar esse cabeçalho com os métodos HEAD Object e GET Object. Se um objeto tiver sido modificado após a data e a hora especificadas com esse cabeçalho, os metadados ou o objeto serão retornados. Se um objeto tiver sido modificado antes da data e hora especificadas com esse cabeçalho, os metadados ou o objeto não serão retornados e o Cloud Storage retornará uma mensagem 304 Not Modified.
Para mais informações sobre o cabeçalho If-Modified-Since, consulte a especificação. Para ver mais detalhes sobre os formatos de data HTTP, consulte a especificação, seção 7.1.1.2. |
If-None-Match
Um cabeçalho de solicitação que especifica uma tag de entidade (ETag).
| Valid Values | Uma tag de entidade válida. |
| Exemplo | If-None-Match: "881f7881ac1bc144a2672e45babb8839" |
| Detalhes | É possível usar esse cabeçalho com os métodos HEAD Object e GET Object. Se a ETag especificada com esse cabeçalho for diferente da ETag do objeto, os metadados ou o objeto serão retornados. Se a ETag especificada com esse cabeçalho for a mesma que a ETag do objeto, os metadados ou o objeto não serão retornados e o Cloud Storage retornará uma 304 Not Modified. Para mais detalhes, consulte a especificação. |
If-Unmodified-Since
Um cabeçalho de solicitação que especifica uma data e hora.
| Valid Values | Data e hora representadas no formato HTTP convencional. |
| Exemplo | If-Unmodified-Since: Fri, 19 Feb 2010 22:04:23 GMT |
| Detalhes | É possível usar esse cabeçalho com os métodos HEAD Object e GET Object. Se o objeto não tiver sido modificado após a data especificada com esse cabeçalho, os metadados ou o objeto serão retornados. Se o objeto tiver sido modificado após a data especificada com esse cabeçalho, os metadados ou o objeto não serão retornados e o Cloud Storage retornará uma mensagem 412 Precondition Failed.
Para mais informações sobre o cabeçalho If-UnModified-Since, consulte a especificação. Para mais informações sobre formatos de data HTTP, consulte a especificação, seção 7.1.1.2 (link em inglês). |
Last-Modified
Um cabeçalho de resposta que contém a data e a hora em que o objeto foi modificado pela última vez.
| Valid Values | Data e hora representadas no formato HTTP convencional. |
| Exemplo | Last-Modified: Fri, 19 Feb 2010 22:04:23 GMT |
| Detalhes | Para mais informações sobre o cabeçalho "Last-Modified", consulte a especificação. Para mais informações sobre formatos de data HTTP, consulte a especificação, seção 7.1.1.2 (link em inglês). |
Local
Um cabeçalho de resposta usado para vários propósitos:
- Em resposta ao início de um upload retomável, ele fornece um URI de sessão para uma operação de upload retomável.
- Em resposta a uma solicitação de autenticação com base em cookie, ela fornece um URL de resposta da origem da Web exclusivo para a solicitação.
- Em resposta a uma solicitação de download da API JSON feita em um URL diferente de
www.googleapis.com/download, ela fornece um redirecionamento para o URL da API JSON em que o download pode ser feito.
| Valid Values | Qualquer URI válido. |
| Exemplo | Location: https://example.storage.googleapis.com/?upload_id=tvA0...rot |
| Detalhes | O cabeçalho de resposta Location é retornado quando você inicia um upload retomável. |
Range
um cabeçalho de solicitação que indica o intervalo de bytes que você quer retornar, e um cabeçalho de resposta que indica o intervalo de bytes que foram enviados ao sistema do Cloud Storage;
| Valid Values | Qualquer intervalo contíguo de bytes. |
| Exemplos | Range: bytes=0-1999 (primeiros bytes)Range: bytes=-2000 (últimos 2.000 bytes)Range: bytes=2000- (do byte 2000 ao final do arquivo) |
| Detalhes | Quando incluído como cabeçalho em uma solicitação de dados de objeto, somente o intervalo especificado de bytes do objeto será retornado. Isso é útil ao retomar os uploads interrompidos. Uma solicitação válida e bem-sucedida resulta em um código de resposta 206 Partial Content. Em algumas circunstâncias, o cabeçalho de solicitação Quando retornada como parte de uma resposta associada a um upload recuperável, Os intervalos de bytes são inclusivos. Por exemplo, |
Transfer-Encoding
Um cabeçalho de solicitação e resposta que especifica se a codificação de transferência foi aplicada ao corpo da mensagem.
| Valid Values | chunked |
| Exemplo | Transfer-Encoding: chunked |
| Detalhes | Esse cabeçalho especifica se o corpo da mensagem de uma solicitação ou resposta foi fragmentado. Se for, o servidor veiculará o conteúdo em uma série de partes, com uma parte final com tamanho zero. Se você especificar Transfer-Encoding: Chunked, não será necessário especificar um Content-Length. Isso poderá ser útil se você não souber o tamanho do corpo da mensagem com antecedência, como ao fazer um upload de streaming. Para mais detalhes sobre codificações de transferência, consulte a especificação.
Para mais detalhes sobre a codificação de transferência fragmentada, consulte a especificação. |
Cabeçalhos HTTP de extensão (personalizado)
x-goog-acl
Um cabeçalho de solicitação que aplica ACLs predefinidas (configuradas) a um bucket ou objeto quando você o cria ou cria.
| Valid Values | Para buckets: project-private, private,
public-read, public-read-write,
authenticated-read
Para objetos: |
| Exemplo | x-goog-acl: private |
| Detalhes | Quando um usuário faz upload de um objeto ou cria um bucket sem especificar ACLs, a ACL private é aplicada. Para mais informações sobre ACLs predefinidas, consulte Controle de acesso. |
x-goog-api-version
Este cabeçalho está obsoleto e não é usado.
x-goog-bucket-retention-period
Um cabeçalho de solicitação que adiciona uma política de retenção a um novo bucket.
| Valid Values | Um número inteiro entre 1 e 3.155.70.000. |
| Exemplo | x-goog-bucket-retention-period: 32000 |
| Detalhes | Esse cabeçalho de solicitação só pode ser usado ao criar um novo bucket. Quando o cabeçalho é incluído, o novo bucket recebe uma política de retenção desbloqueada com duração, em segundos, determinada pelo valor desse cabeçalho. |
x-goog-component-count-count (link em inglês)
Um cabeçalho de resposta que indica o número de componentes que formam um objeto composto.
| Valid Values | Um número inteiro maior ou igual a 1. |
| Exemplo | x-goog-component-count: 32 |
| Detalhes | Esse cabeçalho de resposta é retornado somente quando o objeto acessado é um objeto composto. O cabeçalho retorna o número de componentes que compõem o objeto. |
x-goog-content-length-range
Um cabeçalho de solicitação PUT. Quando usado, o Cloud Storage só aceitará a solicitação se o tamanho do conteúdo da solicitação estiver dentro do intervalo especificado do cabeçalho.
| Valid Values | Um par MIN,MAX |
| Exemplo | x-goog-content-length-range: 0,256 |
| Detalhes | Os valores para o tamanho do conteúdo são inclusivos e fornecidos em bytes. Se o tamanho do conteúdo da solicitação estiver no intervalo especificado, ele será entregue conforme solicitado. Se o tamanho do conteúdo da solicitação estiver fora do intervalo especificado, a solicitação falhará e um código 400 Bad Request será retornado na resposta. Se o x-goog-content-length-range for usado em uma solicitação diferente de PUT, o cabeçalho será ignorado silenciosamente. |
x-goog-content-sha256
Um cabeçalho de solicitação que contém um hash do corpo da solicitação.
| Valid Values | Um hash SHA-256 codificado em hexadecimal ou UNSIGNED-PAYLOAD |
| Exemplo | x-goog-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
| Detalhes | Esse cabeçalho é necessário para solicitações que usam uma assinatura no cabeçalho Authorization.
x-goog-content-sha256 precisa corresponder ao valor usado na parte de payload da sua solicitação canônica. |
x-goog-copy-source
Um cabeçalho de solicitação que especifica o bucket de origem e o objeto para uma operação de cópia.
| Valid Values | Um caminho /BUCKET_NAME/OBJECT_NAME |
| Exemplo | x-goog-copy-source: travel-maps/paris.jpg |
| Detalhes | Esse cabeçalho de solicitação especifica o caminho até o objeto de origem. Um caminho válido precisa incluir o bucket e o objeto, separados por uma barra (/). Observe que o caminho do objeto de origem precisa ser um URL legal, portanto, geralmente precisa ser codificado por porcentagem.
Você precisa ter a permissão Se os objetos de origem e de destino forem os mesmos (incluindo a geração), a cópia será tratada como uma atualização dos metadados. Para detalhes sobre como controlar o comportamento de atualização/substituição, consulte x-goog-metadata-directive. |
x-goog-copy-source-generation
Um cabeçalho de solicitação que especifica a geração do objeto a ser copiado.
| Valid Values | Qualquer número positivo (valor de 64 bits) |
| Exemplo | x-goog-copy-source-generation: 1360044097839000 |
| Detalhes | É possível usar esse cabeçalho de solicitação com x-goog-copy-source para especificar a geração de objeto. Ele não é válido sem o cabeçalho x-goog-copy-source. Se não houver essa geração do objeto de origem, o Cloud Storage retornará um código de status 404 Not Found.
Se os objetos de origem e de destino forem os mesmos (incluindo a geração), a cópia será tratada como uma atualização dos metadados. Para detalhes sobre como controlar o comportamento de atualização/substituição, consulte x-goog-metadata-directive. |
x-goog-copy-source-if-generation-match
Um cabeçalho de solicitação que especifica a solicitação de cópia correspondente só será executado se o objeto de origem x-goog-generation corresponder ao valor especificado. Este cabeçalho é válido apenas quando usado com x-goog-copy-source.
| Valid Values | Qualquer número positivo (valor de 64 bits) |
| Exemplo | x-goog-copy-source-if-generation-match: 1360044097835000 |
| Detalhes | Esse cabeçalho de solicitação só poderá ser usado para copiar condicionalmente o objeto de origem se ele tiver a geração especificada. Se a geração não corresponder, o Cloud Storage retornará um código de erro 412 Precondition Failed.
Para mais informações, consulte Como usar versões de objeto. |
x-goog-copy-source-if-match
Um cabeçalho de solicitação que especifica as condições de uma operação de cópia.
| Valid Values | Uma tag de entidade (ETag) |
| Exemplo | x-goog-copy-source-if-match: 53fc311c15eda0a031809982ccf92aac |
| Detalhes | Somente uma única tag de entidade (não uma lista de tags de entidade separadas por vírgula) pode ser especificada. Esse cabeçalho de solicitação só poderá ser usado se você estiver executando uma operação de cópia com o cabeçalho de solicitação x-goog-copy-source. Se a ETag especificada com esse cabeçalho de solicitação corresponder à ETag do objeto de origem, a operação de cópia continuará. Se a ETag não corresponder, o Cloud Storage retornará um código de erro 412 Precondition Failed. |
x-goog-copy-source-if-metageneration-match
Um cabeçalho de solicitação que especifica a solicitação correspondente só será permitido se o metageneration do objeto de origem corresponder ao valor desse cabeçalho.
| Valid Values | Qualquer número positivo (valor de 64 bits) |
| Exemplo | x-goog-copy-source-if-metageneration-match: 4 |
| Detalhes | Se a metageração de objeto de origem corresponder ao cabeçalho x-goog-copy-source-if-metageneration-match, a solicitação será concluída e o Google Cloud Storage retornará um status HTTP 200 OK. Se a metageração não corresponder, o Cloud Storage retornará um código de erro 412 Precondition Failed.
Esse valor só pode ser usado com x-goog-copy-source-if-generation-match ou x-goog-copy-source-generation, e tentar usá-lo sem qualquer um deles resultará em um código de erro de argumento inválido Para mais informações, consulte Como usar versões de objeto. |
x-goog-copy-source-if-modified-since
Um cabeçalho de solicitação que especifica as condições de uma operação de cópia.
| Valid Values | Data e hora representadas no formato HTTP convencional. |
| Exemplo | x-goog-copy-source-if-modified-since: Fri, 19 Feb 2010 14:05:04 GMT |
| Detalhes | Esse cabeçalho de solicitação só poderá ser usado se você estiver executando uma operação de cópia com o cabeçalho de solicitação x-goog-copy-source. Se a data e a hora especificadas forem anteriores à data Last-Modified do objeto de origem, o objeto será copiado. Se a data e a hora forem posteriores, o Cloud Storage retornará um código de erro 412 Precondition Failed.
Para mais informações sobre o cabeçalho HTTP If-Modified-Since (que não é a fonte de cópia, aplicável a este caso de uso), consulte a especificação. Para mais informações sobre os formatos de data HTTP, consulte a especificação, seção 7.1.1.2 |
x-goog-copy-source-if-none-match
Um cabeçalho de solicitação que especifica as condições de uma operação de cópia.
| Valid Values | Uma tag de entidade (ETag) |
| Exemplo | x-goog-copy-source-if-none-match: 53fc311c15eda0a031809982ccf92aac |
| Detalhes | Esse cabeçalho de solicitação só poderá ser usado se você estiver executando uma operação de cópia com o cabeçalho de solicitação x-goog-copy-source. Se a ETag especificada com esse cabeçalho de solicitação não corresponder à ETag do objeto de origem, a operação de cópia continuará. Se a ETag corresponder, o Cloud Storage retornará um código de erro 412 Precondition Failed. Para mais informações sobre o cabeçalho HTTP If-None-Match (que, diferente da origem da cópia, se aplica a esse caso de uso), consulte a especificação. |
x-goog-copy-source-if-unmodified-since
Um cabeçalho de solicitação que especifica as condições de uma operação de cópia.
| Valid Values | Data e hora representadas no formato HTTP convencional. |
| Exemplo | x-goog-copy-source-if-unmodified-since: Fri, 19 Feb 2010 14:05:04 GMT |
| Detalhes | Esse cabeçalho de solicitação só poderá ser usado se você estiver executando uma operação de cópia com o cabeçalho de solicitação x-goog-copy-source. Se a data e a hora especificadas forem posteriores à data Last-Modified do objeto de origem, o objeto será copiado. Se a data e a hora forem anteriores, o Cloud Storage retornará um código de erro 412 Precondition Failed.
Para mais informações sobre o cabeçalho HTTP If-UnModified-Since (que, diferente da origem da cópia, se aplica a este caso de uso), consulte a especificação. Para mais informações sobre formatos de data HTTP, consulte a especificação, seção 7.1.1.2 (link em inglês). |
x-goog-custom-time
um cabeçalho de solicitação e resposta para metadados personalizados do objeto de carimbo de data/hora.
| Valid Values | Uma data e hora representadas no formato RFC 3339. |
| Exemplo | x-goog-custom-time: 2020-04-12T23:20:50.52Z |
| Detalhes | Esse cabeçalho pode ser incluído durante solicitações PUT ou POST de objeto. O valor especificado no cabeçalho é armazenado com o objeto e é retornado em um cabeçalho de resposta quando você faz uma solicitação GET ou HEAD no objeto. O tempo personalizado para um objeto é normalmente usado com o Gerenciamento do ciclo de vida de objetos. |
x-goog-date
Um cabeçalho de solicitação que especifica um carimbo de data/hora para solicitações autenticadas.
| Valid Values | Data e hora representadas no formato HTTP convencional. |
| Exemplo | x-goog-date: Fri, 19 Feb 2010 14:05:04 GMT |
| Detalhes | Quando usado para criar URLs assinados usando o processo de assinatura V2, o formato precisa estar no formato HTTP convencional.Consulte a seção 7.1.2 do
. Ao usar o processo de assinatura V4, o formato precisa estar no formato básico ISO 8601 YYYYMMDD'T'HHMMSS'Z' (em inglês). |
x-goog-encryption-algorithm
Um cabeçalho de solicitação e resposta que especifica o algoritmo de criptografia a ser usado.
| Valid Values | AES256 |
| Exemplo | x-goog-encryption-algorithm: AES256 |
| Detalhes | Esse cabeçalho de solicitação e resposta é usado quando você fornece chaves de criptografia fornecidas pelo cliente. |
x-goog-encryption-key
Um cabeçalho de solicitação que especifica uma chave de criptografia AES-256.
| Valid Values | Uma string RFC 4648 (em inglês) codificada por Base64 de uma chave de criptografia AES-256 válida |
| Exemplo | x-goog-encryption-key: NwbyGGmcKAX4FxGpOERG2Ap33m5NVOgmXznSGTEvG0I= |
| Detalhes | Esse cabeçalho de solicitação é usado quando você fornece chaves de criptografia fornecidas pelo cliente. |
x-goog-encryption-key-sha256
Um cabeçalho de solicitação e resposta que especifica o hash SHA256 da chave de criptografia.
| Valid Values | Uma string RFC 4648 (em inglês) codificada por Base64 de um hash SHA256 válido para uma chave de criptografia |
| Exemplo | x-goog-encryption-key-sha256: +eBzkZBt1Mj2CZx69L3c8yXoZB6DtRLlSvXMJB9JGIQ= |
| Detalhes | Esse cabeçalho de solicitação é usado quando você fornece chaves de criptografia fornecidas pelo cliente. |
x-goog-encryption-kms-key-name
Um cabeçalho de solicitação que especifica uma chave de criptografia do Cloud KMS.
| Valid Values | Um recurso de chave de criptografia do Cloud KMS. |
| Exemplo | x-goog-encryption-kms-key-name: projects/my-project/locations/us-east1/keyRings/my-keyring/cryptoKeys/my-key |
| Detalhes | Esse cabeçalho de solicitação é usado quando você quer criptografar um objeto específico com uma chave de criptografia gerenciada pelo cliente. |
x-goog-expiration
Um cabeçalho de resposta que especifica quando o objeto acessado será excluído, de acordo com a configuração do ciclo de vida.
| Valid Values | Data e hora representadas no formato HTTP convencional. |
| Exemplo | x-goog-expiration: Tue, 25 June 2013 00:00:00 GMT |
| Detalhes | Esse cabeçalho de resposta é retornado somente para objetos em um bucket com gerenciamento do ciclo de vida ativado se determinadas condições forem atendidas. Para mais informações, consulte Comportamento do ciclo de vida do objeto. |
x-goog-generation
Um cabeçalho de resposta que indica qual versão dos dados do objeto você está acessando.
| Valid Values | Qualquer número positivo (valor de 64 bits) |
| Exemplo | x-goog-generation: 1360044097835000 |
| Detalhes | Sempre que um objeto é criado ou substituído, o Cloud Storage atribui automaticamente uma geração a ele. A geração é alterada sempre que os dados do objeto são substituídos. No entanto, não há relação definida entre as gerações em objetos diferentes.
Para mais informações, consulte Como usar versões de objeto. |
x-goog-if-generation-match
Um cabeçalho de solicitação que especifica a solicitação correspondente só é permitido se o x-goog-generation do objeto corresponder ao valor desse cabeçalho.
| Valid Values | Zero ou qualquer número positivo (64 valor de 64 bits) |
| Exemplo | x-goog-if-generation-match: 1360044097835000 |
| Detalhes | Se a geração de objetos corresponder ao cabeçalho x-goog-if-generation-match, a solicitação será concluída e o Google Cloud Storage retornará um status HTTP 200 OK. Se a geração não for correspondente, o Google Cloud Storage retornará um código de erro HTTP 412 Precondition Failed.
Se você definir o cabeçalho Para mais informações, consulte Como usar versões de objeto. |
x-goog-if-metageneration-match
Um cabeçalho de solicitação que especifica a solicitação correspondente só é permitido se o x-goog-metageneration do objeto corresponder ao valor desse cabeçalho.
| Valid Values | Qualquer número positivo (valor de 64 bits) |
| Exemplo | x-goog-if-metageneration-match: 4 |
| Detalhes | Se a metageração de objeto corresponder ao cabeçalho x-goog-if-metageneration-match, a solicitação será concluída e o Google Cloud Storage retornará um status HTTP 200 OK. Se a metageração não corresponder, o Cloud Storage retornará um código de erro HTTP 412 Precondition Failed.
Esse cabeçalho de solicitação só deve ser usado com o cabeçalho x-goog-if-generation-match para garantir que as atualizações de metadados sejam realmente realizadas em relação à geração do objeto estão planejando atualizar e, portanto, permitem executar operações de leitura-modificação-gravação com segurança. Para mais informações, consulte Como usar versões de objeto. |
x-goog-metadata-directive
Um cabeçalho de solicitação que especifica o tratamento de metadados durante uma operação de cópia.
As ACLs de objeto, quando presentes, nunca são copiadas. Se aplicável, o novo objeto recebe ACLs especificadas no cabeçalho da solicitação x-goog-acl ou as ACLs padrão de objetos do bucket que contém o novo objeto.
| Valid Values | COPY | REPLACE |
| Exemplo | x-goog-metadata-directive: REPLACE |
| Detalhes | Usado apenas com o cabeçalho de solicitação Se você especificar Se você especificar Ao copiar um objeto, ele reescreve o objeto de origem, é necessário incluir |
x-goog-metageneration
Um cabeçalho de resposta que indica qual versão dos metadados do objeto você está acessando.
| Valid Values | Qualquer número positivo (valor de 64 bits) |
| Exemplo | x-goog-metageneration: 1 |
| Detalhes | Sempre que um objeto é criado ou substituído, o Cloud Storage atribui automaticamente uma metageração de 1. A metageração aumenta sempre que os metadados do objeto são atualizados (atualização da ACL ou outras atualizações de metadados). Isso significa que uma metageração maior sempre implica uma versão mais recente dos metadados do objeto. No entanto, não há relação definida entre diferentes gerações em objetos diferentes, nem mesmo gerações diferentes do mesmo objeto. Cada geração do objeto tem a própria versão de metageração que pertence apenas à geração.
Para mais informações, consulte Como usar versões de objeto. |
x-goog-hash
Um cabeçalho de solicitação e resposta para expressar as somas de verificação MD5 e/ou CRC32C de base64 de um objeto. Como um cabeçalho de solicitação para solicitações de upload, os hashes fornecidos são validados em relação aos valores calculados pelo Cloud Storage.
| Valid Values | Esse tipo é md5=BASE64_ENCODED_MD5 ou crc32c=BASE64_ENCODED_CRC32C. Especifique valores CRC32c na ordem de bytes big-endian. Além disso, HTTP considera valores de cabeçalho separados por vírgulas como equivalentes a cabeçalhos separados com chaves idênticas. |
| Exemplos | x-goog-hash: crc32c=n03x6A==x-goog-hash: md5=Ojk9c3dhfxgoKVVHYwFbHQ==x-goog-hash: crc32c=n03x6A==,md5=Ojk9c3dhfxgoKVVHYwFbHQ== |
| Detalhes | O Cloud Storage armazena hashes MD5 para todos os objetos não compostos. CRC32Cs estão disponíveis para todos os objetos. |
x-goog-meta-
Um cabeçalho de solicitação e resposta que permite definir metadados personalizados para um objeto.
| Valid Values | Qualquer nome de cabeçalho válido. |
| Exemplo | x-goog-meta-reviewer: jane |
| Detalhes | Para usar esse cabeçalho, anexe o nome do cabeçalho personalizado ao prefixo x-goog-meta- e, em seguida, adicione o cabeçalho e o valor associado à solicitação PUT ou POST. Por exemplo, se seus objetos estiverem associados a vários projetos, adicione as informações específicas do projeto aos metadados do objeto criando vários cabeçalhos de solicitação, como: x-goog-meta-project-name
x-goog-meta-project-number e x-goog-meta-project-manager. Em seguida, é possível definir um valor para esses cabeçalhos de solicitação durante uma solicitação PUT ou POST, conforme mostrado no exemplo a seguir:
PUT /kitten.jpg HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Wed, 17 Jun 2020 11:11:11 GMT
Content-Type: image/jpg
Content-Length: 554
Authorization: Bearer 1/zVNpoQNsOSxZKqOZgckhpQ
x-goog-meta-project-name: Sales Projections
x-goog-meta-project-number: 878973
x-goog-meta-project-manager: W. Loman
Os cabeçalhos Observação: todos os cabeçalhos personalizados e os valores associados precisam conter apenas caracteres US-ASCII para impressão. Observação: recomendamos que você limite o tamanho total dos cabeçalhos personalizados a alguns KB. |
x-goog-project-id
Um cabeçalho de solicitação que especifica em qual projeto você está trabalhando.
| Valid Values | Qualquer número ou nome de projeto válido. |
| Exemplos | x-goog-project-id: 000111222333x-goog-project-id: my-project-namex-goog-project-id: example.com:my-google-apps-for-work-project-name |
| Detalhes | Esse cabeçalho de solicitação informa ao Cloud Storage em qual projeto criar um bucket ou para que projeto lista os buckets. Ela é opcional para essas tarefas se você tiver definido um projeto padrão para acesso interoperável. |
x-goog-resumable
Um cabeçalho de solicitação que inicia uma operação de upload retomável.
| Valid Values | start |
| Exemplo | x-goog-resumable: start |
| Detalhes | Esse cabeçalho de solicitação notifica o sistema do Cloud Storage de que você quer iniciar um upload retomável. É possível usar o cabeçalho somente com uma solicitação POST Object e apenas para uploads recuperáveis. |
classe x-goog-storage-class
Um cabeçalho de solicitação e resposta que indica a classe de armazenamento de um objeto.
| Valid Values | STANDARD, NEARLINE, COLDLINE,
ARCHIVE, MULTI_REGIONAL,
REGIONAL |
| Exemplo | x-goog-storage-class: NEARLINE |
| Detalhes | Esse cabeçalho pode ser incluído nas solicitações PUT Object e POST Object para definir um objeto como uma classe de armazenamento além da classe de armazenamento padrão do bucket associado. O cabeçalho é incluído em todas as respostas de GET Object. |
x-goog-stored-content-encoding
Um cabeçalho de resposta que indica a codificação do conteúdo do objeto como armazenado no Cloud Storage, independentemente de qualquer negociação orientada pelo servidor que possa ocorrer para solicitações individuais do objeto.
| Valid Values | A codificação de conteúdo especificada no upload do objeto ou identity. |
| Exemplo | x-goog-stored-content-encoding: gzip |
| Detalhes | Se um objeto foi enviado sem codificação de conteúdo, o valor deste cabeçalho é identity. |
x-goog-stored-content-length
Um cabeçalho de resposta que indica o tamanho do conteúdo (em bytes) do objeto como armazenado no Cloud Storage, independentemente de qualquer negociação orientada pelo servidor que possa ocorrer para solicitações individuais do objeto.
| Valid Values | Qualquer valor de byte zero ou superior. |
| Exemplo | x-goog-stored-content-length: 350 |
| Detalhes | Nenhum |
x-goog-user-project
Um cabeçalho de solicitação que especifica um projeto de usuário para faturar as cobranças de acesso associadas à solicitação.
| Valid Values | O ID do projeto para um projeto do Google Cloud existente |
| Exemplo | x-goog-user-project: my-project |
| Detalhes | O projeto especificado no cabeçalho é cobrado pelos custos associados à solicitação. Esse cabeçalho é usado, por exemplo, ao fazer solicitações para buckets com o recurso Pagamentos do solicitante ativado. |
Parâmetros de string de consulta
Nos exemplos de parâmetros de string de consulta descritos nesta seção, os URIs não são mostrados, mas são relativos a storage.googleapis.com. Conforme descrito em Endpoints de solicitação, também é possível especificar o nome do bucket como parte do nome do host, por exemplo, BUCKET-NAME.storage.googleapis.com. Se você estiver especificando o bucket como parte do nome do host, não inclua o nome do bucket como parte do caminho do URI. Por exemplo, os itens a seguir são equivalentes para receber a ACL de um objeto:
https://storage.googleapis.com/BUCKET-NAME/object-name?aclhttps://BUCKET-NAME.storage.googleapis.com/object-name?acl
CódigodeChavedeAcesso
Um parâmetro de string de consulta que permite identificar qual chave HMAC você quer atualizar ou excluir.
| Valid Values | Um ID de acesso associado a uma chave HMAC. |
| Exemplo | /?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive/?Action=DeleteAccessKey&AccessKeyId=GOOG1EXAMPLE |
| Detalhes | O parâmetro de string de consulta AccessKeyId permite especificar qual chave HMAC você está atualizando ou excluindo. É preciso usar AccessKeyId com o parâmetro de consulta Action. Para informações sobre como recuperar o código de acesso da chave HMAC, consulte Como receber informações da chave HMAC. |
acl
Um parâmetro de string de consulta que permite recuperar ou alterar a lista de controle de acesso para um bucket ou objeto.
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME?acl/BUCKET_NAME/OBJECT_NAME?acl |
| Detalhes | Opcional para as seguintes solicitações: PUT Bucket, PUT Object, GET Bucket, GET Object. Se você estiver enviando uma solicitação PUT, precisará incluir um documento XML no corpo da solicitação que especifique as ACLs que você quer aplicar. Não é possível usar sub-recursos adicionais com esse parâmetro de consulta. |
Ação
Um parâmetro de string de consulta que permite identificar qual operação de chave HMAC deve ser executada.
| Valid Values | ListAccessKeys, CreateAccessKey,
UpdateAccessKey, DeleteAccessKey |
| Exemplo | /?Action=ListAccessKeys |
| Detalhes | O parâmetro de string de consulta Action permite especificar qual operação de chave HMAC será executada: list, create,
update ou
delete. |
billing
Um parâmetro de string de consulta que permite ativar, desativar ou verificar o status do recurso Pagamentos do solicitante de um bucket.
| Valid Values | No corpo da solicitação: Enabled, Disabled. |
| Exemplo | /BUCKET_NAME?billing |
| Detalhes | Opcional para as seguintes solicitações: GET Bucket, PUT Bucket. Quando usado em uma solicitação GET Bucket, o status atual do recurso Pagamentos do solicitante é retornado no corpo da resposta. Quando usado em uma solicitação PUT Bucket, o corpo da solicitação precisa conter um elemento <BillingConfiguration> que especifica se o recurso será ativado ou desativado. Para mais informações sobre como configurar o recurso Pagamentos do solicitante usando a API XML, consulte Definir pagamentos do solicitante do bucket. |
compose
Um parâmetro de string de consulta que permite compor uma sequência de objetos existentes em um novo objeto composto (usado apenas com a API XML).
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME/OBJECT_NAME?compose |
| Detalhes | Opcional para solicitações PUT Object. Um documento XML ComposeRequest precisa ser fornecido no corpo da solicitação. Não é possível usar sub-recursos adicionais com esse parâmetro de consulta. |
cors
Um parâmetro de string de consulta que permite recuperar ou alterar o compartilhamento de recursos entre origens (CORS, na sigla em inglês) de um bucket.
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME?cors |
| Detalhes | Opcional para estas solicitações: PUT Bucket, GET Bucket. Se estiver enviando uma solicitação PUT, será necessário incluir um documento XML no corpo da solicitação que especifique o CORS que você quer aplicar. Não é possível usar quaisquer sub-recursos adicionais com esse parâmetro de consulta. |
defaultObjectAcl
Um parâmetro de string de consulta que permite recuperar ou alterar a lista de controle de acesso de objetos padrão de um bucket.
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME?defaultObjectAcl |
| Detalhes | Opcional para solicitações PUT Bucket e GET Bucket. Se você enviar uma solicitação PUT, será necessário incluir um documento XML no corpo da solicitação que especifique a ACL que se aplica por padrão a novos objetos adicionados ao bucket. Não é possível usar sub-recursos adicionais com esse parâmetro de consulta. Consulte Como configurar ACLs de objeto padrão para mais informações. |
delimiter
Um caractere ou grupo de caracteres usado para restringir uma lista de objetos durante uma solicitação GET Bucket.
| Valid Values | Qualquer caractere Unicode. |
| Exemplo | /?delimiter=/ |
| Detalhes | A É possível usar um O |
tipo de codificação
Um parâmetro de string de consulta para codificar nomes de objetos em URL em respostas a solicitações de listagem de objetos.
| Valid Values | url |
| Exemplo | /bucket?encoding-type=url |
| Detalhes | Opcional ao listar objetos em um bucket. Quando incluídos na solicitação, os nomes de objetos retornados são codificados por URL. Isso será útil se algum dos nomes de objetos incluir caracteres Unicode que o XML 1.0 não poderá analisar. |
encryption
Um parâmetro de string de consulta que permite recuperar as informações de criptografia de um objeto.
| Valid Values | nenhum |
| Exemplo | /object?encryption |
| Detalhes | Opcional para solicitações GET Object. Quando o objeto consultado é criptografado por uma chave de criptografia fornecida pelo cliente, o algoritmo de criptografia e o SHA-256 da chave são retornados em um elemento Encryption. Quando o objeto consultado é criptografado por uma chave de criptografia gerenciada pelo cliente, o recurso de chave do Cloud Key Management Service é retornado em um elemento Encryption. Em todos os outros casos, um elemento Encryption vazio é retornado.
Não é possível usar sub-recursos adicionais com esse parâmetro de consulta. |
encryptionConfig
Um parâmetro de string de consulta que permite definir ou recuperar a chave de criptografia padrão gerenciada pelo cliente que um bucket usa.
| Valid Values | nenhum |
| Exemplo | /bucket?encryptionConfig |
| Detalhes | Opcional para solicitações GET Bucket. Quando o bucket consultado tem uma chave de criptografia padrão gerenciada pelo cliente definida nele, o nome do recurso de chave é retornado em um elemento EncryptionConfiguration.
Opcional para solicitações PUT
Bucket. Quando a solicitação inclui um recurso de chave de criptografia gerenciada pelo cliente no corpo da solicitação, essa chave se torna a chave de criptografia padrão do bucket. Quando a solicitação inclui um elemento |
geração
Um valor que indica a geração do objeto a ser buscado.
| Valid Values | Qualquer número positivo (valor de 64 bits) |
| Exemplo | ?generation=1360887759327000 |
| Detalhes | O parâmetro de string de consulta generation permite especificar em qual versão do objeto ele opera. |
marcador de geração
Um valor que indica o número de geração em que você quer iniciar uma lista de objetos.
| Valid Values | Qualquer número positivo (valor de 64 bits) |
| Exemplo | ?generation-marker=1360887759327000 |
| Detalhes | O parâmetro de string de consulta generation-marker é um ponto de partida para listagens paginadas em buckets com versão. Precisa ser usado em conjunto com marker, para especificar completamente o objeto e a geração de onde iniciar a listagem depois. Todas as versões de objeto com maior que o generation-marker especificado (incluindo a versão ativa se tiver uma geração maior) são retornadas na lista de objetos, assim como os objetos lexicograficamente maiores que o marker. |
lifecycle
Um parâmetro de string de consulta que permite recuperar ou alterar as políticas de gerenciamento do ciclo de vida de um bucket.
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME?lifecycle |
| Detalhes | Opcional para estas solicitações: PUT Bucket, GET Bucket. Se você enviar uma solicitação PUT, será necessário incluir um documento XML no corpo da solicitação que especifique a configuração do ciclo de vida. Não é possível usar sub-recursos adicionais com esse parâmetro de consulta. |
local
Um parâmetro de string de consulta que permite recuperar a restrição de location de um bucket.
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME?location |
| Detalhes | Opcional para as seguintes solicitações: GET Bucket. |
logging
Um parâmetro de string de consulta que permite recuperar ou alterar a configuração de geração de registros de um bucket.
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME?logging |
| Detalhes | Opcional para estas solicitações: PUT Bucket, GET Bucket. Ao enviar uma solicitação PUT, é necessário incluir um documento XML no corpo da solicitação que especifique a configuração de geração de registros. Não é possível usar quaisquer sub-recursos adicionais com esse parâmetro de consulta. |
marcador
Uma string que indica onde você deseja iniciar uma lista de objetos.
| Valores válidos | Qualquer string. |
| Exemplo | ?marker=test |
| Detalhes | O parâmetro de string de consulta marker é uma string de caracteres Unicode que especifica qual objeto você quer que uma lista de objetos comece depois. A lista de objetos retornados é aqueles lexicograficamente maiores que marker. |
Marcador
Um token de página que permite listar páginas subsequentes de chaves HMAC.
| Valid Values | Uma string fornecida em uma resposta list anterior se IsTruncated for true. |
| Exemplo | ?Action=ListAccessKeys&Marker=AERPALERN/NEXT/TOKEN |
| Detalhes | O parâmetro de string de consulta Marker é um token de continuação usado para paginar grandes conjuntos de resultados ao listar chaves HMAC para um determinado projeto. Se IsTruncated for true em uma resposta list anterior, use o token Marker fornecido nas solicitações list subsequentes até IsTruncated ser false. É preciso usar Marker em conjunto com o parâmetro de consulta Action. Para mais informações, consulte Chave GET HMAC. |
max-keys
Um número inteiro que limita o número de objetos retornados em uma única "página" de resultado.
| Valid Values | Qualquer número superior a 0. |
| Exemplo | ?max-keys=100 |
| Detalhes | O parâmetro de string de consulta max-keys é um número inteiro que especifica o número máximo de objetos que você quer retornar em uma lista de objetos. Se uma solicitação puder retornar mais objetos do que max-keys permite, o elemento de resposta IsTruncated conterá um valor True. |
Máximo de itens
Um número inteiro que limita o número de chaves HMAC retornadas em uma única página de resultado.
| Valid Values | Qualquer número superior a 0. |
| Exemplo | ?Action=ListAccessKeys&MaxItems=100 |
| Detalhes | O parâmetro de string de consulta MaxItems é um número inteiro que especifica o número máximo de chaves HMAC retornadas em uma única página de resultado. Se uma solicitação puder retornar mais chaves do que o MaxItems permite, o elemento de resposta IsTruncated conterá um valor true. É necessário usar MaxItems com o parâmetro de consulta Action. O serviço pode retornar menos resultados do que o máximo especificado. |
prefix
Uma string que restringe uma lista de objetos para os objetos que têm um prefixo específico.
| Valid Values | Qualquer prefixo válido. |
| Exemplo | ?prefix=/europe/france |
| Detalhes | O parâmetro de string de consulta prefix é uma string de caracteres Unicode que restringe a listagem a objetos cujos nomes começam com o valor prefix especificado. É possível usar o parâmetro de string de consulta prefix com o parâmetro de string de consulta delimiter para criar um subconjunto menor de objetos. |
disposição-resposta
Um parâmetro de string de consulta que permite a disposição do conteúdo ser modificado para solicitações GET autenticadas.
| Valid Values | Cabeçalho codificado pelo URL a ser retornado em vez da disposição do conteúdo do objeto subjacente. |
| Exemplo | ?response-content-disposition=attachment%3B%20filename%3D%22foo%22 |
| Detalhes | Permite que solicitações GET autenticadas substituam a disposição de conteúdo retornada nos cabeçalhos.
Para mais informações, consulte a especificação. |
tipo-content-type
Um parâmetro de string de consulta que permite modificar o tipo de conteúdo para solicitações GET autenticadas.
| Valid Values | Cabeçalho codificado pelo URL a ser retornado em vez do tipo de conteúdo do objeto subjacente. |
| Exemplo | ?response-content-type=text%2Fhtml |
| Detalhes | Permite que solicitações GET autenticadas substituam a disposição de conteúdo retornada nos cabeçalhos.
Para mais informações, consulte a especificação. |
Status
Um parâmetro de string de consulta que permite ativar ou desativar uma chave HMAC.
| Valid Values | Active, Inactive |
| Exemplo | ?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive |
| Detalhes | O parâmetro de string de consulta Status permite alterar o status de uma chave HMAC entre Active e Inactive. Você precisa usar Status com os parâmetros de consulta Action e AccessKeyId. |
Classe de armazenamento
Um parâmetro de string de consulta que permite definir ou recuperar a classe de armazenamento de um bucket.
| Valid Values | No corpo da solicitação: STANDARD, NEARLINE,
ARCHIVE, COLDLINE, MULTI_REGIONAL,
REGIONAL,DURABLE_REDUCED_AVAILABILITY |
| Exemplo | /BUCKET_NAME?storageClass |
| Detalhes | Opcional para as seguintes solicitações: GET Bucket, PUT Bucket. Quando usada em uma solicitação GET Bucket, a classe de armazenamento do bucket especificado é retornada no corpo da resposta. Quando usado em uma solicitação PUT Bucket, o corpo da solicitação deve conter um elemento <StorageClass> que especifica a classe de armazenamento que você quer atribuir ao bucket. Para mais informações sobre como configurar a classe de armazenamento de um bucket usando a API XML, consulte Definir a classe de armazenamento de bucket. |
inclusão de tag
Um parâmetro de string de consulta que permite definir ou recuperar os rótulos aplicados a um bucket.
| Valid Values | Dentro do corpo da solicitação: um rótulo, fornecido como um par key:value. |
| Exemplo | /BUCKET_NAME?tagging |
| Detalhes | Opcional para as seguintes solicitações: GET Bucket, PUT Bucket. Quando usados em uma solicitação GET Bucket, os rótulos aplicados ao bucket especificado são retornados no corpo da resposta. Quando usado em uma solicitação PUT Bucket, o corpo da solicitação precisa conter um elemento <Tagging> que especifica os rótulos que você quer aplicar ao bucket. Para mais informações sobre como aplicar rótulos usando a API XML, consulte Definir rótulos de bucket. |
upload_id
Um parâmetro de string de consulta que especifica esse ID de upload para uma operação de upload retomável. O upload_id faz parte do URI da sessão, mas você precisa salvar todo o URI da sessão, porque ele define exclusivamente o URI de solicitação para operações subsequentes de uploads recuperáveis. O URI da sessão é obtido no cabeçalho de resposta Location.
| Valid Values | Qualquer ID de upload válido. |
| Exemplo | /?upload_id=tvA0ExBntDaOKdxL46u1NkHxNb...B2Uowrot HTTP/1.1 |
| Detalhes | Um ID de upload expira após uma semana. Recomendamos iniciar um upload retomável assim que conseguir o ID do upload e retomar um upload interrompido logo após a interrupção.
Se você usar um código de upload expirado em uma solicitação, receberá um código de status 404 Não encontrado. Nesse caso, você precisará reiniciar o upload retomável, conseguir um novo código de upload e iniciar o upload desde o início usando o novo código de upload. O ID do upload está vinculado ao local onde ele foi criado. Portanto, se você criar um em um local e usá-lo em outro local, seu desempenho será prejudicado. O código de upload é um token do portador, ou seja, a propriedade desse token atua como um autenticador. Portanto, tome cuidado para não vazar IDs de upload. |
Nome de usuário
Um parâmetro de string de consulta que permite identificar a conta de serviço para a qual você quer criar, atualizar ou listar uma chave HMAC.
| Valid Values | Um endereço de e-mail de conta de serviço válido. |
| Exemplo | /?Action=CreateAccessKey&UserName=serviceAccount@proj.iam.gserviceaccount.com |
| Detalhes | UserName é necessário para criar uma chave HMAC e opcional para atualizar uma chave ou listar chaves associadas a um projeto. É preciso usar UserName com o parâmetro de consulta Action. |
UserProject
Um parâmetro de string de consulta que especifica um ID de projeto para faturar as cobranças de acesso associadas à solicitação.
| Valid Values | Qualquer ID de projeto válido. |
| Exemplo | ?userProject=example-project |
| Detalhes | O projeto especificado neste parâmetro é faturado por cobranças associadas à solicitação. userProject é usado, por exemplo, ao fazer solicitações para buckets com o recurso Pagamentos do solicitante ativado.
Geralmente, solicitações XML que exigem um ID de projeto devem fornecer um no cabeçalho |
controle de versão
Um parâmetro de string de consulta que permite recuperar ou alterar a configuração do controle de versão de um bucket.
| Valid Values | nenhum |
| Exemplo | /OBJECT_NAME?versioning |
| Detalhes | Opcional para estas solicitações: PUT Bucket, GET Bucket. Se estiver enviando uma solicitação PUT, será necessário incluir um documento XML no corpo da solicitação que especifique a configuração de versão a ser aplicada. Não é possível usar sub-recursos adicionais com esse parâmetro de consulta. |
versões
Um parâmetro de string de consulta que permite recuperar toda a geração de objetos em um bucket com controle de versão.
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME?versions=True |
| Detalhes | Opcional para as seguintes solicitações: GET Bucket. |
siteConfig
Um parâmetro de string de consulta que permite recuperar ou alterar a configuração do site de um intervalo.
| Valid Values | nenhum |
| Exemplo | /BUCKET_NAME?websiteConfig |
| Detalhes | Opcional para estas solicitações: PUT Bucket, GET Bucket. Se você enviar uma solicitação PUT, precisará incluir um documento XML no corpo da solicitação que especifique a configuração de site que você quer aplicar. Não é possível usar sub-recursos adicionais com esse parâmetro de consulta. |
X-Goog-Algorithm
Um parâmetro de string de consulta para determinar o algoritmo de URL assinado V4.
| Valid Values | GOOG4-RSA-SHA256GOOG4-HMAC-SHA256AWS4-HMAC-SHA256 |
| Detalhes | Usado especificamente para solicitações assinadas da V4, como URLs assinados. |
X-Goog-Credentials
Um parâmetro de string de consulta para determinar o tipo de credencial usado.
| Valid Values | Service_Account_Email/Date/Region/goog4_requestGoogle_HMAC_Access_Key_ID/Date/Region/goog4_requestAWS_HMAC_Access_Key_ID/Date/Region/aws4_request |
| Exemplo | Com uma conta de serviço do Google: example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_requestComo usar o HMAC: GOOGTS7C7FUP3AIRVJTE2BCD%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request |
| Detalhes | Usado especificamente para solicitações assinadas da V4, como URLs assinados. |
X-Goog-Date (parâmetro de consulta)
A data e a hora em que o URL assinado se tornou utilizável.
| Valid Values | Qualquer data que seja a seguinte: AAAAMMDD'T'HHMMSS'Z' |
| Exemplo | ?X-Goog-Date=20181026T181309Z |
| Detalhes | O formato usado é o formato básico ISO 8601 YYYYMMDD'T'HHMMSS'Z'. |
X-Goog-Expires
Um parâmetro de string de consulta para determinar por quanto tempo um URL assinado V4 está ativo.
| Valid Values | Um segundo até incluindo 604.800 segundos |
| Exemplo | ?X-Goog-Expires=900 |
| Detalhes | O tempo que o URL assinado permaneceu válido, medido em segundos a partir do valor em X-Goog-Date (parâmetro de consulta). O valor máximo é de 7 dias ou 604.800 segundos. |
X-Goog-SignedHeaders
Um parâmetro de string de consulta para determinar os cabeçalhos assinados em um URL assinado da V4.
| Valid Values | O único cabeçalho necessário é host. Qualquer cabeçalho assinado em uma assinatura de URL assinado V4 precisa estar nessa lista. |
| Exemplos | ?X-Goog-SignedHeaders=host?X-Goog-SignedHeaders=host,x-goog-acl |
| Detalhes | Cabeçalhos que precisavam ser incluídos como parte de qualquer solicitação que usou o URL assinado. |
X-Goog-Signature
Um parâmetro de string de consulta com o valor de uma assinatura de URL assinado V4.
| Valid Values | Assinatura do URL assinado. |
| Exemplo | ?X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7 |
| Detalhes | A string de autenticação que permitiu às solicitações que usam esse URL assinado acessar o recurso designado. |