폴더 제약조건 위반으로 인해 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보다 커서는 안 된다는 삭제된 폴더 최대 깊이 제약조건을 위반하게 됩니다. |