Este artigo é uma plataforma para notificações sobre alterações potencialmente incompatíveis e anúncios de fim de vida (EoL) para o esquema Cato GraphQL API e contém informações que podem exigir que você atualize o cliente da API.
Os termos da API usados neste artigo são explicados em O que é a API Cato.
Para qualquer cliente que use a API Cato, recomendamos que você clique em Seguir para receber automaticamente notificações por e-mail sobre atualizações deste artigo sobre alterações na API. Você também pode ver mais informações sobre novas e atualizadas APIs no Registro de Mudanças da API Cato.
Para mais informações sobre as APIs, veja a Referência da API GraphQL da Cato Networks.
Atualmente, o gateway da API da Cato pode retornar campos de ID como String ou Long (inteiro). Como parte de uma próxima atualização de infraestrutura, todos os campos de ID serão consistentemente retornados como Strings.
-
O que está mudando: As respostas da API que anteriormente retornavam campos de ID como valores numéricos Long (por exemplo,
1000000002) agora sempre os retornam como Strings (por exemplo,"1000000002"). - Quem é afetado: Clientes de API que manipulam campos de ID estritamente como tipos Long/inteiro podem apresentar falhas quando essa mudança for implementada.
- O que você deve fazer antes de 21 de junho de 2026: Atualize o código do seu cliente de API para aceitar tanto Longs quanto Strings para os campos de ID. Isso garantirá uma transição suave e evitará interrupções quando a alteração entrar em vigor.
Em 10 de agosto de 2025, o campo email nas APIs addAdmin e updateAdmin tornou-se opcional (pode ser nulo). Essa alteração suporta infraestrutura futura para controle de acesso granular à API que inclui scripts e automações usando principais de serviço.
- Administradores humanos CMA atuais e futuros devem sempre incluir um valor
email - Consultas que retornam apenas administradores humanos não são afetadas.
- Alguns clientes podem precisar lidar com valores nulos em payloads de resposta, como addAdminPayload
Isso não é tipicamente uma alteração incompatível, mas pode impactar clientes que assumem que o email sempre está presente. Revise sua integração para evitar problemas.
A API eventsFeed usa um marcador para permitir puxar iterativamente o feed de eventos. O campo Marker mostra um identificador que indica o início de uma nova iteração para buscar eventos. A API lê eventos da fila com base no campo Marker único, e fornece a próxima localização do marcador na resposta. Se não houver novos eventos na fila, então o campo Marker fica vazio
Um modelo alternativo de consumo de eventos é usar a integração direta sem código, veja Integração de Eventos Cato com AWS S3 e Integração de Eventos Cato com Conta de Armazenamento Azure.
O que mudamos?
- Anteriormente, quando o marcador não era especificado, a API retornava o marcador mais antigo disponível. Isso exigia consumir toda a fila de eventos antes de alcançar os eventos mais recentes.
- A partir de 27 de abril de 2025, se nenhum marcador for especificado, a API retorna o marcador mais recente. Isso permite que a API busque diretamente os eventos mais recentes.
É uma alteração incompatível?
- Não há impacto para a maioria dos casos de uso da API eventsFeed. Não há mudança quando o campo Marker é usado para uma consulta, e a lógica de consumo de eventos permanece a mesma.
-
Se você tiver uma lógica dedicada para consumir a fila até alcançar os eventos recentes, essa lógica não é mais necessária.
- Agora, se nenhum marcador de entrada for especificado, a API fornece o marcador mais recente. Chamar a API com este marcador busca os eventos mais recentes
- A resposta da API contém um marcador que aponta para a localização mais recente (topo da fila)
- Os scripts correspondentes e os processos automatizados devem ser atualizados
Alteramos a funcionalidade do campo limit para que limit=0 não seja mais suportado, já que isso não é considerado uma boa prática. Para garantir a continuidade do funcionamento suave, você precisa atualizar quaisquer scripts ou consultas que dependam desse parâmetro. Em vez disso, você pode definir um limite entre 1-2000, que é totalmente suportado pela API.
Se você precisar recuperar todas as histórias, recomendamos usar uma abordagem de paginação.
Os seguintes campos e tipos na API LastMileBWInput estão atualmente marcados como Obsoletos e atingiram o fim de vida (EoL) em 30 de junho de 2025.
Por favor, use os campos e tipos recomendados.
| Tipo Obsoleto | Tipo Recomendado |
|---|---|
| downstream | downstreamMbpsPrecision |
| upstream | upstreamMbpsPrecision |
Os seguintes campos e tipos na API InterfaceInfo estão atualmente marcados como Obsoletos e atingiram o fim de vida (EoL) em 30 de junho de 2025.
Por favor, use os campos e tipos recomendados.
| Tipo Obsoleto | Tipo Recomendado |
|---|---|
| downstreamBandwidth | downstreamBandwidthMbpsPrecision |
| upstreamBandwidth | upstreamBandwidthMbpsPrecision |
Os seguintes campos e tipos na API SocketInterfaceBandwidthInput estão atualmente marcados como Obsoletos e atingiram o fim de vida (EoL) em 30 de junho de 2025.
Por favor, use os campos e tipos recomendados.
| Tipo Obsoleto | Tipo Recomendado |
|---|---|
| downstreamBandwidth | downstreamBandwidthMbpsPrecision |
| upstreamBandwidth | upstreamBandwidthMbpsPrecision |
- A API de consulta
auditFeedaceita uma lista de filtros usando o tipoAuditFieldFilterInput. Cada filtro inclui umfieldNamedefinido pelo tipoFieldNameInput, que atualmente inclui dois campos de entrada:AuditFieldNameeEventFieldName. - No entanto, apenas
AuditFieldNameé um campo de entrada válido e suportado. Para melhorar a clareza do esquema e evitar confusões, o campoEventFieldNamefoi removido do esquema em 8 de junho de 2025. - Atualize todos os scripts e consultas que usam filtros
auditFeedpara usar apenas o campo de entradaAuditFieldName.
Os seguintes campos e tipos na API EventFieldName estão atualmente marcados como Obsoletos e atingiram o fim de vida (EoL) em 1 de maio de 2025.
Por favor, use os campos e tipos recomendados.
| Tipo Obsoleto | Tipo Recomendado |
|---|---|
| aplicação | application_id/application_name |
| categorias_personalizadas | custom_category_id/custom_category_name |
| categoria_personalizada | custom_category_id/custom_category_name |
| dest_site | dest_site_id/dest_site_name |
| device_posture_profiles | device_posture_profile |
| internalId | event_id |
| rule | rule_name |
| src_site | src_site_id/src_site_name |
Os campos e tipos seguintes na API EventFieldName foram marcados como Obsoletos e estão no fim de vida (EoL) a partir de 1 de março de 2025.
Por favor, use os campos e tipos recomendados em vez disso.
| Tipo Obsoleto | Tipo Recomendado |
|---|---|
| parent_pid | src_process_parent_pid |
| pid | src_pid |
| process_path | src_process_path |
O campo seguinte na API Beta StoryDrillDownFilter foi marcado como Obsoleto e está no fim de vida (EoL) a partir de 23 de fevereiro de 2025.
Por favor, utilize os campos e tipos recomendados.
| Tipo Obsoleto | Tipo Recomendado |
|---|---|
| Valor | Insira a versão do SO |
Após o anúncio de EoL para alguns valores de SubType usados nas APIs de consumo de eventos relacionados aos Clientes Cato, a implementação está pausada para contas que usam a localização CMA Irlanda (cc.catonetworks.com) para os seguintes campos:
| Tipo Obsoleto | Tipo Recomendado |
|---|---|
| Reconectado | Conectado ou Desconectado |
| Alteração de PoP |
Conectado ou Desconectado (O nome do PoP é retornado no campo lastPopName.) |
- Para mais informações, consulte CMA - Diretrizes Técnicas
Os seguintes campos e tipos relacionados ao Cliente Cato foram marcados como Obsoletos e estão em fim de vida (EoL) a partir de 2 de janeiro de 2025.
Por favor, utilize os campos e tipos recomendados.
| Tipo Obsoleto | Tipo Recomendado | Notas |
|---|---|---|
| VPN Nunca Desligado-Bypass | Sempre Ativo Bypass | O valor SubTipo VPN Nunca Desligado-Bypass está sendo substituído pelo valor Sempre Ativo Bypass |
| Reconectado | Conectado ou Desconectado | Para aumentar a granularidade, o valor SubTipo Reconectado está sendo dividido em 2 novos valores, Conectado e Desconectado |
| Alteração de PoP |
Conectado ou Desconectado (O nome do PoP é retornado no campo lastPopName) |
Para aumentar a granularidade, o valor SubTipo Alteração de PoP está sendo dividido em 2 novos valores, Conectado e Desconectado |
- Para mais informações, veja este artigo: Próximo EoL para Alguns SubTypes dos Dados de Eventos Cato
0 comentário
Por favor, entre para comentar.