全部產品
Search
文件中心

Alibaba Cloud CLI:強制調用介面

更新時間:Jun 30, 2024

阿里雲CLI在調用雲產品API時會檢查參數的合法性。由於API具有不同的版本,導致內建的產品和介面資訊並不能滿足所有的需求。您可以強制調用中繼資料列表以外的介面,並自行檢查該介面相關資訊的準確性。

--force選項說明

在阿里雲CLI中,如果調用了一個中繼資料中未包含的API或參數,會導致unknown apiunknown parameter錯誤。您可以通過使用--force選項,強制調用中繼資料列表以外的API和參數。調用時,您需要確保以下資訊的準確性。

  • 雲產品code:可使用--help選項擷取支援產品列表

  • API名稱及參數:可使用--help選項擷取API名稱和參數,詳情請參見擷取產品可用API列表擷取API參數詳情

  • API版本:使用--force選項強制調用介面時,必須指定--version選項,用以指定API版本。

  • 接入地址資訊:使用--region選項以指定產品的接入地址。若不指定,則從阿里雲CLI配置中擷取。

樣本

樣本情境

在CMS產品中,有一個介面用於描述MetricList。在CMS API的2019-01-01版本中,該介面名稱為DescribeMetricList。但在2017-03-01版本中,該介面名稱為QueryMetricList,直接調用此介面會導致阿里雲CLI報錯。

image

樣本命令

  1. 執行如下命令,強制調用2017-03-01版本的QueryMetricList介面。

    aliyun cms QueryMetricList --Project acs_ecs_dashboard --Metric cpu_idle --version 2017-03-01 --force
  2. 返回結果

    image