Azure HDInsight：REST API
Azure HDInsight 是雲端中供企業使用的受控、全方位的開放原始碼分析服務。 您可以使用開放原始碼架構，例如 Hadoop、Apache Spark、Apache Hive、LLAP、Apache Kafka、Apache Storm、R 等等。 您可以使用這些開放原始碼架構來啟用各種案例，例如擷取、轉換和載入 (ETL) 、數據倉儲、機器學習和 IoT。
API 查詢概觀
使用這些 API 建立 HDInsight 資源，並透過 Azure Resource Manager 管理。 若要在 Azure HDInsight 資源上執行作業，請使用支援的方法傳送 HTTPS 要求： GET、 POST、 PUT或 DELETE 以特定資源為目標的端點。 所有工作作業都符合 HTTP/1.1 通訊協定規格，而且每個作業都會傳回 x-ms-request-id 可用來取得要求相關信息的標頭。 確定對這些資源發出的要求安全。 如需詳細資訊，請參閱 驗證 Azure Resource Manager 要求。
通用參數和標頭
下列資訊是您可能執行之叢集相關之所有工作的常見資訊：
將 {api-version} 取代為
2021-06-01以 URI 中的訂閱識別碼取代 {subscription-id}。
使用資源群組取代 {resource-group-name}。 如需詳細資訊，請參閱 使用資源群組來管理您的 Azure 資源。
將 {cluster-name} 取代為 URI 中的 HDInsight 叢集名稱。
將 Content-Type 標頭設定為 application/json。
將「授權」標頭設定為您從 Azure Active Directory 取得的 JSON Web 權杖。 如需詳細資訊，請參閱 驗證 Azure Resource Manager 要求。
支援的 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，請注意下列新功能和變更。
- 新增使用可用性區域建立叢集的支援。
- 請參閱 使用可用性區域建立叢集 和 Rest 範例 Rest - 使用可用性區域建立叢集
- 新增使用私人連結建立叢集的支援。
- 請參閱 使用私人連結建立叢集
- 支援取得 HDInsight 叢集的私人鏈接資源。
- 請參閱 私人鏈接資源
- 支援取得/核准/拒絕/刪除私人端點連線。
- 請參閱私人端點連線，如需 Rest 範例 Rest - 私人端點 Connections - 建立或更新
- 需要一個屬性 {location}，先前為選擇性。
- 將會從位置 API{vmsizes} 和 {vmsize_filters} 移除兩個現有的屬性。 這些屬性會保留在 API BillingSpecs 的另一個部分。 我們將移至這兩個屬性的單一來源 (BillingSpecs) 。
- 將會重新命名兩個現有的屬性，以符合 camelCase 樣式。
- {cores_used} 會重新命名為 {coresUsed}
- {max_cores_allowed} 會重新命名為 {maxCoresAllowed}
- {regionName} 已重新命名為 {regionName}