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