宣布v4 API和SDK在pc 2024.3版本中的正式发布...

今天，我们正式宣布推出 v4 API 和软件开发工具包（SDK）！ 该工具包已脱离公开候选版本（RC）状态，正式进入上市（GA）阶段。这意味着 v4 版本现已成为推荐版本，并完全适用于生产环境。

在当前技术环境中，企业面临着云现代化、基础设施快速变化以及加速API 和 SDK** 通过简化基础设施管理，使开发者能够快速、安全且高效地构建解决方案，从而有效降低混合多云的复杂性。

v4 API 和 SDK 的发布背景

Nutanix 一直致力于通过客户反馈推动创新。我们在 v4 API 的开发过程中，积极倾听用户的意见，深入了解他们的需求和痛点，并不断优化 API 功能，以帮助用户实现目标。

今年早些时候，v4 API 和 SDK 进入了 RC 阶段，并承诺为开发者社区带来卓越的 API 使用体验。如今，v4 API 和 SDK 已正式发布，功能全面升级，为各类企业提供了强大的开发工具。

此版本对 API 和 SDK 用户的意义

过去，Nutanix 提供了多个 API 版本（v1、v2 和 v3），每个版本基于不同的架构和技术。然而，随着产品堆栈的扩展，这种多版本的 API 平台给用户带来了学习曲线陡峭和资源需求增加等问题。

v4 API 和 SDK 的推出，旨在解决这些问题，并满足以下关键需求：

提供统一的 API 平台，支持整个堆栈的所有用例。
构建成熟且适合企业使用的 API 架构。
简化 API 的使用体验。
提供直观且高效的用户界面。

v4 API 和 SDK 的正式发布标志着企业级 API 的一个重要里程碑。

满足用户需求的强大功能

采用 OpenAPI 规范的标准化 API

v4 API 基于开放标准构建，提供一致性、可重用性和更好的管理能力。所有 v4 系列的 API 修订版（EA 版本除外）均支持向后兼容，确保应用程序在升级到新版本时能够无缝运行。这种兼容性降低了中断风险，使开发者能够专注于创新。

多语言 SDK 支持

Nutanix 提供了四种语言的 SDK，包括 Python、Java、Golang 和 JavaScript。这些语言惯用的 SDK 简化了集成过程，帮助开发者快速构建解决方案。

数据查询与处理功能

v4 API 支持筛选、排序、选择投影和分页等功能，帮助开发者根据特定用例高效检索所需数据。例如，您可以过滤特定集群上的虚拟机，或按内存大小对虚拟机进行排序。

健壮的 API 特性

v4 API 支持幂等性（Idempotency）和并发性（Concurrency），确保应用程序的一致性和可靠性。此外，统计 API 提供了对容量、运行状况和系统性能等关键指标的访问能力，并支持配置统计数据的类型、时间范围和频率。

批处理操作支持

通过 v4 Batch API，用户可以对 Nutanix 实体执行大规模批处理操作。例如，您可以通过单个 API 请求同时部署或更新多达 500 个虚拟机。这些操作支持异步执行，并提供长达 90 天的历史记录监控。

错误参考指南

每个 API 命名空间都配备了详细的错误参考文档，包括错误代码、消息解释和建议的解决方案，帮助用户快速诊断和解决问题。

基于角色的访问控制（RBAC）

v4 API 和 SDK 集成了 RBAC 功能，允许用户定义和强制执行细粒度权限。您可以配置自定义角色或使用系统定义的角色，并在 API 操作级别提供精确的权限控制。

传统 API 的弃用计划

随着 v4 API 和 SDK 的推出，Nutanix 将逐步弃用旧版 API（v0.8、v1、v2 和 v3）。从 2026 年第 4 季度开始，这些版本将不再受支持。我们建议所有客户尽快迁移到最新的 v4 API 和 SDK，以充分利用最新功能和创新。

新的开发者支持计划

为更好地支持开发者，Nutanix 推出了一个全新的支持计划，专为需要深入技术支持的组织设计。该计划提供专属技术顾问，帮助开发者解决 API 和 SDK 使用中的复杂问题，例如自动化用例实现、性能优化等。

如需了解更多信息，请访问 Nutanix 支持门户。

开始使用 v4 API 和 SDK

Nutanix 提供了丰富的资源，帮助新用户和现有用户快速上手 v4 API 和 SDK。例如，Nutanix Terraform Provider 和 Ansible Collections 已与 v4 API 和 SDK 集成，为基础设施自动化提供了强大的支持。

有关更多详细信息，请访问 Nutanix 官方文档。

原文链接: https://www.nutanix.com/blog/announcing-the-v4-api-and-sdk-general-availability-in-pc-2024-3-aos-7-0