本文為您介紹ENS支援的整合方案。使用OpenAPI自動化整合ENS,可以提升您使用ENS的開發效率。
OpenAPI介紹
為了能夠讓開發人員快速高效的學習和使用雲產品OpenAPI,阿里雲為使用者提供OpenAPI網站。它是一款集OpenAPI智能搜尋、文檔、線上調試、SDK擷取、CodeSample、調用出錯診斷、調用統計為一體的產品。您可以在OpenAPI門戶中調用阿里雲各雲產品開放的OpenAPI,查看OpenAPI請求和返回結果。此外,OpenAPI門戶會自動產生相應的SDK調用樣本,協助您快速使用阿里雲產品。
更多詳情,請參見OpenAPI概覽。
版本說明
API 版本號碼 | 說明 |
API 版本號碼 | 說明 |
推薦使用 |
線上調試
ENS在OpenAPI門戶提供API調試等功能。在調用前,您需要瞭解ENS服務提供的版本、存取點、介面風格、調用方式等資訊。
調式入口
調試API入口為:ENS API調試入口。
存取點說明
請使用新加坡存取點網域名稱ens.ap-southeast-1.aliyuncs.com
。
更多資訊,請參見服務存取點。
使用者身份
您使用阿里雲帳號登入OpenAPI網站後,預設使用您的阿里雲帳號進行線上OpenAPI調試。由於阿里雲帳號擁有所有API的存取權限,存在較高的風險。強烈建議您建立並使用RAM使用者進行API訪問或日常營運。請根據業務的實際情況按需分配許可權後進行介面調用。RAM使用者需具備操作ENS資源的許可權。具體操作,請參見邊緣節點服務 ENS系統權限原則參考。
推薦您使用RAM使用者或RAM角色,根據業務的實際情況按需分配許可權後進行介面調用。
更多資訊
整合方式
調用方式支援情況
調用方式 | 支援情況 |
調用方式 | 支援情況 |
阿里雲SDK(推薦) | 支援 |
支援 | |
支援 | |
支援 | |
支援 |
阿里雲SDK
阿里雲CLI
Terraform
Terraform 是一種開源工具,用於安全高效地預覽,配置和管理雲基礎架構和資源。它與阿里雲的Resource Orchestration Service服務的運行機制類似,通過將模板轉化為內部資料後完成 OpenAPI 呼叫。更多詳情,請參見什麼是Terraform。
快速使用Terraform編排ENS,請參見Terraform整合樣本。
支援資源清單
支援使用Terraform管理ENS的資源,支援一般資源和資料資源清單的部分如下。如果您還不瞭解Terraform,請參見什麼是Terraform。
資源類型
資源名稱
說明
資源類型
資源名稱
說明
Resources
提供ENS磁碟資源。
提供ENS磁碟執行個體附件資源。
提供ENSElastic IP Address。
提供ENS映像資源。
提供ENS執行個體資源。
提供ENS執行個體安全性群組附件資源。
提供ENS金鑰組資源。
提供ENS負載平衡器資源。
提供ENS網路資源。
提供ENS安全性群組資源。
提供ENS快照資源。
提供ENS vSwitch資源。
Data Sources
提供當前阿里雲使用者的ENS金鑰組。
Resource Orchestration Service
Resource Orchestration Service服務ROS(Resource Orchestration Service)是阿里雲提供的一項簡化雲端運算資源管理的服務。開發人員和管理員可以編寫模板,在模板中定義所需的阿里雲資源(例如:ECS 執行個體、RDS 資料庫執行個體)、資源間的依賴關係等。ROS 的編排引擎將根據模板自動完成所有資源的建立和配置,實現自動化部署及營運。更多詳情,請參見什麼是Resource Orchestration Service服務。
支援使用Resource Orchestration Service服務ROS調用ENS。編排的部分資源套件括普通資源和資料資源。
普通資源:
ALIYUN::ENS::Disk:用於建立一塊隨用隨付或訂用帳戶資料盤。
ALIYUN::ENS::DiskInstanceAttachment:用於為ENS執行個體掛載資料盤。
ALIYUN::ENS::Instance:用於建立ENS執行個體。
ALIYUN::ENS::InstanceSecurityGroupAttachment:用於將一台ENS執行個體加入到指定的安全性群組。
ALIYUN::ENS::KeyPair:用於匯入RSA金鑰組公開金鑰。
ALIYUN::ENS::Network:用於建立一個專用網路。
ALIYUN::ENS::NetworkAcl:用於建立一條網路ACL規則。
ALIYUN::ENS::NetworkAclAssociation:用於綁定網路ACL至網路。
ALIYUN::ENS::SecurityGroup:用於建立一個安全性群組。
ALIYUN::ENS::Snapshot:用於建立快照。
ALIYUN::ENS::VSwitch:用於建立交換器。
資料資源:
DATASOURCE::ENS::Instances:用於查詢多台ENS執行個體的詳細資料。
快速使用Resource Orchestration ServiceENS,請參見Resource Orchestration Service整合樣本。
自訂封裝API調用
原生HTTP調用需要您自己實現簽名演算法,並構建自訂請求,發起HTTP調用。有關簽名機制的更多詳細資料,請參見文檔API概覽和V3版本請求體&簽名機制。
注意事項
如果調用API後返回錯誤,您需要根據返回的錯誤碼提示檢查傳入的請求參數及其取值是否正確,更多資訊請參見錯誤碼中心。
您也可以記錄下調用返回的RequestID或SDK報錯資訊,通過阿里雲OpenAPI診斷平台進行自助診斷。