全部產品
Search

搜尋本產品

    PolarDB：AddPolarFsQuota - 新增Polarlakebase配額規則

    文件中心

    PolarDB：AddPolarFsQuota - 新增Polarlakebase配額規則

    更新時間：Mar 16, 2026

    為Polarlakebase執行個體添加新的目錄配額規則。

    介面說明

    請求說明

    • 該 API 用於向指定的 Polarlakebase 執行個體中添加新的 PathPolicy（Quota 規則）。

    • Quotas參數是一個列表，每個元素代表一個待新增的規則，最多支援同時添加 11 條規則。

    • 每個規則必須包含Name和Include欄位，其他欄位如Description、Exclude等為可選項。

    • SizeLimit、FileCountLimit、AccessTTL、ChangeTTL至少需要提供其中之一來定義配額限制。

    • Priority欄位用於設定規則優先順序，數值越大優先順序越高，預設值為 0。

    • Enabled欄位控制規則是否立即生效，預設值為 true 表示立即生效。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    polardb:AddPolarFsQuota

    none

    *全部資源

    *

    		 無 無

    請求文法

    POST  HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    PolarFsInstanceId

    string

    是

    Polarlakebase 執行個體 ID

    pfs-2ze0i74ka607*****
    Quotas

    array<object>

    是

    配額規則詳情。

    object

    否

    配額詳情。

    Name

    string

    是

    規則名稱

    rule1
    Description

    string

    否

    資源配額描述。

    quota_policy
    Include

    string

    是

    匹配路徑的通配模式

    • 以 / 開頭的路徑模式（支援 *、?、**` 的 glob 文法）。

    /b/*project*
    Exclude

    string

    否

    排除特定路徑的匹配規則

    • 以 / 開頭的路徑模式（支援 *、?、** 的 glob 文法）

    /a/*project*
    SizeLimit

    integer

    否

    限制目錄下檔案總容量。單位：GB

    • 說明：不小於 1GB

    1
    FileCountLimit

    integer

    否

    目錄下使用者的檔案數目限制。

    222
    AccessTTL

    integer

    否

    access time 對應的 ttl，單位 秒

    7200
    ChangeTTL

    integer

    否

    change time 對應的 ttl，單位 秒

    7200
    Priority

    integer

    否

    配額規則的優先順序。

    1
    Enabled

    boolean

    否

    規則是否啟用，取值如下：

    • True：新增事件對新事物立即生效，預設值

    • False：新增事件對新事物不生效

    True
    DBClusterId

    string

    否

    應用依賴的 PolarDB 執行個體 ID

    pc-**************

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    Id of the request

    7F2007D3-7E74-4ECB-89A8-BF130D******
    PolarFsInstanceId

    string

    Polarlakebase 執行個體 ID

    pfs-2ze0i74ka607*****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "7F2007D3-7E74-4ECB-89A8-BF130D******",
  "PolarFsInstanceId": "pfs-2ze0i74ka607*****"
}

    錯誤碼

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

    變更歷史

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