미디어 집합 API (V2)
MediaSet은 Foundry의 미디어 데이터를 나타내는 리소스입니다. 항목의 RID, 미디어 집합 뷰와 브랜치, 경로를 구분하여 조회하고 트랜잭션 정책에 맞게 변경합니다. 플랫폼에서 사용하는 방식은 미디어 집합에 있습니다.
집합, 뷰와 항목
| 식별 정보 | 의미 |
|---|---|
mediaSetRid | 미디어 집합 |
mediaSetViewRid 또는 조회의 viewRid | 독립적인 항목 모음을 나타내는 뷰 |
mediaItemRid | 개별 미디어 항목 |
| 항목 경로 | 집합 안에서 사용자가 정하는 식별 문자열 |
Get Media Set에서 mediaSchema, defaultBranchName, transactionPolicy, pathsRequired를 확인합니다. 집합의 스키마 종류와 개별 항목의 MIME 유형은 다릅니다. 예를 들어 집합 스키마가 IMAGERY이고 항목이 image/png일 수 있습니다.
항목 경로는 256자 미만입니다. 같은 경로에 여러 항목을 쓰면 경로 조회는 마지막으로 쓴 항목의 RID를 반환합니다. 브랜치 이름도 256자 미만의 비어 있지 않은 문자열이어야 하며 유효한 RID 형식이어서는 안 됩니다.
트랜잭션 정책
| 정책 | 쓰기 동작 |
|---|---|
batchTransactions | 모든 쓰기가 브랜치 범위의 트랜잭션에 포함되어야 하며 커밋 전에는 보이지 않음 |
noTransactions | 쓰기가 즉시 보이며 트랜잭션 생성 또는 커밋 호출은 오류 |
트랜잭션을 사용하는 집합에서는 생성 요청의 UUID 문자열을 받아 이후 쓰기에 전달합니다. 완료한 쓰기를 공개하려면 커밋하고, 열려 있는 트랜잭션을 폐기하려면 중단합니다. 중단하면 그 트랜잭션 동안 업로드한 항목이 삭제됩니다.
생성 API의 브랜치 기본값은 대부분의 플랫폼 인스턴스에서 master입니다. 실제 집합의 기본 브랜치를 확인하여 사용할 브랜치를 정합니다.
정보와 내용 조회
- 기본 정보는 뷰, 경로, 논리 시각, 생성 정보와 파일 크기를 반환합니다.
- 상세 메타데이터는 10가지 항목 유형의 필드를 반환합니다.
- 미디어 참조는 MIME 유형과 집합, 뷰 및 항목 식별자를 담습니다.
- 현재 콘텐츠와 업로드한 원본은 바이너리 다운로드로 구분합니다.
읽기 토큰은 특정 미디어 항목에 대한 접근을 부여하는 자격 증명입니다. 반환한 MediaReference에 토큰이 있으면 보호하여 취급하고, 사용하는 작업의 선택 헤더 이름과 권한 조건을 따릅니다.
크기는 sizeBytesLong을 사용합니다. 기존 sizeBytes는 일반 정보 조회에서 2GiB 이상일 때 생략되지만 상세 메타데이터에서는 2,147,483,647로 포화됩니다. 논리 시각도 순서 보정이 포함될 수 있으므로 정확한 생성 시각과 동일하게 취급하지 않습니다.