前置概念

阿里云CLI（Alibaba Cloud Command Line Interface）是基于OpenAPI構建的通用命令行工具，您可以通過阿里云CLI實現自動化管理和維護資源組。更多信息，請參見什么是阿里云CLI。

步驟一：安裝阿里云CLI

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

• Windows：在Windows上安裝阿里云CLI。

• Linux：在Linux上安裝阿里云CLI。

• macOS：在macOS上安裝阿里云CLI。

云命令行（Cloud Shell）預裝了阿里云CLI，且自動為您配置身份憑證，無需手動操作。您可在云命令行中調試阿里云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選項指定地域發起命令調用，該選項在使用時將忽略默認身份憑證配置及環境變量設置中的地域信息。更多信息，請參見API命令可用選項。

4. 使用RAM用戶的AccessKey及地域ID配置AK類型憑證，配置文件命名為AkProfile。具體操作，請參見配置示例。

步驟三：生成CLI命令示例

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

   

2. 在參數配置中輸入請求參數，單擊CLI示例頁簽，查看生成的CLI示例。

3. 復制CLI示例或在云命令行中快速執行：

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

   • 單擊復制按鈕，將CLI示例復制到剪貼板中，可粘貼至本地Shell工具中運行。

   說明

   • 復制CLI示例到本地Shell工具中進行調試時請注意參數格式。關于阿里云CLI命令參數使用格式的詳細信息，請參見參數格式說明。

   • OpenAPI門戶生成示例中會默認添加--region選項，復制命令到本地調用時阿里云CLI將忽略默認身份憑證配置及環境變量設置中的地域信息，優先使用指定的地域調用命令，您可根據需要對該選項進行刪除或保留。

步驟四：調用資源組OpenAPI

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