Cloud Key Management Service 提供傳統的 REST/HTTP 和 gRPC 介面。如果您不想使用我們的用戶端程式庫存取 Cloud Key Management Service API,可以選擇自行編寫用戶端程式庫,使用其 REST/HTTP 或 gRPC API 介面。只有在提供的用戶端程式庫無法滿足您的程式設計語言或其他需求時,才建議採用這個方法。
gRPC API
您可以使用下列資源,從 Cloud Key Management Service API 的 .proto 服務定義,以任何支援 gRPC 的語言產生自己的 gRPC 用戶端程式庫:
- 將 gRPC 與 Cloud KMS 搭配使用
- Cloud KMS 服務定義
- gRPC 說明文件:產生及使用專屬 gRPC 用戶端程式碼所需的一切資訊。
- RPC API 參考資料:與語言無關的 RPC 介面總覽。
REST/HTTP API
與服務的 REST 介面互動時,有多種選項可供選擇。 如要建立自己的用戶端,請使用下列資源:
- REST API 參考資料
- 使用 Google HTTP API 的指南
- API 探索服務: 公開 REST/HTTP API 介面的機器可讀取中繼資料,有助於建立用戶端程式庫、工具和外掛程式。
- 用戶端範例目錄,以 REST/HTTP API 和 Google API 探索服務建構而成。
服務端點
Cloud KMS 具有全域和位置服務端點。全球 REST/HTTP 端點為 https://cloudkms.googleapis.com,全球 gRPC 端點為 cloudkms.googleapis.com。全域端點會將要求轉送至資源名稱指定的位置服務。
位置 REST/HTTP 端點為 https://<region>-cloudkms.googleapis.com,位置 gRPC 端點為 <region>-cloudkms.googleapis.com,請將 <region> 替換為任何支援的區域、雙區域或多區域 Cloud KMS 位置。這些端點會依據位置隔離,也就是說,每個端點都會將要求路由至端點名稱指定位置的服務。如果資源名稱指定的位置與端點指定的位置不符,要求就會失敗。