你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Azure HDInsight：REST API

  • 项目

Azure HDInsight 是面向企业的云中的托管、全方位、开源分析服务。 可以使用开源框架，例如 Hadoop、Apache Spark、Apache Hive、LLAP、Apache Kafka、Apache Storm、R 等等。 可以使用这些开源框架来实现各种方案，例如提取、转换和加载 (ETL) 、数据仓库、机器学习和 IoT。

API 查询概述

使用这些 API 通过 Azure 资源管理器创建和管理 HDInsight 资源。 若要对 Azure HDInsight 资源执行操作，请使用受支持的方法向面向特定资源的终结点发送 HTTPS 请求：GET、POSTPUT、 或 DELETE 。 所有任务操作都符合 HTTP/1.1 协议规范，每个操作返回 x-ms-request-id 可用于获取请求相关信息的标头。 请务必确保对这些资源发出的请求都是安全的。 有关详细信息，请参阅对 Azure 资源管理器请求进行身份验证。

常见参数和标头

以下信息对于你可能执行的与群集相关的所有任务都是通用的：

  • 将 {api-version} 替换为 2021-06-01

  • 在 URI 中将 {subscription-id} 替换为你的订阅标识符。

  • 将 {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 时，请注意以下新功能和更改。

  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}

另请参阅