Nesta página, explicamos os diferentes endpoints de solicitação que podem ser usados para acessar o Cloud Storage. O Cloud Storage é compatível com os protocolos HTTP/1.1, HTTP/2 e HTTP/3. Um endpoint é o local em que o Cloud Storage pode ser acessado, escrito como um URL.
Solicitações comuns de API
API JSON
Ao fazer solicitações de API em JSON diretamente para o Cloud Storage, use os seguintes endpoints:
Para solicitações de API JSON gerais, exceto uploads de objetos, use o seguinte endpoint, substituindo
PATH_TO_RESOURCE
pelo valor adequado:https://storage.s3nsapis.fr/storage/v1/PATH_TO_RESOURCE
Use o endpoint a seguir para uploads de objeto da API JSON, substituindo
BUCKET_NAME
pelo valor adequado:https://storage.s3nsapis.fr/upload/storage/v1/b/BUCKET_NAME/o
Use o seguinte endpoint para solicitações em lote, substituindo
PATH_TO_RESOURCE
pelo valor adequado:https://storage.s3nsapis.fr/batch/storage/v1/PATH_TO_RESOURCE
Como opção, é possível usar o seguinte endpoint para downloads de objetos da API JSON, substituindo
BUCKET_NAME
eOBJECT_NAME
pelos valores apropriados:https://storage.s3nsapis.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media
Os endpoints da API JSON só aceitam solicitações HTTPS.
API XML
Ao fazersolicitações da API XML diretamente para o Cloud Storage,
use o endpoint com estilo virtual hospedado ou estilo de caminho, substituindo
BUCKET_NAME
e OBJECT_NAME
pelos valores apropriados:
Endpoint com estilo de hospedagem virtual:
https://BUCKET_NAME.storage.s3nsapis.fr/OBJECT_NAME
Endpoint no estilo de caminho:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Os endpoints da API XML são compatíveis com a criptografia secure sockets layer (SSL), isso significa que você pode usar HTTP ou HTTPS. Recomendamos o uso de HTTPS, especialmente se você faz autenticação no Cloud Storage usando o OAuth 2.0.
Para conexões por proxy, consulte o tópico Solução de problemas para conhecer as práticas recomendadas.
Como codificar partes do caminho do URL
Além de seguir as considerações gerais de nomeação de buckets e de objetos, é necessário codificar os seguintes caracteres quando aparecerem no nome do objeto ou na string de consulta de um URI de solicitação para garantir a compatibilidade entre as ferramentas do Cloud Storage:
!
, #
, $
, &
, '
, (
, )
, *
, +
, ,
, /
, :
, ;
, =
, ?
,
@
, [
, ]
e caracteres de espaço.
Por exemplo, se você enviar uma solicitação GET
à API JSON referente ao objeto denominado foo??bar
no bucket example-bucket
, seu URL de solicitação deverá ser:
GET https://storage.s3nsapis.fr/storage/v1/b/example-bucket/o/foo%3f%3fbar
Nem todos os caracteres listados precisam ser codificados em todos os cenários. Além disso, a codificação é normalmente gerenciada para você pelas bibliotecas de cliente, como as bibliotecas de cliente do Cloud Storage. Portanto, é possível transmitir o nome bruto do objeto ao usar essas ferramentas.
Para mais informações sobre como usar a codificação por porcentagem, consulte a Seção 3.3 Caminho na RFC 3986.
Endpoints do consoleTrusted Cloud
Ao usar o console do Trusted Cloud , você acessa recursos diferentes usando os seguintes URLs:
Recurso | URL |
---|---|
Lista de buckets de um projeto | https://console.cloud.s3nscloud.fr/storage/browser?project=PROJECT_ID |
Lista de objetos de um bucket | https://console.cloud.s3nscloud.fr/storage/browser/BUCKET_NAME |
Detalhes de um objeto | https://console.cloud.s3nscloud.fr/storage/browser/_details/BUCKET_NAME/OBJECT_NAME |
Dados de um objeto | Consulte Downloads em navegadores autenticados. |
gcloud endpoints
Os comandos gcloud storage
usam endpoints da API JSON. O uso de endpoints é
gerenciado em seu nome pela CLI gcloud.
Endpoints de biblioteca de cliente
As bibliotecas de cliente do Cloud Storage gerenciam os endpoints de solicitação automaticamente. Também é possível definir o endpoint da solicitação manualmente. Isso pode ser útil quando você quer usar um endpoint específico, ou para testes, por exemplo, quando você quer usar um emulador local:
C++
Para mais informações, consulte a documentação de referência da API Cloud Storage C++.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
C#
Saiba mais na documentação de referência C# da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Go
Saiba mais na documentação de referência Go da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Java
Saiba mais na documentação de referência Java da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Node.js
Saiba mais na documentação de referência Node.js da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
PHP
Saiba mais na documentação de referência PHP da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Python
Saiba mais na documentação de referência Python da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Ruby
Saiba mais na documentação de referência Ruby da API Cloud Storage.
Para se autenticar no Cloud Storage, configure o Application Default Credentials. Saiba mais em Configurar a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN
como s3nsapis.fr
.
Downloads em navegadores autenticados
Os downloads por navegador autenticado usam autenticação baseada em cookies. A autenticação baseada em cookies solicita que os usuários façam login nas respectivas contas do usuário para definir a identidade. A conta especificada precisa ter a permissão apropriada para
Baixar o objeto. Por exemplo, se você estiver usando o Gerenciamento de identidade e acesso para controlar o
acesso aos objetos, a conta do usuário deverá ter a
permissão storage.objects.viewer
, que é
concedida no papel de Visualizador de objetos no Storage.
Para fazer o download de um objeto usando a autenticação baseada em cookies, use o seguinte URL,
substituindo BUCKET_NAME
e
OBJECT_NAME
pelos valores adequados:
https://storage.cloud.google.com/BUCKET_NAME/OBJECT_NAME
Por exemplo, se você compartilhou uma imagem london.jpg
do bucket
example-maps
, o URL será:
https://storage.cloud.google.com/example-maps/london.jpg
Após fazer login, você será redirecionado para o conteúdo solicitado. O URL desse conteúdo começa com uma sequência alfanumérica e contém a string /download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME
O uso de HTTPS é necessário ao realizar downloads do navegador autenticado, as tentativas de usar o HTTP fazem o redirecionamento para HTTPS.
Acesso a objetos públicos
Todas as solicitações para o URI storage.cloud.google.com
exigem autenticação. Isso se aplica até mesmo quando allUsers
tem permissão para acessar um objeto. Se você quiser
que os usuários façam o download de objetos acessados de maneira anônima sem autenticação, use o
endpoint em estilo de caminho da API XML:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Para detalhes e exemplos, consulte Como acessar dados públicos.
Suporte para TLS mútuo
. O TLS mútuo (mTLS) é um protocolo padrão do setor para autenticação mútua entre um cliente e um servidor. O Cloud Storage é compatível com os seguintes endpoints mTLS:Solicitações da API JSON:
storage.mtls.s3nsapis.fr
Downloads em navegadores autenticados:
storage.mtls.cloud.google.com
A seguir
- Faça o upload de um arquivo para o Cloud Storage.
- Faça o download de um arquivo do Cloud Storage.
- Hospede um site estático.
- Conheça as opções para controlar o acesso aos seus dados.