你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure HDInsight 是面向企业的云中托管的全谱开源分析服务。 您可以使用 Hadoop、Apache Spark、Apache Hive、LLAP、Apache Kafka、Apache Storm、R 等开源框架。 可以使用这些开源框架来支持各种方案，例如提取、转换和加载 （ETL）、数据仓库、机器学习和 IoT。
API 查询概述
使用这些 API 通过 Azure 资源管理器创建和管理 HDInsight 资源。 若要对 Azure HDInsight 资源执行作，请使用受支持的方法 GET发送 HTTPS 请求：、 POST、 PUT或 到 DELETE 面向特定资源的终结点。 所有任务作都符合 HTTP/1.1 协议规范，每个作都会返回一个 x-ms-request-id 标头，可用于获取有关请求的信息。 确保对这些资源发出的请求是安全的。 有关详细信息，请参阅 对 Azure 资源管理器请求进行身份验证。
常见参数和标头
以下信息对于您可能执行的与集群相关的所有任务都是通用的：
将 {api-version} 替换为
2021-06-01将 {subscription-id} 替换为 URI 中的订阅标识符。
将 {resource-group-name} 替换为资源组。 有关详细信息，请参阅使用资源组管理 Azure 资源。
将 {cluster-name} 替换为 URI 中的 HDInsight 群集名称。
将 Content-Type 标头设置为 application/json。
将 Authorization 标头设置为从 Azure Active Directory 获取的 JSON Web 令牌。 有关详细信息，请参阅 对 Azure 资源管理器请求进行身份验证。
支持的 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，请注意以下新功能和更改。
- 添加对创建具有可用性区域的群集的支持。
- 添加对使用专用链接创建集群的支持。
- 请参阅 使用专用链接创建集群
- 支持获取 HDInsight 群集的专用链接资源。
- 请参阅 专用链接资源
- 支持获取/批准/拒绝/删除专用终结点连接。
- 请参阅 专用终结点连接 ，有关 REST 示例 - 专用终结点连接 - 创建或更新
- 需要一个属性 {location}（以前可选）。
- 将从 Locations API 中删除两个现有属性，{vmsizes} 和 {vmsize_filters}。 这些属性保留在 API 的另一部分 BillingSpecs 中。 我们将为这两个属性迁移到单一来源 （BillingSpecs）。
- 两个现有属性将被重命名，以匹配驼峰命名法样式。
- {cores_used} 将重命名为 {coresUsed}
- {max_cores_allowed} 将重命名为 {maxCoresAllowed}
- {regionName} 已重命名为 {regionName}