Cato API チェンジログ

Prev Next

この記事は、Cato GraphQL API スキーマの最近および計画された変更に関する通知のプラットフォームです。 新しく公開された API や自動化ツールなど、新機能のニュースと更新を強調表示しています。

API クライアントを更新する必要がある可能性のある変更については、Cato API 重大な変更とサポート終了を参照してください。

この記事で使用されるAPI用語は、Cato APIとはで説明されています。

Cato API を利用している顧客について、APIに関する変更が記事に更新された際に自動でメール通知を受け取るために、フォロー をクリックすることをお勧めします。

APIに関する詳細は、Cato Networks GraphQL API リファレンスをご覧ください。

ニュースと更新

追加ユーザーアクション

変更:APIが更新されました

機能タイトル:外部ワークフローとアイデンティティ管理システムを通じたユーザー管理の単純化

この API はユーザーを有効にする (enableUser) およびユーザーを無効化する (disableUser) に対応しています。

グループ化された AppStats API 結果の分析の向上 - 2026年6月21日

変更: APIが更新されました

機能タイトル: グループ化されたAppStatsおよびイベントAPI結果のアナリティクス改善

AppStatsまたはイベントAPIデータをクエリし、国やデバイスタイプなどの次元でグループ化する場合、その次元に値がないレコードを空のグループとして表示することを選択できます。 これにより、APIクエリでの合計の一貫性を確保し、以前に隠れていたデータがCMAダッシュボードやレポートに表示されるようになります。

  • 新しいクエリレベルブールパラメーター: IncludeEmptyDimension、既存のAPIスクリプトへの影響はありません

  • APIクエリとCMAに表示されるデータに適用されます

DEM 顧客向けに追加の appStats API フィールド - 2026年4月19日

変更: APIが更新されました

機能タイトル: アプリケーション エクスペリエンス メトリック用appStats APIの更新

アプリケーションエクスペリエンスメトリクス用にappStats APIの新しいフィールドが利用可能です。ユーザー、ホスト、アプリケーションのパフォーマンスデータにプログラムでアクセスできます。

  • experience_score_level - 統合されたエクスペリエンススコアインジケータ

  • ttfb - 最初のバイトまでの時間、サーバーの応答速度を測定

  • tls_latency - TLS 接続の確立時間

  • tcp_latency - TCP 接続設定時間

  • http_latency - エンドツーエンドのHTTPリクエストの遅延

  • http_error_rate - 観測されたHTTPエラーの割合

注意: これらの項目は、DEMライセンスを持つ顧客のみが利用可能です。

Webhook、メーリングリスト、サブスクリプショングループのためのAPI追加 - 2026年3月29日

変更: 新しいAPI

機能タイトル: Webhook、メーリングリスト、およびサブスクリプショングループの管理をサポートするAPI

  • 単一およびプールライセンスのために、サイトライセンスをAPI経由で割り当て、置換、更新、削除するための次のAPIを使用します

      • createWebhook、updateWebhook、deleteWebhook、webhook、webhookList testWebhook を使用してWebhook統合を管理します

      • createMailingList、updateMailingList、deleteMailingList、mailingList、mailingListList を使用してメーリングリストを管理します

      • Webhookとメーリングリストを createSubscriptionGroup、updateSubscriptionGroup、deleteSubscriptionGroup、subscriptionGroup、subscriptionGroupList に“サブスクリプショングループ”として統合します

    CMAにおける通知管理の詳細については、各種通知のKB記事を参照してください

以前のAPIニュースと更新

スプリットトンネルポリシーAPIの更新 - 2026年1月18日

変更: APIが更新されました

機能タイトル: SplitTunnelPolicyMutations 更新

  • Cato管理アプリケーションにおける機能の動作により正確に合わせるために変更されたAPIは次のとおりです。

    • これらの変更は、スプリット トンネル ポリシーのすべてのミューテーションに適用されます: 

      • Exclude - RouteAllToCatoExceptに変更

      • Include - RouteOnlySelected に変更

      • Coverage - ConnectionModeに変更

      • dnsExclusion - dnsSuffix に変更

これらのAPIは現在ベータ版として利用可能です。

サイト帯域幅ライセンスのためのAPI追加 - 2025年8月11日

変更: 新しいAPI

機能タイトル: サイト帯域幅ライセンスを管理するためのAPIサポート

  • 単一およびプールライセンスのために、サイトライセンスをAPI経由で割り当て、置換、更新、削除するための次のAPIを使用します

    • ミューテーション API: 

      • assignSiteBwLicense - ライセンスをサイトに割り当てる

      • updateSiteBwLicense - プールされたライセンスの場合、サイトの帯域幅を更新

      • replaceSiteBwLicense - ダウンタイムなしでサイトライセンスを置き換える

      • removeSiteBwLicense - サイトからライセンスを削除する

これらのAPIは現在ベータ版として利用可能です。

アプリカタログとDLPコンテンツタイプのためのクエリAPI追加 - 2025年5月19日

変更: 新しいAPI

機能タイトル: アプリケーションカタログとDLPコンテンツタイプをクエリするためのAPIサポート

  • アプリカタログ - コンプライアンス、セキュリティ、CASBアクティビティを含むアプリのデータをクエリします:

    • catalogApplicationList - すべてのアプリとデータ

    • catalogApplication - 単一のアプリ

  • DLPコンテンツ - DLPデータインライン保護ルールのコンテンツタイプをクエリします

    • contentTypeGroupList

これらのAPIは現在ベータ版として利用可能です。

HA セカンダリ vSocketのためのAPI追加 - 2025年3月2日

変更: 新しいAPI

機能タイトル: HA構成向けのセカンダリvSocketのAPIサポート

  • 以下のAPIを使用して、ストーリーの判定を設定、ステータスを変更、コメントを追加します

    • ミューテーション API: 

      • addSecondaryAwsVSocketInput AWS の HA 構成でセカンダリ vSocket を追加

      • AddSecondaryAzureVSocketInput AWS の HA 構成でセカンダリ vSocket を追加

これらのAPIは現在ベータ版として利用可能です。

XDR ミューテーションAPIの追加 - 2025年1月12日

変更: 新しいAPI

機能タイトル: XDR ストーリーと コメント用 APIサポート

  • 以下のAPIを使用して、ストーリーの判定を設定、ステータスを変更、コメントを追加します

    • ミューテーション API: 

      • addStoryComment ストーリー調査を追跡するためのコメントを投稿

      • analystFeedback ストーリーアクション、例えばストーリーの判定、タイプ、分類を管理します

      • deleteStoryComment コメントIDを使用して、以前投稿されたコメントを削除

このAPIは現在ベータ版として利用可能です。

ラストマイル帯域幅がKbpsをサポート - 2025年1月12日

変更: APIの改善

機能タイトル: より細分化された精度のために、小数点以下1桁(例:1.5 Mbps)を含むサイトの帯域幅値を設定

  • 以下のAPIを使用して、ストーリーの判定を設定、ステータスを変更、コメントを追加します

    • API の影響を受けるタイプ: 

      • LastMileBwInput 

      • InterfaceInfo 

      • SocketInterfaceBandwidthInput 

これらのAPIタイプは現在ベータ版として利用可能です。

IPsec IKEv2サイト用のaccountSnapshotおよびaccountMetricsの変更 - 2025年1月12日

変更: Primary 値を Primary 1 に更新

機能タイトル: IPsec IKEv2 サイトのためのAPIサポート

Active/Active構成に対するサポートの段階的リリースにより、accountSnapshotおよびaccountMetricsクエリ時に InterfaceId フィールドから取得される値が2025年1月12日から変更されます

以前の値

新しい値

注

プライマリ

プライマリ1

この変更により、複数のプライマリトンネルをサポートできるようになります

新しいBGPピアリングAPI - 2024年12月23日

変更: 新しいAPI

機能タイトル: BGPピアリングのためのAPIサポート

  • 設定 および モニタリング を簡素化するために、次のAPIを使用してBGPピアの設定および監視を行います

    • ミューテーション API: 

      • addBgpPeer 新しいBGPピアをサイトに追加

      • updateBgpPeer 既存のBGPピア設定の更新

      • removeBgpPeer BGPピア設定の削除

    • クエリAPI: 

      • bgpPeer 特定のBGPピアに関する情報を取得

      • siteBgpStatus 現在のBGPステータスを表示、セッション詳細およびルート情報を含む

このAPIは現在、ベータ版として利用可能です。