| 编号 | 111 |
|---|---|
| 原文链接 | AIP-111: Planes |
| 状态 | 批准 |
| 创建日期 | 2023-06-17 |
| 更新日期 | 2023-06-17 |
API上的资源和方法可以根据所属或执行操作的 平面 分类。API上下文中定义了以下平面：
- 管理平面 ：统一的、面向资源的API，主要用于配置和资源检索。
- 数据平面 ：多范式API（理想情况下是面向资源的），读取和写入用户数据。通常连接到管理平面所提供的实体，如虚拟机。
术语“平面”最初用于网络架构。系统和网络架构通常会定义更多平面（例如控制平面或电源平面），由于AIP专注于接口，因此这些平面没有出现在AIP中。
指南
管理平面
管理资源和方法主要用于分配、配置和审计数据平面所连接的资源。
例如，以下内容被视为云提供商的管理资源：
- 虚拟机
- 虚拟专用网络
- 虚拟磁盘
- blob存储实例
- 项目或账户
数据平面
数据平面上的方法操作不同格式的用户数据，通常与管理平面API分配的资源进行交互。数据平面方法的示例有：
- 在表中写入和读取行
- 在消息队列中推送或拉取消息
- 在blob存储实例中上传或下载blob
出于高吞吐量、低延迟或需要遵守现有接口规范（例如ANSI SQL）等要求，数据平面API 可以 在众多接口中使用多种范式。
- 为了方便起见，操作数据平面的资源和方法 可以 通过面向资源的管理API发布。这些资源和方法 必须 遵守其他AIP（AIP-131至AIP-135）中提出的管理平面要求。
管理平面和数据平面的主要区别
- 声明式客户端只能操作管理平面。
- 数据平面通常位于面向用户功能的关键路径上，因此：
- 比管理平面的可用性要求更高。
- 比管理平面对性能更敏感。
- 比管理平面的吞吐量要求更高。
修订记录
- 2023-06-10 ：创建本AIP。
