Tous les produits
Search
Centre de documentation

:Appel forcé d'une opération d'API

Dernière mise à jour :Aug 11, 2026

Lorsque vous appelez les API des services cloud, Alibaba Cloud CLI vérifie la validité des paramètres. Les API étant disponibles en plusieurs versions, les informations intégrées sur les services cloud et les opérations d'API ne couvrent pas tous les cas de figure. Vous pouvez forcer l'appel d'une opération d'API absente de la liste des métadonnées et vérifier l'exactitude des informations spécifiques relatives à cette opération.

Description de l'option --force

Dans Alibaba Cloud CLI, si vous appelez une opération d'API ou spécifiez un paramètre non inclus dans les métadonnées, le système signale une erreur unknown api ou unknown parameter. Pour forcer l'appel d'opérations et utiliser des paramètres absents des métadonnées, utilisez l'option --force. Assurez-vous au préalable que les informations suivantes sont exactes :

Exemple

Scénario

Cet exemple illustre l'utilisation des opérations CloudMonitor destinées à interroger les données de surveillance d'une métrique. Dans la version 2019-01-01 de l'API CloudMonitor, l'opération se nomme DescribeMetricList. En revanche, dans la version 2017-03-01 de l'API CloudMonitor, elle s'intitule QueryMetricList. Si vous tentez d'appeler directement l'opération QueryMetricList depuis Alibaba Cloud CLI, une erreur se produit.

image

Commande type

  1. Exécutez la commande suivante pour appeler de force l'opération QueryMetricList de la version 2017-03-01 :

    aliyun cms QueryMetricList --Project acs_ecs_dashboard --Metric cpu_idle --version 2017-03-01 --force
  2. La figure ci-dessous présente un exemple de résultats renvoyés.

    image