Freigeben über

Azure HDInsight: REST-APIs

Azure HDInsight ist ein verwalteter Open-Source-Analysedienst mit vollständigem Spektrum 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 mehr verwenden. Sie können diese Open-Source-Frameworks verwenden, um eine breite Palette von Szenarien zu ermöglichen, z. B. Extrahieren, Transformieren und Laden (ETL), Data Warehousing, maschinelles Lernen und IoT.

Übersicht über API-Abfragen

Verwenden Sie diese APIs, um HDInsight-Ressourcen über 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, PUToder DELETE an einen Endpunkt, der auf eine bestimmte Ressource abzielt. Alle Aufgabenoperationen entsprechen der HTTP/1.1-Protokollspezifikation, und jede Operation gibt einen x-ms-request-id Header zurück, der zum Abrufen von Informationen über die Anforderung verwendet werden kann. Stellen Sie sicher, dass Anforderungen an diese Ressourcen sicher sind. Weitere Informationen finden Sie unter Authentifizieren von Azure Resource Manager-Anforderungen.

Allgemeine Parameter und Header

Die folgenden Informationen gelten für alle Aufgaben im Zusammenhang mit Clustern, die Sie möglicherweise ausführen:

  • Ersetzen Sie {api-version} durch 2021-06-01

  • Ersetzen Sie {subscription-id} durch Ihren Abonnementbezeichner im URI.

  • Ersetzen Sie {resource-group-name} durch die Ressourcengruppe. Weitere Informationen finden Sie unter Verwenden von Ressourcengruppen zum Verwalten Ihrer Azure-Ressourcen.

  • Ersetzen Sie {cluster-name} durch den Namen Ihres HDInsight-Clusters im URI.

  • Legen Sie den Content-Type-Header auf application/json fest.

  • Legen Sie den Autorisierungsheader auf ein JSON-Webtoken fest, das Sie von Azure Active Directory abrufen. Weitere Informationen finden Sie unter Authentifizieren von Azure Resource Manager-Anforderungen.

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 bei jeder Anfrage über den x-ms-version Header angegeben werden. Wenn nicht angegeben, wird für den Dienst standardmäßig die neueste Version 2021-06-01verwendet.

Version Eingeführte Änderung Ruhestandsdatum
2015-03-01-preview 30.11.2024 geplanter Ruhestand
2018-06-01-preview 30.11.2024 geplanter Ruhestand
2021-06-01 Neue Version, die Unterstützung für mehrere neue Funktionen bietet, die unten aufgeführt sind

Updates in der neuen API-Version vom 01.06.2021

Wir haben eine neue Version der HDInsight-REST-API 2021-06-01veröffentlicht. Diese neue Version ersetzt 2018-06-01-preview die Version, die am 30.11.2024 eingestellt wird. Diese neue API-Version fügt mehrere neue Funktionen hinzu, darunter Verfügbarkeitszonen, private Verbindungen und private Endpunktverbindungen. Mit der neuesten 2021-06-01 API beachten Sie bitte die folgenden Neuerungen und Änderungen.

  1. Hinzufügen von Unterstützung für das Erstellen von Clustern mit Verfügbarkeitszonen.
  2. Unterstützung für das Erstellen von Clustern mit privater Verbindung hinzugefügt.
  3. Unterstützung des Abrufens von Private Link-Ressourcen von HDInsight-Clustern.
  4. Unterstützung von Verbindungen mit privaten Endpunkten zum Abrufen/Genehmigen/Ablehnen/Löschen.
  5. Eine Eigenschaft {location}, die zuvor optional war, ist erforderlich.
  6. Zwei vorhandene Eigenschaften werden aus der Standort-API entfernt: {vmsizes} und {vmsize_filters}. Diese Eigenschaften verbleiben in einem anderen Teil der API, BillingSpecs. Wir gehen für diese beiden Eigenschaften zu einer einzigen Quelle (BillingSpecs) über.
  7. Zwei vorhandene Eigenschaften werden umbenannt, um dem camelCase-Stil zu entsprechen.
    1. {cores_used} wird in {coresUsed} umbenannt
    2. {max_cores_allowed} wird in {maxCoresAllowed} umbenannt.
    3. {regionName} wurde in {regionName} umbenannt

Siehe auch

  • Last updated on