当您需要对通用型NAS文件系统中某个目录所能包含的文件数量或者文件大小或者某个用户所能使用的资源进行限制时,您可以通过配额管理功能中的目录配额或用户配额进行配置。同时,同一个路径下,您还可以为多个用户设置不同的资源配额。
前提条件
配额类型
分类依据 | 配额类型 |
配额统计的范围 |
说明 仅通用型NAS NFS文件系统支持用户(组)配额功能。 |
配额的限制级别 |
|
使用限制
文件系统实例
通用型NAS NFS文件系统支持目录配额和用户(组)配额。
通用型NAS SMB文件系统支持目录配额功能。
配额
对于单个文件系统,最多可以对500个目录设置配额,支持配置的最大目录深度为8层。(例如,根目录/深度为0层,/workspace深度为1层,/workspace/dir1深度为2层,依此类推。)
重要设置限制型配额后,如果文件使用量超过限制会导致写入操作(包括增加文件长度、创建文件、目录、移动文件到目录等操作)失败,应用层会收到IOError。您可以参照为什么向文件系统写入数据时,返回Disk quota exceeded错误信息?进行处理。
由于限制型配额的高风险性,强烈建议您在业务关键路径上谨慎评估和测试验证后再配置限制型配额。
新建目录配额后,会有初始化过程,状态为初始化中。初始化过程时长取决于文件系统的文件和目录数目,最长可达数小时甚至更长。初始化完成之后,状态为运行中。目录配额的状态您可通过NAS控制台或调用DescribeDirQuotas API查询。
NAS配额的设置为异步执行,因此限制型配额的生效和失效都有延迟(正常情况下5分钟~15分钟)。
地域
通用型NAS NFS文件系统:支持所有地域。
通用型NAS SMB文件系统:暂不支持澳大利亚(悉尼)关停中地域和华南1金融云地域。
新建目录配额
登录NAS控制台。
在左侧导航栏,选择文件系统>文件系统列表。
在顶部菜单栏,选择地域。
找到目标文件系统,单击文件系统ID或者单击管理,进入配额管理页面,单击新建目录配额。
在新建目录配额对话框,配置目录路径,完成目录的添加。
重要仅支持为NAS文件系统中已创建的目录设置配额。配额的目录路径就是目录在NAS文件系统的绝对路径,而不是计算节点(例如,ECS,容器)上的本地路径。
不支持路径名中包含中文字符的目录。
例如,NAS挂载本地路径是
/mnt
,而在NAS文件系统中,根目录为/
,且有一级子目录/dir0
,二级子目录/dir/subdir1
等。如果您需要配置根目录、一级子目录、二级子目录的目录配额,则目录路径如下所示:根目录:
/
一级子目录:
/dir0
二级子目录:
/dir/subdir1
查询目录配额状态。
新建目录配额后,会有初始化过程,状态为初始化中。初始化过程时长取决于文件系统的文件和目录数目,最长可达数小时甚至更长。初始化完成之后,状态为运行中。同时,在用户配额列表中,会自动生成一条用户类型为所有用户、配额类型为统计型的配额。该用户配额仅支持修改配额类型,不支持修改用户类型。
添加用户配额
当用户配额的配额类型为统计型时,可以统计用户(组)在目录中的使用量和文件数;当用户配额的类型为限制型时,可以限制用户(组)在目录中的使用容量和文件数。
仅通用型NAS NFS文件系统支持用户(组)配额功能。
同一个用户类型只能配置一种类型的配额类型。
操作步骤
在配额管理区域,找到目标目录路径,单击管理配额。在弹出的面板中,单击添加用户配额,在弹出的对话框中配置相关信息。
参数 | 是否必选 | 说明 |
用户类型 | 是 | 指定用户ID的类型,包括Uid、Gid、所有用户三种。分别限制用户、用户组、全部用户。同一个路径下,可以为多个用户设置不同的配额。 |
ID | 否 | 当用户类型为Uid或Gid时,需要配置该参数。表示要限制的用户或用户组。 例如:
|
配额类型 | 是 |
|
容量限制(GiB) | 否 | 当配额类型为限制型时,需要配置该参数。表示配额用户在配额路径下所拥有文件和目录的最大存储量。 说明
|
文件数限制 | 否 | 当配额类型为限制型时,需要配置该参数。表示配额用户在配额路径下所拥有文件和目录的最大数量。 说明
|
删除单条用户配额
在用户配额列表中,找到目标配额条目,单击删除。
当您删除文件系统中已配置配额的目录时,NAS也会删除目录配额和用户配额列表中的目标配额条目。
编辑单条用户配额
在用户配额列表中,找到目标配额条目,单击编辑。可编辑的选项有配额类型、容量限制、文件数限制。
只有当配额类型为限制型时,可以编辑容量限制和文件数限制,且至少编辑其中一项。
API
管理配额功能提供了以下的API接口:
常见问题
为什么向文件系统写入数据时,返回Disk quota exceeded
错误信息?
问题原因
目标目录的使用量或文件数超过了设定的用户配额限制,因此导致写入操作(包括增加文件长度、创建文件、目录、移动文件到目录等操作)失败,返回类似
Disk quota exceeded
的错误信息。解决方案
建议您尽快清理数据释放空间,或者提升该目录的容量限制。具体操作,请参见编辑单条用户配额。
清理完成后,建议先对配额的目录执行测试性的写操作(例如,创建并写数据到测试文件)来触发配额缓存的异步刷新,判断这些测试性写操作能够成功,然后再重新启动业务。