本主题介绍了当文件夹 API 操作因违反文件夹限制条件而失败时，系统返回的错误代码字符串的含义。发生这种情况时，系统将返回 PreconditionFailure 以说明违规情况。
如果失败情况同步发生，系统将通过 Status.details 字段返回 PreconditionFailure。如果失败情况异步发生，系统将通过 Operation.error 字段返回 PreconditionFailure。这些值会以字符串形式显示在 Status.details 所返回 PreconditionFailure.Violation 消息的类型字段中。
| 状态字符串 | 说明 |
|---|---|
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 层（包括已删除的文件夹）。 |