使用目錄配額或使用者配額對目錄資源進行管理 - File Storage NAS

當您需要對通用型NAS檔案系統中某個目錄所能包含的檔案數量或者檔案大小或者某個使用者所能使用的資源進行限制時，您可以通過配額管理功能中的目錄配額或使用者配額進行配置。同時，同一個路徑下，您還可以為多個使用者佈建不同的資源配額。

前提條件

已建立通用型NAS檔案系統。更多資訊，請參見建立檔案系統。
已添加掛載點。更多資訊，請參見添加掛載點。
已建立許可權組和規則。更多資訊，請參見操作步驟。
已根據掛載情境，完成掛載檔案系統並在檔案系統中建立目錄。更多資訊，請參見掛載情境。

配額類型

分類依據	配額類型
配額統計的範圍	目錄配額：統計目錄下所有使用者的檔案系統使用量。使用者（組）配額：統計目錄下某個使用者（組）下的檔案系統使用量。說明僅通用型NAS NFS協議檔案系統支援使用者（組）配額功能。
配額的限制層級	統計型配額：只統計檔案系統使用量，方便使用者查看。限制型配額：當您為指定目錄配置限制型配額時，若檔案系統使用量超出配額後，將導致建立檔案或目錄、追加寫入等操作失敗。

使用限制

檔案系統執行個體
- 通用型NAS NFS協議檔案系統支援目錄配額和使用者（組）配額。
- 通用型NAS SMB協議檔案系統支援目錄配額功能。
- 極速型NAS不支援目錄配額功能。
配額
對於單個檔案系統，最多可以對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協議檔案系統支援使用者（組）配額功能。
同一個使用者類型只能配置一種類型的配額類型。

操作步驟

在配額管理地區，找到目標目錄路徑，單擊管理配額。在彈出的面板中，單擊添加使用者配額，在彈出的對話方塊中配置相關資訊。 add_user_quota

參數	是否必選	說明
使用者類型	是	指定使用者ID的類型，包括Uid、Gid、所有使用者三種。分別限制使用者、使用者組、全部使用者。同一個路徑下，可以為多個使用者佈建不同的配額。
ID	否	當使用者類型為Uid或Gid時，需要配置該參數。表示要限制的使用者或使用者組。例如：要限制Uid=500的使用者，使用者類型是Uid，ID是500。要限制Gid=100的使用者組，使用者類型是Gid，ID是100。
配額類型	是	統計型：僅統計指定目錄路徑的檔案系統使用量。限制型：除了統計和展示外，超出配額後，I/O會被限制。
容量限制(GB)	否	當配額類型為限制型時，需要配置該參數。表示配額使用者在配額路徑下所擁有檔案和目錄的最大儲存量。說明儲存量最小值為0 GiB，最大值為10,000,000 GiB。容量限制和檔案數限制至少填寫其中一項。
檔數限制	否	當配額類型為限制型時，需要配置該參數。表示配額使用者在配額路徑下所擁有檔案和目錄的最大數量。說明容量限制和檔案數限制至少填寫其中一項。檔案數最小值為1，最大值為1,000,000,000。

刪除單條使用者配額

在使用者配額列表中，找到目標配額條目，單擊刪除。

重要

當您刪除檔案系統中已配置配額的目錄時，NAS也會刪除目錄配額和使用者配額列表中的目標配額條目。

編輯單條使用者配額

在使用者配額列表中，找到目標配額條目，單擊編輯。可編輯的選項有配額類型、容量限制、檔案數限制。

說明

只有當配額類型為限制型時，可以編輯容量限制和檔案數限制，且至少編輯其中一項。

API

管理配額功能提供了以下的API介面：

常見問題

為什麼向檔案系統寫入資料時，返回`Disk quota exceeded`錯誤資訊？

問題原因
目標目錄的使用量或檔案數超過了設定的使用者配額限制，因此導致寫入操作（包括增加檔案長度、建立檔案、目錄、移動檔案到目錄等操作）失敗，返回類似Disk quota exceeded的錯誤資訊。
解決方案
1. 建議您儘快清理資料釋放空間，或者提升該目錄的容量限制。具體操作，請參見編輯單條使用者配額。
2. 清理完成後，建議先對配額的目錄執行測試性的寫操作（例如，建立並寫資料到測試檔案）來觸發配額緩衝的非同步重新整理，判斷這些測試性寫操作能夠成功，然後再重新啟動業務。