在 Trusted Cloud 中使用用戶端程式庫

Trusted Cloud 提供多種語言的用戶端程式庫,例如 Go、Java 和 C++,可讓您透過程式碼與服務互動。這些程式庫包括我們推薦的 Cloud 用戶端程式庫,以及舊版 Google API 用戶端程式庫。如要進一步瞭解用戶端程式庫和存取Trusted Cloud中的服務,請參閱「用戶端程式庫說明」。

本文說明在 Trusted Cloud中使用這些程式庫時,需要採取的具體步驟,以及與在 Google Cloud 中使用這些程式庫的主要差異。

事前準備

在Trusted Cloud中使用用戶端程式庫時,您必須指定 universe。請先將 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 用戶端程式庫 (依語言分類)」一文。

驗證及使用用戶端程式庫

如要在本地開發或實際環境中開始使用用戶端程式庫,請瞭解如何使用應用程式預設憑證驗證並建立用戶端連線

後續步驟