Todos los productos
Search

Este producto

    :Forzar la llamada a una operación de API

    Centro de documentos

    :Forzar la llamada a una operación de API

    Última actualización: Sep 05, 2026

    Alibaba Cloud CLI valida los parámetros al llamar a las API de los servicios en la nube. Dado que las API están disponibles en varias versiones, la información integrada sobre los servicios en la nube y las operaciones de API no cubre todos los requisitos. Puede forzar la llamada a una operación de API que no se encuentra en la lista de metadatos para verificar la precisión de información específica sobre dicha operación.

    Descripción de la opción --force

    En Alibaba Cloud CLI, si llama a una operación de API o especifica un parámetro no incluido en los metadatos, se muestra el error unknown api o unknown parameter. Para forzar la llamada a operaciones de API y usar parámetros fuera de los metadatos, utilice la opción --force. Para ello, asegúrese de que la siguiente información sea correcta:

    • Código del servicio en la nube: Use la opción --help para obtain the list of supported services.

    • Nombres y parámetros de las operaciones de API: Use la opción --help para obtain the list of operations of a service y obtain the parameters of an API operation.

    • Versión de la API: Al usar la opción --force para llamar forzosamente a una operación de API, debe especificar la versión mediante la opción --version.

    • Endpoint: Use la opción --endpoint para especificar el endpoint de un servicio. Si no especifica esta opción, el endpoint se obtiene de los datos integrados de Alibaba Cloud CLI.

    Ejemplo

    Escenario

    Este ejemplo utiliza las operaciones de CloudMonitor para consultar los datos de monitoreo de una métrica. En la versión 2019-01-01 de la API de CloudMonitor, la operación es DescribeMetricList. Sin embargo, en la versión 2017-03-01 de la API de CloudMonitor, la operación es QueryMetricList. Si llama directamente a la operación QueryMetricList en Alibaba Cloud CLI, se muestra un error.

    imagen

    Comando de ejemplo

    1. Ejecute el siguiente comando para forzar la llamada a la operación QueryMetricList de la versión 2017-03-01:

      aliyun cms QueryMetricList --Project acs_ecs_dashboard --Metric cpu_idle --version 2017-03-01 --force

    2. La siguiente figura muestra un ejemplo de los resultados devueltos.

      imagen