阿里云CLI（Alibaba Cloud Command Line Interface）是基于OpenAPI構建的通用命令行工具，您可以通過阿里云CLI實現自動化管理和維護IMS（Identity Management Service）。本文以調用GetUser接口查詢指定RAM用戶詳情為例，為您介紹使用阿里云CLI調用IMS OpenAPI的操作步驟。
前置概念
閱讀本文前，若您還不了解阿里云CLI，請參見什么是阿里云CLI。
步驟一：安裝阿里云CLI
使用阿里云CLI前，您需要先安裝阿里云CLI。阿里云CLI為用戶提供了Windows、Linux和macOS三種操作系統下的安裝服務，請根據您所使用的操作系統選擇對應的安裝服務。
Windows：在Windows上安裝阿里云CLI。
Linux：在Linux上安裝阿里云CLI。
macOS：在macOS上安裝阿里云CLI。
您可使用阿里云提供的云命令行Cloud Shell調試阿里云CLI命令。關于云命令行的更多信息，請參見什么是云命令行。
步驟二：配置阿里云CLI
阿里云主賬號擁有所有產品OpenAPI的管理和訪問權限，風險很高。強烈建議您創建RAM身份，并依據最小化權限原則授予權限，使用RAM身份訪問OpenAPI。
使用阿里云CLI之前，您需要在阿里云CLI中配置身份憑證、地域ID等信息。阿里云CLI支持多種身份憑證，詳情請參見身份憑證類型。本文操作以AK類型憑證為例，具體操作步驟如下：
創建一個RAM用戶，并創建AccessKey，以便后續配置身份憑證使用。具體操作，請參見創建RAM用戶及創建AccessKey。
為RAM用戶授權。本文示例需授予RAM用戶只讀訪問IMS的權限
AliyunRAMReadOnlyAccess。具體操作，請參見為RAM用戶授權。獲取可用的地域ID，以便后續配置身份憑證使用。阿里云CLI將使用您指定的地域發起OpenAPI調用。可用地域詳情請參見服務接入點。
說明使用阿里云CLI過程中您可使用
--region選項指定地域發起命令調用，該選項在使用時將忽略默認身份憑證配置及環境變量設置中的地域信息。詳情請參見OpenAPI命令可用選項。使用RAM用戶的AccessKey配置AK類型憑證，配置文件命名為
AkProfile。具體操作，請參見配置示例。
步驟三：生成CLI命令示例
在OpenAPI門戶中，訪問GetUser調試地址。
在參數配置中輸入請求參數，單擊CLI示例頁簽，查看生成的CLI示例。
在云命令行中運行命令，或復制CLI示例。
按鈕，可喚出
按鈕，將CLI示例復制到剪貼板中，可粘貼至本地Shell工具中運行。
步驟四：調用IMS OpenAPI
示例一：獲取支持阿里云CLI調用的IMS OpenAPI列表
以下示例將為您展示如何使用--help選項獲取IMS支持阿里云CLI調用OpenAPI列表。您也可在API概覽中查看支持調用的OpenAPI。
執行命令。
aliyun ims --help輸出結果。
示例二：查詢指定RAM用戶的信息
以下示例將為您展示如何使用阿里云CLI調用IMS的GetUser命令，獲取ID為20732900249392****的RAM用戶信息。
執行命令。
aliyun ims GetUser --UserId 20732900249392****輸出結果。
{ "User": { "DisplayName": "test", "UserPrincipalName": "test@example.onaliyun.com", "Email": "alice@example.com", "UpdateDate": "2020-10-13T07:39:22Z", "MobilePhone": "86-1868888****", "UserId": "20732900249392****", "Comments": "This is a cloud computing engineer.", "LastLoginDate": "2020-10-12T09:12:00Z", "CreateDate": "2020-10-12T09:12:00Z", "ProvisionType": "Manual", "Tags": { "Tag": [ { "TagKey": "operator", "TagValue": "alice" } ] } }, "RequestId": "4507D1CD-526A-4E2B-A1E2-3AB045D1EE0B" }說明如果調用身份管理IMS OpenAPI后返回錯誤，您需要根據返回的錯誤碼提示檢查傳入的請求參數及其取值是否正確。
您也可以記錄下調用返回的RequestID或SDK報錯信息，通過阿里云OpenAPI診斷平臺進行自助診斷。