在 Trusted Cloud 中使用客户端库

Trusted Cloud 提供多种语言(例如 Go、Java 和 C++)的客户端库,您可以使用这些库以编程方式与服务进行互动。这些库包括我们推荐的 Cloud 客户端库,以及旧版 Google API 客户端库。如需详细了解客户端库以及如何在Trusted Cloud中访问服务,请参阅客户端库说明

本文档介绍了在 Trusted Cloud中使用这些库时需要执行的具体步骤,以及与在 Google Cloud 中使用这些库时的主要区别。

准备工作

在Trusted Cloud中使用客户端库时,您必须指定宇宙。在使用客户端库之前,请将 GOOGLE_CLOUD_UNIVERSE_DOMAIN 环境变量设置为 s3nsapis.fr,包括运行使用这些库的任何代码示例:

export GOOGLE_CLOUD_UNIVERSE_DOMAIN=s3nsapis.fr

您还可以在自己的代码中指定目标宇宙。其语法因语言而异。

与 Google Cloud 的区别

在Trusted Cloud 和 Google Cloud 中使用客户端库存在以下主要区别:

  • 默认 API 服务名称与 Google Cloud 中的名称相同,例如 bigquery.googleapis.com。例如,当您启用或停用 API 时,这些服务名称可见。不过,服务端点 FQDN 因Trusted Cloud的主机名而异。例如,bigquery.googleapis.com 会变为 bigquery.s3nsapis.fr

  • 在Trusted Cloud中使用客户端库时,您必须指定宇宙,如上文的准备工作部分中所述。

  • 指定项目 ID 时,Trusted Cloud 项目都带有宇宙前缀 s3ns:,例如 s3ns:example-project

  • 由于并非所有 Google Cloud 功能和服务都可在 Trusted Cloud中使用,因此某些客户端库或 REST 调用可能无法在Trusted Cloud中使用。如果您的代码向不可用的产品或服务发出请求,该请求将失败。

安装客户端库

Cloud 客户端库适用于 Go、Java、Node.js、Python、Ruby、PHP、C# 和 C++。每个库都有一个 GitHub 代码库,其中包含用于安装或实现库的说明,以及可帮助您入门的示例。如需安装并开始使用您偏好的库,请参阅按语言列出的 Cloud 客户端库

验证并使用客户端库

如需开始在本地开发或生产环境中使用客户端库,请了解如何使用应用默认凭证进行身份验证并创建客户端连接

后续步骤