Aracılığıyla paylaş


Azure HDInsight: REST API'leri

Azure HDInsight , kuruluşlar için bulutta yönetilen, tam spektrumlu bir açık kaynak analiz hizmetidir. Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R ve daha fazlası gibi açık kaynak çerçeveleri kullanabilirsiniz. Ayıklama, dönüştürme ve yükleme (ETL), veri ambarı, makine öğrenmesi ve IoT gibi çok çeşitli senaryoları etkinleştirmek için bu açık kaynak çerçeveleri kullanabilirsiniz.

API sorgulamaya genel bakış

Azure Resource Manager aracılığıyla HDInsight kaynakları oluşturup yönetmek için bu API’leri kullanın. Azure HDInsight kaynaklarında işlem gerçekleştirmek için desteklenen bir yöntemle HTTPS isteği gönderirsiniz: GET, POST, PUTveya DELETE belirli bir kaynağı hedefleyen bir uç noktaya. Tüm görev işlemleri HTTP/1.1 protokol belirtimine uygundur ve her işlem istek hakkında bilgi almak için kullanılabilecek bir x-ms-request-id üst bilgi döndürür. Bu kaynaklara gönderilen isteklerin güvenli olduğundan emin olun. Daha fazla bilgi için bkz. Azure Resource Manager isteklerinin kimliğini doğrulama.

Ortak parametreler ve üst bilgiler

Aşağıdaki bilgiler, yapabileceğiniz kümelerle ilgili tüm görevler için ortaktır:

  • {api-version} öğesini şununla değiştirin: 2021-06-01

  • {subscription-id} değerini URI'deki abonelik tanımlayıcınızla değiştirin.

  • {resource-group-name} öğesini kaynak grubuyla değiştirin. Daha fazla bilgi için bkz. Azure kaynaklarınızı yönetmek için Kaynak gruplarını kullanma.

  • {cluster-name} değerini URI'deki HDInsight küme adınızla değiştirin.

  • Content-Type üst bilgisini application/json olarak ayarlayın.

  • Yetkilendirme üst bilgisini Azure Active Directory'den aldığınız bir JSON Web Belirteci olarak ayarlayın. Daha fazla bilgi için bkz. Azure Resource Manager isteklerinin kimliğini doğrulama.

Desteklenen REST API sürümleri

Aşağıdaki tabloda Azure HDInsight hizmeti tarafından desteklenen REST API sürümleri listelenmiştir. Sürüm her istekte x-ms-version üst bilgi aracılığıyla belirtilmelidir. Belirtilmezse, hizmet varsayılan olarak en son sürümüne sahiptir 2021-06-01.

Sürüm Değişiklik kullanıma sunulmuştur Kullanımdan kaldırma tarihi
2015-03-01-preview 2024-11-30 planlanan kullanımdan kaldırma
2018-06-01-preview 2024-11-30 planlanan kullanımdan kaldırma
2021-06-01 Aşağıda ayrıntıları verilen birkaç yeni özellik için destek ekleyen yeni sürüm

Yeni 2021-06-01 API sürümünde Güncelleştirmeler

HDInsight REST API'sinin 2021-06-01yeni bir sürümünü yayımladık. Bu yeni sürüm, 2024-11-30'da devre dışı bırakılacak olan sürümün yerini alır 2018-06-01-preview . Bu yeni API sürümü kullanılabilirlik alanları, özel bağlantı ve özel uç nokta bağlantıları gibi çeşitli yeni özellikler ekler. En son 2021-06-01 API ile aşağıdaki yeni özelliklere ve değişikliklere dikkat edin.

  1. Kullanılabilirlik alanlarıyla küme oluşturma desteği eklendi.
  2. Özel bağlantı ile küme oluşturma desteği eklendi.
  3. HDInsight kümelerinin özel bağlantı kaynaklarını alma desteği.
  4. Özel uç nokta bağlantılarını alma/onaylama/reddetme/silme desteği.
  5. Daha önce isteğe bağlı olan bir {location} özelliği gerekli olacak.
  6. Konumlar API'sinden {vmsizes} ve {vmsize_filters} olmak üzere iki mevcut özellik kaldırılacak. Bu özellikler api'nin başka bir bölümünde (BillingSpecs) kalır. Bu iki özellik için tek bir kaynağa (BillingSpecs) geçiyoruz.
  7. CamelCase stiliyle eşleşecek şekilde mevcut iki özellik yeniden adlandırılacak.
    1. {cores_used} {coresUsed} olarak yeniden adlandırılacak
    2. {max_cores_allowed} {maxCoresAllowed} olarak yeniden adlandırılacak
    3. {regionName} {regionName} olarak yeniden adlandırıldı

Ayrıca bkz.