Resource Management：CLI參考

前置概念

阿里雲CLI（Alibaba Cloud Command Line Interface）是基於OpenAPI構建的通用命令列工具，您可以通過阿里雲CLI實現自動化管理和維護資源群組。更多資訊，請參見什麼是阿里雲CLI。

步驟一：安裝阿里雲CLI

使用阿里雲CLI前，您需要先安裝阿里雲CLI。阿里雲CLI為使用者提供了Windows、Linux和macOS三種作業系統下的安裝服務，請根據您使用裝置的作業系統選擇對應的安裝服務。

• Windows：安裝CLI（Windows）。

• Linux：安裝CLI（Linux）。

• macOS：安裝CLI（macOS）。

Cloud Shell預裝了阿里雲CLI，且自動為您配置身份憑證，無需手動操作。您可在Cloud Shell中調試阿里雲CLI命令。更多資訊，請參見什麼是雲命令列。

步驟二：配置阿里雲CLI

使用阿里雲CLI之前，您需要在阿里雲CLI中配置身份憑證、地區ID等資訊。阿里雲CLI支援多種身份憑證，詳情請參見身份憑證類型。本文以AK類型憑證為例，具體操作步驟如下：

1. 建立一個RAM使用者，並建立AccessKey，以便後續配置身份憑證使用。具體操作，請參見建立RAM使用者及建立AccessKey。

2. 為RAM使用者授權。本文樣本需要授予RAM使用者資源群組的CreateResourceGroup許可權。

   1. 建立包含資源群組CreateResourceGroup許可權的自訂權限原則，策略內容如下所示。具體操作，請參見建立自訂權限原則。

      {
        "Version": "1",
        "Statement": [
          {
            "Effect": "Allow",
            "Action": "ram:CreateResourceGroup",
            "Resource": "*"
          }
        ]
      }

   2. 將建立的自訂權限原則授予RAM使用者。具體操作，請參見為RAM使用者授權。

3. 擷取可用的地區ID，以便後續配置身份憑證使用。阿里雲CLI將使用您指定的地區發起OpenAPI調用，資源群組的可用地區請參見服務存取點。

   說明

   使用阿里雲CLI過程中，您可使用--region選項指定地區發起命令調用，該選項在使用時將忽略預設身份憑證配置及環境變數設定中的地區資訊。更多資訊，請參見命令列選項。

4. 使用RAM使用者的AccessKey及地區ID配置AK類型憑證，設定檔命名為AkProfile。具體操作，請參見配置樣本。

步驟三：產生CLI命令樣本

1. 在OpenAPI門戶中，訪問CreateResourceGroup調試地址。

   

2. 在參數配置中輸入請求參數，單擊CLI樣本頁簽，查看產生的CLI樣本。

3. 複製CLI樣本或在Cloud Shell中快速執行：

   • 單擊運行命令按鈕，可喚出Cloud Shell並快速完成命令調試。

   • 單擊複製按鈕，將CLI樣本複製到剪貼簿中，可粘貼至本地Shell工具中運行。

   說明

   • 複製CLI樣本到本地Shell工具中進行調試時請注意參數格式。關於阿里雲CLI命令參數使用格式的詳細資料，請參見參數格式。

   • OpenAPI門戶產生樣本中會預設添加--region選項，複製命令到本地調用時阿里雲CLI將忽略預設身份憑證配置及環境變數設定中的地區資訊，優先使用指定的地區調用命令，您可根據需要對該選項進行刪除或保留。

步驟四：調用資源群組OpenAPI

阿里雲CLI支援調用的資源群組OpenAPI列表，請參見API概覽。