本頁說明如何使用 Google Cloud CLI gcloud endpoints services
指令,管理代管服務的生命週期。
如要處理進階用途,可以使用 Service Management API 以程式輔助方式管理服務。詳情請參閱「開始使用 Service Management API」一文。
簡介
代管服務是一種簡單的資源,可從邏輯上代表與服務基礎架構整合的服務,例如 Gmail API 和 Spanner API。代管服務本身只有兩個不可變更的屬性,即服務名稱和供應商專案,但代管服務的實作項目可提供各種功能。舉例來說,Cloud Storage API 為數百萬名開發人員和企業提供全球規模的物件儲存空間。
代管服務有一組服務消費者、不可變更的服務設定記錄,以及不可變更的服務發布記錄。最新服務推出作業所參照的服務設定代表服務的目前狀態,涵蓋服務的所有層面,從顯示名稱到指標定義,再到速率限制。如需規格,請參閱 google.api.Service
。
本頁面將說明如何建立及管理服務生命週期。如要進一步瞭解服務管理,請參閱操作指南。
建立 Service
如要建立服務,請完成下列步驟。
在電腦上安裝並初始化 gcloud CLI。
建立專屬的生產者專案來代管服務。專屬專案可為服務提供最佳安全防護和隔離措施。您也可以將服務擁有權轉移給其他團隊,甚至是其他公司。
為專案啟用 Service Management API 和 Service Control API。
為專案啟用 Cloud Billing。如要將服務與 Service Infrastructure 整合,您需要使用多項付費 Google Cloud 產品,包括 Service Control API、Cloud Logging API 和 Cloud Monitoring API。
為服務準備簡單的服務設定 YAML 檔案,如下所示:
# Filename: endpointsapis.yaml type: google.api.Service config_version: 3 # Update the next line to use your own service name. name: endpointsapis.appspot.com # Update the next line to use your own producer project id. producer_project_id: endpointsapis
執行
gcloud
指令,部署空白服務設定來建立服務:gcloud endpoints services deploy endpointsapis.yaml
服務建立程序大約需要一分鐘。完成後,您應該就能在 Google Cloud 控制台的「Endpoints」頁面中看到服務。
列出服務
如要列出專案中的服務,可以使用下列指令:
gcloud endpoints services list --project endpointsapis
描述服務
如要說明服務及其設定,可以使用下列指令:
gcloud endpoints services describe endpointsapis.appspot.com
刪除服務
如果不再需要某項服務,可以使用下列指令刪除:
gcloud endpoints services delete endpointsapis.appspot.com
注意:所有服務都必須保留刪除資料 30 天。
取消刪除服務
您可以在保留期限內使用下列指令,還原服務:
gcloud endpoints services undelete endpointsapis.appspot.com
後續步驟
Service Management API 使用服務管理的宣告式模型。建立服務後,您需要推送不可變更的服務設定和服務發布作業,才能達到服務的所需狀態。服務設定可用於設定 Google Cloud 基礎架構服務,以支援您的服務,包括 Cloud Billing、Cloud Logging、Cloud Monitoring 和 Identity and Access Management。
如要進一步瞭解服務設定,請參閱「管理服務設定」。如要進一步瞭解服務推出作業,請參閱管理服務推出作業。