ECS集成概覽
使用編程方式在業(yè)務(wù)系統(tǒng)中集成云服務(wù)器 ECS（Elastic Compute Service）的能力，使系統(tǒng)能夠自動(dòng)化地創(chuàng)建ECS實(shí)例、創(chuàng)建ECS快照、查詢ECS實(shí)例資源、ECS實(shí)例運(yùn)行狀態(tài)以及管理ECS安全組、ECS云盤等資源，簡(jiǎn)化運(yùn)營(yíng)、管理成本。本文為您介紹云服務(wù)器 ECS開(kāi)放的OpenAPI及支持的集成方式。
ECS OpenAPI
想了解OpenAPI的完整調(diào)用鏈路流程及涉及到的身份、授權(quán)、憑證等信息，請(qǐng)參見(jiàn)什么是OpenAPI。
在線調(diào)試
云服務(wù)器 ECS在OpenAPI門戶提供API調(diào)試等功能。在調(diào)用前，您需要了解云服務(wù)器 ECS提供的版本、接入點(diǎn)說(shuō)明、集成方式等信息。
版本說(shuō)明
阿里云OpenAPI通過(guò)版本號(hào)管控各時(shí)期云產(chǎn)品大版本的API列表，例如云服務(wù)器 ECS目前支持2014-05-26版本的API列表，2014-05-26代表的是API版本號(hào)而非時(shí)間概念，所展示的都是最新的API公開(kāi)數(shù)據(jù)，并非自2014-05-26之后就未更新。
版本號(hào) | 說(shuō)明 |
推薦使用。 包含云服務(wù)器 ECS實(shí)例、鏡像、快照、安全組、密鑰對(duì)、塊存儲(chǔ)等基礎(chǔ)功能。 | |
包含塊存儲(chǔ)EBS異步復(fù)制、數(shù)據(jù)洞察、專屬塊存儲(chǔ)集群等高階功能。 |
服務(wù)接入點(diǎn)說(shuō)明
服務(wù)接入點(diǎn)是訪問(wèn)阿里云服務(wù)的入口點(diǎn)。根據(jù)相關(guān)資源所在地域，選擇對(duì)應(yīng)的服務(wù)接入點(diǎn)地址，以獲得最低延遲。例如華東1（杭州）的云服務(wù)器 ECS公網(wǎng)接入地址為ecs-cn-hangzhou.aliyuncs.com，VPC接入地址為ecs-vpc.cn-hangzhou.aliyuncs.com。
公網(wǎng)接入地址在全球都可訪問(wèn)。
VPC接入地址只有在阿里云對(duì)應(yīng)的地域內(nèi)，且是VPC網(wǎng)絡(luò)類型才可訪問(wèn)。VPC接入地址的優(yōu)勢(shì)：
高安全性：VPC服務(wù)地址只能在VPC內(nèi)部訪問(wèn)，提供更高的安全性和隱私性。
更快的響應(yīng)速度：由于VPC服務(wù)地址在VPC內(nèi)部網(wǎng)絡(luò)中運(yùn)行，其響應(yīng)速度通常比公網(wǎng)服務(wù)更快，且可以避免公網(wǎng)延遲和帶寬限制等問(wèn)題。
更低的成本：VPC服務(wù)地址可以使用內(nèi)部網(wǎng)絡(luò)通信。
更多信息，請(qǐng)參見(jiàn)服務(wù)接入點(diǎn)。
支持的調(diào)用身份
您阿里云賬號(hào)登錄OpenAPI網(wǎng)站后，OpenAPI默認(rèn)使用您的阿里云賬號(hào)進(jìn)行在線OpenAPI調(diào)試。阿里云賬號(hào)擁有所有API的訪問(wèn)權(quán)限，風(fēng)險(xiǎn)很高。強(qiáng)烈建議您創(chuàng)建并使用RAM用戶進(jìn)行API訪問(wèn)或日常運(yùn)維。ECS對(duì)于以下用戶身份訪問(wèn)OpenAPI的支持情況如下表所示：
用戶身份 | 支持情況 |
支持 | |
RAM 用戶（推薦） | 支持 |
RAM角色（推薦） | 支持 |
集成方式
SDK是最易于集成，且支持度最好的OpenAPI調(diào)用方式，推薦您選擇使用SDK。
ECS支持通過(guò)SDK、CLI等方式管理云上資源，具體的支持情況如下表所示：
集成方式 | 支持情況 |
阿里云SDK（推薦） | 支持 |
阿里云CLI | 支持 說(shuō)明
|
Terraform | 支持 說(shuō)明
|
資源編排ROS | 支持 說(shuō)明
|
自定義封裝API調(diào)用 | 支持 說(shuō)明
|
注意事項(xiàng)
如果調(diào)用云服務(wù)器 ECS API后返回錯(cuò)誤，您需要根據(jù)返回的錯(cuò)誤碼提示檢查傳入的請(qǐng)求參數(shù)及其取值是否正確。更多信息，請(qǐng)參見(jiàn)公共錯(cuò)誤碼。
您也可以記錄下調(diào)用返回的RequestID或SDK報(bào)錯(cuò)信息，通過(guò)阿里云OpenAPI診斷平臺(tái)進(jìn)行自助診斷。