체크포인트 기록 검색 필터
Search Records의 where.filter에는 SearchCheckpointRecordsFilter를 전달합니다. type이 필터 종류를 구분하며, and, or, not으로 조건을 재귀적으로 결합할 수 있습니다.
eq는 문자열 값의 일치를, textSearch는 통과 근거의 텍스트 검색을 표현합니다. 생성 시각은 gte와 lt로 각각 시작 시각 이상, 종료 시각 미만을 지정할 수 있습니다. textSearch.matchType은 EXACT 또는 CONTAINS이며 대소문자 처리나 별도 정규식 문법을 추가로 가정하지 않습니다.
분기 not
하위 필터를 논리 부정하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: not. | not |
filter | SearchCheckpointRecordsFilter | 필수 | 체크포인트 기록을 선택하는 필터입니다. | 본문 예시 참조 |
filter의 구조
동일한 필터 정의를 하위 조건으로 사용합니다.
분기 or
하위 필터를 OR로 결합하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: or. | or |
filters | list<SearchCheckpointRecordsFilter> | 선택 |
filters의 구조
배열의 각 항목에 SearchCheckpointRecordsFilter를 넣어 하위 조건을 구성합니다.
분기 textSearch
통과 근거의 텍스트 필드를 검색하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: textSearch. | textSearch |
field | enum | 필수 | 텍스트 검색을 지원하는 필드입니다. 허용값: justificationResponse, justificationSelectedOption, justificationAdditionalResponse. | justificationResponse |
query | string | 필수 | ||
matchType | enum | 필수 | 자유 형식으로 입력한 통과 근거를 일치시킬 방식을 정합니다. 허용값: EXACT, CONTAINS. | EXACT |
분기 and
하위 필터를 AND로 결합하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: and. | and |
filters | list<SearchCheckpointRecordsFilter> | 선택 |
filters의 구조
배열의 각 항목에 SearchCheckpointRecordsFilter를 넣어 하위 조건을 구성합니다.
분기 lt
지정한 값 미만을 선택하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: lt. | lt |
field | enum | 필수 | 미만 비교를 지원하는 필드입니다. 허용값: createdAt. | createdAt |
value | string (date-time) | 필수 |
분기 gte
지정한 값 이상을 선택하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: gte. | gte |
field | enum | 필수 | 이상 비교를 지원하는 필드입니다. 허용값: createdAt. | createdAt |
value | string (date-time) | 필수 |
분기 eq
필드값이 정확히 일치하는 기록을 선택하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: eq. | eq |
field | enum | 필수 | 동등 비교를 지원하는 필드입니다. 허용값: recordRid, configRid, checkpointType, actingUserId, delegateUserId, organizationRid, namespaceRid, interactionRid, checkpointedItemType. | checkpointType |
value | string | 필수 |
분기 checkpointedItemId
체크포인트 대상의 식별자와 일치하는 기록을 선택하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedItemId. | checkpointedItemId |
checkpointedItemId | CheckpointedItemId | 필수 | 체크포인트 대상의 식별자입니다. 분기로 대상 종류를 명시하여 RID와 일반 문자열 ID를 구분합니다. | 본문 예시 참조 |
checkpointedItemId의 구조
분기 checkpointedJobRid
기록한 작업의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedJobRid. | checkpointedJobRid |
rid | string | 필수 |
분기 checkpointedMarkingId
기록한 보안 표지의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedMarkingId. | checkpointedMarkingId |
id | string | 필수 |
분기 checkpointedTokenId
기록한 토큰의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedTokenId. | checkpointedTokenId |
id | string | 필수 |
분기 checkpointedGroupId
기록한 그룹의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedGroupId. | checkpointedGroupId |
id | string | 필수 |
분기 checkpointedObjectSetVersionedRid
기록한 버전 객체 집합의 RID입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedObjectSetVersionedRid. | checkpointedObjectSetVersionedRid |
rid | string | 필수 |
분기 checkpointedObjectSetTypesProxyRids
유형 프록시 객체 집합의 객체 유형 RID 목록입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedObjectSetTypesProxyRids. | checkpointedObjectSetTypesProxyRids |
rids | list<rid> | 선택 |
분기 checkpointedResourceRid
기록한 리소스의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedResourceRid. | checkpointedResourceRid |
rid | string | 필수 |
분기 checkpointedPeeringJobId
기록한 피어링 작업의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedPeeringJobId. | checkpointedPeeringJobId |
id | string | 필수 | ||
relationshipRid | string | 필수 | 피어링 관계의 리소스 식별자입니다. |
분기 checkpointedIssueRid
기록한 이슈의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedIssueRid. | checkpointedIssueRid |
rid | string | 필수 |
분기 checkpointedInterventionRid
기록한 Intervention의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedInterventionRid. | checkpointedInterventionRid |
rid | string | 필수 |
분기 checkpointedJobSpecRid
기록한 작업 명세의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedJobSpecRid. | checkpointedJobSpecRid |
rid | string | 필수 |
분기 checkpointedActionTypeRid
기록한 액션 유형의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedActionTypeRid. | checkpointedActionTypeRid |
rid | string | 필수 |
분기 checkpointedScheduleRid
기록한 일정의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedScheduleRid. | checkpointedScheduleRid |
rid | string | 필수 |
분기 checkpointedRoleId
기록한 역할의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedRoleId. | checkpointedRoleId |
id | string | 필수 |
분기 checkpointedUserIntakeFormInputId
기록한 사용자 접수 양식 입력의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedUserIntakeFormInputId. | checkpointedUserIntakeFormInputId |
id | string | 필수 |
분기 checkpointedMarketplaceProductId
기록한 Marketplace 상품의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedMarketplaceProductId. | checkpointedMarketplaceProductId |
id | string | 필수 |
분기 checkpointedLanguageModelRid
기록한 언어 모델의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedLanguageModelRid. | checkpointedLanguageModelRid |
rid | string | 필수 |
분기 checkpointedPrincipalId
기록한 주체의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedPrincipalId. | checkpointedPrincipalId |
id | string | 필수 |
분기 checkpointedLanguageModelSessionRid
기록한 언어 모델 세션의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedLanguageModelSessionRid. | checkpointedLanguageModelSessionRid |
rid | string | 필수 |
분기 checkpointedUserIntakeSubmissionRid
기록한 사용자 접수 양식 제출의 식별자입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 분기를 구분하는 type 값입니다. 허용값: checkpointedUserIntakeSubmissionRid. | checkpointedUserIntakeSubmissionRid |
rid | string | 필수 |
대상 식별자와 스냅샷의 차이
checkpointedItemId 필터에는 대상을 식별하는 20가지 분기 중 하나를 넣습니다. 이는 응답의 19가지 대상 스냅샷과 구조가 다릅니다. 버전 객체 집합과 유형 프록시 객체 집합은 검색 식별자에서 각각 별도 분기를 사용합니다. 대상 종류에 맞는 rid, id, rids를 선택하며, 피어링 작업은 작업 ID와 relationshipRid가 모두 필요합니다.
생성 시각 범위 예시
다음은 가상 조회 조건입니다. Contour 내보내기 기록 중 UTC 기준 2024년 1월 1일 이상, 2월 1일 미만에 생성한 기록을 선택합니다.
{
"type": "and",
"filters": [
{"type": "eq", "field": "checkpointType", "value": "CONTOUR_EXPORT"},
{"type": "gte", "field": "createdAt", "value": "2024-01-01T00:00:00Z"},
{"type": "lt", "field": "createdAt", "value": "2024-02-01T00:00:00Z"}
]
}
특정 리소스의 기록 예시
필터 바깥의 type과 안쪽 식별자의 type을 모두 지정합니다. 다음 RID는 가상 데이터셋의 예시값입니다.
{
"type": "checkpointedItemId",
"checkpointedItemId": {
"type": "checkpointedResourceRid",
"rid": "ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da"
}
}