Azure HDInsight: REST API-k

  • Cikk

Az Azure HDInsight egy felügyelt, teljes spektrumú, nyílt forráskódú elemzési szolgáltatás a felhőben nagyvállalatok számára. Olyan nyílt forráskódú keretrendszereket használhat, mint a Hadoop, az Apache Spark, az Apache Hive, az LLAP, az Apache Kafka, az Apache Storm, az R és egyebek. Ezekkel a nyílt forráskódú keretrendszerekkel számos forgatókönyvet használhat, például kinyerést, átalakítást és betöltést (ETL), adattárházat, gépi tanulást és IoT-t.

API-lekérdezések áttekintése

Ezekkel az API-kkal HDInsight-erőforrásokat hozhat létre és kezelhet az Azure Resource Manager használatával. Az Azure HDInsight-erőforrásokon végzett műveletek végrehajtásához https-kérést kell küldenie egy támogatott módszerrel: GET, POST, PUTvagy DELETE egy adott erőforrást célzó végpontnak. Minden tevékenységművelet megfelel a HTTP/1.1 protokoll specifikációjának, és minden művelet egy x-ms-request-id fejlécet ad vissza, amely a kéréssel kapcsolatos információk lekérésére használható. Gondoskodnia kell arról, hogy az ezekhez az erőforrásokhoz irányuló kérelmek biztonságosak legyenek. További információ: Azure-Resource Manager-kérelmek hitelesítése.

Gyakori paraméterek és fejlécek

Az alábbi információk gyakoriak a fürtökkel kapcsolatos összes feladattal kapcsolatban:

  • Cserélje le az {api-version} elemet a 2021-06-01

  • Cserélje le a(z) {subscription-id} elemet az előfizetés azonosítójára az URI-ban.

  • Cserélje le az {resource-group-name} elemet az erőforráscsoportra. További információ: Erőforráscsoportok használata az Azure-erőforrások kezeléséhez.

  • Cserélje le a {cluster-name} elemet a HDInsight-fürt nevére az URI-ban.

  • Állítsa a Content-Type fejlécet application/json értékre.

  • Állítsa az Engedélyezési fejlécet egy JSON-webjogkivonatra, amelyet az Azure Active Directoryból szerezhet be. További információ: Azure-Resource Manager-kérelmek hitelesítése.

Támogatott REST API-verziók

Az alábbi táblázat az Azure HDInsight szolgáltatás által támogatott REST API-verziókat sorolja fel. A verziót minden x-ms-version kérés fejlécén keresztül kell megadni. Ha nincs megadva, a szolgáltatás alapértelmezés szerint a legújabb verziót használja 2021-06-01.

Verzió Módosítás bevezetve Kivonás dátuma
2015-03-01-preview 2024-11-30 tervezett kivonás
2018-06-01-preview 2024-11-30 tervezett kivonás
2021-06-01 Új verzió, amely az alábbiakban részletezett számos új funkció támogatását biztosítja

Frissítések az új 2021-06-01 API-verzióban

Megjelent a HDInsight REST API 2021-06-01új verziója. Ez az új verzió váltja fel a verziót 2018-06-01-preview , amely 2024.11.30-án megszűnik. Ez az új API-verzió számos új funkciót tartalmaz, beleértve a rendelkezésre állási zónákat, a privát kapcsolatot és a privát végponti kapcsolatokat. A legújabb 2021-06-01 API-val vegye figyelembe az alábbi új funkciókat és módosításokat.

  1. Támogatás hozzáadása rendelkezésre állási zónákkal rendelkező fürtök létrehozásához.
  2. A privát kapcsolattal rendelkező fürtök létrehozásának támogatása.
  3. A HDInsight-fürtök privát kapcsolati erőforrásainak lekérésének támogatása.
  4. A privát végponti kapcsolatok lekérésének/jóváhagyásának/elutasításának/törlésének támogatása.
  5. Egy {location} tulajdonságra lesz szükség, amely korábban nem kötelező.
  6. Két meglévő tulajdonság el lesz távolítva a Locations API-ból( {vmsizes} és {vmsize_filters}). Ezek a tulajdonságok az API egy másik részében, a BillingSpecsben maradnak. Ehhez a két tulajdonsághoz egyetlen forrásra (BillingSpecs) költözünk.
  7. Két meglévő tulajdonság lesz átnevezve a camelCase stílusnak megfelelően.
    1. A(z) {cores_used} neve {coresUsed} lesz
    2. A(z) {max_cores_allowed} neve {maxCoresAllowed} lesz.
    3. A(z) {regionName} át lett nevezve a(z) {regionName} névre.

Lásd még