Utiliser des bibliothèques clientes dans Trusted Cloud

Trusted Cloud fournit une gamme de bibliothèques clientes dans de nombreux langages, tels que Go, Java et C++, que vous pouvez utiliser pour interagir avec les services de manière programmatique. Ces bibliothèques incluent nos bibliothèques clientes Cloud recommandées, ainsi que nos anciennes bibliothèques clientes d'API Google. Pour en savoir plus sur les bibliothèques clientes et l'accès aux services dansTrusted Cloud, consultez la présentation des bibliothèques clientes.

Ce document explique les étapes spécifiques que vous devez suivre pour utiliser ces bibliothèques dans Trusted Cloud, ainsi que les principales différences avec leur utilisation avec Google Cloud.

Avant de commencer

Vous devez spécifier votre univers lorsque vous utilisez des bibliothèques clientes dansTrusted Cloud. Définissez la variable d'environnement GOOGLE_CLOUD_UNIVERSE_DOMAIN sur s3nsapis.fr avant d'utiliser les bibliothèques clientes, y compris en exécutant l'un de nos exemples de code qui les utilisent:

export GOOGLE_CLOUD_UNIVERSE_DOMAIN=s3nsapis.fr

Vous pouvez également spécifier un univers cible dans votre propre code. La syntaxe varie selon la langue.

Différences avec Google Cloud

Les principales différences entre l'utilisation de bibliothèques clientes dansTrusted Cloud et Google Cloud sont les suivantes:

  • Les noms de service d'API par défaut sont les mêmes que dans Google Cloud, par exemple bigquery.googleapis.com. Ces noms de service sont visibles lorsque vous activez ou désactivez des API, par exemple. Toutefois, le nom de domaine complet du point de terminaison de service est différent, en fonction du nom d'hôte deTrusted Cloud. Par exemple, bigquery.googleapis.com devient bigquery.s3nsapis.fr.

  • Vous devez spécifier un univers lorsque vous utilisez des bibliothèques clientes dansTrusted Cloud, comme décrit dans la section Avant de commencer précédente.

  • Lorsque vous spécifiez des ID de projet, les projetsTrusted Cloud ont tous le préfixe d'univers s3ns:: par exemple, s3ns:example-project.

  • Étant donné que toutes les fonctionnalités et tous les services Google Cloud ne sont pas disponibles dans Trusted Cloud, il est possible que certaines bibliothèques clientes ou appels REST ne fonctionnent pas dansTrusted Cloud. Si votre code envoie une requête à un produit ou service indisponible, la requête échouera.

Installer les bibliothèques clientes

Les bibliothèques clientes Cloud sont disponibles pour Go, Java, Node.js, Python, Ruby, PHP, C# et C++. Chaque bibliothèque dispose d'un dépôt GitHub avec des instructions d'installation ou d'implémentation, ainsi que des exemples pour vous aider à vous lancer. Pour installer et commencer à utiliser la bibliothèque de votre choix, consultez la page Bibliothèques clientes Cloud par langue.

Authentifier et utiliser les bibliothèques clientes

Pour commencer à utiliser des bibliothèques clientes dans un environnement de développement ou de production local, découvrez comment vous authentifier à l'aide des identifiants par défaut de l'application et créer une connexion client.

Étape suivante