CheckPolarFsQuotaConsistency - 檢查配額一致性 - PolarDB

介面說明

請求說明

該 API 允許使用者驗證指定 PolarFS 執行個體內的配額配置是否一致，包括但不限於目錄路徑上的儲存容量和 inode 限制。如果存在不一致的情況，將返回具體的不一致路徑列表及可能的錯誤資訊。

注意事項

確保PolarFsInstanceId參數正確無誤地指向了目標 PolarFS 執行個體。
當系統檢測到配額不一致時，除了返回IsConsistent=false外，還會提供InconsistentPaths數組來指示具體哪些路徑存在問題。
如果請求成功但沒有發現任何不一致，則InconsistentPaths為空白數組，並且IsConsistent=true。
錯誤處理：若請求過程中遇到許可權不足、資源不存在等問題，請參考提供的錯誤碼定義部分以擷取更詳細的錯誤資訊。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardb:CheckPolarFsQuotaConsistency

none

*全部資源

*

無

請求文法

GET / HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
PolarFsInstanceId	string	是	PolarFs 執行個體 ID	pfs-test****
Path	string	否	目錄	/test
EnableRepair	boolean	否	修複不一致配額，樣本值： false true	false
EnableStrictCalculate	boolean	否	在strict 模式下計算目錄的總使用量，樣本值： false true	false

返回參數

名稱	類型	描述	樣本值
	object	檢查配額一致性
PolarFsInstanceId	string	PolarFs 執行個體 ID	pfs-2ze0i74ka607*****
QuotaItem	object	檢查配額一致性
Path	string	路徑	/zookeepertest718
Capacity	integer	配額容量	104857600
UsedCapacity	integer	已使用容量，單位：Byte	104857600
Inodes	integer	Inodes	50000
UsedInodes	integer	已使用 Inodes	1
RequestId	string	請求 ID	E56531A4-E552-40BA-9C58-137B80******

樣本

正常返回樣本

JSON格式

{
  "PolarFsInstanceId": "pfs-2ze0i74ka607*****",
  "QuotaItem": {
    "Path": "/zookeepertest718",
    "Capacity": 104857600,
    "UsedCapacity": 104857600,
    "Inodes": 50000,
    "UsedInodes": 1
  },
  "RequestId": "E56531A4-E552-40BA-9C58-137B80******"
}

錯誤碼

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

變更歷史

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