Foundry 파일시스템 API (V2)

Filesystem API는 Foundry의 리소스와 폴더, 프로젝트 및 공간(Space)을 다룹니다. 운영체제의 로컬 파일시스템 경로가 아니라 Foundry 리소스의 RID와 절대 경로를 사용합니다.

리소스 조회와 상태 관리

Resource API는 RID 또는 경로 조회, 휴지통 이동과 복원, 영구 삭제 및 보안 표지 관리를 제공합니다. 공통 메타데이터에는 리소스 유형, 소속, 수정 시각과 휴지통 상태가 있습니다.

리소스의 역할 권한과 조직 및 표지의 자격 조건을 함께 고려합니다. API로 상태를 바꾸기 전에 대상 RID와 작업별 권한 조건을 확인합니다.

리소스 역할 부여

ResourceRole API는 사용자, 그룹 또는 플랫폼 사용자 전체를 리소스 역할과 연결합니다. ID가 있는 주체는 조회 응답에서 principalWithId, 추가 및 제거 요청에서 principalIdOnly로 표현합니다. 상속된 역할 포함 여부와 대상 공간의 프로젝트 역할 집합에 등록된 ID를 확인하여 조회하거나 변경합니다.

폴더 생성과 탐색

Folder API는 프로젝트 안의 일반 폴더를 만들고 폴더 메타데이터 및 자식 리소스를 조회합니다. Folder.type은 FOLDER, PROJECT, SPACE를 구분하므로 Resource의 유형 enum과 혼동하지 않습니다. 폴더 배치 조회는 최대 1,000개이며 자식 조회의 페이지 기본값과 상한은 2,000개입니다.

프로젝트 생성과 접근 경계

Project API는 일반 생성과 템플릿 생성, 메타데이터 조회 및 조직 요구조건 관리를 제공합니다. 일반 생성의 OAuth 애플리케이션 제약, 소유자에 준하는 역할 조건과 템플릿의 고정값 및 제안값 규칙을 구분합니다. 프로젝트의 조직은 상위 공간에도 적용되어 있어야 합니다.

프로젝트 간 참조

ProjectResourceReference API는 다른 프로젝트의 파일시스템 리소스와 파일시스템 밖의 Spark 프로필 및 LLM 모델 같은 리소스를 참조합니다. 조회, 추가와 제거는 서로 다른 입력 및 출력 구조를 사용하며 참조가 원본 접근 권한을 대신 부여하지 않습니다.

공간 설정 조회

Space API는 프로젝트의 상위 컨테이너와 조직, 파일시스템, 사용량 계정 및 기본 역할 집합 정보를 조회합니다. 접근 허용 조직과 Last Out 삭제 정책의 대상 조직을 구분합니다.