本頁說明如何從專案描述、列出及刪除類型。
事前準備
- 如要使用本指南提供的指令列範例,請安裝 `gcloud` 指令列工具。
- 如要使用本指南提供的 API 範例,請設定 API 存取權。
- 如要使用本指南提供的 API 範例,請設定 v2beta API 存取權。
描述類型提供者
類型提供者是已與 Deployment Manager 整合為「類型」的 API。您可以描述單一類型提供者、取得所有類型提供者的清單,或是取得由類型提供者提供的所有類型的清單。
描述單一類型提供者
您可以描述類型提供者來取得各種資訊,例如已針對特定 API 設定的描述元文件網址和進階 API 選項。
gcloud
執行 type-providers describe 指令來描述類型提供者。
gcloud beta deployment-manager type-providers describe PROVIDER_NAME --project PROJECT_ID
舉例來說,您可以使用下列指令描述 Pub/Sub 類型提供者:
gcloud beta deployment-manager type-providers describe pubsub-v1 --project gcp-types
API
向下列的 URI 發出 GET 要求:
https://www.googleapis.com/deploymentmanager/v2beta/projects/[PROJECT_ID]/global/typeProviders/[PROVIDER_NAME]
舉例來說,請為 Pub/Sub 類型提供者使用這個 URI:
https://www.googleapis.com/deploymentmanager/v2beta/projects/gcp-types/global/typeProviders/pubsub-v1
取得類型提供者所提供類型的清單
類型提供者會將基礎 API 的所有資源公開為基礎類型。您可以取得類型提供者所提供基礎類型的清單。
gcloud
如要取得類型提供者所提供基礎類型的清單,請按照下列指示操作:
gcloud beta deployment-manager types list --provider [TYPE_PROVIDER] --project [PROJECT_ID]
舉例來說,如要取得 Compute Engine 類型提供者中的基礎類型清單,請執行下列指令:
gcloud beta deployment-manager types list --provider compute-v1 --project gcp-types
API
向下列的 URI 發出 GET 要求:
GET https://www.googleapis.com/deploymentmanager/v2beta/projects/[PROJECT_ID]/global/typeProviders/[PROVIDER_NAME]/types
舉例來說,如要查看 Compute Engine 類型供應商的類型清單,請使用下列 URI:
GET https://www.googleapis.com/deploymentmanager/v2beta/projects/gcp-types/global/typeProviders/compute-v1/types
列出類型提供者
您可以使用 gcloud CLI 或 API 取得類型提供者清單。
gcloud
如要列出類型提供者,請發出 type-providers list 要求:
gcloud beta deployment-manager type-providers list
API
透過 API 向全域的類型提供者清單發出 GET 要求:
GET https://www.googleapis.com/deploymentmanager/v2/projects/[PROJECT_ID]/global/typeProviders
詳情請參閱 list 方法的說明文件。
描述複合類型
複合類型是已永久新增至 Deployment Manager 來當做類型的一組範本。您可以描述單一複合類型,或是取得專案可用的複合類型清單。
描述單一複合類型
您可以描述單一複合類型,藉此取得類型相關資訊。
gcloud
如要描述類型,請執行 types describe 指令:
gcloud beta deployment-manager types describe [COMPOSITE_TYPE_NAME] --provider composite
API
向下列的 URI 發出 GET 要求:
https://www.googleapis.com/deploymentmanager/v2beta/projects/[PROJECT_ID]/global/compositeTypes/[COMPOSITE_TYPE_NAME]
列出複合類型
您可以使用 gcloud CLI 或 API 來取得複合類型的清單。
gcloud
如要列出複合類型,請發出 types list 要求:
gcloud beta deployment-manager types list --provider composite
API
透過 API 向全域的類型清單發出 GET 要求:
GET https://www.googleapis.com/deploymentmanager/v2/projects/[PROJECT_ID]/global/types
詳情請參閱 list 方法的說明文件。
刪除類型提供者
gcloud
如要刪除類型提供者,請發出 type-providers delete 要求。例如:
gcloud beta deployment-manager type-providers delete [TYPE_PROVIDER]
API
透過 API 向您要刪除的類型提供者發出 DELETE 要求:
DELETE https://www.googleapis.com/deploymentmanager/v2beta/projects/[PROJECT_ID]/global/typeProviders/[TYPE_PROVIDER]
詳情請參閱 delete 方法的說明文件。
刪除複合類型
gcloud
如要刪除複合類型,請發出 types delete 要求。例如:
gcloud beta deployment-manager types delete [COMPOSITE_TYPE]
API
透過 API 向您要刪除的類型發出 DELETE 要求:
DELETE https://www.googleapis.com/deploymentmanager/v2beta/projects/[PROJECT_ID]/global/compositeTypes/[COMPOSITE_TYPE]
詳情請參閱 delete 方法的說明文件。