全部產品
Search

搜尋本產品

    File Storage NAS：SetDirQuota - 設定檔案系統的目錄配額

    文件中心

    File Storage NAS：SetDirQuota - 設定檔案系統的目錄配額

    更新時間：Apr 04, 2026

    設定檔案系統的目錄配額。

    介面說明

    僅通用型 NAS 檔案系統支援目錄配額功能。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    nas:SetDirQuota

    create

    *FileSystem

    acs:nas:{#regionId}:{#accountId}:filesystem/{#filesystemId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    FileSystemId

    string

    是

    檔案系統 ID。

    1ca404****
    Path

    string

    是

    目錄在檔案系統中的絕對路徑。

    說明

    • 僅支援為 NAS 檔案系統中已建立的目錄設定配額。配額的目錄路徑就是目錄在 NAS 檔案系統的絕對路徑，而不是計算節點（例如，ECS，容器）上的本地路徑。

    • 不支援路徑名中包含中文字元的目錄。

    /data/sub1
    QuotaType

    string

    是

    配額類型。

    取值：

    • Accounting：統計型配額，只統計使用量。

    • Enforcement：限制型配額，當使用量超過限制後，會導致建立檔案或目錄、追加寫入等操作失敗。

    Accounting
    UserType

    string

    是

    使用者類型。

    取值：

    • Uid：使用者識別碼

    • Gid：使用者所屬組 ID

    • AllUsers：所有使用者

    Uid
    UserId

    string

    否

    要限制的 Uid 或 Gid。

    當 UserType=Uid 或 Gid 時必填且有意義。

    例如：

    • 要限制 Uid=500 的使用者，則 UserType 填 Uid，UserId 填 500。

    • 要限制 Gid=100 的使用者組，則 UserType 填 Gid，UserId 填 100。

    500
    SizeLimit

    integer

    否

    限制目錄下檔案總容量。

    單位：GiB

    當 QuotaType=Enforcement 時，SizeLimit 和 FileCountLimit 至少填寫其中一項。

    1024
    FileCountLimit

    integer

    否

    限制目錄下檔案數目。

    包括檔案、目錄和特殊檔案。

    當 QuotaType=Enforcement 時，SizeLimit 和 FileCountLimit 至少填寫其中一項。

    10000

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    5BC5CB97-9F28-42FE-84A4-0CD0DF42****
    Success

    boolean

    請求狀態。

    包括：

    • true：請求成功

    • false：請求失敗

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "5BC5CB97-9F28-42FE-84A4-0CD0DF42****",
  "Success": true
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    404 InvalidParameter.DirPathNotExist The Dir Path does not exist 目錄路徑不存在

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。