阿里雲CLI是基於阿里雲OpenAPI建立的管理工具,您可在雲命令列中使用阿里雲CLI快速管理阿里雲資源。
前置概念
在雲命令列中使用阿里雲CLI之前,您可能需要瞭解以下資訊:
-
阿里雲CLI是基於阿里雲OpenAPI建立的管理工具,更多資訊請參見什麼是阿里雲 CLI。
-
為確保您的阿里雲帳號及雲資源使用安全,推薦您使用RAM身份(即RAM使用者和RAM角色)來訪問雲命令列。使用RAM身份訪問雲命令列需要授予對應許可權,詳情請參見基於身份的策略。
-
由於同步需求排期存在多種影響因素,雲命令列預裝版本通常會在阿里雲CLI版本升級後數天內完成同步更新。您可使用
aliyun version命令查看阿里雲CLI的目前的版本資訊。您也可手動安裝任意版本阿里雲CLI。
操作步驟
步驟一:啟動雲命令列
在啟動雲命令列之前,您需要使用已授予許可權的可用RAM身份登入阿里雲首頁。雲命令列將使用當前登入態為您自動設定身份憑證,無需手動操作。為避免自動設定憑證功能失效,建議您在操作時避免對初始設定檔default進行修改或刪除。
您可以通過以下方式啟動雲命令列:
-
在控制台中運行
單擊控制台首頁頂部導覽列中的雲命令列按鈕,啟動雲命令列。
-
獨立運行
在瀏覽器中輸入https://shell.aliyun.com,開啟雲命令列操作介面。
-
雲命令列啟動時會為您建立一台虛擬機器,這個過程將消耗一些時間,最長不超過30秒。
-
您可以根據實際需要開啟多個雲命令列視窗,最多可同時開啟5個雲命令列視窗。多個雲命令列視窗會串連到同一台虛擬機器,虛擬機器數量不會因為您開啟新的命令列視窗而增加。
-
更多資訊,請參見什麼是雲命令列?。
步驟二:擷取CLI命令
自動產生
在API調試介面左側搜尋方塊中可搜尋您需要使用的API。在參數配置中根據API文檔資訊填寫參數,單擊參數配置右側的CLI樣本頁簽即可產生攜帶參數的命令樣本。
-
單擊運行命令
按鈕,可喚出雲命令列並快速完成命令調試。 -
單擊複製
按鈕,將CLI命令樣本複製到剪貼簿中,可粘貼至雲命令列中運行。
手動編寫
阿里雲雲產品的API分為RPC和RESTful兩種類型,大部分產品提供RPC API,例如Elastic Compute Service,雲資料庫RDS和負載平衡等。
不同類型的API的調用方法也不同。您可以通過以下特點判斷API類型:
-
API參數中包含Action欄位的是RPC API,需要PathPattern參數的是RESTful API。
-
一般情況下,一個雲產品的API類型是一致的。
更多詳情,請參見理解命令結構。
擷取協助資訊
-
在Cloud Shell中運行以下命令查看雲產品的協助資訊。
aliyun <ProductCode> --help以查看ECS的API列表的協助資訊為例,執行以下命令:
aliyun ecs --help -
在Cloud Shell中運行以下命令查看指定API的協助資訊:
aliyun <ProductCode> <ApiName> --help以查看ECS的
DescribeInstanceAttribute介面的協助資訊為例,執行以下命令:aliyun ecs DescribeInstanceAttribute --help
步驟三:在雲命令列中執行命令
在雲命令列中執行Elastic Compute Service的CreateInstance命令,建立一台隨用隨付ECS執行個體。
shell@Alicloud:~$ aliyun ecs CreateInstance\
> --InstanceName myvm1\
> --ImageId centos_7_03_64_40G_alibase_20170625.vhd\
> --InstanceType ecs.n4.small\
> --SecurityGroupId sg-xxx123\
> --VSwitchId vsw-xxx456\
> --InternetChargeType PayByTraffic\
> --Password