阿里云CLI集成了部分云产品的元数据,调用时会检查参数的合法性。由于API具有不同的版本,导致内置的产品和接口信息并不能满足所有的需求。您可以强制调用元数据列表以外的接口,并自行检查该接口相关信息的准确性。

--force选项说明

在阿里云CLI中,如果调用了一个元数据中未包含的API或参数,会导致 unknown apiunknown parameter错误。您可以通过使用 --force选项,强制调用元数据列表以外的API和参数。调用时,您需要确保以下信息的准确性:
  • 云产品code
  • 接口名称及参数
  • API版本
  • endpoint信息

当使用--force选项强制调用接口时,必须指定--version选项,用以指定API版本。例如,ECS的版本号是2014-05-26。还可以指定--endpoint选项,用以指定产品的接入地址。若不指定,则从阿里云CLI内置数据中获取。

示例

  • 示例场景:

    在CMS产品中,有一个接口用于描述MetricList。在阿里云CLI 3.0.16版本中,CMS的API版本为2019-01-01,接口名称为DescribeMetricList。但在2017-03-01版本中,该接口名称为QueryMetricList

  • 示例命令:
    执行如下命令,强制调用 2017-03-01版本的 QueryMetricList接口。
    aliyun cms QueryMetricList [api参数] --force --version 2017-03-01