接口概览
更新时间：2026-06-17
RapidFS API提供下列接口类型：
| 接口类型 | 描述 |
|---|---|
| 实例接口 | 使用RapidFS首先需要创建缓存实例。 RapidFS API提供了创建前校验、创建、查询、释放、扩缩容、查询和更新实例Token等实例相关接口。 |
| 权限组接口 | 您可以通过权限组控制不同客户端网段对RapidFS实例的访问权限。创建缓存实例时用户指定了缓存实例的VPC及子网，默认情况下该VPC内的实例，以及和该VPC网络互通的其他实例都可以访问该缓存实例。 RapidFS API提供了创建、查询、修改、删除等权限组相关接口。 |
| 缓存部署组接口 | RapidFS部署模式为Master托管模式且缓存接入类型为K8S/CCE/AIHC时，RapidFS API提供了查询缓存部署组接口。 |
| 缓存节点接口 | RapidFS部署模式为Master托管模式时，您需要运维和管理缓存节点。 RapidFS对不同缓存接入类型提供了如下接口： |
| 数据源接口 | 创建缓存实例后，您还需要创建和管理数据源，数据源建立了到对象存储的映射，为您提供了客户端挂载地址。 RapidFS API提供了导入、查询、修改、移除等数据源相关接口，以及用于查询数据源可分配配额的接口。 |
| 元数据同步接口 | 当您绕过RapidFS直接更新了底层对象存储数据时（例如通过对象存储工具/客户端/控制台更新了对象存储），您需要在RapidFS缓存实例对应数据源下触发元数据同步操作，才能在RapidFS实例内看到这些更新。直接通过RapidFS实例更新不需要该操作。RapidFS API当前支持元数据单次同步和周期同步两种同步规则。 |
| 缓存管理接口 | RapidFS实例通过将底层对象存储的数据缓存到实例中加速访问，您可以通过缓存预热和缓存淘汰接口主动管理 RapidFS实例中的缓存。与元数据同步不同，缓存管理不是必选操作，这正体现了RapidFS的透明访问特性。 强烈建议您提前触发所需目录的缓存预热，特别是需要读取的文件存在大量MB级以下小文件时，缓存预热可以保证首次读取性能。 RapidFS API提供了创建、查询、执行、取消、删除等缓存管理接口，以及查询缓存管理策略任务列表接口。 |
| 其他接口 | RapidFS API提供了查询可用区、查询套餐规格、查询配置价格、查询订单状态、绑定/解绑标签等接口； 对于Master托管部署模式且缓存接入类型为 CCE/AIHC的实例，RapidFS API提供了查询可部署的AIHC资源池列表、CCE集群列表接口。 |
评价此篇文章