简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

ASA R2支持REST API

08/27/2026 贡献者

ASA R2 REST API基于通过统一ONTAP特性提供的REST API、并根据ASA R2特性的独特特性和功能进行了许多更改。

API更改类型

ASA r2 REST API 与适用于 FAS、AFF 和 ASA 系统的统一 ONTAP REST API 之间存在几个区别。了解这些更改将有助于您更有效地使用在线 API 参考文档。

统一ONTAP不支持新的ASA R2端点

ASA R2 REST API中添加了多个端点、这些端点在统一ONTAP中不可用。

例如、ASA R2系统的REST API中添加了一个新的块卷端点。通过块卷端点、您可以同时访问LUN和NVMe命名空间对象、从而获得资源的聚合视图。此功能仅可通过REST API使用。

另一个示例是、*存储单元*端点提供了LUN和NVMe命名空间的汇总视图。有多个端点，它们都基于或派生自 /api/storage/storage-units。您还应查看 /api/storage/luns`和 `/api/storage/namespaces。

对某些端点使用的HTTP方法的限制

与统一ONTAP相比、ASA R2提供的多个端点对可使用的HTTP方法有一些限制。例如、 `/api/protocols/nvme/services`在ASA R2系统中使用端点时、不允许POST和DELETE。

端点和HTTP方法的属性更改

某些 ASA r2 端点和方法组合不支持为统一 ONTAP 特性定义的所有属性。例如，将 PATCH 与端点 `/api/storage/volumes/{uuid}`结合使用时，ASA r2 不支持以下几个属性，包括：

对内部处理的更改

ASA R2处理某些REST API请求的方式有几处变更。例如、端点的删除请求 `/api/storage/luns/{uuid}`会异步处理。

OAuth 2.0 是行业标准授权框架。它用于根据已签名的访问令牌限制和控制对受保护资源的访问。您可以使用 System Manager 配置 OAuth 2.0 以保护 ASA r2 系统资源。

使用System Manager设置OAuth2.0后、可以控制REST API客户端的访问。您需要先从授权服务器获取访问令牌。然后、REST客户端使用HTTP授权请求标头将令牌作为承载令牌传递到ASA R2集群。有关详细信息、请参见 "使用OAuth2.0进行身份验证和授权" 。

您可以在ASA R2系统上通过Swagger UI访问REST API参考文档。

关于此任务

有关REST API的详细信息、您应访问ASA R2参考文档页面。在此过程中，您可以搜索字符串*Platform specifices*，以查找有关ASA R2系统对API调用和属性的支持的详细信息。

开始之前

您必须具备以下条件：

步骤