--- title: "Cato API 潜在的破壊的な変更とEoL" slug: "cato-api-potentially-breaking-changes-and-eol" updated: 2026-11-05T00:08:48Z published: 2026-11-05T00:08:48Z canonical: "knowledge.catonetworks.com/cato-api-potentially-breaking-changes-and-eol" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Cato API 潜在的破壊的な変更とEoL この文章は、Cato GraphQL APIスキーマの潜在的な破壊的変更とエンドオブライフ (EoL) の通知プラットフォームであり、APIクライアントの更新が必要になるかもしれない情報が含まれています。 この記事で使用されているAPI用語は、「[Cato APIとは何ですか](/v1/docs/what-is-the-cato-api)」で説明されています。 Cato APIを使用している顧客の皆様は、**フォロー**をクリックして、APIの破壊的変更に関するこの文章の更新を自動的に電子メールで通知を受け取ることをお勧めします。新しいAPIや更新されたAPIに関する詳細は、[Cato API変更履歴](/v1/docs/cato-api-changelog)をご覧ください。 APIに関する詳細情報は、[Cato Networks GraphQL API参照資料](https://api.catonetworks.com/documentation/)を参照してください。 ## 潜在的な破壊的な変更 ### 2026-12-1 - API 変更とレート制限 2026年12月1日より、CatoはAPIレート制限の変更を含む新しいAPIゲートウェイを段階的に導入します。新しいモデルには以下が含まれます： - ポイントベースのレート制限: 各操作はそのコストに基づいてポイントを消費し、各呼び出しが均等にカウントされるわけではありません - 共有アカウント予算: 操作は同じアカウント予算からポイントを引き出し、時間とともに補充されます - 追加の操作予算: 一部の操作は共有アカウント予算に加えて独自の予算を持っています - 再試行ガイダンス: APIレスポンスは再試行の待機時間や、容量超過時にリクエストを簡略化または分割するタイミングを示しています **重要:** これは重大な変更ではありません。既存の統合に劣化はなく、アクションは必要ありません。 詳細については、[FAQ: 今後のAPIゲートウェイおよびレート制限の変更について](/v1/docs/faq-upcoming-api-gateway-and-rate-limiting-changes)をご覧ください ### 2026-08-30 - 厳密なスキーマタイプの検証 2026年8月30日より、API全体で厳密なタイプの検証を実施し、文書化されたスキーマと一致させます。 API コールでフィールドのドキュメント化されたタイプと一致しない形式で値が渡される場合、エンドポイントによって影響を受ける可能性があります。 - **変更点：** パラメーターは、スキーマで定義されたタイプと正確に一致する必要があります。例えば、`Int` 項目は整数値のみ許可されます。文字列入力 `"5"` は今後受け入れられません。これは Int 項目に限らず、ドキュメントに記載されたタイプと一致しない形式で渡されるパラメーターには影響があります。 - **2026年8月30日までにあなたがするべきこと：** - 記録されたスキーマタイプと一致しない形式で渡された値に対して、APIコールを見直してください（例：文字列として渡される数値）。 - 不一致のコールをすべて更新してください。 ### 2026-06-21 - API IDフィールド：タイプ変更、Long/IntegerからStringへ 現在、CatoのAPIゲートウェイはIDフィールドを文字列またはLong（整数）として返すことがあります。今後のインフラ更新の一環として、すべてのIDフィールドは一貫して文字列として返されるようになります。 - **何が変わるのか：**以前にIDフィールドを数値のLong値（例えば、`1000000002`）として返していたAPIの応答が、今後は常に文字列（例えば、`"1000000002"`）として返されるようになります。 - **影響を受ける人：**IDフィールドをLong/整数型として扱っているAPIクライアントは、変更が導入されたときに問題が発生する可能性があります。 - **2026年6月21日までに何をすべきか：**IDフィールドに対し、Long型とString型の両方を承認するように、クライアントコードを更新してください。これにより、変更が効果的に行われた際に中断を防ぎ、スムーズな移行を確実にします。 ### 2025-08-10 - addAdminとupdateAdmin APIでのemailフィールドの変更 2025年8月10日、addAdminおよびupdateAdmin APIの`電子メール`項目がオプション（null許可）になりました。この変更は、スクリプトやサービスプリンシパルを使用したオートメーションを含む、細かいAPIアクセス制御をサポートする今後のインフラに対応しています。 - 現在および将来の管理者は常に`電子メール`値を含めなければなりません - 人間の管理者のみを返すクエリには影響がありません。 - 一部のクライアントは、addAdminPayloadなどの応答ペイロードでのnull値を処理する必要があります これは通常の破壊的変更ではありませんが、`電子メール`が常に存在すると仮定しているクライアントに影響する可能性があります。統合をレビューして問題を回避してください。 ### 2025-04-27 - eventsFeedクエリAPIが最新イベント取得をサポート eventsFeed APIはマーカーを使用してイベントフィードを繰り返し取り込むことを有効にします。マーカーフィールドは、新しい反復の開始を示す識別子を表示します。 APIは一意のマーカーフィールドに基づいてキューからイベントを読むと応答に次のマーカーロケーションを提供します。キューに新しいイベントがない場合、マーカーフィールドは空です 代替のイベント消費モデルとして、直接のノーコード統合を使用することもでき、[AWS S3とのCatoイベント統合](/v1/docs/integrating-cato-events-with-aws-s3)および[AzureストレージアカウントとのCatoイベント統合](%%LINK:13539822366493%%)をご覧ください。 **何を変更しましたか？** - 以前は、マーカーが指定されていないと、APIは利用可能な最も古いマーカーを返しました。これにより、最新のイベントに到達するまでに全イベントキューを消費する必要がありました。 - 2025年4月27日以降、マーカーが指定されていない場合、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の[項目とタイプ](https://api.catonetworks.com/documentation/#definition-LastMileBwInput)は、廃止予定としてマークされ、2025年6月30日にEoLに達しました。 代わりに推奨されるフィールドとタイプを使用してください。 | 廃止予定のタイプ | 推奨されるタイプ | | --- | --- | | ダウンストリーム | downstreamMbpsPrecision | | アップストリーム | upstreamMbpsPrecision | `InterfaceInfo` APIの[項目とタイプ](https://api.catonetworks.com/documentation/#definition-InterfaceInfo)は、廃止予定としてマークされ、2025年6月30日にEoLに達しました。 代わりに推奨されるフィールドとタイプを使用してください。 | 廃止予定のタイプ | 推奨されるタイプ | | --- | --- | | ダウンストリーム帯域幅 | downstreamBandwidthMbpsPrecision | | アップストリーム帯域幅 | upstreamBandwidthMbpsPrecision | `SocketInterfaceBandwidthInput` APIの[項目とタイプ](https://api.catonetworks.com/documentation/#definition-SocketInterfaceWanInput)は、廃止予定としてマークされ、2025年6月30日にEoLに達しました。 代わりに推奨されるフィールドとタイプを使用してください。 | 廃止予定のタイプ | 推奨されるタイプ | | --- | --- | | ダウンストリーム帯域幅 | downstreamBandwidthMbpsPrecision | | アップストリーム帯域幅 | upstreamBandwidthMbpsPrecision | ### 2025-06-08 - FieldNameInputのEventFieldNameフィールドのEoL - `auditFeed`クエリAPIは、`AuditFieldFilterInput`タイプを使用してフィルターのリストを受け入れます。各フィルターには`AuditFieldName`と`EventFieldName`の二つの入力フィールドを含む`FieldNameInput`タイプで定義された`fieldName`が含まれます。 - しかし、`AuditFieldName`のみが有効でサポートされている入力フィールドです。スキーマの明確さを改善し、混乱を避けるため、2025年6月8日にスキーマから`EventFieldName`項目が削除されました。 - `AuditFieldName`入力フィールドのみを使用するように、`auditFeed`フィルターを使用するすべてのスクリプトとクエリを更新してください。 ### 2025-05-01 - EventFieldNameタイプのEoL `EventFieldName` APIの[項目とタイプ](https://api.catonetworks.com/documentation/#definition-EventFieldName)は、廃止予定としてマークされ、2025年5月1日にEoLに達しました。 代わりに推奨されるフィールドとタイプを使用してください。 | 廃止予定のタイプ | 推奨されるタイプ | | --- | --- | | アプリケーション | application_id/application_name | | custom_categories | custom_category_id/custom_category_name | | custom_category | 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 | ### 2025-04-15 - bgp_peer_descriptionのEoL `EventFieldName` APIのbgp_peer_description項目は、廃止予定としてマークされ、2025年4月15日にEoLです。 ### 2025-03-01 - EventFieldNameタイプのEoL `EventFieldName` APIの[項目とタイプ](https://api.catonetworks.com/documentation/#definition-EventFieldName)は、廃止予定としてマークされ、2025年3月1日にEoLです。 代わりに推奨されるフィールドとタイプを使用してください。 | 非推奨タイプ | 推奨タイプ | | --- | --- | | parent_pid | src_process_parent_pid | | pid | src_pid | | process_path | src_process_path | ### 2025-02-23 - StoryDrillDownFilter の 値 フィールド EoL 次の [項目](https://api.catonetworks.com/documentation/#definition-StoryDrillDownFilter) は `StoryDrillDownFilter` Beta API において非推奨マークされました。2025年2月23日をもってすべて廃止されます。 代わりに推奨される項目とタイプを使用してください。 | 非推奨タイプ | 推奨タイプ | | --- | --- | | 値 | 値 | ### 2025-02-11 - 一部の Cato イベントデータ サブタイプ EoL Cato クライアントに関連するいくつかのサブタイプ値のEoLの[発表](/v1/docs/upcoming-eol-for-some-subtypes-of-cato-event-data)後、アイルランド CMA 位置（cc.catonetworks.com）を使用しているアカウントのために、以下の項目で展開が一時停止されています。 | 非推奨タイプ | 推奨タイプ | | --- | --- | | 再接続済み | 接続済みまたは切断済み | | PoP 変更 | 接続済みまたは切断済み (PoPの名前は lastPopName 項目に返されます。) | - 詳細は[CMA - 技術ガイドライン](/v1/docs/cma-technical-guidelines)を参照してください ### 2025-01-02 - イベント サブタイプ EoL Catoクライアントに関連する次の項目とタイプが非推奨とされ、2025年1月2日よりEoLになります。 代わりに推奨される項目とタイプを使用してください。 | 非推奨タイプ | 推奨タイプ | 注意 | | --- | --- | --- | | VPN Never-Off バイパス | 常時強制バイパス | VPN Never-Off バイパス サブタイプ値は常時強制バイパス値に置換されます | | 再接続済み | 接続済みまたは切断済み | 細かさを増すため、再接続サブタイプ値は接続済みおよび切断に分割されます | | PoP 変更 | 接続済みまたは切断済み (PoPの名前は lastPopName 項目に返されます) | 細かさを増すため、PoP変更サブタイプ値は接続済みおよび切断に分割されます | - 詳細情報は以下の記事を参照： [Cato イベントデータ の 一部サブタイプ の EoL](/v1/docs/upcoming-eol-for-some-subtypes-of-cato-event-data)