Azure HDInsight: REST API

  • [アーティクル]

Azure HDInsight は、全範囲に対応した、クラウドでのオープンソースの企業向けマネージド分析サービスです。 Hadoop、Apache Spark、Apache Hive、LLAP、Apache Kafka、Apache Storm、R などのオープンソース フレームワークを使用できます。 これらのオープンソース フレームワークを使用すると、抽出、変換、読み込み (ETL)、データ ウェアハウス、機械学習、IoT など、さまざまなシナリオを実現できます。

API クエリの概要

Azure Resource Manager を通じて HDInsight リソースを作成し、管理するには、これらの API を使用します。 Azure HDInsight リソースに対して操作を実行するには、サポートされているメソッド GETPOSTPUT、または DELETE を使用して、特定のリソースを対象とするエンドポイントに HTTPS 要求を送信します。 すべてのタスク操作は HTTP/1.1 プロトコル仕様に準拠しており、各操作は要求に関する情報を取得するために使用できるヘッダーを返 x-ms-request-id します。 これらのリソースに対して行う要求がセキュリティで保護されていることを確認してください。 詳細については、「Azure REST API Reference (Azure REST API リファレンス)」を参照してください。

一般的なパラメーターとヘッダー

次の情報は、実行できるクラスターに関連するすべてのタスクに共通です。

  • {api-version} を に置き換えます 2021-06-01

  • URI の {subscription-id} をサブスクリプション ID に置き換えます。

  • {resource-group-name} をリソース グループで置換します。 詳細については、リソース グループを使用した Azure リソースの管理に関するページを参照してください。

  • {cluster-name} を URI の HDInsight クラスター名に置き換えます。

  • Content-Type ヘッダーを application/json に設定します。

  • Authorization ヘッダーを、Azure Active Directory から取得する JSON Web Token に設定します。 詳細については、「Azure REST API Reference (Azure REST API リファレンス)」を参照してください。

サポートされている REST API のバージョン

次の表に、Azure HDInsight サービスでサポートされている REST API のバージョンを示します。 バージョンは、すべての要求で ヘッダーを x-ms-version 使用して指定する必要があります。 指定しない場合、サービスの既定値は最新バージョン 2021-06-01です。

バージョン 導入された変更 提供終了日
2015-03-01-preview 2024-11-30 廃止予定
2018-06-01-preview 2024-11-30 廃止予定
2021-06-01 以下で詳しく説明するいくつかの新機能のサポートを追加する新しいバージョン

新しい 2021-06-01 API バージョンの更新

HDInsight REST API 2021-06-01の新しいバージョンがリリースされました。 この新しいバージョンは、 2018-06-01-preview 2024-11-30 で廃止されるバージョンに置き換えられます。 この新しい API バージョンでは、可用性ゾーン、プライベート リンク、プライベート エンドポイント接続など、いくつかの新機能が追加されます。 最新 2021-06-01 の API では、次の新機能と変更に注意してください。

  1. 可用性ゾーンを使用したクラスターの作成のサポートの追加。
  2. プライベート リンクを使用したクラスターの作成のサポートの追加。
  3. HDInsight クラスターのプライベート リンク リソースの取得をサポートします。
  4. プライベート エンドポイント接続の取得、承認、拒否、削除をサポートします。
  5. 1 つのプロパティ {location} (以前は省略可能) が必要です。
  6. Locations API {vmsizes} と {vmsize_filters} から 2 つの既存のプロパティが削除されます。 これらのプロパティは、API BillingSpecs の別の部分に残ります。 これら 2 つのプロパティについて、単一のソース (BillingSpecs) に移行します。
  7. camelCase スタイルと一致するように、既存の 2 つのプロパティの名前が変更されます。
    1. {cores_used} の名前が {coresUsed} に変更されます
    2. {max_cores_allowed} の名前が {maxCoresAllowed} に変更されます
    3. {regionName} の名前が {regionName} に変更されました

こちらもご覧ください