Cato APIの潜在的な破壊的変更とEoL

現在、CatoのAPIゲートウェイはID項目を文字列または長整数として返すことがあります。 今後のインフラ更新の一環として、すべてのID項目は一貫して文字列として返されます。

• 何が変わるのか: 以前はID項目を数値の長整数値として返していたAPI応答が、今後は常に文字列として返されます（例: "1000000002"）。
• 影響を受けるのは誰か: この変更が実施されると、ID項目を長整数型として扱うAPIクライアントが正常に動作しなくなる可能性があります。
• 2026年6月21日までにすべきこと: ID項目のためにAPIクライアントコードを長整数と文字列タイプの両方を受け入れるよう更新してください。 これにより円滑な移行が確保され、変更が有効になるときに混乱が発生するのを防ぐことができます。

2025年8月10日、addAdminおよびupdateAdmin APIのemail項目はオプション（null許容）になりました。 この変更は、サービスプリンシパルを使用したスクリプトおよび自動化を含む、細かいAPIアクセスコントロールをサポートする今後のインフラストラクチャをサポートします。

これは通常は破壊的変更ではありませんが、emailが常に存在すると仮定するクライアントに影響を与える可能性があります。 問題を避けるために、統合を見直してください。

eventsFeed APIはマーカーを使用してイベントフィードの反復的な取得を可能にします。 Markerフィールドは、新しい反復の開始を示す識別子を示します。 APIは一意のMarkerフィールドに基づいてキューからイベントを読み取り、応答には次のマーケーションの場所を提供します。 キューに新しいイベントがない場合、Markerフィールドは空になります

イベント消費モデルの代替として、直接の無コード統合を使用できます。詳細はCato EventsとAWS S3の統合およびCato EventsとAzure ストレージアカウントの統合を参照してください。

何を変更しましたか？ 

これは破壊的変更ですか？ 

limitフィールドの機能を変更し、limit=0がサポートされなくなったため、これがベストプラクティスと見なされないことが理由です。 円滑な運用を続けるために、このパラメータに依存しているスクリプトやクエリを更新する必要があります。 代わりに、APIが完全にサポートする1から2000の間の制限を設定できます。

すべてのストーリーを取得する必要がある場合、ページネーションアプローチの使用をお勧めします。

secondary_socket_serialイベント項目は、EventFieldName APIで現在廃止扱いとなっており、2026年3月18日に終息（EoL）しました。

推奨される代替項目: socket_serial

次のフィールドとタイプは、LastMileBWInput APIで現在廃止扱いとなっており、2025年6月30日に終息（EoL）しました。

代わりに推奨されるフィールドとタイプを使用してください。

次のフィールドとタイプは、InterfaceInfo APIで現在廃止扱いとなっており、2025年6月30日に終息（EoL）しました。

代わりに推奨されるフィールドとタイプを使用してください。

次のフィールドとタイプは、SocketInterfaceBandwidthInput APIで現在廃止扱いとなっており、2025年6月30日に終息（EoL）しました。

代わりに推奨されるフィールドとタイプを使用してください。

次のフィールドとタイプは、EventFieldName APIで現在廃止扱いとなっており、2025年5月1日に終息（EoL）しました。

代わりに推奨されるフィールドとタイプを使用してください。

EventFieldName API内のbgp_peer_descriptionフィールドは廃止予定になり、2025年4月15日をもって商用計画となります。

EventFieldName APIの項目とタイプは、非推奨としてマークされており、2025年3月1日時点でサポート終了となりました。

代わりに推奨されるフィールドとタイプを使用してください。

StoryDrillDownFilter Beta APIの項目は、非推奨としてマークされており、2025年2月23日時点でサポート終了となりました。

代わりに推奨されたフィールドと種類を使用してください。

Catoクライアントに関連するイベント消費APIで使用されている一部のサブタイプ値のEoL発表発表に続いて、以下の項目に対してはアイルランドCMAロケーション(cc.catonetworks.com)を使用するアカウントでの展開が一時停止されています。

Catoクライアントに関連する以下のフィールドと種類が非推奨としてマークされ、2025年1月2日に寿命終了 (EoL) となります。

代わりに推奨されたフィールドと種類を使用してください。