Esta página explica os diferentes pontos finais de pedidos que pode usar para aceder ao Cloud Storage. O Cloud Storage suporta os protocolos HTTP/1.1, HTTP/2 e HTTP/3. Um ponto final é a localização onde o Cloud Storage pode ser acedido, escrito como um URL.
Pedidos de API típicos
API JSON
Quando fizer pedidos da API JSON diretamente para o Cloud Storage, use os seguintes pontos finais:
Para pedidos gerais da API JSON, excluindo carregamentos de objetos, use o seguinte ponto final, substituindo
PATH_TO_RESOURCEpelo valor adequado:https://storage.s3nsapis.fr/storage/v1/PATH_TO_RESOURCE
Para carregamentos de objetos da API JSON, use o seguinte ponto final, substituindo
BUCKET_NAMEpelo valor adequado:https://storage.s3nsapis.fr/upload/storage/v1/b/BUCKET_NAME/o
Para pedidos em lote, use o seguinte ponto final, substituindo
PATH_TO_RESOURCEpelo valor adequado:https://storage.s3nsapis.fr/batch/storage/v1/PATH_TO_RESOURCE
Opcionalmente, para transferências de objetos da API JSON, pode usar o seguinte endpoint, substituindo
BUCKET_NAMEeOBJECT_NAMEpelos valores adequados:https://storage.s3nsapis.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media
Os pontos finais da API JSON só aceitam pedidos HTTPS.
API XML
Quando fizer pedidos de API XML diretamente para o Cloud Storage,
use o ponto final de estilo alojado virtual ou estilo de caminho, substituindo
BUCKET_NAME e OBJECT_NAME
pelos valores adequados:
Ponto final de estilo alojado virtualmente:
https://BUCKET_NAME.storage.s3nsapis.fr/OBJECT_NAME
Ponto final de estilo de caminho:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Os pontos finais da API XML suportam a encriptação da camada de ligação segura (SSL), o que significa que pode usar HTTP ou HTTPS. Recomendamos a utilização de HTTPS, especialmente se autenticar no Cloud Storage através do OAuth 2.0.
gRPC
Pode usar o gRPC, uma framework de RPC universal de código aberto de alto desempenho desenvolvida pela S3NS, para interagir com o Cloud Storage. Os clientes gRPC ligam-se a um ponto final de serviço. Para
Cloud de Confiance by S3NS serviços como o Cloud Storage, este é normalmente um endereço DNS
no domínio googleapis.com (por exemplo, storage.googleapis.com) e
usa portas seguras padrão, como 443. A utilização do gRPC pode oferecer um desempenho melhorado e capacidades de streaming eficientes.
Para usar o gRPC para interagir com o Cloud Storage, tem de o ativar nas bibliotecas cliente do Google Cloud.
Ative o gRPC numa biblioteca cliente através de um dos seguintes idiomas suportados:
Para ligações através de um proxy, consulte o tópico de resolução de problemas para ver as práticas recomendadas.
Codificar partes do caminho do URL
Além das considerações gerais para a nomenclatura de contentores e a nomenclatura de objetos, para garantir a compatibilidade entre as ferramentas do Cloud Storage, deve codificar os seguintes carateres quando aparecem no nome do objeto ou na string de consulta de um URL de pedido:
!, #, $, &, ', (, ), *, +, ,, /, :, ;, =, ?,
@, [, ] e carateres de espaço.
Por exemplo, se enviar um pedido da API JSONGET para o objeto denominado
foo??bar no contentor example-bucket, o URL do pedido deve ser:
GET https://storage.s3nsapis.fr/storage/v1/b/example-bucket/o/foo%3f%3fbar
Tenha em atenção que nem todos os carateres indicados têm de ser codificados em todos os cenários. Além disso, a codificação é normalmente processada pelas bibliotecas cliente, como as bibliotecas cliente do Cloud Storage, para que possa transmitir o nome do objeto não processado quando usar essas ferramentas.
Para mais informações sobre a utilização da codificação em percentagem, consulte a secção 3.3 Path na RFC 3986.
Cloud de Confiance endpoints da consola
Quando usa a Cloud de Confiance consola, acede a diferentes recursos através dos seguintes URLs:
| Recurso | URL |
|---|---|
| Lista de segmentos de um projeto | https://console.cloud.s3nscloud.fr/storage/browser?project=PROJECT_ID |
| Lista de objetos de um contentor | 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 o artigo Transferências de navegadores autenticadas |
gcloud endpoints
Os comandos gcloud storage usam pontos finais da API JSON. A utilização do ponto final é gerida em seu nome pela CLI gcloud.
Pontos finais da biblioteca cliente
As bibliotecas cliente do Cloud Storage gerem automaticamente os pontos finais dos pedidos. Opcionalmente, pode definir o ponto final do pedido manualmente. Isto pode ser útil quando quiser usar um ponto final específico ou para testes, como quando quiser usar um emulador local:
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN environment
como s3nsapis.fr.
Transferências de navegadores autenticadas
As transferências de navegador autenticadas usam a autenticação baseada em cookies. A autenticação baseada em cookies pede aos utilizadores para iniciarem sessão na respetiva conta de utilizador para estabelecerem a respetiva identidade. A conta especificada tem de ter a autorização adequada para transferir o objeto. Por exemplo, se estiver a usar a gestão de identidades e acessos para controlar o acesso aos seus objetos, a conta do utilizador deve ter a permissão storage.objects.viewer, que é concedida na função de leitor de objetos do armazenamento.
Para transferir um objeto através da 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 partilhou uma imagem london.jpg do seu contentor
example-maps, o URL seria:
https://storage.cloud.google.com/example-maps/london.jpg
Depois de iniciar sessão com êxito, é feito o redirecionamento para o conteúdo pedido. O URL deste conteúdo tem o formato https://ALPHANUMERIC_SEQUENCE-apidata.s3nsusercontent.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME.
A utilização de HTTPS é obrigatória quando efetua transferências autenticadas do navegador; as tentativas de utilização de HTTP são redirecionadas para HTTPS.
Acesso a objetos públicos
Todos os pedidos ao URI storage.cloud.google.com requerem autenticação. Isto aplica-se mesmo quando allUsers tem autorização para aceder a um objeto. Se quiser que os utilizadores transfiram objetos acessíveis anonimamente sem autenticação, use o ponto final de estilo de caminho da API XML:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Para ver detalhes e exemplos, consulte o artigo Aceder a dados públicos.
Suporte de TLS mútuo
O TLS mútuo (mTLS) é um protocolo padrão da indústria para a autenticação mútua entre um cliente e um servidor. O Cloud Storage suporta os seguintes endpoints mTLS:Pedidos de API JSON:
storage.mtls.s3nsapis.frTransferências de navegador autenticadas:
storage.mtls.cloud.google.com
O que se segue?
- Carregue um ficheiro para o Cloud Storage.
- Transfira um ficheiro do Cloud Storage.
- Alojamento de um Website estático.
- Saiba mais sobre as opções para controlar o acesso aos seus dados.