文件夹 API 错误详细信息

本主题介绍了当文件夹 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 层(包括已删除的文件夹)。