雲命令列(Cloud Shell)中預裝了阿里雲CLI,阿里雲CLI是基於阿里雲開放 API 建立的管理工具。您可以通過阿里雲CLI管理阿里雲資源。
阿里雲雲產品的API分為RPC和RESTful兩種類型,大部分產品提供RPC API,例如Elastic Compute Service,雲資料庫RDS和負載平衡等。
不同類型的API的調用方法也不同。您可以通過以下特點判斷API類型:
API參數中包含Action欄位的是RPC API,需要PathPattern參數的是RESTful API。
一般情況下,一個雲產品的API類型是一致的。
啟動Cloud Shell
選擇一種方式啟動雲命令列:
在控制台中運行
單擊控制台首頁頭部導航的命令列按鈕,啟動雲命令列。
獨立運行
在瀏覽器中輸入https://shell.aliyun.com中開啟雲命令列操作介面。
您可以根據實際需要開啟多個命令列視窗,但最多可同時開啟5個雲命令列視窗。
在啟動雲命令時,請注意:
第一次串連雲命令列時會為您建立虛擬機器,會消耗一些時間,最長不超過30秒。
開啟多個雲命令列視窗時,所有視窗都會串連到同一台虛擬機器。虛擬機器數量不會因您開啟新的命令列視窗而增加。
在Cloud Shell中調用RPC API
在雲命令中調用RPC API需遵循以下格式:
aliyun <ProductCode> <ActionName> [--parameter1 value1 --parameter2 value2]
其中:
ProductCode:要調用的雲產品 code,例如雲端服務器的產品code為
ecs
,負載平衡的產品code 為slb
。您可以執行aliyun --help
命令查看產品code。ActionName:要調用的 API。例如使用 ECS 的
DescribeInstanceAttribute
介面查看一個 ECS 執行個體的詳細資料。parameter:要傳入的請求參數。具體參見各產品的API文檔。
樣本
在Cloud Shell中執行以下命令,查看指定ECS執行個體的配置資訊。
運行前,請替換執行個體ID。
aliyun ecs DescribeInstanceAttribute --InstanceId i-bp198exxxxxx | jq
在Cloud Shell中調用RESTful API
部分阿里雲產品如Container Service是RESTful API。RESTful API與RPC API的調用方式不同。使用阿里雲CLI調用RESTful API的基本結構如下:
GET請求
aliyun <ProductCode> GET /<Resource>
樣本
aliyun cs GET /clusters
POST請求
aliyun <ProductCode> POST /<Resource> --body "$(cat input.json)"
樣本
aliyun cs POST /clusters//attach --header "Content-Type=application/json" --body "$(cat attach.json)"
DELETE請求
aliyun <ProductCode> DELETE /<Resource>
樣本
aliyun cs DELETE /clusters/<cluster-id>
相關文檔