Tüm Ürünler
Search
Belge Merkezi

:Bir API işlemini zorla çağırma

Son Güncelleme:Oct 06, 2026

Alibaba Cloud CLI, cloud hizmetlerinin API'lerini çağırdığınızda parametrelerin geçerliliğini kontrol eder. API'ler birden fazla sürümde sunulduğu için cloud hizmetleri ve API işlemlerine ilişkin yerleşik bilgiler tüm gereksinimleri karşılamayabilir. Meta veri listesinde bulunmayan bir API işlemini zorla çağırabilir ve bu API işlemine ilişkin belirli bilgilerin doğruluğunu kontrol edebilirsiniz.

--force seçeneğinin açıklaması

Alibaba Cloud CLI'de meta verilerde yer almayan bir API işlemini çağırırsanız veya bir parametre belirtirseniz unknown api veya unknown parameter hatası alırsınız. --force seçeneğini kullanarak meta verilerde bulunmayan API işlemlerini zorla çağırabilir ve bu işlemlerde parametre kullanabilirsiniz. Bunu yapmak için aşağıdaki bilgilerin doğru olduğundan emin olun:

  • Cloud hizmet kodu: Desteklenen hizmetlerin listesini almak için --help seçeneğini kullanabilirsiniz obtain the list of supported services.

  • API işlemlerinin adları ve parametreleri: Bir hizmetin işlem listesini almak ve bir API işleminin parametrelerini edinmek için --help seçeneğini kullanabilirsiniz obtain the list of operations of a service ve obtain the parameters of an API operation.

  • API sürümü: Bir API işlemini --force seçeneğiyle zorla çağırdığınızda API sürümünü --version seçeneğini kullanarak belirtmeniz gerekir.

  • Uç nokta: Bir hizmetin uç noktasını belirtmek için --endpoint seçeneğini kullanabilirsiniz. Bu seçeneği belirtmezseniz uç nokta Alibaba Cloud CLI'nin yerleşik verilerinden alınır.

Örnek

Senaryo

Bu örnekte bir ölçümün izleme verilerini sorgulamak için kullanılan CloudMonitor işlemleri ele alınmaktadır. CloudMonitor API'sinin 2019-01-01 sürümünde işlem DescribeMetricList olarak adlandırılır. Ancak CloudMonitor API'sinin 2017-03-01 sürümünde işlem QueryMetricList olarak adlandırılır. QueryMetricList işlemini Alibaba Cloud CLI'de doğrudan çağırırsanız hata alırsınız.

image

Örnek komut

  1. 2017-03-01 sürümündeki QueryMetricList işlemini zorla çağırmak için aşağıdaki komutu çalıştırın:

    aliyun cms QueryMetricList --Project acs_ecs_dashboard --Metric cpu_idle --version 2017-03-01 --force
  2. Aşağıdaki görselde döndürülen sonuçlara bir örnek gösterilmektedir.

    image