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	否	在严格模式下计算目录的总使用量，示例值： 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******"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。