Azure HDInsight: REST-APIs
Azure HDInsight ist ein umfassender, verwalteter Open-Source-Analysedienst in der Cloud für Unternehmen. Sie können Open Source-Frameworks wie Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R und andere verwenden. Sie können diese Open-Source-Frameworks verwenden, um eine vielzahl von Szenarien wie Extrahieren, Transformieren und Laden (ETL), Data Warehousing, Machine Learning und IoT zu ermöglichen.
Übersicht über API-Abfragen
Verwenden Sie diese APIs, um HDInsight-Ressourcen über den Azure Resource Manager zu erstellen und zu verwalten. Zum Ausführen von Vorgängen für Azure HDInsight-Ressourcen senden Sie eine HTTPS-Anforderung mit einer unterstützten Methode: GET
, POST
, PUT
oder DELETE
an einen Endpunkt, der auf eine bestimmte Ressource abzielt. Alle Vorgangsvorgänge entsprechen der HTTP/1.1-Protokollspezifikation, und jeder Vorgang gibt einen x-ms-request-id
Header zurück, mit dem Informationen zur Anforderung abgerufen werden können. Stellen Sie sicher, dass Anforderungen, die an diese Ressourcen gesendet werden, sicher sind. Weitere Informationen finden Sie unter Authentifizieren von Anforderungen des Azure-Ressourcen-Managers.
Allgemeine Parameter und Header
Die folgenden Informationen sind allen Aufgaben im Zusammenhang mit Clustern gemeinsam, die Sie möglicherweise ausführen:
Ersetzen Sie {api-version} durch
2021-06-01
Ersetzen Sie im URI {subscription-id} durch Ihre Abonnement-ID.
Ersetzen Sie "{resource-group-name}" durch die Ressourcengruppe. Weitere Informationen finden Sie unter Verwenden von Ressourcengruppen zum Verwalten von Azure-Ressourcen.
Ersetzen Sie {cluster-name} durch ihren HDInsight-Clusternamen im URI.
Legen Sie den "Content-Type"-Header auf application/json fest.
Legen Sie den Autorisierungsheader auf ein JSON-Webtoken fest, das Sie aus Azure Active Directory erhalten haben. Weitere Informationen finden Sie unter Authentifizieren von Anforderungen des Azure-Ressourcen-Managers.
Unterstützte REST-API-Versionen
In der folgenden Tabelle sind die vom Azure HDInsight-Dienst unterstützten REST-API-Versionen aufgeführt. Die Version muss über den x-ms-version
Header in jeder Anforderung angegeben werden. Wenn nicht angegeben, wird der Dienst standardmäßig auf die neueste Version festgelegt 2021-06-01
.
Version | Änderung eingeführt | Deaktivierungstermin |
---|---|---|
2015-03-01-preview |
30.11.2024 geplante Pensionierung | |
2018-06-01-preview |
30.11.2024 geplante Pensionierung | |
2021-06-01 |
Neue Version, die Unterstützung für mehrere neue Features hinzufügt, die unten beschrieben werden |
Updates in der neuen API-Version 2021-06-01
Wir haben eine neue Version der HDInsight-REST-API 2021-06-01
veröffentlicht. Diese neue Version ersetzt die 2018-06-01-preview
Version, die am 30.11.2024 eingestellt wird. Diese neue API-Version fügt mehrere neue Features hinzu, darunter Verfügbarkeitszonen, private Verknüpfungen und private Endpunktverbindungen. Beachten Sie bei der neuesten 2021-06-01
API die folgenden neuen Features und Änderungen.
- Hinzufügen von Unterstützung für das Erstellen von Clustern mit Verfügbarkeitszonen.
- Weitere Informationen finden Sie unter Erstellen von Clustern mit Verfügbarkeitszonen und für ein Restbeispiel Rest – Erstellen eines Clusters mit Verfügbarkeitszonen.
- Hinzufügen von Unterstützung für das Erstellen von Clustern mit privatem Link.
- Weitere Informationen finden Sie unter Erstellen von Clustern mit privatem Link.
- Unterstützung des Abrufens von Private Link-Ressourcen von HDInsight-Clustern.
- Weitere Informationen finden Sie unter Private Link-Ressourcen.
- Unterstützung von Verbindungen zum Abrufen/Genehmigen/Ablehnen/Löschen von privaten Endpunkten.
- Weitere Informationen finden Sie unter Private Endpunktverbindungen und für ein Restbeispiel Ruhe – Privater Endpunkt Connections – Erstellen oder Aktualisieren
- Eine zuvor optionale Eigenschaft {location} ist erforderlich.
- Zwei vorhandene Eigenschaften werden aus der Speicherort-API entfernt: {vmsizes} und {vmsize_filters}. Diese Eigenschaften verbleiben in einem anderen Teil der API, BillingSpecs. Wir wechseln zu einer einzigen Quelle (BillingSpecs) für diese beiden Eigenschaften.
- Zwei vorhandene Eigenschaften werden umbenannt, um dem camelCase-Stil zu entsprechen.
- {cores_used} wird in {coresUsed} umbenannt.
- {max_cores_allowed} wird in {maxCoresAllowed} umbenannt.
- {regionName} wurde in {regionName} umbenannt.