Azure HDInsight : API REST

  • Article

Azure HDInsight est un service cloud d’analyse managé, complet et open source pour les entreprises. Vous pouvez utiliser les infrastructures open source telles que Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R et bien plus encore. Vous pouvez utiliser ces infrastructures open source pour activer un large éventail de scénarios tels que l’extraction, la transformation et le chargement (ETL), l’entreposage de données, le Machine Learning et l’IoT.

Vue d’ensemble de l’interrogation des API

Ces API permettent de créer et gérer des ressources HDInsight via Azure Resource Manager. Pour effectuer des opérations sur des ressources Azure HDInsight, vous envoyez une requête HTTPS avec une méthode prise en charge : GET, POST, PUTou DELETE à un point de terminaison qui cible une ressource spécifique. Toutes les opérations de tâche sont conformes à la spécification du protocole HTTP/1.1 et chaque opération retourne un x-ms-request-id en-tête qui peut être utilisé pour obtenir des informations sur la requête. Assurez-vous que les demandes adressées à ces ressources sont sécurisées. Pour plus d’informations, consultez Demandes d'authentification Azure Resource Manager.

Paramètres et en-têtes communs

Les informations suivantes sont communes à toutes les tâches liées aux clusters que vous pouvez effectuer :

  • Remplacez {api-version} par 2021-06-01

  • Remplacez {subscription-id} par l'identificateur de votre abonnement dans l'URI.

  • Remplacez {resource-group-name} par le nom du groupe de ressources. Pour plus d'informations, consultez la rubrique Utilisation des groupes de ressources pour gérer vos ressources Azure.

  • Remplacez {cluster-name} par le nom de votre cluster HDInsight dans l’URI.

  • Définissez l’en-tête Content-Type sur application/json.

  • Définissez l'en-tête Authorization sur un jeton web JSON que vous obtenez d'Azure Active Directory. Pour plus d’informations, consultez Demandes d'authentification Azure Resource Manager.

Versions d’API REST prises en charge

Le tableau suivant répertorie les versions d’API REST prises en charge par le service Azure HDInsight. La version doit être spécifiée via l’en-tête x-ms-version dans chaque requête. S’il n’est pas spécifié, le service utilise par défaut la dernière version 2021-06-01.

Version Modification introduite Date de mise hors service
2015-03-01-preview 2024-11-30 retraite planifiée
2018-06-01-preview 2024-11-30 retraite planifiée
2021-06-01 Nouvelle version qui ajoute la prise en charge de plusieurs nouvelles fonctionnalités détaillées ci-dessous

Mises à jour dans la nouvelle version de l’API 2021-06-01

Nous avons publié une nouvelle version de l’API 2021-06-01REST HDInsight . Cette nouvelle version remplace 2018-06-01-preview la version qui sera mise hors service le 30/11/2024. Cette nouvelle version de l’API ajoute plusieurs nouvelles fonctionnalités, notamment des zones de disponibilité, une liaison privée et des connexions de point de terminaison privées. Avec la dernière 2021-06-01 API, notez les nouvelles fonctionnalités et modifications suivantes.

  1. Ajout de la prise en charge de la création de clusters avec des zones de disponibilité.
  2. Ajout de la prise en charge de la création de clusters avec une liaison privée.
  3. Prise en charge de l’obtention de ressources de liaison privée de clusters HDInsight.
  4. Prise en charge des connexions de point de terminaison privé get/approve/reject/delete.
  5. Une propriété {location}, précédemment facultative, sera requise.
  6. Deux propriétés existantes seront supprimées de l’API Emplacements, {vmsizes} et {vmsize_filters}. Ces propriétés restent dans une autre partie de l’API, BillingSpecs. Nous passons à une seule source (BillingSpecs) pour ces deux propriétés.
  7. Deux propriétés existantes seront renommées pour correspondre au style camelCase.
    1. {cores_used} sera renommé en {coresUsed}
    2. {max_cores_allowed} sera renommé en {maxCoresAllowed}
    3. {regionName} a été renommé en {regionName}

Voir aussi