Operações de blacklist
Operações de blacklist
Esta página é uma tradução automática da página em inglês, que prevalece. Machine-translated from the English page, which is authoritative.
Os campos exatos que cada operação blacklist.* recebe e retorna.
Toda op é POST /v1/<op> via HTTP e a ferramenta MCP loom_<op>. Os campos de identidade (org, namespace, agent, user_id, session_id) são preenchidos a partir do token e da sessão MCP quando o transporte consegue; em uma chamada HTTP sem token em um servidor de usuário único, é usada a org da instalação em toda op, exceto code.* e tracker.* (que mantêm a do seu plano), e em algumas ops também o namespace e o agente; veja identidades e namespaces. O índice de operações explica role, kind e a listagem all do MCP. Campos de entrada desconhecidos são atendidos e listados em ignored_args.
blacklist.add
Recusa futuras gravações de memória cujo valor corresponda a um padrão.
POST /v1/blacklist.add · MCP loom_blacklist_add · role writer · idempotente · auditada
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
pattern |
str |
obrigatório | O texto a recusar, comparado com diferenciação de maiúsculas e minúsculas ao valor armazenado: como substring ou como regex de no máximo 256 caracteres. |
pattern_type |
Literal['substring', 'regex'] |
'substring' |
substring (texto simples) ou regex (RE2, nas gravações e na varredura; limitado na adição). |
scope |
Literal['namespace', 'org', 'global'] |
'namespace' |
Alcance: namespace (apenas este), org (todos os namespaces; exige admin da org) ou global (todos os tenants; exige admin da plataforma). |
reason |
str |
'' |
Por que o padrão existe; é armazenado e listado. |
created_by |
str |
'' |
Autor registrado apenas quando a chamada não tem um principal autenticado para carimbar. |
sweep |
bool |
False |
Também marca como removidas (tombstone) as linhas ativas que o padrão já corresponde: dentro desta org e, para um padrão com escopo de namespace, dentro do namespace. |
| Campo de saída | Tipo | Significado |
|---|---|---|
pattern_id |
str |
O id do novo padrão, para blacklist.sweep e blacklist.remove. |
created_at |
datetime |
Quando o padrão foi armazenado (UTC). |
swept |
int |
Linhas que a varredura marcou como removidas; 0 sem sweep. |
swept_truncated |
bool |
Verdadeiro quando mais linhas corresponderam do que uma varredura comporta; chame blacklist.sweep. |
sweep_error |
str |
“” quando a varredura terminou; caso contrário, o motivo (o padrão é armazenado de qualquer forma): <code>: <message> (execute de novo com blacklist.sweep), o motivo do RE2 quando uma regex não pode ser executada (nenhuma consulta rodou) ou o tipo de erro com que a consulta de correspondência falhou. |
blacklist.list
Lista os padrões que impedem o armazenamento de memória.
POST /v1/blacklist.list · MCP loom_blacklist_list · role viewer · leitura · não listada no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
scope |
Literal['namespace', 'org', 'global'] | None |
None |
scope=None retorna todos os padrões que se aplicam a este (org, namespace), incluindo os de escopo mais alto (da org inteira, globais): o conjunto de regras efetivo, não apenas os fixados literalmente neste escopo. |
limit |
int |
100 |
No máximo esta quantidade de padrões, de 1 a 1000, do mais novo para o mais antigo. |
| Campo de saída | Tipo | Significado |
|---|---|---|
rows |
list[_BlacklistRow] |
Os padrões ativos que correspondem ao filtro de escopo, do mais novo para o mais antigo. |
blacklist.remove
Remove um padrão de blacklist adicionado anteriormente.
POST /v1/blacklist.remove · MCP loom_blacklist_remove · role admin · idempotente · auditada · não listada no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
pattern_id |
str |
obrigatório | O padrão a marcar como removido; um padrão de namespace fora do alcance do chamador responde removed=false. |
removed_by |
str |
'' |
Registrado apenas no marcador de versão do cache da blacklist, não na linha do padrão. |
reason |
str |
'' |
Aceito, mas não armazenado. |
| Campo de saída | Tipo | Significado |
|---|---|---|
removed |
bool |
Falso quando nenhum padrão ativo com esse id está visível para o chamador. |
removed_at |
datetime | None |
Quando o padrão foi marcado como removido (UTC); nulo quando nada foi removido. |
blacklist.sweep
Marca como removidas as linhas ativas que um padrão existente corresponde.
POST /v1/blacklist.sweep · MCP loom_blacklist_sweep · role writer · idempotente · auditada · não listada no toolset all do MCP
| Campo de entrada | Tipo | Padrão | Significado |
|---|---|---|---|
org |
str |
obrigatório | O tenant (primeiro elemento da tupla de identidade). |
namespace |
str |
obrigatório | O namespace que a op lê ou grava. |
pattern_id |
str |
obrigatório | O padrão ativo com o qual varrer; um id desconhecido ou fora do alcance do chamador responde 404. |
| Campo de saída | Tipo | Significado |
|---|---|---|
pattern_id |
str |
O padrão usado na varredura, repetido. |
matched |
int |
Linhas ativas que o padrão correspondeu nesta chamada: no máximo 5,000 no ClickHouse, mais, sob a autoridade Postgres, as cabeças estacionadas que esta chamada marcou como removidas. |
tombstoned |
int |
Linhas que esta chamada marcou como removidas. |
truncated |
bool |
Verdadeiro quando mais linhas corresponderam do que uma chamada comporta; chame de novo. |
error |
str |
“” quando a varredura terminou; caso contrário, <code>: <message> depois que linhas podem ter sido gravadas (chame de novo), o motivo do RE2 quando uma regex não pode ser executada (nenhuma consulta rodou) ou o tipo de erro com que a consulta de correspondência falhou; uma falha anterior a isso é da chamada. |