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