概述
文件存储（Cloud File Storage，CFS）提供了可扩展的共享文件存储服务，可与腾讯云的 CVM 、容器、批量计算等服务搭配使用。CFS 提供了标准的 NFS 及 CIFS/SMB 文件系统访问协议，为多个 CVM 实例或其他计算服务提供共享的数据源，支持弹性容量和性能的扩展，现有应用无需修改即可挂载使用，是一种高可用、高可靠的分布式文件系统，适合于大数据分析、媒体处理和内容管理等场景。
- 本章节介绍的文件存储 API 接口均为 API 3.0 接口。
- 您可以调用 API 对文件存储进行操作，例如创建文件系统、查询文件系统详情、删除文件系统等。
- 文件存储支持的所有接口信息，请参见 API 概览。
- 在调用以下接口前，请确保已充分了解 CFS 产品、创建使用 和 计费方式。
术语表
文件存储 API 接口的常见术语请参见下表：
| 术语 | 说明 |
|---|---|
| CFS | Cloud File Storage，即云文件存储。是一种提供标准网络文件系统协议（如 NFS、CIFS）访问的共享文件存储服务。用于在云上搭建高性能、可扩展且可靠的文件共享系统，供多个云服务器（CVM）或容器同时访问。 |
| KiB | Kibibyte，一种数据存储容量单位，1KiB = 1024Bytes。用于精确表示文件或存储系统的容量。 |
| MiB | Mebibyte，一种数据存储容量单位，1MiB = 1024KiB = 1,048,576Bytes。用于精确表示文件或存储系统的容量。 |
| GiB | Gibibyte，一种数据存储容量单位，1GiB = 1024MiB = 1,073,741,824Bytes。用于精确表示文件或存储系统的容量。 |
| TiB | Tebibyte，一种数据存储容量单位，1TiB = 1024GiB。用于表示大型文件系统的容量。 |
| PiB | Pebibyte，一种数据存储容量单位，1PiB = 1024TiB。用于表示超大规模文件系统的容量。 |
| NFS | Network File System，即网络文件系统。一种分布式文件系统协议。通过 NFS 协议，您可以像访问本地文件一样访问远端系统上的文件，是 Linux/Unix 系统间文件共享的标准协议。CFS 的通用系列文件系统支持通过 NFS 协议提供服务。 |
| CIFS | Common Internet File System，即通用互联网文件系统。它是 SMB（Server Message Block）协议的一个公共版本。主要用于 Windows 系统之间进行网络文件共享。CFS 的通用系列文件系统支持通过也支持 CIFS/SMB 协议。 |
| TURBO | CFS Turbo 系列文件系统所使用的私有客户端文件系统协议。CFS Turbo 系列用于为 AI 训练、高性能计算（HPC）、媒体处理等需要超高性能、低延迟和高吞吐的 I/O 密集型业务场景提供支持。 |
| SD | Standard，即 CFS 通用标准型文件存储。适用于小规模通用数据存储场景。 |
| HP | High-Performance，即 CFS 通用性能型文件存储。适合于小规模延时敏感型核心业务。 |
| TB | Standard Turbo，即 CFS Turbo 标准型文件存储。适用于大规模吞吐型和混合负载型业务。 |
| TP | High-Performance Turbo，即 CFS Turbo 性能型文件存储。适用于大规模小文件业务。 |
| THP | High-Throughput，即 CFS 吞吐型文件存储。适用于渲染、游戏战斗服务器、非线性编辑等读密集型场景。 |
| VPC | Virtual Private Cloud，即私有网络，是用户在腾讯云上自定义的逻辑隔离网络空间。用于为 CFS 文件系统提供网络隔离和安全访问控制，CFS 文件系统通常部署在 VPC 内以确保安全。 |
| CCN | Cloud Connect Network，即云联网。提供腾讯云上 VPC 之间、VPC 与本地数据中心间（IDC）内网互联的服务。用于实现从用户自建的 VPC 访问专属 VPC 下的 CFS Turbo 文件系统。 |
| CidrBlock | Classless Inter-Domain Routing Block，即无类别域间路由网段。用于在云联网（CCN）中为 CFS Turbo 文件系统指定一个 IP 地址范围（如10.0.0.0/24），是配置 Turbo 文件系统网络的基础。 |
| PGroup | Permission Group，即权限组。是 CFS 中用于管理文件系统访问权限的配置集合。用于为文件系统绑定规则，控制允许访问文件系统的 IP 地址以及 RW（读写）或 RO（只读）权限。 |
| UID | User Identifier，即用户 ID 。在 Linux/Unix 系统中，它是一个用于标识系统用户的唯一数字。用于在文件系统层面控制文件和目录的访问权限（所有者）。 |
| GID | Group Identifier，即组 ID 。在 Linux/Unix 系统中，它是一个用于标识用户组的唯一数字。用于在文件系统层面控制文件和目录的访问权限（所属组）。 |
| Snapshot | 快照。快照是文件系统在某个时间点的数据状态副本。用于数据备份、容灾恢复和版本回溯。CFS 提供通用系列（general）快照和 Turbo 系列（turbo）快照。 |
| LifecyclePolicy | 生命周期管理策略。用于自动执行对数据的管理操作，例如根据预设规则（如文件最后访问时间）将不常访问的数据从标准存储自动转移到更低成本的低频存储中，以优化存储成本。 |
使用限制
由于技术架构、开发周期不同，不同类型文件系统的规格和功能有所不同，详情请参见 系统限制。对于具体的参数限制，请参考各接口文档中输出参数的说明。
API 快速入门
通过 API 使用 CFS 通用标准型文件系统，您可以通过 API Explorer 工具，步骤如下：
- 开通 CFS 服务：您可以使用 开通 CFS 服务 接口查询及开通 CFS 服务。
- 查询区域可用情况：您可以使用 查询区域可用情况 接口了解各可用区的资源售卖情况以及支持的存储类型、存储协议等信息，确保在您期望创建文件系统的地域开放售卖通用标准型（SD）。
- 创建权限组及权限组规则：您可以使用 创建权限 及 创建权限组规则 接口配置权限组，用于管理文件系统访问权限。
- 创建通用标准型文件系统：您可以使用 创建文件系统 接口定义文件系统详细设置，并关联所创建的权限组。
- 查询文件系统：您可以使用 查询文件系统 接口查看文件系统状态和详细配置。
- 在云服务器上挂载文件系统：当文件系统创建成功后，您可以在云服务器上挂载该文件系统，挂载方式请参考 在 Linux 客户端上使用 CFS 文件系统，提供命令行挂载和控制台挂载多种方式。
- 在云服务器上卸载文件系统：当您不再需要使用该文件系统，您可以在云服务器上卸载该文件系统，卸载方式请参考 在 Linux 客户端上使用 CFS 文件系统，提供命令行卸载和图形化界面卸载（Windows）等多种方式。
- 删除文件系统：当您已卸载云服务器上的文件系统，您可以调用 删除文件系统 接口删除文件系统，删除后该文件系统不再计费。
