프로젝트의 리소스 참조 API (V2)
참조는 현재 프로젝트 밖의 리소스를 프로젝트에서 사용할 수 있도록 포함하는 관계입니다. 원본 리소스를 복사하거나 그 원본에 대한 접근 권한을 대신 부여하는 작업은 아닙니다. 프로젝트 간 사용과 권한의 관계는 프로젝트와 역할을 따릅니다.
List Project Resource References로 조회하고, Add Project Resource References와 Remove Project Resource References로 변경합니다.
두 참조 유형
응답 및 추가 입력의 type | 대상 | 추가할 때 필요한 값 |
|---|---|---|
filesystem | 다른 프로젝트 안의 파일시스템 리소스 | resourceRid |
external | Spark 프로필이나 LLM 모델처럼 Foundry 파일시스템 밖에 있는 리소스 | resourceRid, importName |
여기서 external은 파일시스템 밖이라는 뜻입니다. 인터넷 URL이나 Data Connection의 외부 시스템 주소를 넣는 필드가 아니며 리소스 RID를 사용합니다. importName은 프로젝트에서 참조를 식별하는 사용자 지정 레이블입니다.
조회와 변경의 형태
조회 응답의 각 ProjectResourceReference 항목에는 reference가 있습니다. 그 안의 type이 두 유형을 구분하며 resourceRid, name, importedAt, importedBy가 모두 필요합니다. name은 외부 참조에서 사용자가 지정한 레이블, 파일시스템 참조에서는 원본 리소스의 표시 이름입니다.
추가 요청의 resources는 구분자 객체들의 배열입니다. 조회 응답의 reference 래퍼나 가져온 시각 및 사용자 메타데이터를 그대로 추가 입력으로 사용하지 않습니다.
제거 요청의 resources는 RID 문자열 배열입니다. 파일시스템과 외부 리소스 ID를 함께 지정할 수 있으며 type이나 레이블은 넣지 않습니다. 제거할 참조를 사용하는 프로젝트 작업을 확인합니다.
유형 필터와 권한
목록의 쿼리 매개변수 referenceType은 대문자 EXTERNAL 또는 FILESYSTEM을 사용합니다. 생략하면 모든 유형을 조회합니다. 응답 객체의 소문자 구분자와 혼동하지 않습니다.
조회에는 api:filesystem-read, 추가와 제거에는 api:filesystem-write OAuth 권한 범위를 사용합니다. 다른 프로젝트의 파일시스템 리소스를 참조할 때는 일반적으로 원본 프로젝트의 Viewer와 목적지 프로젝트의 Editor가 필요합니다. 원본의 조직 및 보안 표지 요구조건도 계속 적용됩니다.