콘텐츠로 이동

번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.

blacklist 연산

각 blacklist.* 연산이 받고 반환하는 정확한 필드입니다.

모든 op는 HTTP에서는 POST /v1/<op>이고 MCP에서는 loom_<op> 도구입니다. 신원 필드(org, namespace, agent, user_id, session_id)는 전송 방식이 가능하면 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면 code.*와 tracker.*(각자의 플레인을 유지함)를 제외한 모든 op에서 설치본의 org가 사용되며, 일부 op에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 신원과 네임스페이스를 참고하세요. 연산 색인에서 역할, 종류, MCP all 목록을 설명합니다. 알 수 없는 입력 필드는 그대로 처리되며 ignored_args에 이름이 표시됩니다.

blacklist.add

값이 패턴과 일치하는 이후의 메모리 쓰기를 거부합니다.

POST /v1/blacklist.add · MCP loom_blacklist_add · 역할 writer · 멱등 · 감사 대상

입력 필드 타입 기본값 의미
org str 필수 테넌트(신원 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
pattern str 필수 거부할 텍스트. 저장된 값과 대소문자를 구분하여 비교하며, 부분 문자열 또는 256자 이하의 정규식으로 일치 여부를 판단합니다.
pattern_type Literal['substring', 'regex'] 'substring' substring(일반 텍스트) 또는 regex(RE2, 쓰기와 스윕에서 사용하며 추가 시 길이가 제한됨).
scope Literal['namespace', 'org', 'global'] 'namespace' 적용 범위: namespace(이 네임스페이스만), org(모든 네임스페이스, org 관리자 필요), global(모든 테넌트, 플랫폼 관리자 필요).
reason str '' 패턴이 존재하는 이유. 저장되고 목록에 표시됩니다.
created_by str '' 호출에 기록할 인증된 주체가 없을 때만 기록되는 작성자.
sweep bool False 패턴이 이미 일치하는 활성 행도 함께 tombstone 처리합니다. 이 org 안에서 처리하며, 네임스페이스 범위 패턴은 해당 네임스페이스 안에서만 처리합니다.
출력 필드 타입 의미
pattern_id str 새 패턴의 id. blacklist.sweep과 blacklist.remove에서 사용합니다.
created_at datetime 패턴이 저장된 시각(UTC).
swept int 스윕이 tombstone 처리한 행 수. sweep이 없으면 0.
swept_truncated bool 한 번의 스윕이 처리할 수 있는 것보다 많은 행이 일치하면 True. blacklist.sweep을 호출하세요.
sweep_error str 스윕이 끝나면 "", 그렇지 않으면 이유(어느 쪽이든 패턴은 저장됨): <code>: <message>(blacklist.sweep으로 다시 실행), 정규식을 실행할 수 없을 때 RE2가 알려 주는 이유(쿼리는 실행되지 않음), 또는 일치 쿼리가 실패한 오류의 종류.

blacklist.list

메모리 저장을 막는 패턴을 나열합니다.

POST /v1/blacklist.list · MCP loom_blacklist_list · 역할 viewer · 읽기 · MCP all 도구 세트에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(신원 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
scope Literal['namespace', 'org', 'global'] \| None None scope=None이면 이 (org, namespace)에 적용되는 모든 패턴을 반환하며, 더 높은 범위(org 전체, global)의 패턴도 포함합니다. 즉 이 범위에 직접 지정된 패턴만이 아니라 실제로 적용되는 규칙 집합입니다.
limit int 100 최대 이 개수만큼의 패턴을 최신순으로 반환합니다(1-1000).
출력 필드 타입 의미
rows list[_BlacklistRow] 범위 필터와 일치하는 활성 패턴, 최신순.

blacklist.remove

이전에 추가한 blacklist 패턴을 제거합니다.

POST /v1/blacklist.remove · MCP loom_blacklist_remove · 역할 admin · 멱등 · 감사 대상 · MCP all 도구 세트에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(신원 튜플의 첫 번째 요소).
pattern_id str 필수 tombstone 처리할 패턴. 호출자의 권한 범위 밖에 있는 네임스페이스 패턴은 removed=false로 응답합니다.
removed_by str '' 패턴 행이 아닌 blacklist 캐시의 버전 마커에만 기록됩니다.
reason str '' 받아들이지만 저장하지 않습니다.
출력 필드 타입 의미
removed bool 해당 id의 활성 패턴이 호출자에게 보이지 않으면 False.
removed_at datetime \| None 패턴이 tombstone 처리된 시각(UTC). 제거된 것이 없으면 null.

blacklist.sweep

기존 패턴과 일치하는 활성 행을 tombstone 처리합니다.

POST /v1/blacklist.sweep · MCP loom_blacklist_sweep · 역할 writer · 멱등 · 감사 대상 · MCP all 도구 세트에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(신원 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
pattern_id str 필수 스윕에 사용할 활성 패턴. 알 수 없는 id나 호출자의 권한 범위 밖의 id는 404로 응답합니다.
출력 필드 타입 의미
pattern_id str 스윕에 사용한 패턴(그대로 반환).
matched int 이번 호출에서 패턴과 일치한 활성 행: ClickHouse에서는 최대 5,000개이며, Postgres 권한 하에서는 이번 호출이 tombstone 처리한 보류 중인 헤드가 더해집니다.
tombstoned int 이번 호출이 tombstone 처리한 행 수.
truncated bool 한 번의 호출이 처리할 수 있는 것보다 많은 행이 일치하면 True. 다시 호출하세요.
error str 스윕이 끝나면 "", 그렇지 않으면 행이 이미 반영되었을 수 있는 경우 <code>: <message>(다시 호출), 정규식을 실행할 수 없을 때 RE2가 알려 주는 이유(쿼리는 실행되지 않음), 또는 일치 쿼리가 실패한 오류의 종류. 그 이전 단계의 실패는 호출 자체의 실패입니다.