Azure HDInsight: REST API:er
Azure HDInsight är en hanterad analystjänst med fullständigt spektrum med öppen källkod i molnet för företag. Du kan använda ramverk baserade på öppen källkod, till exempel Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R med flera. Du kan använda dessa ramverk med öppen källkod för att möjliggöra en mängd olika scenarier, till exempel ETL (extrahering, transformering och inläsning), informationslagerhantering, maskininlärning och IoT.
Översikt över API-frågor
Använd de här API:erna till att skapa och hantera HDInsight-resurser via Azure Resource Manager. Om du vill utföra åtgärder på Azure HDInsight-resurser skickar du HTTPS-begäran med en metod som stöds: GET, POST, PUTeller DELETE till en slutpunkt som riktar sig till en specifik resurs. Alla aktivitetsåtgärder överensstämmer med HTTP/1.1-protokollspecifikationen och varje åtgärd returnerar ett x-ms-request-id huvud som kan användas för att hämta information om begäran. Se till att förfrågningarna mot de här resurserna är säkra. Mer information finns i Autentisera Azure Resource Manager-begäranden.
Vanliga parametrar och sidhuvuden
Följande information är gemensam för alla uppgifter som är relaterade till kluster som du kan göra:
Ersätt {api-version} med
2021-06-01Ersätt {subscription-id} med din prenumerationsidentifierare i URI:n.
Ersätt {resource-group-name} med resursgruppen. Mer information finns i Använda resursgrupper för att hantera dina Azure-resurser.
Ersätt {cluster-name} med ditt HDInsight-klusternamn i URI:n.
Ange rubriken Content-Type till application/json.
Ange auktoriseringshuvudet till en JSON-webbtoken som du hämtar från Azure Active Directory. Mer information finns i Autentisera Azure Resource Manager-begäranden.
REST API-versioner som stöds
I följande tabell visas de REST API-versioner som stöds av Azure HDInsight-tjänsten. Versionen måste anges via x-ms-version rubriken i varje begäran. Om inget anges använder tjänsten som standard den senaste versionen 2021-06-01.
| Version | Ändring introducerad | Indragningsdatum |
|---|---|---|
2015-03-01-preview |
2024-11-30 planerad pension | |
2018-06-01-preview |
2024-11-30 planerad pension | |
2021-06-01 |
Ny version som lägger till stöd för flera nya funktioner som beskrivs nedan |
Uppdateringar i den nya API-versionen 2021-06-01
Vi har släppt en ny version av HDInsight REST API 2021-06-01. Den här nya versionen ersätter 2018-06-01-preview den version som kommer att dras tillbaka 2024-11-30. Den här nya API-versionen lägger till flera nya funktioner, inklusive tillgänglighetszoner, privat länk och privata slutpunktsanslutningar. Observera följande nya funktioner och ändringar med det senaste 2021-06-01 API:et.
- Lägga till stöd för att skapa kluster med tillgänglighetszoner.
- Se Skapa kluster med tillgänglighetszoner och för restexempel Rest – Skapa kluster med tillgänglighetszoner
- Lägger till stöd för att skapa kluster med privat länk.
- Stöd för att hämta privata länkresurser för HDInsight-kluster.
- Stöd för att hämta/godkänna/avvisa/ta bort privata slutpunktsanslutningar.
- Se Privata slutpunktsanslutningar och ett restexempel rest – privat slutpunkt Connections – Skapa eller uppdatera
- En egenskap {location}, som tidigare var valfri, krävs.
- Två befintliga egenskaper tas bort från PLATS-API:et, {vmsizes} och {vmsize_filters}. Dessa egenskaper finns kvar i en annan del av API:et, BillingSpecs. Vi flyttar till en enda källa (BillingSpecs) för dessa två egenskaper.
- Två befintliga egenskaper kommer att byta namn för att matcha camelCase-stilen.
- {cores_used} kommer att byta namn till {coresUsed}
- {max_cores_allowed} kommer att byta namn till {maxCoresAllowed}
- {regionName} har bytt namn till {regionName}