通过

你当前正在访问 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}

另请参阅