V1 첨부 파일 API

첨부 파일(Attachment)은 객체와 함께 사용하는 파일입니다. 먼저 임시 파일로 업로드하고 액션을 통해 객체에 연결합니다. 첨부 파일 사용을 위한 속성과 액션 매개변수는 Ontology Manager에서 구성합니다.

객체에 연결하기 위한 구성

액션 매개변수 유형과 편집할 객체 속성 유형은 Attachment여야 합니다. 단일 첨부 파일을 저장할 기반 데이터셋 열은 String입니다. 여러 파일을 한 속성에 연결하려면 액션 매개변수의 Allow multiple values와 객체 속성의 Allow multiple을 모두 켜고 기반 열을 Array로 구성합니다.

첨부 파일은 로직 기반 액션과 함수 기반 액션을 모두 지원합니다. 객체에 연결된 첨부 파일의 조회, 편집과 삭제 권한은 해당 객체의 권한을 따릅니다. 객체를 볼 수 있는 사용자는 그 객체의 첨부 파일을 보고 다운로드할 수 있으며, 교체에는 객체 편집 권한이 필요합니다.

수명과 제한

• 파일 크기의 전역 고정 한도는 200 MB입니다.
• 업로드한 뒤 한 시간 안에 액션으로 객체에 연결하지 않은 첨부 파일은 제거됩니다.
• 이전에 연결했지만 더 이상 어느 객체에도 연결되지 않은 첨부 파일도 격주(biweekly) 정리 주기에 제거됩니다.
• 첨부 파일 하나는 수명 전체에 걸쳐 최대 10개 객체에 연결할 수 있습니다. 원래 객체를 삭제해도 다른 객체에 연결할 수 있는 한도가 복구되지 않습니다. 한도에 도달하면 파일을 새 첨부 파일로 다시 업로드하여 추가 객체에 연결합니다.

액션 양식에서는 파일을 추가하는 즉시 업로드가 시작됩니다. 양식 제출에 실패하거나 취소하면 남은 첨부 파일에 직접 접근할 수 없게 되고 이후 영구 삭제됩니다. 객체 삭제나 첨부 속성 제거로 연결이 사라진 파일도 정리 대상입니다.

Attachment 응답

다음 필드는 모두 필수입니다.

업로드 요청의 콘텐츠 유형은 파일 자체의 미디어 유형과 관계없이 application/octet-stream을 사용합니다.