全部產品
Search
文件中心

Data Management:CLI整合樣本-DMS

更新時間:Mar 20, 2025

本文以調用Data Management (DMS)UpdateUser介面,更新系統角色為例,為您介紹使用阿里雲CLI調用Data ManagementOpenAPI的操作步驟。

前置概念

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

當您需要使用CLI調用API完成相對複雜的任務時,建議將CLI整理成Shell指令碼後再執行,以提高效率。

步驟一:安裝阿里雲CLI

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

步驟二:配置阿里雲CLI

重要

阿里雲帳號(主帳號)擁有所有產品OpenAPI的管理和存取權限,風險很高。強烈建議您建立RAM使用者(子帳號),並依據最小化許可權原則授予許可權,使用RAM使用者身份訪問OpenAPI。Data Management支援的權限原則,請參見DMS系統權限原則參考DMS自訂權限原則參考

使用阿里雲CLI之前,您需要在阿里雲CLI中配置身份憑證、地區ID等資訊。阿里雲CLI支援多種身份憑證,詳情請參見身份憑證類型。阿里雲CLI支援使用RAM使用者的AccessKey資訊配置AK類型身份憑證,具體操作步驟如下:

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

  2. 為RAM使用者授權。本文樣本需授予RAM使用者管理Data Management資源的許可權AliyunDMSFullAccess。具體操作,請參見為RAM使用者授權

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

    說明

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

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

步驟三:產生CLI命令樣本

  1. 在OpenAPI門戶中,訪問UpdateUser調試地址

    image

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

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

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

    • 單擊複製按鈕image,將CLI樣本複製到剪貼簿中,可粘貼至本地Shell工具中運行或用於編輯自動化命令列指令碼。

    說明

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

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

步驟四:調用Data ManagementOpenAPI

樣本一:擷取OpenAPI列表

以下樣本將為您展示如何使用--help選項擷取支援阿里雲CLI調用的Data ManagementOpenAPI列表。更多資訊,請參見API概覽

  1. 執行以下命令。

    aliyun dms-enterprise --help
  2. 預期輸出。

    image

樣本二:更新系統角色

以下程式碼範例將為您展示如何使用阿里雲CLI調用Data ManagementUpdateUser介面,更新指定使用者擁有的系統角色。更多介面資訊,請參見UpdateUser - 更新使用者資訊

  1. 執行命令。

    aliyun dms-enterprise UpdateUser --Uid 21400447956867**** --RoleNames 'ADMIN,DBA'
  2. 輸出結果。

    {
        "RequestId": "B94173EF-0AEE-5B38-84A9-E6BDEF2B84F3",
        "Success": true
    }
    說明

    如果調用Data ManagementOpenAPI後返回錯誤,您需要根據返回的錯誤碼提示檢查傳入的請求參數及其取值是否正確。

    您可以記錄下調用返回的RequestID或SDK報錯資訊,通過阿里雲OpenAPI診斷平台進行自助診斷。