API standartları ve çok dilli hazır SDK'lar
Bu ürünün OpenAPI'si (SysOM/2023-12-30), ROA imzalama yöntemini kullanır. Geliştiriciler için yaygın programlama dillerine yönelik SDK'ları kapsülledik. Geliştiriciler, bu ürünün OpenAPI'sini teknik ayrıntılarla uğraşmadan doğrudan çağırabilmek için SDK'yı indirebilir. Mevcut SDK ihtiyaçlarınızı karşılamıyorsa, kendi imzanızı oluşturmak üzere imzalama mekanizmasını kullanarak entegrasyon yapabilirsiniz. Kendi imzanızı oluşturma sürecinin ayrıntıları oldukça karmaşık olduğundan, bu işlem yaklaşık 5 iş günü sürebilir. Bu nedenle, DingTalk hizmet grubumuza (147535001692) katılmanızı ve uzman rehberliği altında imzalama entegrasyonu gerçekleştirmenizi öneririz.
API'yi kullanmadan önce, istemci araçları (SDK ve CLI gibi) aracılığıyla API'ye etkili bir şekilde erişebilmek için kimlik hesabınızı ve erişim anahtarınızı (AccessKey) hazırlamanız gerekir. Ayrıntılar için bkz. AccessKey Alma.
Özel imzalama senaryoları
İş senaryonuzun özel gereksinimleri varsa ve API'yi kendi imzanızı oluşturarak entegre etmeniz gerekiyorsa, profesyonel rehberlik almak ve verimli bir entegrasyon sağlamak için öncelikle teknik destek ekibimizle (DingTalk hizmet grubu: 147535001692) iletişime geçmenizi öneririz.
Hesap ve güvenlik hazırlığı
Alibaba Cloud hesapları, tüm kaynaklar üzerinde tam yönetici izinlerine sahiptir. Bir AccessKey ele geçirildiğinde, ilişkili tüm kaynaklar yetkisiz erişim riskiyle karşı karşıya kalır. Güvenliği sağlamak için, yalnızca API erişim izinlerine sahip bir RAM kullanıcısı oluşturmanız ve bunun AccessKey'ini yapılandırmanız; ayrıca en az ayrıcalık ilkesine (PoLP) dayalı olarak RAM ilkelerini yapılandırmanız önerilir. Alibaba Cloud hesabını yalnızca Alibaba Cloud hesabı izinlerinin açıkça gerekli olduğu belirli senaryolarda kullanın.
Düzeltme ekleri
|
API |
Başlık |
Açıklama |
| GetHotfixTask | Acil düzeltme görevi durumu | Eşzamansız bir CVE acil düzeltme görevinin durumunu sorgular. |
| UninstallHotfix | Düzeltmeleri kaldır | Belirtilen örneklerden CVE düzeltmelerini zamanuyumsuz olarak kaldırır. |
| QueryHotfixStatus | Acil düzeltme durumunu sorgulama | Belirtilen örneklerdeki CVE acil düzeltme durumunu asenkron olarak sorgular. |
| InstallHotfix | Acil düzeltmeleri yükle | Belirtilen örneklere CVE acil düzeltmelerini zamanuyumsuz olarak yükler. |
İnceleme
|
API |
Başlık |
Açıklama |
| CreateInstanceInspection | Örnek denetimi oluştur. | Bir SysOM örnek denetimi oluşturur. |
Uyarı bildirimleri
|
API |
Başlık |
Açıklama |
| ListAlertDestinations | Uyarı kişileri listesi. | Uyarı kişileri listesini getirir. |
| UpdateAlertDestination | Uyarı kişisini güncelle. | Bir uyarı kişisini günceller. |
| GetAlertDestination | Uyarı kişisi. | Belirtilen bir uyarı kişisinin bilgilerini getirir. |
| UpdateAlertEnabled | Uyarı ilkesi durumunu güncelle. | Bir push uyarı ilkesinin durumunu günceller. |
| GetAlertStrategy | Uyarı ilkesi getirme. | İlke kimliğine göre bir kullanıcının uyarı kuralını getirir. |
| DeleteAlertStrategy | Bir uyarı ilkesini silme. | Anında iletme uyarıları için bir uyarı ilkesini siler. |
| ListAlertItems | Uyarı metrikleri listesi. | Tüm uyarı metriklerini getirir. |
| ListAlertStrategies | Uyarı ilkesi listesini getir. | Kullanıcı tarafından anlık bildirimler için yapılandırılan tüm uyarı ilkelerini getirir. |
| DeleteAlertDestination | Uyarı kişisini silme. | Bir uyarı kişisini siler. |
| CreateAlertDestination | Uyarı kişisi oluştur. | Uyarı bildirimleri için bir kişi oluşturur. |
| CreateAlertStrategy | Uyarı ilkesi oluşturma. | Anında iletme bildirimleri için bir uyarı ilkesi oluşturur. |
| UpdateAlertStrategy | Uyarı politikasını güncelle. | Bir push uyarı politikasını günceller. |
Sıcak nokta analizi
|
API |
Başlık |
Açıklama |
| UpdateFuncSwitchRecord | Hizmet özellik modülü yapılandırmasını güncelleme. | Bir hizmet özellik modülünün yapılandırmasını günceller. |
| GetServiceFuncStatus | Hizmet yapılandırma durumu. | Bir özellik modülünün yapılandırmasını getirir. |
| GetHotSpotUniqList | Uç nokta türü listesi. | Bir örneğe ait belirli bir alanın listesini getirir. |
| GetHotspotTracking | Sıcak nokta izleme sonuçlarını getirme. | Sıcak nokta izleme sonuçlarını getirir. |
| GetHotspotPidList | PID listesini getirme. | Belirtilen bir örneğin PID listesini getirir. |
| GetHotspotInstanceList | Örnek listesini getirme. | Hot spot örneklerinin listesini getirir. |
| GetHotspotCompare | Etkin nokta karşılaştırma izi sonuçlarını getirme. | Bir etkin nokta karşılaştırma izinin sonuçlarını getirir. |
| GetHotspotAnalysis | Hot spot analizi sonuçları. | Hot spot analizi sonuçlarını getirir. |
Yapay zeka gözlemlenebilirliği
|
API |
Başlık |
Açıklama |
| StartAIAnalysis | Yapay zeka altyapı gözlemini başlat. | Yapay zeka işi analizini başlatır. |
| GetListRecord | AI Infra analiz kayıtlarını getir. | AI Infra analiz kayıtlarının listesini getirir. |
| GetAIQueryResult | AI altyapısı gözlem sonuçlarını alır. | AI altyapısı analiz sonuçlarını sorgular. |
Bileşen yönetimi
|
API |
Başlık |
Açıklama |
| InstallAgentWithType | Aracı yükleme. | Belirtilen bir örneğe bir aracı yükler. |
| UninstallAgentWithType | Bir bileşeni kaldırma. | Bir bileşenin belirtilen sürümünü kaldırır. |
| UpgradeAgentWithType | Bir bileşeni güncelleme. | Yüklü bir bileşenin sürümünü belirtilen bir sürüme günceller. |
| GetResources | Bir küme veya düğümün gerçek zamanlı kaynak kullanımı. | Bir küme veya düğümün gerçek zamanlı kaynak kullanımını getirir. |
| GetHostCount | Küme düğüm sayısı veya düğüm Pod sayısı. | Bir kümedeki düğüm veya düğüm Pod sayısını getirir. |
| InitialSysom | Alinux konsolunu etkinleştir. | Hizmet bağlantılı rolün var olduğundan emin olmak için SysOM'u başlatır. |
| ListClusters | Geçerli kullanıcı için yönetilen kümeleri sorgulama. | Geçerli kullanıcı için yönetilen tüm kümeleri getirir. |
| ListPluginsInstances | Bir bileşenin örnek listesi. | Eklenti kurulumu, güncellemesi veya kaldırılması için örneklerin listesini getirir. |
| ListPodsOfInstance | Bir küme veya örnekteki pod listesi. | Bir küme veya örnekteki pod listesini getirir. |
| UpgradeAgentForCluster | ACK kümesi için bileşen güncelleme. | Bir kümenin bileşenini günceller. |
| UpgradeAgent | Bir bileşeni güncelleme. | Yüklü bir bileşeni belirtilen bir sürüme günceller. |
| UninstallAgentForCluster | ACK kümesinden bileşen kaldırma. | Bir kümeden bileşen kaldırır. |
| UninstallAgent | Bir bileşeni kaldır. | Bir bileşenin belirtilen sürümünü kaldırır. |
| ListInstancesWithEcsInfo | ECS bilgileriyle örnek listesini getirme. | Yönetilen ve yönetilmeyen örnekler hakkında ECS bilgileri de dahil olmak üzere bilgileri getirir. |
| ListInstanceStatus | Yönetilen örnek durumunu getirme. | Örnek durumunu getirir. |
| ListInstancesEcsInfoList | Örnekler için ECS bilgi listelerini getirme. | Örnekler için etiket listeleri ve genel IP adresi listeleri gibi ECS bilgi listelerini getirir. |
| ListClusterAgentInstallRecords | ACK küme bileşeni kurulum kayıtlarını getirme. | Küme bileşenlerinin kurulum kayıtlarını getirir. |
| ListAgentInstallRecords | Bileşen kurulum kayıtlarını listeleme. | Bir aracının kurulum kayıtlarını listeler. |
| InstallAgentForCluster | Bir ACK kümesine bileşen yükleme. | Bir ACK kümesine bileşen yükler. |
| InstallAgent | Aracı kurma. | Belirtilen bir örneğe aracı kurar. |
| GetAgentTask | Bir bileşen görevinin yürütme durumunu getirme. | Bir Agent kurulum görevinin yürütme durumunu getirir. |
| GetAgent | Bileşen ayrıntılarını getirme. | Belirli bir bileşenin ayrıntılarını getirir. |
| ListAllInstances | Tüm örnekleri eksiksiz bilgilerle getir. | Yönetilen ve yönetilmeyen örneklerin bir listesini örnek bilgileriyle birlikte getirir. |
Sağlık durumu
|
API |
Başlık |
Açıklama |
| UpdateEventsAttention | Anormalite öğesi dikkat düzeyini güncelleme. | Bir anormalite öğesinin dikkat düzeyini günceller. Dikkat düzeyinin ayarlanması, anormalite algılama algoritmasının hassasiyetini etkiler. |
| ListAbnormalyEvents | Anormallik olayı ayrıntılarını getir. | Belirtilen bir zaman aralığında bir küme, düğüm veya pod için anormallik olayı bilgilerini getirir. |
| ListInstanceHealth | Bir kümedeki düğümlerin veya podların sağlık durumu listesi. | Belirtilen bir zaman aralığında küme düğümlerinin veya podlarının sağlık durumu listesini getirir. |
| InvokeAnomalyDiagnosis | Anormallik tanısı başlatma. | Bir anormallik tanısı başlatır. |
| GetRangeScore | Sağlık puanı eğilimini getir. | Sağlık puanı eğilimini getirir. |
| GetProblemPercentage | Anormallik sorun oranını getirme. | Belirtilen bir zaman aralığında bir kümedeki düğümler veya bir düğümdeki podlar için anormallik sorunlarının oranını getirir. |
| GetInstantScore | Gerçek zamanlı küme/düğüm sağlık puanını getirme. | Bir küme veya düğümün gerçek zamanlı sağlık puanını getirir. |
| GetHealthPercentage | Düğüm/pod sağlık durumu dağılımı. | Belirtilen bir zaman dilimi boyunca düğümlerin veya podların sağlık durumu dağılımını getirir. |
| GetAbnormalEventsCount | Anormal olay sayısını getirme. | Bir düğüm veya pod için farklı önem seviyelerindeki işlenmemiş (tanılanmamış) anormal olayların sayısını getirir. |
Tanılama
|
API |
Başlık |
Açıklama |
| ListDiagnosis | Tanı listesi. | Tanı geçmişi kayıtlarının listesini getirir. |
| GetDiagnosisResult | Tanılama sonuçlarını getir. | Tanılama sonuçlarını getirir. |
| InvokeDiagnosis | Tanılama görevi başlatma. | Bir tanılama görevi başlatır. |
| AuthDiagnosis | Tanılama yetkilendirmesi. | Mevcut hesap altındaki ECS örneklerinde tanılama yapmak için SysOM'a yetki verir. Belirli bir ECS örneğinde tanılamayı başlatmak üzere InvokeDiagnosis işlemini çağırmadan önce, söz konusu örnek için tanılama yetkisi vermek amacıyla bu işlemi çağırmanız gerekir. |
İşletim sistemi asistanı
|
API |
Başlık |
Açıklama |
| GetCopilotHistory | Copilot akış API'sinden sohbet kayıtlarını getirme. | Copilot'un geçmiş sohbet kayıtlarını getirir. |
| GenerateCopilotStreamResponse | OS Copilot akışlı SSE hizmeti isteği. | OS Copilot hizmeti için akışlı bir SSE arabirimi sağlar. |
| GenerateCopilotResponse | Copilot hizmeti isteği. | Copilot hizmetinden yanıt sonucunu alır. |
Diğerleri
|
API |
Başlık |
Açıklama |
| CheckInstanceSupport | Örneklerin desteklenip desteklenmediğini kontrol eder. | Hedef örneklerin SysOM tarafından desteklenip desteklenmediğini kontrol eder. |
| StartAIDiffAnalysis | AI Infra fark analizi başlatma. | Bir AI Infra fark analizi başlatır. |
| CreateVmcoreDiagnosisTask | Arıza tanılama görevi oluşturma. | Giriş parametrelerinde belirtilen vmcore veya dmesg günlük dosyasını tanılamak için akıllı bir arıza tanılama düğümü oluşturur. |
| GetVmcoreDiagnosisTask | Tanılama görevi sorgulama. | Görev kimliğine göre bir tanılama görevinin yürütme durumunu ve tanılama sonucunu sorgular. |
| ListVmcoreDiagnosisTask | Çökme tanılama listesini sorgulama. | Geçmiş çökme tanılama görevlerinin listesini sorgular. |
| CpuHighAgentStreamResponse | CPU high agent akışlı SSE arabirimini çağırma. | CPU high agent akışlı SSE arabirimini çağırır. |
| CheckAgentConfigSupported | Bileşen yapılandırma desteği kontrolü | Küme ve düğümler gibi kaynakların geçerli yapılandırmayı destekleyip desteklemediğini kontrol eder. |
| CreateAgentConfig | Bir bileşen yapılandırması oluştur | Bir bileşen yapılandırması oluşturur. |
| CreateClusterVpcEndpointConnection | Bir küme için VPC uç noktası bağlantısı oluşturma. | Bir küme için VPC uç noktası bağlantısı oluşturur. |
| DeleteAgentConfig | Bileşen yapılandırmasını silme | Bir bileşen yapılandırmasını siler. |
| DescribeMetricList | Metrik verilerini sorgulama. | Metrik verilerini sorgular. |
| GetAgentConfig | Bileşen yapılandırmalarını getirme | Bileşen yapılandırmalarını getirir. |
| GetAifgResult | Tanı sonuçlarını getirme. | Tanı sonuçlarını getirir. |
| GetAifgUrl | Tanılama sonucu URL bağlantısını getirme. | Bir tanılama sonucunun URL bağlantısını getirir. |
| GetConfigByName | Yapılandırma adına göre yapılandırma içeriğini getirme. | Yapılandırma adına göre yapılandırma bilgilerini getirir. |
| GetGpuClusterArgsOptions | GPU kaynak topolojisi seçenek parametrelerini getirir. | GPU kümesi parametre listesini getirir. |
| GetGpuClusterListAlarmRecord | GPU kaynak topolojisi anormallik olayları listesi. | GPU kümesi uyarılarının listesini getirir. |
| GetGpuClusterTopology | GPU kaynak topolojisini getirme. | GPU kümesi topolojisini getirir. |
| GetInspectionReport | Denetim raporu getirme. | Bir SysOM denetim raporunu getirir. |
| GetListGpuCluster | GPU kümesi listesi. | GPU kümelerinin listesini getirir. |
| ListAgents | Bileşen listesini getir. | Aracı listesini getirir. |
| ListAifgJobs | Tanılama görevi listesi. | Tanılama görevlerinin listesini getirir. |
| ListInstanceInfo | Örnek bilgi listesi. | Belirli bir örnek bilgi türüne ait tüm değerleri getirir. |
| ListInstances | Yönetilen örnek listesi. | Yönetilen örneklerin listesini getirir. |
| ListRegions | Yönetilen örneklerin bölgeleri. | Yönetilen örnekleri içeren tüm bölgeleri listeler. |
| StartAifgAnalysis | Tanı tetikleme. | Yapay zeka uygulama tanılarını tetikler. |
| UpdateAgentConfig | Bileşen yapılandırmasını güncelleme | Bileşen yapılandırmasını günceller. |
| UpdateClusterAgentConfig | Küme bileşeni yapılandırmasını uygula | Bir küme bileşeninin yapılandırmasını günceller. |
| UpdateInstanceAgentConfig | Örnek bileşen yapılandırmasını uygulama | Bir örneğin bileşen yapılandırmasını günceller. |