O Alibaba Cloud CLI valida os parâmetros quando você chama as APIs dos serviços em nuvem. Como as APIs estão disponíveis em várias versões, as informações integradas sobre os serviços em nuvem e as operações de API podem não atender a todos os requisitos. Você pode forçar a chamada de uma operação de API que não consta na lista de metadados para verificar a precisão de informações específicas sobre essa operação.
Descrição da opção --force
No Alibaba Cloud CLI, ao chamar uma operação de API ou especificar um parâmetro não incluído nos metadados, o sistema reporta o erro unknown api ou unknown parameter. Use a opção --force para forçar a chamada de operações de API e utilizar parâmetros ausentes nos metadados. Para isso, garanta que as seguintes informações estejam corretas:
Código do serviço em nuvem: Utilize a opção
--helppara obter a lista de serviços suportados.Nomes e parâmetros das operações de API: A opção
--helppermite obter a lista de operações de um serviço e obter os parâmetros de uma operação de API.Versão da API: Ao usar a opção
--forcepara forçar uma chamada, é obrigatório especifique a versão da API por meio da opção--version.Endpoint: Especifique o endpoint de um serviço com a opção
--endpoint. Caso essa opção não seja definida, o endpoint será obtido dos dados integrados do Alibaba Cloud CLI.
Exemplo
Cenário
Este exemplo utiliza operações do CloudMonitor para consultar dados de monitoramento de uma métrica. Na versão 2019-01-01 da API do CloudMonitor, a operação é DescribeMetricList. Já na versão 2017-03-01 da API do CloudMonitor, a operação correspondente é QueryMetricList. Se você tentar chamar diretamente a operação QueryMetricList no Alibaba Cloud CLI sem as configurações adequadas, um erro será reportado.
Comando de exemplo
-
Execute o comando abaixo para forçar a chamada da operação
QueryMetricListda versão2017-03-01:aliyun cms QueryMetricList --Project acs_ecs_dashboard --Metric cpu_idle --version 2017-03-01 --force -
A figura a seguir mostra um exemplo dos resultados retornados.
