프로젝트의 상위 공간 API (V2)
공간(Space)은 공통 목적과 온톨로지를 사용하는 프로젝트를 묶는 상위 컨테이너이며 여러 조직이 공유할 수 있습니다. List Spaces로 공간의 RID, 경로와 조직, 파일시스템 및 사용량 계정 정보를 조회합니다.
설정 식별자 구분
| 필드 | 용도 |
|---|---|
rid | 공간 자체의 RID |
fileSystemId | 공간 콘텐츠를 저장하는 파일시스템 ID |
usageAccountRid | 공간 내 프로젝트의 사용량이 기본적으로 귀속되는 사용량 계정 RID |
defaultRoleSetId | 프로젝트에서 사용할 역할들을 정의하는 역할 집합 ID |
spaceMavenIdentifier | 이 공간에서 게시하는 리소스의 Maven 좌표 접두사 |
defaultRoleSetId는 개별 역할 ID가 아닙니다. 프로젝트 생성의 defaultRoles와 roleGrants에는 해당 역할 집합에서 사용할 실제 역할 ID를 지정합니다.
파일시스템, 사용량 계정과 역할 집합을 설정할 때 값을 지정하지 않으면 각각 플랫폼 인스턴스의 기본값 또는 프로젝트용 기본 역할 집합을 사용합니다. 조회 응답에서는 이 세 필드가 필수입니다. spaceMavenIdentifier는 Control Panel의 공간 설정에 구성했을 때만 제공됩니다.
접근 조직과 삭제 정책 조직
organizations는 공간에 접근할 조직 목록이며 사용자에게는 이 중 적어도 하나의 구성원 자격이 필요합니다. 프로젝트의 조직 요구조건도 상위 공간과의 관계를 지켜야 합니다.
deletionPolicyOrganizations는 삭제 정책의 대상 조직입니다. 기본 Last Out 정책에서는 이 목록의 마지막 조직이 삭제될 때 공간과 그 프로젝트들도 삭제됩니다. 사용자 한 명의 탈퇴나 프로젝트의 조직 요구조건 제거를 조직 자체의 삭제와 같은 사건으로 처리하지 않습니다. 이 목록에는 공간과 같은 플랫폼 인스턴스에 속한 조직만 포함할 수 있습니다.
페이지 처리
페이지의 항목 수는 요청한 pageSize보다 작거나 클 수 있습니다. 더 많은 결과가 있으면 nextPageToken이 제공되므로 이 토큰으로 이어서 조회합니다. 토큰이 없으면 마지막 페이지입니다. 폴더 자식 조회의 2,000개 기본값을 공간 목록에 그대로 적용하지 않습니다.