Partager via


Azure HDInsight : API REST

Azure HDInsight est un service d’analytique open source managé, complet et disponible dans le cloud pour les entreprises. Vous pouvez utiliser des frameworks open source tels que Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R, etc. Vous pouvez utiliser ces frameworks 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, l’apprentissage automatique et l’IoT.

Présentation de l’interrogation d’API

Utilisez ces API pour créer et gérer des ressources HDInsight via Azure Resource Manager. Pour effectuer des opérations sur des ressources Azure HDInsight, vous devez envoyer une requête HTTPS avec une méthode prise en charge : GET, POST, PUT, ou 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 renvoie un x-ms-request-id en-tête qui peut être utilisé pour obtenir des informations sur la demande. Assurez-vous que les demandes adressées à ces ressources sont sécurisées. Pour plus d’informations, consultez Authentification des demandes Azure Resource Manager.

Paramètres et en-têtes courants

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 votre identificateur d’abonnement dans l’URI.

  • Remplacez {resource-group-name} par le groupe de ressources. Pour plus d’informations, consultez Utilisation de 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 à partir d’Azure Active Directory. Pour plus d’informations, consultez Authentification des demandes Azure Resource Manager.

Versions de l’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 Changement introduit Date de mise hors service
2015-03-01-preview 2024-11-30 Retraite prévue
2018-06-01-preview 2024-11-30 Retraite prévue
2021-06-01 Nouvelle version qui ajoute la prise en charge de plusieurs nouvelles fonctionnalités détaillées ci-dessous

Mises à jour de 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 prendra sa retraite le 2024-11-30. Cette nouvelle version de l’API ajoute plusieurs nouvelles fonctionnalités, notamment des zones de disponibilité, des liens privés et des connexions de points de terminaison privés. Avec la dernière 2021-06-01 API, veuillez noter 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 lien privé.
  3. Prise en charge de l’obtention de ressources de liaison privée des clusters HDInsight.
  4. Prise en charge de l’obtention/de l’approbation/du rejet/de la suppression des connexions de point de terminaison privé.
  5. Une propriété {location}, auparavant facultative, sera requise.
  6. Deux propriétés existantes seront supprimées de l’API Locations, {vmsizes} et {vmsize_filters}. Ces propriétés restent dans une autre partie de l’API, BillingSpecs. Nous passons à une source unique (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