Azure HDInsight: REST API

  • Статья

Azure HDInsight — это управляемая комплексная облачная служба аналитики с открытым кодом, предназначенная для предприятий. Вы можете использовать такие платформы с открытым кодом, как Hadoop, Apache Spark, Apache Hive, LLAP, Apache Kafka, Apache Storm, R и др. Эти платформы с открытым кодом можно использовать для реализации широкого спектра сценариев, таких как извлечение, преобразование и загрузка (ETL), хранение данных, машинное обучение и Интернет вещей.

Обзор запросов API

Эти API позволяют создавать ресурсы HDInsight и управлять ими с помощью Azure Resource Manager. Для выполнения операций с ресурсами Azure HDInsight отправляется HTTPS-запрос с поддерживаемым методом: GET, POST, PUTили DELETE в конечную точку, предназначенную для определенного ресурса. Все операции задачи соответствуют спецификации протокола HTTP/1.1, и каждая операция возвращает заголовок x-ms-request-id , который можно использовать для получения сведений о запросе. Убедитесь, что запросы к этим ресурсам безопасны. Дополнительные сведения см. в справочнике REST API Azure.

Распространенные параметры и заголовки

Следующие сведения являются общими для всех задач, связанных с кластерами, которые вы можете выполнять.

  • Замените {api-version} на 2021-06-01

  • Замените {subscription-id} на ваш идентификатор подписки в URI.

  • Замена {resource-group-name} на группу ресурсов. Дополнительные сведения см. в разделе Использование групп ресурсов для управления ресурсами Azure.

  • Замените {cluster-name} именем кластера HDInsight в URI.

  • Задание для заголовка Content-Type значения application/json.

  • Задание для заголовка авторизации веб-маркера JSON, полученного из Azure Active Directory. Дополнительные сведения см. в справочнике REST API Azure.

Поддерживаемые версии REST API

В следующей таблице перечислены версии REST API, поддерживаемые службой Azure HDInsight. Версия должна быть указана с помощью заголовка x-ms-version в каждом запросе. Если этот параметр не указан, служба по умолчанию использует последнюю версию 2021-06-01.

Версия Внесенные изменения Дата вывода
2015-03-01-preview Плановое прекращение поддержки на 30.11.2024 г.
2018-06-01-preview Плановое прекращение поддержки на 30.11.2024 г.
2021-06-01 Новая версия, в которой добавлена поддержка нескольких новых функций, описанных ниже

Обновления в новой версии API 2021-06-01

Мы выпустили новую версию REST API 2021-06-01HDInsight. Эта новая версия заменяет 2018-06-01-preview версию, которая будет прекращена 30.11.2024. Эта новая версия API добавляет несколько новых функций, включая зоны доступности, приватный канал и подключения к частной конечной точке. В последней версии 2021-06-01 API обратите внимание на следующие новые функции и изменения.

  1. Добавлена поддержка создания кластеров с зонами доступности.
  2. Добавлена поддержка создания кластеров с приватным каналом.
  3. Поддержка получения ресурсов приватного канала кластеров HDInsight.
  4. Поддержка получения, утверждения, отклонения и удаления подключений к частным конечным точкам.
  5. Требуется одно свойство {location}, ранее необязательное.
  6. Два существующих свойства будут удалены из API расположений: {vmsizes} и {vmsize_filters}. Эти свойства остаются в другой части API, BillingSpecs. Мы переходим к одному источнику (BillingSpecs) для этих двух свойств.
  7. Два существующих свойства будут переименованы в соответствии со стилем camelCase.
    1. {cores_used} будет переименован в {coresUsed}
    2. {max_cores_allowed} будет переименован в {maxCoresAllowed}
    3. {regionName} переименован в {regionName}

См. также раздел