OCloud de Confiance 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 Cloud de Confiance, consulte Explicações sobre bibliotecas de cliente.
Este documento explica as etapas específicas que você precisa seguir para usar essas bibliotecas em Cloud de Confiance, 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
Cloud de Confiance. 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 Cloud de Confiance 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 deCloud de Confiance. Por exemplo,bigquery.googleapis.comse tornabigquery.s3nsapis.fr.É necessário especificar um universo ao usar bibliotecas de cliente em Cloud de Confiance, conforme descrito na seção Antes de começar anterior.
Ao especificar IDs de projeto, todos os projetosCloud de Confiance 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 Cloud de Confiance, algumas bibliotecas de cliente ou chamadas REST podem não funcionar no Cloud de Confiance. 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.