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 用戶端程式庫 (依語言分類)」一文。
驗證及使用用戶端程式庫
如要在本地開發或實際環境中開始使用用戶端程式庫,請瞭解如何使用應用程式預設憑證驗證並建立用戶端連線。