카토 API 잠재적 변경 사항 및 종료 공지

이 기사는 Cato GraphQL API 스키마에 대한 잠재적인 변경 사항 및 종료(End-of-Life, EoL) 공지 알림을 위한 플랫폼이며, API 클라이언트를 업데이트해야 할 수 있는 정보를 포함하고 있습니다.

이 문서에서 사용된 API 라이센스 기간은 무엇 같습니다 Cato API에서 설명되어 있습니다.

Cato API를 사용하는 고객께는 이 기사에 대한 업데이트 메일 알림을 자동으로 수신하기 위해 팔로우를 클릭할 것을 권장합니다. Cato API 변경 기록에서 새로운 그리고 업데이트된 API에 대한 더 많은 정보를 확인할 수 있습니다.

API에 대한 더 많은 정보는 Cato Networks GraphQL API Reference를 참조하십시오.

잠재적으로 접두사 변경됩니다 변경 내역

2026-06-21 - API ID 필드: 유형 변경에서 Long/Integer부터 문자열까지

현재, Cato의 API 게이트웨이는 ID 필드를 문자열 또는 Long(정수)로 반환할 수 있습니다. 다가오는 인프라 업데이트의 일환으로, 모든 ID 필드는 일관되게 문자열로 반환됩니다.

  • 무엇이 변경되는지: 이전에 숫자 Long 값으로 ID 필드를 반환하던 API 응답이 이제 항상 문자열로 반환됩니다 (예: "1000000002").
  • 누가 영향을 받을까요: ID 필드를 엄격하게 Long/정수 유형으로 처리하는 API 고객은 변경이 실시될 때 문제가 발생할 수 있습니다.
  • 2026년 6월 21일 전 필요한 준비사항: ID 필드에 대해 Long 및 문자열 유형을 모두 수용하도록 API 클라이언트 코드를 업데이트하세요. 이렇게 하면 변화가 발생할 때 원활한 전환을 보장하고 혼란을 방지할 수 있습니다.

2025-08-10 - addAdmin 및 updateAdmin API의 이메일 필드 변경

2025년 8월 10일, addAdmin 및 updateAdmin API에서 email 필드는 선택사항(널 가능)이 되었습니다. 이 변경 사항은 서비스 주요 사용을 포함한 스크립트 및 자동화를 통한 세분화된 API 접근 제어를 지원하는 인프라를 지원합니다.

  • 현재와 향후 인간 CMA 관리자 반드시 항상 포함 이메일 값
  • 오직 인간 관리자 반환된 쿼리는 같습니다 영향을 받지 않습니다.
  • 몇몇 클라이언트는 응답 대응 페이로드에서 NULL 값 처리해야 할 수 있습니다, 예를 들어 addAdminPayload

이는 일반적으로 중단을 초래하는 변경 사항이 아니지만, email이 항상 존재한다고 가정하는 클라이언트에 영향을 미칠 수 있습니다. 문제가 발생하지 않도록 통합을 검토하십시오.

2025-04-27 - eventsFeed 쿼리 API가 가장 최근 이벤트 가져오기를 지원합니다.

eventsFeed API는 마커를 사용하여 이벤트 피드를 반복적으로 가져옵니다. 마커 필드는 이벤트를 가져오는 새로운 반복의 시작을 나타내는 식별자를 보여줍니다. API는 고유한 마커 필드를 기반으로 큐에서 이벤트를 읽고 응답에서 다음 마커 위치를 제공합니다. 큐에 새로운 이벤트가 없으면 마커 필드는 비어 있습니다

직접 무코드 통합을 사용하여 이벤트 소모 모델을 대체할 수 있습니다, Cato Events 및 AWS S3 통합 그리고 Cato Events 및 Azure Storage Account 통합 참조하십시오.

무엇이 변경되었습니까? 

  • 이전에 마커가 지정되지 않은 경우, API는 가장 오래된 사용 가능 마커 반환되었습니다. 이 전체 이벤트 큐를 소비해야 최근 이벤트에 도달할 수 있음을 요구합니다.
  • April 27, 2025부터, 마커가 지정되지 않은 경우, API는 가장 최근 마커 반환합니다. 이는 API가 가장 최근 이벤트를 직접 가져올 수 있게 합니다.

이것은 중대한 변화입니까? 

  • 대부분의 사용 사례에서 eventsFeed API에 대한 영향력은 아닙니다. 마커 필드가 쿼리에 사용될 때 변경 없으며, 이벤트 피드 소비 로직은 같은입니다.

  • 최근 이벤트에 도달하기 위해 큐를 소비하는 전용 로직이 있는 경우 이제 더 이상 필요하지 않습니다.

    • 현재 입력 마커가 지정되지 않은 경우, API는 가장 최근 마커 제공합니다. 이 마커로 API 호출하면 가장 최근 이벤트 가져옵니다
    • API 응답은 저 최근 (큐의 상위) 위치 지점 마커 포함합니다
    • 해당 스크립트 및 자동화 프로세스를 업데이트해야 합니다

2025-02-09 - XDR API에 대한 변경, limit=0 더 이상 지원되지 않음

limit 필드의 기능을 변경하여 limit=0은 더 이상 지원되지 않습니다. 이는 최선의 방법이 아닙니다. 원활한 운영을 보장하기 위해 이 매개변수에 의존하는 모든 스크립트나 쿼리를 업데이트해야 합니다. 대신, API가 완전히 지원하는 1에서 2000 사이의 제한을 설정할 수 있습니다.

모든 스토리를 검색하려면 페이지 매김 접근 방식을 사용할 것을 권장합니다.

다가오는 서비스 종료 발표

 

이전 종료 공지

2026-03-18 - SecondarySocketSerial 필드의 종료(EoL)

EventFieldName API의 secondary_socket_serial 이벤트 필드는 현재 불용 상태이며 2026년 3월 18일에 종료되었습니다(EoL).

추천 대체 필드: socket_serial

2025-06-30 - LastMileBwInput, InterfaceInfo, 및 SocketInterfaceBandwidthInput 유형의 종료(EoL)

LastMileBWInput API의 필드 및 유형은 현재 불용 상태이며 2025년 6월 30일에 종료되었습니다(EoL).

대신 권장 필드와 타입을 사용해 주십시오.

사용 중지 타입 권장 타입
다운스트림 다운스트림Mbps정밀도
업스트림 업스트림Mbps정밀도

InterfaceInfo API의 필드 및 유형은 현재 불용 상태이며 2025년 6월 30일에 종료되었습니다(EoL).

대신 권장 필드와 타입을 사용해 주십시오.

사용 중지 타입 권장 타입
다운스트림대역폭 다운스트림대역폭Mbps정밀도
업스트림대역폭 업스트림대역폭Mbps정밀도

SocketInterfaceBandwidthInput API의 필드 및 유형은 현재 불용 상태이며 2025년 6월 30일에 종료되었습니다(EoL).

대신 권장 필드와 타입을 사용해 주십시오.

사용 중지 타입 권장 타입
다운스트림대역폭 다운스트림대역폭Mbps정밀도
업스트림대역폭 업스트림대역폭Mbps정밀도

2025-06-08 - FieldNameInput에서 EventFieldName 필드의 종료(EoL)

  • auditFeed 쿼리 API는 AuditFieldFilterInput 유형을 사용하여 필터 목록을 수락합니다. 각 필터에는 유형 FieldNameInput으로 정의된 fieldName이 포함되어 있으며 현재 두 입력 필드인 AuditFieldName과 EventFieldName이 포함됩니다.
  • 그러나 AuditFieldName만 유효하고 지원되는 입력 필드입니다. EventFieldName 필드는 스키마 명확성을 개선하고 혼란을 방지하기 위해 2025년 6월 8일에 스키마에서 제거되었습니다.
  • auditFeed 필터를 사용하는 모든 스크립트와 쿼리를 업데이트하여 AuditFieldName 입력 필드만 사용하십시오.

2025-05-01 - EventFieldName 유형의 종료(EoL)

EventFieldName API의 필드 및 유형은 현재 불용 상태이며 2025년 5월 1일에 종료되었습니다(EoL).

대신 권장 필드와 타입을 사용해 주십시오.

사용 중지 타입 권장 타입
애플리케이션 애플리케이션_id/애플리케이션_name
사용자 정의_카테고리 사용자 정의_카테고리_id/사용자 정의_카테고리_name
사용자 정의_카테고리 사용자 정의_카테고리_id/사용자 정의_카테고리_name
목적지_사이트 목적지_사이트_ID/목적지_사이트_이름
디바이스_자세_프로파일 디바이스_자세_프로파일
내부ID 이벤트_ID
규칙 규칙_이름
출처_사이트 출처_사이트_ID/출처_사이트_이름

2025-04-15 - bgp_peer_description 종료(EoL)

EventFieldName API의 bgp_피어_설명 필드는 2025년 4월 15일 현재 사용 중단되어 수명이 다했습니다 (EoL).

2025-03-01 - EventFieldName 유형의 종료(EoL)

EventFieldName API의 다음 필드 및 유형은 사용 중지로 표시되어 있었으며, 2025년 3월 1일부터 서비스 종료(EoL)입니다.

권장 필드 및 유형을 사용하십시오.

사용 중단된 유형 추천 유형
parent_pid src_process_parent_pid
pid src_pid
process_path src_process_path

2025-02-23 - StoryDrillDownFilter 값 필드의 종료(EoL)

StoryDrillDownFilter 베타 API의 다음 필드는 사용 중지로 표시되어 있었으며 2025년 2월 23일부로 서비스 종료(EoL)입니다.

대신 추천되는 필드와 유형을 사용하십시오.

사용 중단된 유형 추천 유형
값 OS 버전 입력

2025-02-11 - Cato 이벤트 데이터의 일부 하위 유형 종료(EoL)

Cato 클라이언트와 관련된 이벤트 소비 API에서 사용되는 일부 하위 유형 값의 EoL 발표에 따라, 다음 필드에 대해 아일랜드 CMA 위치(cc.catonetworks.com)를 사용하는 계정의 롤아웃이 일시 중지되었습니다:

사용 중단된 유형 추천 유형
재연결됨 연결됨 또는 연결 해제됨
PoP 변경됨

연결됨 또는 연결 해제됨

(PoP 이름은 lastPopName 필드에 반환됩니다.)

2025-01-02 - 이벤트 하위 유형의 종료(EoL)

Cato 클라이언트와 관련된 다음 필드와 유형은 사용 중단됨으로 표시되었으며, 2025년 1월 2일자로 수명이 종료됩니다.

대신 추천되는 필드와 유형을 사용하십시오.

사용 중단된 유형 추천 유형 메모
VPN Never-Off-우회 항상 적용 우회 VPN Never-Off-우회 하위 유형 값이 항상 적용 우회 값으로 대체됩니다.
재연결됨 연결됨 또는 연결 해제됨 세분성을 높이기 위해, 재연결됨 하위 유형 값이 2개의 새 값, 연결됨 및 연결 해제됨으로 분할되었습니다.
PoP 변경됨

연결됨 또는 연결 해제됨

(PoP 이름은 lastPopName 필드에 반환됩니다)

 세분성을 높이기 위해, PoP 변경됨 하위 유형 값이 2개의 새 값, 연결됨 및 연결 해제됨으로 분할되었습니다.

도움이 되었습니까?

1명 중 0명이 도움이 되었다고 했습니다.

댓글 0개