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_RESOURCEpelo 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_NAMEpelo 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_RESOURCEpelo 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_NAMEeOBJECT_NAMEpelos 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.
gRPC
É possível usar o gRPC, um framework RPC universal de alto desempenho e código aberto desenvolvido pelo S3NS, para interagir com o Cloud Storage. Os clientes gRPC se conectam a um endpoint de serviço. Para
serviçosCloud de Confiance by S3NS , como o Cloud Storage, geralmente é um endereço DNS
no domínio googleapis.com (por exemplo, storage.googleapis.com) e
usa portas seguras padrão, como 443. O uso do gRPC pode melhorar o
desempenho e oferecer recursos de streaming eficientes.
Para usar o gRPC e interagir com o Cloud Storage, é necessário ativá-lo nas bibliotecas de cliente do Cloud.
Ative o gRPC em uma biblioteca de cliente usando uma das seguintes linguagens compatíveis:
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 consoleCloud de Confiance
Ao usar o console Cloud de Confiance , 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 tem o formato
https://ALPHANUMERIC_SEQUENCE-apidata.s3nsusercontent.fr/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.frDownloads 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.