当 Google Cloud 文件夹 API 操作因违反文件夹限制条件而失败时，该 API 会返回描述违规行为的 PreconditionFailure 错误。对于同步操作，API 会在 Status.details 字段中返回 PreconditionFailure 错误。对于异步操作，错误会显示在 Operation.error 字段中。错误代码字符串显示在 Status.details 中 PreconditionFailure.Violation 消息的 type 字段中。
| 状态字符串 | 说明 |
|---|---|
ERROR_TYPE_UNSPECIFIED |
错误类型无法识别或未指定。 |
ACTIVE_FOLDER_HEIGHT_VIOLATION |
尝试执行的操作会导致文件夹树状结构的深度超出上限 (4)。 |
MAX_CHILD_FOLDERS_VIOLATION |
尝试执行的操作会创建超出上限 (300) 的子文件夹。 |
FOLDER_NAME_UNIQUENESS_VIOLATION |
尝试执行的操作会违反本地专属的文件夹 display_name 限制条件。 |
RESOURCE_DELETED_VIOLATION |
要移动的资源已被删除。 |
PARENT_DELETED_VIOLATION |
正在将文件夹添加到其中的资源已被删除。 |
CYCLE_INTRODUCED_VIOLATION |
尝试执行的操作会形成资源路径循环。 |
FOLDER_BEING_MOVED_VIOLATION |
尝试执行的操作会移动正在被移动的文件夹。 |
FOLDER_TO_DELETE_NON_EMPTY_VIOLATION |
调用方尝试删除的文件夹包含活跃资源或与防火墙政策相关联。 |
DELETED_FOLDER_HEIGHT_VIOLATION |
尝试执行的操作会违反已删除文件夹深度上限；该限制条件规定，完整文件夹树状结构的深度不能超过 8 层（包括已删除的文件夹）。 |