OTrusted Cloud oferece uma variedade de bibliotecas de cliente em várias linguagens, como Go, Java e C++, que podem ser usadas para interagir com os serviços de forma programática. Essas bibliotecas incluem as bibliotecas de cliente do Cloud recomendadas e as bibliotecas de cliente mais antigas das APIs do Google. Para saber mais sobre bibliotecas de cliente e como acessar serviços no Trusted Cloud, consulte Explicações sobre bibliotecas de cliente.
Este documento explica as etapas específicas que você precisa seguir para usar essas bibliotecas em Trusted Cloud, além das principais diferenças de usá-las com o Google Cloud.
Antes de começar
É necessário especificar seu universo ao usar bibliotecas de cliente em
Trusted Cloud. Defina a
variável de ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN como
s3nsapis.fr antes de usar
bibliotecas de cliente, incluindo a execução de qualquer um dos nossos exemplos de código que as usam:
export GOOGLE_CLOUD_UNIVERSE_DOMAIN=s3nsapis.fr
Também é possível especificar um universo de destino no seu próprio código. A sintaxe para isso varia de acordo com o idioma.
Diferenças do Google Cloud
As seguintes diferenças importantes existem entre o uso de bibliotecas de cliente no Trusted Cloud e no Google Cloud:
Os nomes de serviço de API padrão são iguais aos do Google Cloud, como
bigquery.googleapis.com. Esses nomes de serviço ficam visíveis quando você ativa ou desativa APIs, por exemplo. No entanto, o FQDN do endpoint do serviço é diferente, com base no nome do host deTrusted Cloud. Por exemplo,bigquery.googleapis.comse tornabigquery.s3nsapis.fr.É necessário especificar um universo ao usar bibliotecas de cliente em Trusted Cloud, conforme descrito na seção Antes de começar anterior.
Ao especificar IDs de projeto, todos os projetosTrusted Cloud têm o prefixo de universo
s3ns:: por exemplo,s3ns:example-project.Como nem todos os recursos e serviços do Google Cloud estão disponíveis no Trusted Cloud, algumas bibliotecas de cliente ou chamadas REST podem não funcionar no Trusted Cloud. Se o código fizer uma solicitação para um produto ou serviço indisponível, a solicitação vai falhar.
Instalar bibliotecas de cliente
As bibliotecas de cliente do Cloud estão disponíveis para Go, Java, Node.js, Python, Ruby, PHP, C# e C++. Cada biblioteca tem um repositório do GitHub com instruções para instalar ou implementar as bibliotecas e exemplos para ajudar você a começar. Para instalar e começar a usar a biblioteca que você preferir, consulte Bibliotecas de cliente do Cloud por idioma.
Autenticar e usar bibliotecas de cliente
Para começar a usar as bibliotecas de cliente em um ambiente de desenvolvimento ou de produção local, aprenda a autenticar usando o Application Default Credentials e criar uma conexão de cliente.