API上的资源和方法可以根据所属或执行操作的 平面 分类。API上下文中定义了以下平面：

• 管理平面 ：统一的、面向资源的API，主要用于配置和资源检索。
• 数据平面 ：多范式API（理想情况下是面向资源的），读取和写入用户数据。通常连接到管理平面所提供的实体，如虚拟机。

术语“平面”最初用于网络架构。系统和网络架构通常会定义更多平面（例如控制平面或电源平面），由于AIP专注于接口，因此这些平面没有出现在AIP中。

指南

管理平面

管理资源和方法主要用于分配、配置和审计数据平面所连接的资源。

例如，以下内容被视为云提供商的管理资源：

• 虚拟机
• 虚拟专用网络
• 虚拟磁盘
• blob存储实例
• 项目或账户

数据平面

数据平面上的方法操作不同格式的用户数据，通常与管理平面API分配的资源进行交互。数据平面方法的示例有：

• 在表中写入和读取行
• 在消息队列中推送或拉取消息
• 在blob存储实例中上传或下载blob

出于高吞吐量、低延迟或需要遵守现有接口规范（例如ANSI SQL）等要求，数据平面API 可以 在众多接口中使用多种范式。

• 为了方便起见，操作数据平面的资源和方法 可以 通过面向资源的管理API发布。这些资源和方法 必须 遵守其他AIP（AIP-131至AIP-135）中提出的管理平面要求。

管理平面和数据平面的主要区别

• 声明式客户端只能操作管理平面。
• 数据平面通常位于面向用户功能的关键路径上，因此：
  • 比管理平面的可用性要求更高。
  • 比管理平面对性能更敏感。
  • 比管理平面的吞吐量要求更高。

修订记录

• 2023-06-10 ：创建本AIP。