Dell Geliştiricileri için Herkese Açık Belgeler
VxRail REST Uygulama Programlama Arayüzü (API) ve diğer Dell ürünlerinin eksiksiz geliştirici belgeleri için
Dell Geliştirici API'leri sayfasına gidin. VxRail e özel API'yi hızlı bir şekilde bulmak için "Hyperconverged Infrastructure" öğesini filtreleyin.
DNS'yi sorgulamak veya güncellemek için özel belgeler "Sistem Bilgileri" altında bulunabilir - DNS'yi Al ve Ayarla:
Bu belgeler, özel curl komutları oluşturmak veya daha deneyimli kullanıcılar için "postacı" veya diğer uygulamalar gibi bir uygulamaya entegre etmek için kullanılabilir.
VxRail yerleşik API istemcisi
VxRail API'lerini kullanmanın tercih edilen yolu (REST API'ye daha az aşina olanlar için önerilir), yerel VxRail Manager API istemcisini kullanmaktır.
VxRail sürüm 7.0.350'den, daha fazla özelliğe sahip spotlight tabanlı yeni bir arayüze geçiş yaptık.
Tarayıcınızda VxRail Manager FQDN/IP sini girerek yerel API istemcisine erişin.
< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Örneğin, VxRail Manager IP'si 172.168.10.50 olduğundan URL
https://172.168.10.50/rest/vxm/api-doc.html olur:
Geçerli VxRail kümesi DNS yapılandırmasını sorgulama
Mevcut DNS yapılandırmasını sorgulamak için sol paneldeki "System Information" bölümünde bulunan v1_sytem_dns_get API'yi kullanın:
- Doğrudan URL https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get olacaktır, ancak bunlar sürümler arasında değişebilir, bu nedenle kullanıcı arayüzünde gezinmek en iyisidir.
- Genellikle administrator@vsphere.local olan ancak etki alanı yapılandırmanıza bağlı olarak değişebilen VxRail vCenter Çoklu Oturum Açma (SSO) kimlik bilgilerini girin.
- GET isteğini gerçekleştirmek için Send Request düğmesine tıklayın:
- API istemcisi kimlik doğrulaması yapar ve 200 Tamam yanıtı alırsak istenen bilgileri döndürür. Burada geçerli DNS sunucusu laboratuvar IP'si 172.168.10.253'tür ve VxRail Manager "Dahili DNS" olarak yapılandırılmamıştır, yani harici bir müşteri tarafından sağlanan DNS sunucularını kullanıyoruz:
VxRail kümesi DNS IP sunucusu bilgilerini güncelleştirme
Geçerli DNS yapılandırmasını güncellemek için sol paneldeki "System Information" bölümünde bulunan v1_system_dns_post API'yi kullanın:
- Doğrudan URL https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post olacaktır, ancak bunlar sürümler arasında değişebilir, bu nedenle kullanıcı arayüzünde gezinmek en iyisidir.
- Auth" bölümüne, genellikle administrator@vsphere.local olan ancak etki alanı yapılandırmanıza bağlı olarak değişebilen VxRail vCenter SSO kimlik doğrulama kimlik bilgilerini girin.
- DNS sunucusunu güncellemek için "Gövde" bölümünü üç alanda düzenleyin:
- components" bölümü isteğe bağlıdır ve varsayılan ayar "ALL'dur. ALL ayarlanırsa VxRail Manager, vCenter ve ESXi dahil olmak üzere kümedeki tüm DNS sunucuları değiştirilir. VXM" ayarlanırsa yalnızca VxRail Manager DNS sunucusu değiştirilir. Bu, tüm bileşen yapılandırmasının tutarlı olmasını önerdiğimiz için sınırlı bir kullanım durumu olur. VXM" değerinin YALNIZCA VxRail ortamındaki VCF'de desteklendiğini unutmayın.
- vCenter" bölümünde bir yönetici SSO kullanıcı adı ve parolası geçirmemiz gerekir. Genellikle bu bilgi, "Auth" bölümündekiyle aynıdır ancak yönetici düzeyinde farklı bir SSO hesabı da sağlanabilir.
- "sunucular" bölümünde, aşağıdaki örnekte DNS'yi IP 172.168.10.253 olarak ayarlıyoruz
- Not : Birden çok sunucu eklerken IP'ler virgülle ayrılmalıdır: "172.168.10.253,10.8.8.8"
- POST isteğini gerçekleştirmek için Send Request düğmesine tıklayın:
- Kümedeki ESXi ana bilgisayarlarının sayısına bağlı olarak istek biraz zaman alabilir ancak istek başarılı bir şekilde tamamlandığında 200 Tamam yanıt kodu döndürür.
Beklenmeyen yanıt kodları varsa.
Sağlıksız bir sistemde veya belki de ESXi ana bilgisayarlarından vb. yeni bir DNS sunucusuna ulaşılamıyor. API istemcisi bazı temel hata mesajı kılavuzları sağlar ve ek yanıt hata kodları çevrimiçi olarak bulunabilir
, örneğin https://restfulapi.net/http-status-codes/ iyi bir konumdur.
Beklenmeyen hata kodları varsa ek sorun giderme için Dell Destek ekibi ile iletişime geçin.
İlk VxRail 8.0 sürümlerinde, Solve Online yordamlarında REST API aracılığıyla VxRail DNS IP ayarlarının güncelleştirilmesi önerilir. Bu özellik, VxRail kullanıcı arayüzü eklentisine eklenecektir.
Bu makalede, VxRail REST API'sini kullanma konusunda daha az deneyime sahip müşteriler için bu etkinliğe yönelik rehberlik ve örnekler yer almaktadır.
Bu makaledeki IP bilgileri geçici bir sanal yalıtılmış laboratuvardan alınmıştır ve müşteri/gizli IP bilgisi içermez.