파일시스템 리소스 메타데이터
Resource는 데이터셋, 애플리케이션, 폴더와 프로젝트 등 Foundry 파일시스템 리소스의 공통 메타데이터입니다. RID로 조회하거나 경로로 찾은 결과에 같은 구조를 사용합니다. 조회 대상 데이터셋의 행이나 파일 본문을 담는 응답과 구분합니다.
필드
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
rid | string | 필수 | 리소스의 고유 식별자(RID)입니다. | ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da |
displayName | string | 필수 | 리소스의 표시 이름입니다. | My Dataset |
description | string | 선택 | 리소스의 설명입니다. | This dataset contains important data about Empyrean Airlines |
documentation | string | 선택 | 리소스에 연결된 문서 내용입니다. | |
path | string | 필수 | 리소스 이름 자체를 포함한 전체 경로입니다. | /Empyrean Airlines/My Important Project/My Dataset |
type | enum | 필수 | RID에서 도출한 리소스 유형입니다. 리소스 유형 식별자의 값을 사용합니다. | FOUNDRY_DATASET |
createdBy | string | 필수 | 리소스를 만든 사용자입니다. | f05f8da4-b84c-4fca-9c77-8af0b13d11de |
updatedBy | string | 필수 | 리소스를 마지막으로 갱신한 사용자입니다. | f05f8da4-b84c-4fca-9c77-8af0b13d11de |
createdTime | string (date-time) | 필수 | 리소스 생성 시각입니다. | 2024-09-25T17:29:35.974Z |
updatedTime | string (date-time) | 필수 | 마지막 수정 시각입니다. 일반 폴더에는 하위 리소스의 수정도 반영됩니다. 다만 성능상의 이유로 최상위 폴더인 공간과 프로젝트는 하위 리소스 수정만으로 이 시각을 갱신하지 않습니다. | 2024-09-25T17:29:35.974Z |
trashStatus | enum | 필수 | 리소스의 휴지통 상태입니다. 리소스 자체가 휴지통에 있거나 조상이 휴지통에 있어서 영향을 받는 경우를 구분합니다. 허용값: DIRECTLY_TRASHED, ANCESTOR_TRASHED, NOT_TRASHED. | NOT_TRASHED |
parentFolderRid | string | 필수 | 상위 폴더의 RID입니다. 프로젝트라면 상위 공간 RID가 들어갑니다. | ri.compass.main.folder.4cae7c13-b59f-48f6-9ef2-dbde603e4e33 |
projectRid | string | 필수 | 리소스가 속한 프로젝트 RID입니다. 리소스 자체가 프로젝트이면 자신의 프로젝트 RID를 사용합니다. | ri.compass.main.folder.4cae7c13-b59f-48f6-9ef2-dbde603e4e33 |
spaceRid | string | 필수 | 리소스가 속한 공간의 RID입니다. | ri.compass.main.folder.a86ad5f5-3db5-48e4-9fdd-00aa3e5731ca |
경로와 소속
path에는 리소스 이름까지 포함한 전체 경로가 들어갑니다. parentFolderRid는 바로 위의 폴더이고, 프로젝트 자체라면 공간 RID입니다. projectRid는 프로젝트 자신을 조회할 때도 자신의 RID로 채워집니다.
리소스 조회 API에서는 루트 폴더와 공간을 지원하지 않습니다. 일반 폴더와 프로젝트를 이 두 대상과 구분합니다.
수정 시각과 휴지통 상태
일반 폴더의 updatedTime에는 하위 리소스의 수정이 반영되지만 공간과 프로젝트는 성능상의 이유로 자식 수정만으로 갱신하지 않습니다. 프로젝트의 수정 시각만 비교하여 모든 하위 변경을 추적하지 않습니다.
trashStatus | 상태 |
|---|---|
DIRECTLY_TRASHED | 리소스 자체를 휴지통으로 옮긴 상태 |
ANCESTOR_TRASHED | 조상이 휴지통에 있어서 영향을 받는 상태 |
NOT_TRASHED | 휴지통 상태가 아님 |
휴지통 이동, 복원, 영구 삭제는 별도 작업입니다. 특히 영구 삭제는 직접 휴지통에 옮겨진 리소스를 대상으로 합니다.
리소스 유형 식별자
Resource.type은 RID에서 도출하며 다음 식별자를 사용합니다.
AIP_PROFILEAIP_AGENTS_AGENTAIP_AGENTS_SESSIONAIP_ASSIST_FLOW_CAPTUREAIP_ASSIST_WALKTHROUGHARTIFACTS_REPOSITORYBELLASO_CIPHER_CHANNELBELLASO_CIPHER_LICENSEBLACKSMITH_DOCUMENTBLOBSTER_ARCHIVEBLOBSTER_AUDIOBLOBSTER_BLOBBLOBSTER_CODEBLOBSTER_CONFIGURATIONBLOBSTER_DOCUMENTBLOBSTER_IMAGEBLOBSTER_JUPYTERNOTEBOOKBLOBSTER_PDFBLOBSTER_PRESENTATIONBLOBSTER_SPREADSHEETBLOBSTER_VIDEOBLOBSTER_XMLCARBON_WORKSPACECOMPASS_FOLDERCOMPASS_WEB_LINKCONTOUR_ANALYSISDATA_HEALTH_MONITORING_VIEWDECISIONS_EXPLORATIONDREDDIE_PIPELINEEDDIE_LOGICEDDIE_PIPELINEFFORMS_FORMFLOW_WORKFLOWFOUNDRY_DATASETFOUNDRY_DEPLOYED_APPFOUNDRY_ACADEMY_TUTORIALFOUNDRY_CONTAINER_SERVICE_CONTAINERFOUNDRY_ML_OBJECTIVEFOUNDRY_TEMPLATES_TEMPLATEFUSION_DOCUMENTGEOTIME_CATALOG_INTEGRATIONGPS_VIEWHUBBLE_EXPLORATION_LAYOUTHYPERAUTO_INTEGRATIONLOGIC_FLOWS_CONNECTED_FLOWMACHINERY_DOCUMENTMAGRITTE_AGENTMAGRITTE_DRIVERMAGRITTE_EXPORTMAGRITTE_SOURCEMARKETPLACE_BLOCK_SET_INSTALLATIONMARKETPLACE_BLOCK_SET_REPOMARKETPLACE_LOCALMARKETPLACE_REMOTE_STOREMIO_MEDIA_SETMODELS_MODELMODELS_MODEL_VERSIONMONOCLE_GRAPHNOTEPAD_NOTEPADNOTEPAD_NOTEPAD_TEMPLATEOBJECT_SENTINEL_MONITOROBJECT_SET_VERSIONED_OBJECT_SETOPUS_GRAPHOPUS_GRAPH_TEMPLATEOPUS_MAPOPUS_MAP_LAYEROPUS_MAP_TEMPLATEOPUS_SEARCH_AROUNDQUIVER_ANALYSISQUIVER_ARTIFACTQUIVER_DASHBOARDQUIVER_FUNCTIONQUIVER_OBJECT_SET_PATHREPORT_REPORTSLATE_DOCUMENTSOLUTION_DESIGN_DIAGRAMSTEMMA_REPOSITORYTABLES_TABLETAURUS_WORKFLOWTHIRD_PARTY_APPLICATIONS_APPLICATIONTIME_SERIES_CATALOG_SYNCVECTOR_TEMPLATEVECTOR_WORKBOOKWORKSHOP_MODULEWORKSHOP_STATE
메타데이터 예시
가상 항공사 데이터셋의 메타데이터입니다.
{
"projectRid": "ri.compass.main.folder.4cae7c13-b59f-48f6-9ef2-dbde603e4e33",
"updatedTime": "2024-09-25T17:29:35.974Z",
"updatedBy": "f05f8da4-b84c-4fca-9c77-8af0b13d11de",
"displayName": "My Dataset",
"description": "This dataset contains important data about Empyrean Airlines",
"rid": "ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da",
"type": "FOUNDRY_DATASET",
"spaceRid": "ri.compass.main.folder.a86ad5f5-3db5-48e4-9fdd-00aa3e5731ca",
"trashStatus": "NOT_TRASHED",
"parentFolderRid": "ri.compass.main.folder.4cae7c13-b59f-48f6-9ef2-dbde603e4e33",
"path": "/Empyrean Airlines/My Important Project/My Dataset",
"createdBy": "f05f8da4-b84c-4fca-9c77-8af0b13d11de",
"createdTime": "2024-09-25T17:29:35.974Z"
}