在 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 项目都带有“universe”前缀 s3ns::例如 s3ns:example-project

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

安装客户端库

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

进行身份验证并使用客户端库

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

后续步骤