Azure HDInsight: REST API's
Azure HDInsight is een beheerde, volledige opensource-analyseservice in de cloud voor ondernemingen. U kunt populaire opensourcekaders zoals Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R, enzovoort gebruiken. U kunt deze opensource-frameworks gebruiken om een breed scala aan scenario's mogelijk te maken, zoals extraheren, transformeren en laden (ETL), datawarehousing, machine learning en IoT.
Overzicht van API-query's uitvoeren
Gebruik deze API’s voor het maken en beheren van HDInsight-resources via Azure Resource Manager. Als u bewerkingen wilt uitvoeren op Azure HDInsight-resources, verzendt u een HTTPS-aanvraag met een ondersteunde methode: GET, POST, PUTof DELETE naar een eindpunt dat is gericht op een specifieke resource. Alle taakbewerkingen voldoen aan de http/1.1-protocolspecificatie en elke bewerking retourneert een x-ms-request-id header die kan worden gebruikt om informatie over de aanvraag te verkrijgen. Zorg ervoor dat aanvragen die worden gemaakt aan deze resources veilig zijn. Zie Verificatie van Azure Resource Manager-aanvragen voor meer informatie.
Algemene parameters en headers
De volgende informatie is gemeenschappelijk voor alle taken die betrekking hebben op clusters die u kunt uitvoeren:
Vervang {api-version} door
2021-06-01Vervang {subscription-id} door uw abonnements-id in de URI.
Vervang {resource-group-name} door de resourcegroep. Zie Resourcegroepen gebruiken om uw Azure-resources te beheren voor meer informatie.
Vervang {cluster-name} door de naam van uw HDInsight-cluster in de URI.
Stel de header Content-Type in op application/json.
Stel de autorisatieheader in op een JSON-webtoken dat u ophaalt uit Azure Active Directory. Zie Verificatie van Azure Resource Manager-aanvragen voor meer informatie.
Ondersteunde REST API-versies
De volgende tabel bevat de ondersteunde REST API-versies door de Azure HDInsight-service. De versie moet worden opgegeven via de x-ms-version header in elke aanvraag. Als dit niet is opgegeven, wordt de service standaard ingesteld op de nieuwste versie 2021-06-01.
| Versie | Wijziging geïntroduceerd | Buitengebruikstellingsdatum |
|---|---|---|
2015-03-01-preview |
Geplande uittreding 2024-11-2024 | |
2018-06-01-preview |
Geplande uittreding 2024-11-2024 | |
2021-06-01 |
Nieuwe versie die ondersteuning toevoegt voor verschillende nieuwe functies die hieronder worden beschreven |
Updates in de nieuwe API-versie 2021-06-01
We hebben een nieuwe versie van de HDInsight REST API 2021-06-01uitgebracht. Deze nieuwe versie vervangt 2018-06-01-preview de versie die buiten gebruik wordt gesteld op 30-11-2024. Deze nieuwe API-versie voegt verschillende nieuwe functies toe, waaronder beschikbaarheidszones, private link en privé-eindpuntverbindingen. Houd bij de nieuwste 2021-06-01 API rekening met de volgende nieuwe functies en wijzigingen.
- Ondersteuning toegevoegd voor het maken van clusters met beschikbaarheidszones.
- Zie Clusters maken met beschikbaarheidszones en voor een rest-voorbeeld Rest - Cluster maken met beschikbaarheidszones
- Ondersteuning toegevoegd voor het maken van clusters met private link.
- Ondersteuning voor het ophalen van Private Link-resources van HDInsight-clusters.
- Ondersteuning voor het ophalen/goedkeuren/weigeren/verwijderen van privé-eindpuntverbindingen.
- Zie Privé-eindpuntverbindingen en voor een Rest-voorbeeld Rest - Privé-eindpunt Connections - Maken of bijwerken
- Eén eigenschap {location}, voorheen optioneel, is vereist.
- Twee bestaande eigenschappen worden verwijderd uit de Locaties-API, {vmsizes} en {vmsize_filters}. Deze eigenschappen blijven in een ander deel van de API, BillingSpecs. We verplaatsen naar één bron (BillingSpecs) voor deze twee eigenschappen.
- De naam van twee bestaande eigenschappen wordt aangepast aan de camelCase-stijl.
- De naam van {cores_used} wordt gewijzigd in {coresUsed}
- De naam van {max_cores_allowed} wordt gewijzigd in {maxCoresAllowed}
- De naam van {regionName} is gewijzigd in {regionName}