新機能および変更された機能に関する情報

新機能および変更情報

表 1. Catalyst Center プラットフォーム 2.3.7.10 の新機能と変更された機能
機能 説明

新しい API

なし

API の機能拡張

デバイス API

このリリースでは、到達可能性正常性ステータスパラメータが、次のデバイス API の応答にオプションの属性として含まれています。

  • 指定されたデバイス ID(Uuid)のデバイスデータを取得します。

  • 指定された複雑なフィルタと集約関数に基づいて、ネットワークデバイスのリストを取得します。

  • 指定されたクエリパラメータに基づいてネットワークデバイスの詳細を取得します。

ネットワーク設定 API

このリリースでは、configureDevice 属性がネットワークデバイス同期クレデンシャル API でクエリパラメータとして追加されます。

廃止された API

なし

後方互換性を損なう API の変更

なし

表 2. Catalyst Center プラットフォーム 2.3.7.9 の新機能および変更された機能
機能 説明

記載場所

[インベントリレポート(Inventory Report)]

この Catalyst Center プラットフォーム リリースでは、新しい インベントリレポートテンプレート「All Data Version 2.0」がサポートされています。

この新しいすべてのデータビューでは、ネットワークデバイス、時間の経過に伴うデバイスの分散、サイト別のデバイス数、デバイスタイプ別のデバイス数、ソフトウェアバージョン別のデバイス数、ファブリックロール別のデバイス数に関する詳細情報が、より効率的に表示されます。

詳細については、以下を参照してください。

新しい API

アプリケーション API

Catalyst Center プラットフォーム は、次のアプリケーション API をサポートしています。

  • GET <cluster-ip>/dna/data/api/v1/networkApplications

    ネットワークアプリケーションのリストを、エクスペリエンスおよび正常性メトリックとともに取得します。

  • GET <cluster-ip>/dna/data/api/v1/networkApplications/count

    基本的なフィルタ処理を適用して、ネットワークアプリケーションの合計数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/networkApplications/trendAnalytics

    ネットワークアプリケーションに関連するトレンド分析データを取得します。

新しいアプリケーション API にアクセスするには、メニューアイコンをクリックし、[Platform > Developer Toolkit > APIs] を選択します。

[Policy] ドロップダウンリストを展開し、[Applications] を選択します。

アプリケーションポリシー API

Catalyst Center プラットフォーム では、次のアプリケーションポリシー API がサポートされています。

  • GET <cluster-ip>/dna/intent/api/v1/applicationVisibility/networkDevices

    ネットワークデバイスのリストとアプリケーションの可視性ステータスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/applicationVisibility/networkDevices/count

    指定されたアプリケーション可視性ステータスフィルタのネットワークデバイス数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/applicationVisibility/networkDevices/enableAppTelemetry

    複数のネットワークデバイスでアプリケーションテレメトリ機能を有効にします。

  • POST <cluster-ip>/dna/intent/api/v1/applicationVisibility/networkDevices/disableAppTelemetry

    複数のネットワークデバイスでアプリケーションテレメトリ機能を無効にします。

  • POST <cluster-ip>/dna/intent/api/v1/applicationVisibility/networkDevices/enableCbar

    複数のネットワークデバイスで CBAR 機能を有効にします。

  • POST <cluster-ip>/dna/intent/api/v1/applicationVisibility/networkDevices/disableCbar

    複数のネットワークデバイスで CBAR 機能を無効にします。

  • GET <cluster-ip>/dna/intent/api/v1/qosPolicySetting

    アプリケーション QoS ポリシー設定を取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/qosPolicySetting

    アプリケーション QoS ポリシー設定を更新します。

新しいアプリケーションポリシー API にアクセスするには、メニューアイコンをクリックし、[Platform > Developer Toolkit > APIs] を選択します。

[Policy] ドロップダウンリストを展開し、[Application Policy] を選択します。

Cisco Integrated Management Controller (IMC) APIs

Catalyst Center プラットフォーム は、次の Cisco IMC API をサポートしています。

  • GET <cluster-ip>/dna/system/api/v1/ciscoImcs

    Catalyst Center ノードの Cisco IMC 設定を取得します。

  • POST <cluster-ip>/dna/system/api/v1/ciscoImcs

    Catalyst Center ノードに Cisco IMC 設定を追加します。

  • GET <cluster-ip>/dna/system/api/v1/ciscoImcs/${id}

    Catalyst Center ノードの Cisco IMC 設定を取得します。

  • PUT <cluster-ip>/dna/system/api/v1/ciscoImcs/${id}

    Catalyst Centerノードの Cisco IMC 設定を更新します。

  • DELETE <cluster-ip>/dna/system/api/v1/ciscoImcs/${id}

    Catalyst Center ノードの Cisco IMC 設定を削除します。

新しい Cisco IMC API にアクセスするには、メニューアイコンをクリックし、[Platform > Developer Toolkit > APIs] を選択します。

[Appliance] ドロップダウンリストを展開し、[Cisco IMC] を選択します。

コンプライアンス API

Catalyst Center プラットフォーム は、次のコンプライアンス API をサポートしています。

  • POST <cluster-ip>/dna/intent/api/v1/networkBugs/trials

    ネットワークデバイスでバグ検出用のトライアルを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/trials

    ネットワークデバイスでのバグ検出に関するトライアルの詳細を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/networkBugs/triggerScan

    サポートされているネットワークデバイスのバグスキャンをトリガーします。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs/count

    ネットワークデバイスに影響するバグの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs

    ネットワークデバイスに影響するバグを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/bugs/${id}

    ID でネットワークバグを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/bugs/${id}/networkDevices/count

    バグのネットワークバグデバイスの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/bugs/${id}/networkDevices

    バグのネットワークバグデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/bugs/${id}/networkDevices/${networkDeviceId}

    ネットワークデバイス ID でバグのネットワークバグデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/networkDevices/count

    ネットワークバグデバイスの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/networkDevices

    ネットワークバグデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}

    デバイス ID でネットワークバグデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs/count

    ネットワークデバイスに影響するバグの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs

    ネットワークデバイスに影響するバグを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/results/networkDevices/${networkDeviceId}/bugs/${id}

    デバイス ID とバグ ID で、ネットワークデバイスに影響するバグを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/resultsTrend/count

    時系列のネットワークバグ数結果のトレンドを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkBugs/resultsTrend

    時間の経過に伴うネットワークバグ結果のトレンドを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/fieldNotices/trials

    ネットワークデバイスでフィールド通知検出のトライアルを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/trials

    ネットワークデバイスでのフィールド通知検出に関するトライアルの詳細を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/fieldNotices/triggerScan

    サポートされているネットワークデバイスのフィールド通知スキャンをトリガーします。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices/count

    ネットワークデバイスに影響するフィールド通知の数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices

    ネットワークデバイスに影響するフィールド通知を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/notices/${id}

    ネットワークデバイスに影響する Field Notice を ID で取得できます。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/notices/${id}/networkDevices/count

    通知の Field Notice ネットワークデバイスの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/notices/${id}/networkDevices

    通知用の Field Notice ネットワークデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/notices/${id}/networkDevices/${networkDeviceId}

    ネットワークデバイス ID で通知の Field Notice ネットワークデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/networkDevices/count

    Field Notice ネットワークデバイスの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/networkDevices

    Field Notice ネットワークデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}

    デバイス ID で Field Notice ネットワークデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices/count

    ネットワークデバイスに影響するフィールド通知の数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices

    ネットワークデバイスに影響するフィールド通知を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/results/networkDevices/${networkDeviceId}/notices/${id}

    デバイス ID と通知 ID で、ネットワークデバイスに影響する Field Notice を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/resultsTrend/count

    時間の経過に伴う Field Notice 結果のトレンドを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/fieldNotices/resultsTrend

    時間の経過に伴う Field Notice 結果のトレンドを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/securityAdvisories/trials

    ネットワークデバイスでセキュリティアドバイザリ検出用のトライアルを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/trials

    ネットワークデバイスでのセキュリティアドバイザリ検出に関するトライアルの詳細を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/securityAdvisories/triggerScan

    サポートされているネットワークデバイスのセキュリティ アドバイザリ スキャンをトリガーします。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/advisories/count

    ネットワークデバイスに影響を与えるセキュリティアドバイザリの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/advisories

    ネットワークデバイスに影響するセキュリティアドバイザリを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/advisories/${id}

    ネットワークデバイスに影響するセキュリティアドバイザリを ID ごとに取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/advisories/${id}/networkDevices/count

    セキュリティアドバイザリのセキュリティ アドバイザリ ネットワーク デバイスの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/advisories/${id}/networkDevices

    セキュリティアドバイザリのセキュリティ アドバイザリ ネットワーク デバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/advisories/${id}/networkDevices/${networkDeviceId}

    ネットワークデバイス ID でセキュリティアドバイザリのセキュリティ アドバイザリ ネットワーク デバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/networkDevices/count

    セキュリティ アドバイザリ ネットワーク デバイスの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/networkDevices

    セキュリティ アドバイザリ ネットワーク デバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/networkDevices/${networkDeviceId}

    ネットワークデバイス ID でセキュリティ アドバイザリ ネットワーク デバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/networkDevices/${networkDeviceId}/advisories/count

    ネットワークデバイスに影響を与えるセキュリティアドバイザリの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/networkDevices/${networkDeviceId}/advisories

    ネットワークデバイスに影響するセキュリティアドバイザリを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/results/networkDevices/${networkDeviceId}/advisories/${id}

    デバイス ID とアドバイザリ ID で、ネットワークデバイスに影響するセキュリティアドバイザリを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/resultsTrend/count

    時系列のセキュリティアドバイザリ結果のトレンドを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/securityAdvisories/resultsTrend

    時系列のセキュリティアドバイザリ結果のトレンドを取得します。

新しいコンプライアンス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Know Your Network] ドロップダウンリストを展開し、[Compliance] を選択します。

Configuration Archive API

Catalyst Center プラットフォーム は、次の Configuration Archive API をサポートします。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceConfigFiles

    ネットワークデバイス構成ファイルの詳細を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceConfigFiles/count

    ネットワーク デバイス構成ファイルの数。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceConfigFiles/${id}

    構成ファイルの詳細を ID で取得します。

  • POST <cluster-ip>/dna/intent/api/v1/networkDeviceConfigFiles/${id}/downloadMasked

    マスクされたデバイス設定をダウンロードします。

  • POST <cluster-ip>/dna/intent/api/v1/networkDeviceConfigFiles/${id}/downloadUnmasked

    マスクなし(未加工)のデバイス設定を ZIP としてダウンロードします。

新しい設定テンプレート API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform > Developer Toolkit > APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[Configuration Archive APIs] を選択します。

設定テンプレート API

Catalyst Center プラットフォーム は、次の Configuration Templates API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/templates/${templateId}/networkProfilesForSites

    CLI テンプレートに関連付けられたネットワークプロファイルを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/templates/${templateId}/networkProfilesForSites/count

    CLI テンプレートに接続されているネットワークプロファイルの数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/templates/${templateId}/networkProfilesForSites

    ネットワークプロファイルを Day-N CLI テンプレートに関連付けます。

  • POST <cluster-ip>/dna/intent/api/v1/templates/${templateId}/networkProfilesForSites/bulk

    ネットワークプロファイルのリストを Day-N CLI テンプレートに関連付けます。

  • DELETE <cluster-ip>/dna/intent/api/v1/templates/${templateId}/networkProfilesForSites/bulk

    Day-N CLI テンプレートからネットワークプロファイルのリストを切り離します。

  • DELETE <cluster-ip>/dna/intent/api/v1/templates/${templateId}/networkProfilesForSites/${profileId}

    Day-N CLI テンプレートからネットワークプロファイルを切り離します。

  • GET <cluster-ip>/templates/${templateId}/versions

    テンプレートバージョンを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/templates/${templateId}/versions/${versionId}

    テンプレートバージョンを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/templates/${templateId}/versions/count

    テンプレートバージョン数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/templates/${templateId}/versions/commit

    新しいバージョンのテンプレートをコミットします。

  • GET <cluster-ip>/dna/intent/api/v1/projects

    テンプレートプロジェクトを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/projects

    テンプレートプロジェクトを作成します。

  • PUT <cluster-ip>/dna/intent/api/v1/projects/${projectId}

    テンプレートプロジェクトを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/projects/${projectId}

    テンプレートプロジェクトを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/projects/${projectId}

    テンプレートプロジェクトを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/projects/count

    テンプレートプロジェクト数を取得します。

新しい設定テンプレート API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform > Developer Toolkit > APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[Configuration Templates APIs] を選択します。

デバイス API

Catalyst Center プラットフォーム は、次のデバイス API をサポートしています。

  • POST <cluster-ip>/dna/intent/api/v1/networkDevices/deleteWithoutCleanup

    設定をクリーンアップせずにネットワークデバイスを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/networkDevices/deleteWithCleanup

    設定クリーンアップを使用してネットワークデバイスを削除します。

  • GET <cluster-ip>/dna/data/api/v1/aaaServices

    指定されたパラメータに対して AAA サービスのリストを取得します。

  • GET <cluster-ip>/dna/data/api/v1/aaaServices/count

    指定されたパラメータの AAA サービスの総数を取得します。

  • GET <cluster-ip>/dna/data/api/v1/aaaServices/${id}

    サービスの ID に一致する特定の AAA サービスの詳細を取得します。

  • POST <cluster-ip>/dna/data/api/v1/aaaServices/query

    指定された複雑なフィルタのセットに対して AAA サービスのリストを取得します。

  • POST <cluster-ip>/dna/data/api/v1/aaaServices/query/count

    指定された複雑なフィルタのセットに対する AAA サービスの総数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/aaaServices/summaryAnalytics

    指定された一連の複雑なフィルタに関する AAA サービスのサマリー分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/aaaServices/topNAnalytics

    指定された複雑なフィルタのセットに関する AAA サービスの上位 N の分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/aaaServices/trendAnalytics

    指定された一連の複雑なフィルタに関する AAA サービスのトレンド分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/aaaServices/${id}/trendAnalytics

    サービスの ID に一致する特定の AAA サービスのトレンド分析データを取得します。

  • GET <cluster-ip>/dna/data/api/v1/dhcpServices

    指定されたパラメータの DHCP サービスのリストを取得します。

  • GET <cluster-ip>/dna/data/api/v1/dhcpServices/count

    指定されたパラメータの DHCP サービスの総数を取得します。

  • GET <cluster-ip>/dna/data/api/v1/dhcpServices/${id}

    サービスの ID に一致する特定の DHCP サービスの詳細を取得します。

  • POST <cluster-ip>/dna/data/api/v1/dhcpServices/query

    指定された複雑なフィルタのセットに対する DHCP サービスのリストを取得します。

  • POST <cluster-ip>/dna/data/api/v1/dhcpServices/query/count

    指定された複雑なフィルタのセットに対する DHCP サービスの総数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/dhcpServices/summaryAnalytics

    指定された一連の複雑なフィルタに関する DHCP サービスの概要分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/dhcpServices/topNAnalytics

    指定された複雑なフィルタのセットに関する DHCP サービスの上位 N の分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/dhcpServices/trendAnalytics

    指定された一連の複雑なフィルタに関する DHCP サービスのトレンド分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/dhcpServices/${id}/trendAnalytics

    サービスの ID に一致する特定の DHCP サービスのトレンド分析データを取得します。

  • GET <cluster-ip>/dna/data/api/v1/dnsServices

    指定されたパラメータの DNS サービスのリストを取得します。

  • GET <cluster-ip>/dna/data/api/v1/dnsServices/count

    指定されたパラメータの DNS サービスの総数を取得します。

  • GET <cluster-ip>/dna/data/api/v1/dnsServices/${id}

    サービスの ID に一致する特定の DNS サービスの詳細を取得します。

  • POST <cluster-ip>/dna/data/api/v1/dnsServices/query

    指定された複雑なフィルタのセットに対する DNS サービスのリストを取得します。

  • POST <cluster-ip>/dna/data/api/v1/dnsServices/query/count

    指定された複雑なフィルタのセットに対する DNS サービスの総数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/dnsServices/summaryAnalytics

    指定された一連の複雑なフィルタに関する DNS サービスの概要分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/dnsServices/topNAnalytics

    指定された複雑なフィルタのセットに関する DHCP サービスの上位 N の分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/dnsServices/trendAnalytics

    指定された一連の複雑なフィルタに関する DNS サービスのトレンド分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/dnsServices/${id}/trendAnalytics

    サービスの ID に一致する特定の DNS サービスのトレンド分析データを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceMaintenanceSchedules

    ネットワークデバイスのスケジュールされたメンテナンス期間を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/networkDeviceMaintenanceSchedules

    ネットワークデバイスのメンテナンススケジュールを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceMaintenanceSchedules/count

    スケジュールされたメンテナンスウィンドウの合計数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceMaintenanceSchedules/${id}

    メンテナンススケジュール情報を取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/networkDeviceMaintenanceSchedules/${id}

    メンテナンススケジュール情報を更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/networkDeviceMaintenanceSchedules/${id}

    メンテナンススケジュールを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices

    ネットワークデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/${id}

    単一のネットワークデバイスの詳細を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/count

    ネットワークデバイスの数をカウントします。

  • POST <cluster-ip>/dna/intent/api/v1/networkDevices/query

    フィルタを使用してネットワークデバイスをクエリします。

  • POST <cluster-ip>/dna/intent/api/v1/networkDevices/query/count

    フィルタを使用してネットワークデバイスの数をカウントします。

  • POST <cluster-ip>/dna/data/api/v1/networkDevices/topNAnalytics

    ネットワークデバイスに関連する上位 N 分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/interfaces/${id}/trendAnalytics

    指定された時間範囲のインターフェイスのトレンド分析データ。

新しいデバイスAPIにアクセスするには、メニューアイコンをクリックし、[Platform > Developer Toolkit > APIs] を選択します。

[Know Your Network] ドロップダウンリストを展開し、[Devices] を選択します。

デバイス交換 API

Catalyst Center プラットフォーム は、次のデバイス交換 API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceReplacements/${id}

    障害のあるデバイスを交換用のデバイスに置き換えるデバイス交換ワークフローのステータスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceReplacements

    すべてのデバイス交換ワークフローのステータスを取得します。

新しいデバイス交換 API にアクセスするには、メニューアイコンをクリックして、[Platform > Developer Toolkit > APIs] を選択します。

[Site Management] ドロップダウンリストを展開し、[Device Replacement] を選択します。

ファブリックワイヤレス API

Catalyst Center プラットフォーム は、次のファブリックワイヤレス API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabrics/${fabricId}/switchWirelessSetting

    スイッチから SDA ワイヤレスの詳細を取得します。

  • PUT <cluster-ip>//dna/intent/api/v1/sda/fabrics/${fabricId}/wirelessMulticast

    SDA ワイヤレスマルチキャストを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabrics/${fabricId}/wirelessMulticast

    SDA ワイヤレスマルチキャストを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/fabrics/${fabricId}/switchWirelessSetting

    スイッチワイヤレス設定およびローリング AP アップグレード管理。

  • POST <cluster-ip>//dna/intent/api/v1/sda/fabrics/${fabricId}/switchWirelessSetting/reload

    ワイヤレスコントローラクリーンアップのためにスイッチをリロードします。

新しいファブリックワイヤレス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Connectivity] ドロップダウンリストを展開して、[Fabric Wireless] を選択します。

正常性およびパフォーマンス API

Catalyst Center プラットフォーム は、次の正常性およびパフォーマンス API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/diagnosticTasks/${id}

    診断タスクを ID で取得します。

  • GET <cluster-ip>/dna/intent/api/v1/diagnosticTasks/${id}/detail

    診断タスクの詳細を ID で取得します。

新しい正常性およびパフォーマンス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[System] ドロップダウンリストを展開し、[Health and Performance] を選択します。

ライセンス API

Catalyst Center プラットフォーム は、次のライセンス API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/connectionModeSetting

    CSSM 接続モードを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/connectionModeSetting

    CSSM 接続モードを更新します。

  • GET <cluster-ip>/dna/system/api/v1/license/status

    システムライセンスのステータス。

  • POST <cluster-ip>/dna/system/api/v1/license/register

    スマートライセンシングの登録。

  • POST <cluster-ip>/dna/system/api/v1/license/renew

    スマートライセンスの更新操作。

  • POST <cluster-ip>/dna/system/api/v1/license/deregister

    スマートライセンシングの登録解除。

  • GET <cluster-ip>/dna/system/api/v1/license/lastOperationStatus

    システムライセンスの直前の操作ステータス。

新しいライセンス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Cisco DNA Center System] ドロップダウンリストを展開し、[Licenses] を選択します。

ネットワーク設定 API

Catalyst Center プラットフォーム は、次のネットワーク設定 API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/networkProfilesForSites/${profileId}/templates

    ネットワークプロファイルに関連付けられた CLI テンプレートを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkProfilesForSites/${profileId}/templates/count

    ネットワークプロファイルに関連付けられた CLI テンプレートの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/globalIpAddressPools

    グローバル IP アドレスプールを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/ipam/globalIpAddressPools

    グローバル IP アドレスプールを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/globalIpAddressPools/${id}

    グローバル IP アドレスプールを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/ipam/globalIpAddressPools/${id}

    グローバル IP アドレスプールを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/ipam/globalIpAddressPools/${id}

    グローバル IP アドレスプールを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/globalIpAddressPools/${globalIpAddressPoolId}/subpools

    グローバル IP アドレスプールのサブプール ID を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/globalIpAddressPools/${globalIpAddressPoolId}/subpools/count

    グローバル IP アドレスプールのサブプールをカウントします。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/globalIpAddressPools/count

    グローバル IP アドレスプールをカウントします。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/siteIpAddressPools

    IP アドレスサブプールを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/ipam/siteIpAddressPools

    IP アドレスサブプールを予約(作成)します。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/siteIpAddressPools/${id}

    IP アドレスサブプールを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/ipam/siteIpAddressPools/{id}

    IP アドレスサブプールを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/ipam/siteIpAddressPools/{id}

    IP アドレスサブプールをリリースします。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/siteIpAddressPools/count

    IP アドレスサブプールをカウントします。

新しいネットワーク設定 API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[Network Settings] を選択します。

SD-Access API

Catalyst Center プラットフォーム は、次の SDA API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/sda/pendingFabricEvents

    保留中のファブリックイベントを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/sda/pendingFabricEvents/apply

    保留中のファブリックイベントを適用します。

  • GET <cluster-ip>/dna/data/api/v1/fabricSummary

    ファブリックエンティティの概要を読み取ります。

  • GET <cluster-ip>/dna/data/api/v1/fabricSiteHealthSummaries

    正常性の概要を含むファブリックサイトのリストを読み取ります。

  • GET <cluster-ip>/dna/data/api/v1/fabricSiteHealthSummaries/${id}

    ID から正常性概要を使用してファブリックサイトを読み取ります。

  • GET <cluster-ip>/dna/data/api/v1/fabricSiteHealthSummaries/${id}/trendAnalytics

    指定された時間範囲のファブリックサイトのトレンド分析データ。

  • GET <cluster-ip> /dna/data/api/v1/fabricSiteHealthSummaries/count

    ファブリックサイト数を読み取ります。

  • GET <cluster-ip> //dna/data/api/v1/virtualNetworkHealthSummaries

    正常性の概要を含む仮想ネットワークのリストを読み取ります。

  • GET <cluster-ip> /dna/data/api/v1/virtualNetworkHealthSummaries/${id}

    ID から仮想ネットワークの正常性概要を読み取ります。

  • GET <cluster-ip> /dna/data/api/v1/virtualNetworkHealthSummaries/count

    仮想ネットワーク数を読み取ります。

  • GET <cluster-ip> /dna/data/api/v1/virtualNetworkHealthSummaries/${id}/trendAnalytics

    指定された時間範囲の仮想ネットワークの傾向分析データ。

  • GET <cluster-ip> //dna/data/api/v1/transitNetworkHealthSummaries

    正常性の概要を含むトランジットネットワークのリストを読み取ります。

  • GET <cluster-ip> /dna/data/api/v1/transitNetworkHealthSummaries/${id}

    ID からトランジットネットワークの正常性概要を読み取ります。

  • GET <cluster-ip> /dna/data/api/v1/transitNetworkHealthSummaries/count

    トランジットネットワーク数を読み取ります。

  • GET <cluster-ip> /dna/data/api/v1/transitNetworkHealthSummaries/${id}/trendAnalytics

    指定された時間範囲のトランジットネットワークの傾向分析データ。

新しい SD-Access API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform > Developer Toolkit > APIs] の順に選択します。

[Connectivity] ドロップダウンリストを展開し、[SDA] を選択します。

センサー API

Catalyst Center プラットフォーム は、次のセンサー API をサポートしています。

  • GET <cluster-ip>/dna/data/api/v1/icap/captureFiles

    指定された条件に一致する ICAP パケットキャプチャファイルを一覧表示します。

  • GET <cluster-ip>/dna/data/api/v1/icap/captureFiles/count

    指定された条件に一致するパケットキャプチャファイルの総数を取得します。

  • GET <cluster-ip>/dna/data/api/v1/icap/captureFiles/${id}

    特定の ICAP パケットキャプチャファイルの詳細を取得します。

  • GET <cluster-ip>/dna/data/api/v1/icap/captureFiles/${id}/download

    特定の ICAP パケットキャプチャファイルをダウンロードします。

  • GET <cluster-ip>/dna/data/api/v1/icap/spectrumSensorReports

    指定された AP Mac の WLC によって送信されたスペクトルセンサーレポートを取得します。

  • GET <cluster-ip>/dna/data/api/v1/icap/spectrumInterferenceDeviceReports

    指定された AP Mac に関して WLC から送信されるスペクトル干渉デバイスレポートを取得します。

  • POST <cluster-ip>/dna/data/api/v1/icap/clients/${id}/stats

    指定された期間の特定のクライアントの統計情報を取得します。

  • POST <cluster-ip>/dna/data/api/v1/icap/radios/${id}/stats

    指定された期間の特定の無線統計情報を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/icapSettings/deploy

    指定された ICAP 設定インテントをプレビューなしで展開します。

  • POST <cluster-ip>/dna/intent/api/v1/icapSettings/deploy/${id}/deleteDeploy

    プレビューなしでデバイスの ICAP 設定を削除します。

  • POST <cluster-ip>/dna/intent/api/v1/icapSettings/configurationModels

    プレビュー承認用の ICAP 設定インテントを作成します。

  • POST <cluster-ip>/dna/intent/api/v1/icapSettings/configurationModels/${id}/deleteDeploy

    デバイス上の ICAP 設定を削除するための ICAP インテントのワークフローを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}/networkDeviceStatusDetails

    ネットワークデバイスごとに ICAP 設定ステータスを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}/networkDevices/${networkDeviceId}/config

    ICAP 設定インテントのデバイスの CLI を生成します。

  • GET <cluster-ip>/dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}/networkDevices/${networkDeviceId}/config

    ICAP インテントのデバイスの CLI を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}

    アクティビティ ID によって ICAP 設定インテントを破棄します。

  • DELETE <cluster-ip>/dna/intent/api/v1/icapSettings/configurationModels/${previewActivityId}/deploy

    アクティビティ ID によって ICAP 設定インテントを展開します。

  • GET <cluster-ip>/dna/intent/api/v1/icapSettings/deviceDeployments

    デバイス展開ステータスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/icapSettings/deviceDeployments/count

    デバイス展開ステータス数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/icapSettings

    基本的なフィルタリングをサポートしながら、展開された ICAP 設定を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/icapSettings/count

    展開された ICAP 設定の数を取得しますが、基本的なフィルタリングをサポートします。

新しいセンサー API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform > Developer Toolkit > APIs] の順に選択します。

[Know Your Network] ドロップダウンリストを展開し、[Sensors] を選択します。

サイト設計 API

Catalyst Center プラットフォーム は、次のサイト設計 API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v2/floors/${floorId}/accessPointPositions

    アクセスポイントの位置を取得します。

  • GET <cluster-ip>/dna/intent/api/v2/floors/${floorId}/accessPointPositions/count

    アクセスポイント位置数を取得します。

  • POST <cluster-ip>/dna/intent/api/v2/floors/${floorId}/accessPointPositions/bulkChange

    アクセスポイントの位置を編集します。

  • POST <cluster-ip>/dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/bulk

    計画されたアクセスポイントの位置を追加します。

  • POST <cluster-ip>/dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/bulkChange

    計画されたアクセスポイントの位置を編集します。

  • DELETE <cluster-ip>/dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/${id}

    計画されたアクセスポイントの位置を削除します。

  • GET <cluster-ip>/dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions

    計画されたアクセスポイントの位置を取得します。

  • GET <cluster-ip>/dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/count

    計画されたアクセスポイントの位置数を取得します。

  • POST <cluster-ip>/dna/intent/api/v2/floors/${floorId}/plannedAccessPointPositions/assignAccessPointPositions

    計画済みアクセスポイントを運用中のフロアに割り当てます。

新しいサイト設計 API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[Site Design] を選択します。

SWIM API

Catalyst Center プラットフォーム は、次の SWIM API をサポートしています。

  • POST <cluster-ip>/dna/intent/api/v1/images/ccoSync

    Cisco.com からソフトウェアイメージの同期を開始します。

  • GET <cluster-ip>dna/intent/api/v1/siteWiseImagesSummary

    指定されたサイトのイメージサマリーを返します。

  • DELETE <cluster-ip>/dna/intent/api/v1/images/${id}

    イメージを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/images/${id}/sites/${siteId}/tagGolden

    ゴールデンイメージにタグ付けします。

  • POST <cluster-ip>/dna/intent/api/v1/images/${id}/sites/${siteId}/untagGolden

    ゴールデンイメージのタグを解除します。

新しい SWIM API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[Software Image Management (SWIM)] を選択します。

タグ API

Catalyst Center プラットフォーム は、次のタグ API をサポートしています。

  • PUT <cluster-ip>/dna/intent/api/v1/tags/networkDevices/membersAssociations/bulk

    ネットワークデバイスに関連付けられているタグを更新します。

  • PUT <cluster-ip>/dna/intent/api/v1/tags/interfaces/membersAssociations/bulk

    インターフェイスに関連付けられたタグを更新します。

新しいタグ API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Operational Tasks] ドロップダウンリストを展開し、[Tag] を選択します。

タスク API

Catalyst Center プラットフォーム は、次のタスク API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/activities/${activityId}/triggeredJobs/count

    トリガーされたジョブの数をアクティビティ ID ごとに取得します。

  • GET <cluster-ip>/dna/intent/api/v1/activities

    アクティビティを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/activities/count

    アクティビティ数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/activities/${id}

    ID ごとにアクティビティを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/activities/${activityId}/triggeredJobs

    トリガーされたジョブをアクティビティ ID ごとに取得します。

新しいタスク API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Operational Tasks] ドロップダウンリストを展開し、[Task] を選択します。

ワイヤレス API

Catalyst Center プラットフォーム は、次のワイヤレス API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/anchorGroups

    アンカーグループを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessSettings/anchorGroups

    アンカーグループを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/anchorGroups/${id}

    ID ごとにアンカーグループを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessSettings/anchorGroups/${id}

    アンカーグループを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessSettings/anchorGroups/${id}

    ID ごとにアンカーグループを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/anchorGroups/count

    アンカーグループの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/anchorCapableDevices

    アンカー対応デバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/apAuthorizationLists

    AP 認証リストを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessSettings/apAuthorizationLists

    AP 認証リストを作成します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessSettings/apAuthorizationLists/${id}

    ID で AP 認証リストを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessSettings/apAuthorizationLists/${id}

    AP 認証リストを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessSettings/apAuthorizationLists/${id}

    AP 認証リストを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/apAuthorizationLists/count

    AP 承認リスト数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/${networkDeviceId}/apAuthorizationLists

    ネットワークデバイス ID で AP 認証リストを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/powerProfiles

    電力プロファイルを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessSettings/powerProfiles

    電力プロファイルの作成

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/powerProfiles/${id}

    ID で電力プロファイルを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessSettings/powerProfiles/${id}

    ID ごとに電力プロファイルを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessSettings/powerProfiles/${id}

    ID で電力プロファイルを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/powerProfiles/count

    電力プロファイル数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/meshApNeighbours

    メッシュ AP ネイバーを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/meshApNeighbours/count

    メッシュ AP ネイバー数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/${id}/update

    SSID を更新またはオーバーライドします。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/ssids/overrideAtSites

    SSID が上書きされているサイトを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/apProfiles

    AP プロファイルを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessSettings/apProfiles

    AP プロファイルの作成

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/apProfiles/${id}

    ID で AP プロファイルを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessSettings/apProfiles/${id}

    ID ごとに AP プロファイルを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessSettings/apProfiles/${id}

    ID ごとに AP プロファイルを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/apProfiles/count

    AP プロファイル数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/siteTags

    ワイヤレスプロファイルのすべてのサイトタグを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/siteTags/bulk

    ワイヤレスプロファイルの複数のサイトタグを一括で作成します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/siteTags/${siteTagId}

    ワイヤレスプロファイルの特定のサイトタグを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/siteTags/${siteTagId}

    ワイヤレスプロファイルの特定のサイトタグを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/siteTags/${siteTagId}

    ワイヤレスプロファイルから特定のサイトタグを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/siteTags/count

    ワイヤレスプロファイルのサイトタグの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/policyTags

    ワイヤレスプロファイルのすべてのポリシータグを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/policyTags/bulk

    ワイヤレスプロファイルの複数のポリシータグを一括で作成します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/policyTags/${policyTagId}

    ワイヤレスプロファイルの特定のポリシータグを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/policyTags/${policyTagId}

    ワイヤレスプロファイルの特定のポリシータグを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/policyTags/${policyTagId}

    ワイヤレスプロファイルから特定のポリシータグを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}/policyTags/count

    ワイヤレスプロファイルのポリシータグの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/${networkDeviceId}/assignAnchorManagedApLocations

    WLC の アンカー管理対象 AP の場所を割り当てます。

  • GET <cluster-ip>/dna/intent/api/v1/wireless/accesspoint-configuration/count

    アクセスポイント設定数を取得します。

新しいワイヤレス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Connectivity] ドロップダウンリストを展開して、[Wireless] を選択します。

ベータ版 API

有線 API

このリリースでは、Catalyst Center プラットフォーム には次の Campus Automation ベータ API が含まれています。

  • POST <cluster-ip>dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels

    有線デバイスの目的の設定の設定モデルを作成します。

  • PUT <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature}

    有線デバイス上の目的のレイヤ 2 機能の設定を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/deployed/layer2/${feature}

    有線デバイスに展開されたレイヤ 2 機能の設定を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/deployed/layer2/${feature}/count

    デバイスに展開されたレイヤ 2 機能の設定数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/deploy

    有線デバイスに目的の設定機能を展開します。

  • PUT <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2

    有線デバイスで、目的のレイヤ 2 機能の設定を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/supported/layer2

    有線デバイスでサポートされているレイヤ 2 機能を取得してください。

  • GET <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/serviceDeployments

    サービス展開ステータスを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/config

    設定モデルのデバイス設定を生成します。

  • POST <cluster-ip>/dna/intent/api/v1/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/deploy

    ネットワークデバイスに設定モデルを展開します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature}

    有線デバイスの目的のレイヤ 2 機能の設定を削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature}

    有線デバイスで目的のレイヤ 2 機能の設定を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}

    設定モデルを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature}

    有線デバイスで目的のレイヤ 2 機能の設定を作成します。

  • GET <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2/${feature}/count

    有線デバイス上の目的のレイヤ 2 機能の設定数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/configurationModels/${previewActivityId}/config

    設定モデルのデバイス設定を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2

    有線デバイスで目的のレイヤ 2 機能の設定を作成します。

  • GET <cluster-ip>/dna/intent/api/v1/wired/networkDevices/${networkDeviceId}/configFeatures/intended/deviceDeployments

    デバイス展開ステータスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/intent/api/v1/wired/networkDevices/${id}/configFeatures/intended/layer2

    有線デバイスで目的のレイヤ 2 機能の設定を取得します。

Wired API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform > Developer Toolkit > APIs] を選択します。

[Connectivity] ドロップダウンリストを展開して、[Wired] を選択します。

API の機能拡張

コンプライアンス API

このリリースでは、デバイス API のコンプライアンス詳細のリクエストクエリパラメータに statusremediationSupported プロパティが追加され、remediationSupported という新しい応答パラメータが導入されています。

デバイス API

次のデバイス API に、新しい応答属性 physicalPortCount および virtualPortCount が含まれます。

  • 指定されたデバイス ID(Uuid)のデバイスデータを取得します。

  • 指定されたクエリパラメータに基づいてネットワークデバイスの詳細を取得します。

  • 指定された複雑なフィルタと集約関数に基づいて、ネットワークデバイスのリストを取得します。

SD-Access API

  • ポートチャネル削除 API に、PortchannelIds および connectedDeviceType リクエストパラメータが含まれます。networkDeviceId パラメータがオプションになりました。

  • このリリースでは、isGlobalAuthenticationProfile という新しいリクエストパラメータが Get Authentication Profiles API に追加されます。

  • fabricId リクエスト属性が、Get Authentication Profiles および Update Authentication Profiles API でオプションになりました。

ワイヤレス API

このリリースでは、以下の通りです。
  • anchorGroupNamevlanGroupNameadditionalInterfacesapZonesapZoneNamerfProfileName、および ssids 属性は、Update Wireless Profile、Create Wireless Profile、Get Wireless Profiles、および Get Wireless Profile by ID API に含まれています。

  • provisioningStatus と呼ばれる新しい応答パラメータが、Get Access Point Configuration API に含まれています。

廃止された API

サンセットバナーは、特定の API が廃止されることを示します。

(注)  

 

代替の API がある場合、詳細はそれぞれの廃止された API の [Features] タブに記載されています。

ディスカバリ API

このリリースでは、次のディスカバリ API がサンセットとしてマークされています。

POST <cluster-ip>/dna/intent/api/v1/discovery

すべてのディスカバリを削除します。

イベント管理 API

このリリースでは、次のイベント管理 API が「Sunset」としてマークされ、対応する新しい API がサポートされています。

廃止された API

新しい API

POST <cluster-ip>/dna/intent/api/v1/event/subscription

イベントサブスクリプションを作成します。

POST <cluster-ip>/dna/intent/api/v1/event/subscription/rest

Rest/ウェブフック イベントサブスクリプションを作成します。

PUT <cluster-ip>/dna/intent/api/v1/event/subscription

イベントサブスクリプションを更新します。

PUT <cluster-ip>/dna/intent/api/v1/event/subscription/rest

Rest/ウェブフック イベントサブスクリプションを取得します。

GET <cluster-ip>/dna/intent/api/v1/event/subscription

イベントサブスクリプションを取得します。

GET <cluster-ip>/dna/intent/api/v1/event/subscription/rest

Rest/ウェブフック イベントサブスクリプションを取得します。

ネットワーク設定 API

このリリースでは、次のネットワーク設定 API が廃止されます。

  • POST <cluster-ip>/dna/intent/api/v1/global-pool

    グローバルプールを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/global-pool

    グローバルプールを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/global-pool

    グローバルプールを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/global-pool/${id}

    グローバル IP プールを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/reserve-ip-subpool/${siteId}

    IP サブプールを予約します。

  • GET <cluster-ip>/dna/intent/api/v1/reserve-ip-subpool

    予約済み IP サブプールを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/reserve-ip-subpool/${siteId}

    予約済み IP サブプールを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/reserve-ip-subpool/${id}

    予約済み IP サブプールをリリースします。

SD-Access API

このリリースでは、次の SD-Access ビジネス API が廃止されます。

ファブリック作成 API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/fabric

    ファブリックサイトを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/fabric

    SDA ファブリック情報を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/fabric

    SDA ファブリックを削除します。

SDA ファブリック API のファブリックサイト
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/fabric-site

    SDA ファブリックにサイトを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/fabric-site

    SDA ファブリックからサイトを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/fabric-site

    SDA ファブリックからサイトを削除します。

SDA ファブリック API のファブリックゾーン
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/fabric-zone

    SDA ファブリックにファブリックゾーンを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/fabric-zone

    SDA ファブリックからファブリックゾーンを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/fabric-zone

    SDA ファブリックからファブリックゾーンを削除します。

コントロールプレーンデバイス API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/control-plane-device

    コントロールプレーンデバイスを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/control-plane-device

    コントロールプレーンデバイスを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/control-plane-device

    SDA ファブリックのコントロールプレーンデバイスを削除します。

エッジデバイスロール割り当て API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/edge-device

    エッジデバイスを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/edge-device

    エッジデバイスを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/edge-device

    エッジデバイスを削除します。

ボーダーデバイスロール割り当て API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/border-device

    SDA ファブリックにボーダーデバイスを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/border-device

    SDA ファブリックからボーダーデバイスの詳細を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/border-device

    SDA ファブリックからボーダーデバイスを削除します。

デフォルト認証テンプレート(プロファイル)API
  • PUT <cluster-ip>/dna/intent/api/v1/business/sda/authentication-profile

    デフォルト認証プロファイルを更新します。

  • POST <cluster-ip>/dna/intent/api/v1/business/sda/authentication-profile

    デフォルト認証プロファイルを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/authentication-profile

    デフォルト認証プロファイルを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/authentication-profile

    デフォルト認証プロファイルを削除します。

仮想ネットワーク作成 API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/virtual-network

    SDA ファブリックに VN を追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/virtual-network

    SDA ファブリックから VN を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/virtual-network

    SDA ファブリックから VN を削除します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/virtual-network/summary

    仮想ネットワークの概要を取得します。

SDA セグメント API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/virtualnetwork/ippool

    SDA 仮想ネットワークに IP プールを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/virtualnetwork/ippool

    SDA 仮想ネットワークから IP プールを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/virtualnetwork/ippool

    SDA 仮想ネットワークから IP プールを削除します。

ユーザーデバイスのポート割り当て API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/user-device

    ユーザーデバイスのポート割り当てを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/user-device

    ユーザーデバイスのポート割り当てを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/user-device

    ユーザーデバイスのポート割り当てを削除します。

アクセスポイントへのポート割り当て API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/access-point

    アクセスポイントのポート割り当てを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/access-point

    アクセスポイントのポート割り当てを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/access-point

    アクセスポイントのポート割り当てを削除します。

SDA マルチキャスト API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/multicast

    マルチキャストを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/multicast

    マルチキャストを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/multicast

    マルチキャストを削除します。

有線デバイスプロビジョニング API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/provision-device

    有線デバイスをプロビジョニングします。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/provision-device

    プロビジョニングされた有線デバイスを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/provision-device

    プロビジョニングされた有線デバイスを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/business/sda/provision-device

    有線デバイスを再プロビジョニングします。

仮想ネットワーク API
  • POST <cluster-ip>/dna/intent/api/v1/virtual-network

    スケーラブルグループを含む仮想ネットワークを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/virtual-network

    スケーラブルグループを含む仮想ネットワークを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/virtual-network

    スケーラブルグループを含む仮想ネットワークを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/virtual-network

    スケーラブルグループを使用して仮想ネットワークを更新します。

トランジットネットワークおよびピアネットワーク API
  • POST <cluster-ip>/dna/intent/api/v1/business/sda/transit-peer-network

    トランジットピアネットワークを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/transit-peer-network

    トランジットピアネットワークを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/transit-peer-network

    トランジットピアネットワークを削除します。

SDA ファブリック API からのデバイス情報の取得
  • GET <cluster-ip>/dna/intent/api/v1/business/sda/device

    SDA ファブリックからデバイス情報を取得します。

指定されたデバイス API の SDA デバイスロールを取得する
  • GET <cluster-ip>/dna/intent/api/v1/business/sda/device/role

    SDA ファブリックでデバイスロールを取得します。

ファブリック数の取得 - Cyclops API
  • GET <cluster-ip>/dna/intent/api/v1/business/sda/fabric/count

    SDA ファブリック数を取得します。

セキュリティアドバイザリ API

このリリースでは、次のセキュリティアドバイザリ API が廃止予定としてマークされています。

  • GET <cluster-ip>/dna/intent/api/v1/security-advisory/advisory/aggregate

    アドバイザリの概要を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/security-advisory/device/${deviceId}

    アドバイザリデバイスの詳細を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/security-advisory/advisory

    アドバイザリリストを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/security-advisory/device/${deviceId}/advisory

    デバイスごとにアドバイザリを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/security-advisory/advisory/${advisoryId}/device

    アドバイザリごとにデバイスを取得します。

SWIM API

このリリースでは、次の SWIM API が廃止予定としてマークされています。

  • GET <cluster-ip>/dna/intent/api/v1/image/importation

    ソフトウェアイメージの詳細を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/image/importation/device-family-identifiers

    デバイスファミリ識別子を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/image/importation/golden

    ゴールデンイメージとしてタグ付けします。

  • GET <cluster-ip>/dna/intent/api/v1/image/importation/golden/site/${siteId}/family/${deviceFamilyIdentifier}/role/${deviceRole}/image/${imageId}Swagger doc

    イメージのゴールデンタグステータスを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/image/importation/golden/site/${siteId}/family/${deviceFamilyIdentifier}/role/${deviceRole}/image/${imageId}

    イメージのゴールデンタグを削除します。

後方互換性を損なう API の変更

なし

表 3. Catalyst Center プラットフォーム リリース 2.3.7.6 の新機能および変更された機能
機能 説明

Catalyst Center アプリへの名前変更

ServiceNow ストアの Cisco DNA Center アプリは、アプリバージョン 2.3.1 以降、Catalyst Center にブランド変更されています。

アプリケーションの以前のバージョンは Cisco DNA Center と呼ばれます。これらのバージョンは、対応する Catalyst Center リリースで引き続き使用できます。

新しい API

シスコの信頼できる証明書 API

Catalyst Center プラットフォーム は、次の信頼できる証明書のインポート API をサポートしています。

  • POST <cluster-ip>/dna/intent/api/v1/trustedCertificates/import

    信頼できる証明書をトラストストアにインポートします。.pem または .der ファイルを入力として受け入れます。

新しい信頼できる証明書のインポート API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[System] ドロップダウンリストを展開し、[Cisco Trusted Certificates] を選択します。

クライアント API

Catalyst Center プラットフォーム は、次のクライアント API をサポートしています。

  • GET <cluster-ip>/dna/data/api/v1/clients

    基本的なフィルタ処理機能とソート機能も提供しながら、クライアントのリストを取得します。

  • GET <cluster-ip>/dna/data/api/v1/clients/${id}

    MAC アドレスに一致する特定のクライアント情報を取得します。

  • GET <cluster-ip>/dna/data/api/v1/clients/count

    基本的なフィルタ処理を適用して、クライアントの合計数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/clients/query

    集約属性もサポートしながら、複雑なフィルタを適用してクライアントのリストを取得します。

  • POST <cluster-ip>/dna/data/api/v1/clients/query/count

    複雑なフィルタを適用してクライアントの数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/clients/trendAnalytics

    クライアントに関連するトレンド分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/clients/${id}/trendAnalytics

    指定された期間の特定のクライアント情報を取得します。

  • POST <cluster-ip>/dna/data/api/v1/clients/summaryAnalytics

    クライアントに関連するサマリー分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/clients/topNAnalytics

    クライアントに関連する上位 N 個の分析データを取得します。

新しいクライアント API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Know Your Network] ドロップダウンリストを展開し、[Clients] を選択します。

コンプライアンス API

Catalyst Center プラットフォーム は、次のコンプライアンス API をサポートしています。

  • POST <cluster-ip>/dna/intent/api/v1/compliance/networkDevices/${id}/issues/remediation/provision

    コンプライアンス改善。

新しいコンプライアンス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Know Your Network] ドロップダウンリストを展開し、[Compliance] を選択します。

デバイス API

Catalyst Center プラットフォーム は、次のデバイス API をサポートしています。

  • PUT <cluster-ip>/dna/intent/api/v1/networkDevices/resyncIntervalSettings

    グローバル再同期間隔を更新します。

  • PUT <cluster-ip>/dna/intent/api/v1/networkDevices/${id}/resyncIntervalSettings

    ネットワークデバイスの再同期間隔を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/${id}/resyncIntervalSettings

    ネットワークデバイスの再同期間隔を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/networkDevices/resyncIntervalSettings/override

    再同期間隔をオーバーライドします。

  • GET <cluster-ip>/dna/data/api/v1/assuranceEvents

    アシュアランスイベントを照会します。

  • GET <cluster-ip>/dna/data/api/v1/assuranceEvents/count

    イベント数を数えます。

  • GET <cluster-ip>/dna/data/api/v1/assuranceEvents/${id}

    単一のアシュアランスイベントの詳細を取得します。

  • GET <cluster-ip>/dna/data/api/v1/assuranceEvents/${id}/childEvents

    指定されたワイヤレス クライアント イベントの子イベントのリストを取得します。

  • POST <cluster-ip>/dna/data/api/v1/assuranceEvents/query

    フィルタを使用してアシュアランスイベントを照会します。

  • POST <cluster-ip>/dna/data/api/v1/assuranceEvents/query/count

    フィルタを使用してイベント数を数えます。

  • PUT <cluster-ip>/dna/intent/api/v1/healthScoreDefinitions/${id}

    指定された ID の正常性スコア定義を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/healthScoreDefinitions

    指定されたフィルタのすべての正常性スコア定義を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/healthScoreDefinitions/${id}

    指定された ID の正常性スコア定義を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/healthScoreDefinitions/count

    指定されたフィルタに基づいて正常性スコア定義の数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/healthScoreDefinitions/bulkUpdate

    正常性スコア定義を更新します。

  • GET <cluster-ip>/dna/data/api/v1/networkDevices

    指定されたクエリパラメータに基づいてネットワークデバイスの詳細を取得します。

  • GET <cluster-ip>/dna/data/api/v1/networkDevices/{id}

    指定されたデバイス ID(Uuid)のデバイスデータを取得します。

  • GET <cluster-ip>/dna/data/api/v1/networkDevices/count

    指定されたクエリパラメータに基づいてネットワークデバイスの総数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/networkDevices/query

    指定された複雑なフィルタと集約関数に基づいて、ネットワークデバイスのリストを取得します。

  • POST <cluster-ip>/dna/data/api/v1/networkDevices/query/count

    指定された複雑なフィルタと集約関数に基づいて、ネットワークデバイスの総数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/networkDevices/trendAnalytics

    トレンド分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/networkDevices/${id}/trendAnalytics

    指定した時間範囲のネットワークデバイスのトレンド分析データ。

  • POST <cluster-ip>/dna/data/api/v1/networkDevices/summaryAnalytics

    ネットワークデバイスに関連するサマリー分析データを取得します。

  • GET <cluster-ip>/dna/data/api/v1/interfaces

    すべてのネットワークデバイスからインターフェイスと統計データを取得します。

  • GET <cluster-ip>/dna/data/api/v1/interfaces/${id}

    指定されたインターフェイス ID(インスタンス Uuid)のインターフェイスデータを統計データとともに取得します。

  • GET <cluster-ip>/dna/data/api/v1/interfaces/count

    指定した時間範囲のネットワーク デバイス インターフェイスの総数を取得します。開始時刻と終了時刻が指定されていない場合は、最新のインターフェイスの総数を返します。

  • POST <cluster-ip>/dna/data/api/v1/interfaces/query

    指定された複雑なフィルタと集約関数に基づいて、ネットワークデバイス全体のインターフェイスのリストを取得します。

  • POST <cluster-ip>/dna/data/api/v1/interfaces/query/count

    ネットワークデバイス全体のインターフェイスの総数。

新しいデバイス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Know Your Network] ドロップダウンリストを展開し、[Devices] を選択します。

ファブリックワイヤレス API

Catalyst Center プラットフォーム は、次のファブリックワイヤレス API をサポートしています。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/fabrics/${fabricId}/vlanToSsids

    VLAN への SSID マッピングを追加、更新、または削除します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabrics/vlanToSsids/count

    SSID から IP プールへのマッピングを持つすべてのファブリックサイトの数を返します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabrics/vlanToSsids

    VLAN から SSID へのマッピングを持つすべてのファブリックサイトを返します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabrics/${fabricId}/vlanToSsids/count

    ファブリックサイトのSSIDにマッピングされている VLAN の数を返します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabrics/${fabricId}/vlanToSsids

    ファブリックサイト内の VLAN にマッピングされている VLAN と SSID を取得します。

新しいファブリックワイヤレス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Connectivity] ドロップダウンリストを展開して、[Fabric Wireless] を選択します。

正常性およびパフォーマンス API

Catalyst Center プラットフォーム は、次の正常性およびパフォーマンス API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/diagnosticValidationSets

    すべての検証セットを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/diagnosticValidationSets/${id}

    検証セットの検証の詳細を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/diagnosticValidationWorkflows/count

    検証ワークフローの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/diagnosticValidationWorkflows/${id}

    検証ワークフローの詳細を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/diagnosticValidationWorkflows

    検証ワークフローのリストを取得します。

  • POST <cluster-ip>/dna/ intent/api/v1/diagnosticValidationWorkflows

    検証を実行するためのワークフローを送信します。

  • DELETE <cluster-ip>/dna/intent/api/v1/diagnosticValidationWorkflows/${id}

    検証ワークフローを削除します。

新しい正常性およびパフォーマンス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Cisco DNA Center System] ドロップダウンリストを展開し、[Health and Performance] を選択します。

問題 API

Catalyst Center プラットフォーム は、次の問題 API をサポートしています。

  • GET <cluster-ip>/dna/data/api/v1/assuranceIssues

    指定された一連のフィルタの問題の詳細を取得します。

  • GET <cluster-ip>/dna/data/api/v1/assuranceIssues/${id}

    指定された問題 ID の問題のすべての詳細と推奨されるアクションを取得します。

  • GET <cluster-ip>/dna/data/api/v1/assuranceIssues/count

    指定された一連のフィルタの問題の総数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/assuranceIssues/query

    指定された一連のフィルタの問題の詳細を取得します。

  • POST <cluster-ip>/dna/data/api/v1/assuranceIssues/query/count

    指定された一連のフィルタの問題の総数を取得します。

  • POST <cluster-ip>/dna/data/api/v1/assuranceIssues/topNAnalytics

    問題の上位 N 個の分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/assuranceIssues/summaryAnalytics

    問題の概要分析データを取得します。

  • POST <cluster-ip>/dna/data/api/v1/assuranceIssues/trendAnalytics

    問題のトレンド分析データを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/assuranceIssues/resolve

    指定された問題のリストを解決します。

  • POST <cluster-ip>/dna/intent/api/v1/assuranceIssues/ignore

    指定された問題のリストを無視します。

  • POST <cluster-ip>/dna/intent/api/v1/assuranceIssues/${id}/update

    選択したフィールドを更新して、指定された問題を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/customIssueDefinitions

    指定されたフィルタに基づいてすべてのカスタム問題定義を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/customIssueDefinitions

    新しいユーザー定義の問題定義を作成します。

  • GET <cluster-ip>/dna/intent/api/v1/customIssueDefinitions/count

    指定されたフィルタに基づいて、カスタム問題定義の総数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/customIssueDefinitions/${id}

    指定されたカスタム問題定義 ID のカスタム問題定義を取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/customIssueDefinitions/${id}

    指定された ID に基づいて既存のカスタム問題定義を更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/customIssueDefinitions/${id}

    既存のカスタム問題定義を削除します。

  • GET <cluster-ip>/dna/intent/api/v1/systemIssueDefinitions

    指定されたフィルタのすべての問題トリガー定義を返します。

  • GET <cluster-ip>/dna/intent/api/v1/systemIssueDefinitions/${id}

    指定された ID の問題トリガー定義を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/systemIssueDefinitions/count

    指定されたフィルタに基づいて、システム定義の問題定義の数を取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/systemIssueDefinitions/${id}

    問題トリガー定義を更新します。

新しい問題 API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Know Your Network] ドロップダウンリストを展開し、[Issues] を選択します。

ライセンス API

Catalyst Center プラットフォーム は、次のライセンス API をサポートしています。

  • PUT <cluster-ip>/dna/intent/api/v1/licenseSetting

    ライセンス設定を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/licenseSetting

    ライセンス設定を取得します。

新しいライセンス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Cisco DNA Center System] ドロップダウンリストを展開し、[Licenses] を選択します。

ネットワーク設定 API

Catalyst Center プラットフォーム は、次のネットワーク設定 API をサポートしています。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/{id}/timeZoneSettings

    サイトのタイムゾーンを設定します。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/{id}/bannerSettings

    サイトのバナー設定を行います。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${id}/telemetrySettings

    サイトのテレメトリ設定を取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/${id}/telemetrySettings

    サイトのテレメトリ設定を行います。

  • POST <cluster-ip>/dna/intent/api/v1/telemetrySettings/apply

    サイトのテレメトリ設定に準拠するようにデバイスのテレメトリ設定を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${id}/deviceCredentials

    サイトのデバイスログイン情報の設定を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${id}/deviceCredentials/status

    指定されたサイトでネットワークデバイスのログイン情報の同期ステータスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/deviceCredentials/apply

    ネットワークデバイスのログイン情報を同期します。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/${id}/deviceCredentials

    サイトのデバイスログイン情報の設定を更新します。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/${id}/aaaSettings

    サイトの AAA 設定を行います。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/${id}/dnsSettings

    サイトの DNS 設定を行います。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/${id}/dhcpSettings

    サイトの DHCP 設定を行います。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/${id}/ntpSettings

    サイトの NTP 設定を行います。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/${id}/imageDistributionSettings

    サイトのイメージ配信設定を行います。

  • GET<cluster-ip>/dna/intent/api/v1/sites/${id}/aaaSettings

    サイトの AAA 設定を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${id}/dnsSettings

    サイトの DNS 設定を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${id}/dhcpSettings

    サイトの DHCP 設定を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${id}/ntpSettings

    サイトの NTP 設定を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${id}/imageDistributionSettings

    サイトのイメージ配信設定を取得します。

新しいネットワーク設定 API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[Network Settings] を選択します。

SDA API

Catalyst Center プラットフォーム は、次の SDA API をサポートしています。

エクストラネット API

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/extranetPolicies

    エクストラネットポリシーを削除します。

マルチキャスト API

  • GET <cluster-ip>/dna/intent/api/v1/sda/multicast/virtualNetworks

    マルチキャスト仮想ネットワークを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/multicast

    マルチキャストを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/multicast/virtualNetworks

    マルチキャスト仮想ネットワークを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/multicast/virtualNetworks/count

    マルチキャスト仮想ネットワーク数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/multicast/virtualNetworks/${id}

    ID でマルチキャスト仮想ネットワークを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/sda/multicast/virtualNetworks

    マルチキャスト仮想ネットワークを追加します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/multicast

    マルチキャストを更新します。

ポートチャネル API

  • POST <cluster-ip>/dna/intent/api/v1/sda/portChannels

    ポートチャネルを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/portChannels

    ポートチャネルを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/portChannels

    ポートチャネルを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/portChannels

    ポートチャネルを削除します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/portChannels/{id}

    ID でポートチャネルを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/portChannels/count

    ポートチャネル数を取得します。

トランジットネットワーク API

  • GET <cluster-ip>/dna/intent/api/v1/sda/transitNetworks

    トランジットネットワークを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/sda/transitNetworks

    トランジットネットワークを追加します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/transitNetworks

    トランジットネットワークを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/transitNetworks/${id}

    ID でトランジットネットワークを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/transitNetworks/count

    トランジットネットワーク数を取得します。

レイヤ 2 仮想ネットワーク API

  • PUT <cluster-ip>/dna/intent/api/v1/sda/layer2VirtualNetworks

    レイヤ 2 仮想ネットワークを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/layer2VirtualNetworks/count

    レイヤ 2 仮想ネットワーク数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/layer2VirtualNetworks/${id}

    ID でレイヤ 2 仮想ネットワークを削除します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/layer2VirtualNetworks

    レイヤ 2 仮想ネットワークを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/sda/layer2VirtualNetworks

    レイヤ 2 仮想ネットワークを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/layer2VirtualNetworks

    レイヤ 2 仮想ネットワークを取得します。

レイヤ 3 仮想ネットワーク API

  • POST <cluster-ip>/dna/intent/api/v1/sda/layer3VirtualNetworks

    レイヤ 3 仮想ネットワークを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/layer3VirtualNetworks

    レイヤ 3 仮想ネットワークを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/layer3VirtualNetworks

    レイヤ 3 仮想ネットワークを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/layer3VirtualNetworks

    レイヤ 3 仮想ネットワークを削除します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/layer3VirtualNetworks/${id}

    ID でレイヤ 3 仮想ネットワークを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/layer3VirtualNetworks/count

    レイヤ 3 仮想ネットワーク数を取得します。

新しい SDA API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Connectivity] ドロップダウンリストを展開し、[SDA] を選択します。

サイト API

Catalyst Center プラットフォーム は、次のサイト API をサポートしています。

  • GET <cluster-ip>/dna/data/api/v1/siteHealthSummaries

    サイトの正常性の概要のリストを読み取ります。

  • GET <cluster-ip>/dna/data/api/v1/siteHealthSummaries/${id}

    サイト ID でサイトの正常性の概要データを読み取ります。

  • GET <cluster-ip>/dna/data/api/v1/siteHealthSummaries/count

    サイト数を読み取ります。

  • GET <cluster-ip>/dna/data/api/v1/siteHealthSummaries/summaryAnalytics

    サイトの正常性データの集約された概要を読み取ります。

  • POST <cluster-ip>/dna/data/api/v1/siteHealthSummaries/summaryAnalytics

    サイトの正常性データの集約された概要を照会します。

  • GET <cluster-ip>/dna/data/api/v1/siteHealthSummaries/trendAnalytics

    ネットワーク内のサイトのグループに関するトレンド分析データを読み取ります。

  • GET <cluster-ip>/dna/data/api/v1/siteHealthSummaries/${id}/trendAnalytics

    ネットワーク内の特定のサイトのトレンド分析データを読み取ります。

新しいサイト API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Know Your Network] ドロップダウンリストを展開し、[Sites] を選択します。

サイト設計 API

Catalyst Center プラットフォーム は、次のサイト設計 API をサポートしています。

  • POST <cluster-ip>/dna/intent/api/v1/areas

    エリアを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/areas/${id}

    エリアを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/areas/${id}

    エリアを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/areas/${id}

    エリアを削除します。

  • POST <cluster-ip>/dna/intent/api/v2/buildings

    ビルディングを作成します。

  • GET <cluster-ip>/dna/intent/api/v2/buildings/${id}

    ビルディングを取得します。

  • PUT <cluster-ip>/dna/intent/api/v2/buildings/${id}

    ビルディングを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v2/buildings/${id}

    ビルディングを削除します。

  • POST <cluster-ip>/dna/intent/api/v2/floors

    フロアを作成します。

  • GET <cluster-ip>/dna/intent/api/v2/floors/${id}

    フロアを取得します。

  • PUT <cluster-ip>/dna/intent/api/v2/floors/${id}

    フロアを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v2/floors/${id}

    フロアを削除します。

  • POST <cluster-ip>/dna/intent/api/v2/floors/${id}/uploadImage

    フロア画像をアップロードします。

  • POST <cluster-ip>/dna/intent/api/v1/sites/bulk

    サイトを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/sites

    サイトを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/count

    サイト数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/networkDevices/assignToSite/apply

    ネットワークデバイスをサイトに割り当てます。

  • POST <cluster-ip>/dna/intent/api/v1/networkDevices/unassignFromSite/apply

    サイトからネットワークデバイスの割り当てを解除します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/assignedToSite

    サイトに割り当てられたネットワークデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/assignedToSite/count

    サイトに割り当てられたネットワークデバイス数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/notAssignedToSite

    サイトに割り当てられていないネットワークデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/${id}/assignedToSite

    サイトに割り当てられたネットワークデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/notAssignedToSite/count

    サイトに割り当てられていないネットワークデバイス数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDevices/deviceControllability/settings

    デバイスの可制御性設定を取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/networkDevices/deviceControllability/settings

    デバイスの可制御性設定を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/networkProfilesforSites

    サイトのネットワークプロファイルのリストを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkProfilesforSites/count

    サイトのネットワークプロファイル数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkProfilesforSites/${id}

    ID でサイトのネットワークプロファイルを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/networkProfilesforSites/${id}

    サイトのネットワークプロファイルを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments

    サイトの指定されたネットワークプロファイルが割り当てられているサイトのリストを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments

    サイトのネットワークプロファイルを指定されたサイトに割り当てます。

  • POST <cluster-ip>/dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments/bulk

    サイトのネットワークプロファイルをサイトのリストに割り当てます。

  • DELETE <cluster-ip>/dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments/bulk

    複数のサイトからサイトのネットワークプロファイルの割り当てを解除します。

  • DELETE <cluster-ip>/dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments/${id}

    1 つのサイトからサイトのネットワークプロファイルの割り当てを解除します。

  • GET <cluster-ip>/dna/intent/api/v1/networkProfilesForSites/${profileId}/siteAssignments/count

    サイトの指定されたネットワークプロファイルが割り当てられているサイトの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${siteId}/profileAssignments

    指定されたサイトに割り当てられているネットワークプロファイルのリストを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${siteId}/profileAssignments/count

    指定されたサイトに割り当てられているプロファイルの数を取得します。

新しいサイト設計 API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[Site Design] を選択します。

SWIM API

Catalyst Center プラットフォーム は、次の SWIM API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/images

    ソフトウェアイメージのリストを返します。

  • POST <cluster-ip>/dna/intent/api/v1/images/${id}/download

    ソフトウェアイメージをダウンロードします。

  • GET <cluster-ip>/dna/intent/api/v1/productNames

    ネットワークデバイス製品名のリストを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/productNames/count

    ネットワーク製品名の数。

  • GET <cluster-ip>/dna/intent/api/v1/productNames/${productNameOrdinal}

    ネットワークデバイスの製品名を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/siteWiseProductNames

    サイトのネットワークデバイス製品名を返します。

  • POST <cluster-ip>/dna/intent/api/v1/images/${imageId}/siteWiseProductNames

    指定されたソフトウェアイメージにネットワークデバイスの製品名を割り当てます。

  • GET <cluster-ip>/dna/intent/api/v1/siteWiseProductNames/count

    サイトのネットワークデバイス製品名の数を返します。

  • DELETE <cluster-ip>/dna/intent/api/v1/images/${imageId}/siteWiseProductNames/${productNameOrdinal}

    指定されたソフトウェアイメージからネットワークデバイス製品名の割り当てを解除します。

  • PUT <cluster-ip>/dna/intent/api/v1/images/${imageId}/siteWiseProductNames/${productNameOrdinal}

    ソフトウェアイメージに割り当てられているネットワークデバイス製品名のサイトのリストを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/images/count

    ソフトウェアイメージの数を返します。

  • GET <cluster-ip>dna/intent/api/v1/images/${id}/addonImages/count

    追加イメージの数を返します。

  • GET <cluster-ip>/dna/intent/api/v1/images/distributionServerSettings

    イメージ配信サーバーを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/images/distributionServerSettings

    イメージ配信サーバーを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/images/distributionServerSettings/${id}

    特定のイメージ配信サーバーを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/images/distributionServerSettings/${id}

    リモートイメージ配信サーバーを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/images/distributionServerSettings/${id}

    イメージ配信サーバーを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceImageUpdates

    ネットワークデバイスイメージの更新を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/networkDeviceImageUpdates/count

    ネットワークデバイスイメージの更新数。

  • GET <cluster-ip>/dna/intent/api/v1/images/${imageId}/siteWiseProductNames

    ソフトウェアイメージに割り当てられているネットワークデバイス製品名を取得します

  • GET <cluster-ip>/dna/intent/api/v1/siteWiseProductNames/count

    サイトのネットワークデバイス製品名の数を返します。

新しい SWIM API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[Software Image Management (SWIM)] を選択します。

システム設定 API

Catalyst Center プラットフォーム は、次のシステム設定 API をサポートしています。

  • POST <cluster-ip>/dna/intent/api/v1/ipam/serverSetting

    外部 IPAM サーバーの設定の詳細を作成します。外部 IPAM サーバーは 1 つしか作成できません。新しいものを作成する前に、既存の外部サーバーを削除してください。

  • GET <cluster-ip>/dna/intent/api/v1/ipam/serverSetting

    外部 IPAM サーバーの設定の詳細を取得します。外部 IPAM サーバーが作成されていない場合、このリソースは「404」応答を返します。

  • PUT <cluster-ip>/dna/intent/api/v1/ipam/serverSetting

    外部 IPAM サーバーの設定の詳細を更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/ipam/serverSetting

    外部 IPAM サーバーの設定の詳細を削除します。

  • GET <cluster-ip>/dna/intent/api/v1/provisioningSettings

    プロビジョニング設定を取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/provisioningSettings

    プロビジョニング設定を行います。

新しいシステム設定 API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

下にスクロールし、[System Settings] をクリックします。

タスク API

Catalyst Center プラットフォーム は、次のタスク API をサポートしています。

  • GET<cluster-ip>/dna/intent/api/v1/tasks

    タスクを取得します。

  • GET<cluster-ip>/dna/intent/api/v1/tasks/count

    タスク数を取得します。

  • GET<cluster-ip>/dna/intent/api/v1/tasks/${id}

    ID でタスクを取得します。

  • GET<cluster-ip>/dna/intent/api/v1/tasks/${id}/detail

    ID でタスクの詳細を取得します。

  • GET <cluster-ip>/dna/data/api/v1/assuranceTasks/${id}

    特定のアシュアランスタスクを ID ごとに取得します。

  • GET <cluster-ip>/dna/data/api/v1/assuranceTasks/count

    現在存在するアシュアランスタスクの数を取得します。

  • GET <cluster-ip>/dna/data/api/v1/assuranceTasks

    アシュアランスタスクのリストを取得します。

新しいタスク API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Operational Tasks] ドロップダウンリストを展開し、[Task] を選択します。

タグ API

Catalyst Center プラットフォーム は、次のタグ API をサポートしています。

  • GET <cluster-ip>/dna/intent/api/v1/tags/networkDevices/membersAssociations

    ネットワークデバイスに関連付けられているタグを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/tags/interfaces/membersAssociations/count

    少なくとも 1 つのタグに関連付けられているインターフェイスの数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/tags/networkDevices/membersAssociations/count

    少なくとも 1 つのタグに関連付けられているネットワークデバイスの数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/tags/networkDevices/membersAssociations/query

    ネットワークデバイスに関連付けられているタグを照会します。

  • POST <cluster-ip>/dna/intent/api/v1/tags/interfaces/membersAssociations/query

    インターフェイスに関連付けられているタグを照会します。

  • GET <cluster-ip>/dna/intent/api/v1/tags/interfaces/membersAssociations

    インターフェイスに関連付けられているタグを取得します。

新しいタグ API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Operational Tasks] ドロップダウンリストを展開し、[Tag] を選択します。

ワイヤレス API

このリリースでは、Catalyst Center プラットフォーム では次の新しいワイヤレス API が導入されました。

(注)  

 

新しいワイヤレス API は Cisco AireOS ワイヤレスコントローラ をサポートしていません。サポートは、Cisco Catalyst 9800 ファミリのデバイスにのみ拡張されます。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/${networkDeviceId}/anchorManagedApLocations

    特定のワイヤレスコントローラのアンカー管理対象 AP の場所を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/${networkDeviceId}/managedApLocations/count

    特定のワイヤレスコントローラの管理対象 AP の場所の数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/${networkDeviceId}/primaryManagedApLocations

    特定のワイヤレスコントローラのプライマリ管理対象 AP の場所を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/${networkDeviceId}/secondaryManagedApLocations

    特定のワイヤレスコントローラのセカンダリ管理対象 AP の場所を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/wirelessMobilityGroups/count

    モビリティグループ数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/wirelessMobilityGroups

    すべてのモビリティグループを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessControllers/wirelessMobilityGroups/mobilityProvision

    モビリティのプロビジョニング。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessControllers/wirelessMobilityGroups/mobilityReset

    モビリティのリセット。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/${networkDeviceId}/ssidDetails

    特定のワイヤレスコントローラの SSID の詳細を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessControllers/${networkDeviceId}/ssidDetails/count

    特定のワイヤレスコントローラの SSID 数を取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessSettings/interfaces/${id}

    インターフェイスを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessSettings/interfaces/${id}

    インターフェイスを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/interfaces

    インターフェイスを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessSettings/interfaces

    インターフェイスを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/interfaces/${id}

    ID でインターフェイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/interfaces/count

    インターフェイス数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids

    SSID を作成します。

  • PUT <cluster-ip>/dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/${id}

    SSID を更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/${id}

    SSID を削除します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids

    サイトで SSID を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/${id}

    ID で SSID を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sites/${siteId}/wirelessSettings/ssids/count

    サイトごとの SSID 数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}

    ワイヤレスプロファイルを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}

    ワイヤレスプロファイルを更新します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessProfiles

    ワイヤレスプロファイルを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles

    ワイヤレスプロファイルを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/${id}

    ID でワイヤレスプロファイルを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessProfiles/count

    ワイヤレスプロファイル数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessSettings/rfProfiles/${id}

    RF プロファイルを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessSettings/rfProfiles

    RF プロファイルを作成します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessSettings/rfProfiles/${id}

    RF プロファイルを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/rfProfiles

    RF プロファイルを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/rfProfiles/${id}

    ID で RF プロファイルを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/rfProfiles/count

    RF プロファイル数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessAccessPoints/factoryResetRequest/provision

    アクセスポイントを工場出荷時設定にリセットします。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessAccessPoints/factoryResetRequestStatus

    アクセスポイントの工場出荷時設定へのリセットのステータスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/dot11beProfiles

    すべての 802.11be プロファイルを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/wirelessSettings/dot11beProfiles/${id}

    802.11be プロファイルを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wirelessSettings/dot11beProfiles/${id}

    802.11be プロファイルを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/dot11beProfiles/${id}

    ID で 802.11be プロファイルを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/wirelessSettings/dot11beProfiles/count

    802.11be プロファイル数を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessSettings/dot11beProfiles

    802.11be プロファイルを作成します。

  • POST<cluster-ip>/dna/intent/api/v1/wirelessControllers/${deviceId}/assignManagedApLocations

    WLC の管理対象 AP の場所を割り当てます。

  • POST<cluster-ip>/dna/intent/api/v1/wirelessControllers/${deviceId}/provision

    ワイヤレスコントローラのプロビジョニング。

  • POST <cluster-ip>/dna/intent/api/v1/wirelessAccessPoints/provision

    AP のプロビジョニング。

新しいワイヤレス API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Connectivity] ドロップダウンリストを展開して、[Wireless] を選択します。

API の機能拡張

デバイスオンボーディング(PnP)API

このリリースでは、以下の通りです。

  • sudiSerialNos 要求パラメータは、デバイスの更新 API とデバイスの追加 API で userSudiSerialNos に名前が変更されました。

  • バーチャルアカウントの追加 API および PnP サーバープロファイルの更新 API に、addressIpV6 要求パラメータが追加されました。このパラメータは、クラスタが IPv6 で設定されている場合に必要です。

  • isSudiRequired 要求パラメータは、デバイスの一括インポート API で sudiRequired に名前が変更されました。

  • サイトへのデバイスの要求 API に、hostname という新しいオプションの要求パラメータが追加されました。

  • デバイス要求 API に、authorizationNeeded という新しいオプションの要求パラメータが追加されました。

デバイス API

このリリースでは、デバイスリストの取得 API に syncRequestedByApp および lastManagedResyncReasons 応答パラメータが導入されました。

イベント管理 API

イベントアーティファクトの取得 API に、オプションの deprecationMessage および deprecated 応答パラメータが含まれるようになりました。deprecated の値が true の場合、イベントアーティファクトは廃止され、廃止メッセージが表示されます。

ファブリックデバイス API

このリリースでは、以下の通りです。

  • 要求パラメータ deviceRoles は、WIRELESS_CONTROLLER_NODE 値を受け入れます。

  • ファブリックデバイス API のサポートがワイヤレスロールに拡張されました。

パストレース API

egressPhysicalInterface、ingressPhysicalInterface、egressInterface、ingressInterface 属性は、以前のパストレースの取得 API のオプション属性になりました。

SDA API

このリリースでは、オプションの isBpduGuardEnabled 要求本文パラメータが、認証プロファイルの更新 API に追加されました。authenticationProfileName パラメータが [Closed Authentication] に設定されている場合、値を null にすることはできません。

廃止された API

ファブリックワイヤレス API

このリリースでは、次のファブリックワイヤレス API が廃止予定としてマークされています。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/sda/wireless-controller

    ファブリックドメインからの WLC の削除。

  • PUT <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/ssid-ippool

    SSID から IP プールへのマッピングの更新。

  • POST <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/ssid-ippool

    SSID から IP プールへのマッピングの追加。

  • GET <cluster-ip>/dna/intent/api/v1/business/sda/hostonboarding/ssid-ippool

    SSID から IP プールへのマッピングの取得。

  • POST <cluster-ip>/dna/intent/api/v1/business/sda/wireless-controller

    ファブリックドメインへの WLC の追加。

ネットワーク設定 API

このリリースでは、次のネットワーク設定 API が廃止予定としてマークされています。

  • POST <cluster-ip>/dna/intent/api/v1/network/${siteId}

    ネットワークの作成

  • POST <cluster-ip>/dna/intent/api/v2/network/${siteId}

    ネットワーク V2 を作成します。

  • PUT <cluster-ip>/dna/intent/api/v1/network/${siteId}

    ネットワークを更新します。

  • PUT <cluster-ip>/dna/intent/api/v2/network/${siteId}

    ネットワーク V2 を更新します。

  • GET <cluster-ip>/dna/intent/api/v1/network

    ネットワークを取得します。

  • GET <cluster-ip>/dna/intent/api/v2/network

    ネットワーク V2 を取得します。

  • POST <cluster-ip>/dna/intent/api/v1/credential-to-site/${siteId}

    デバイスのログイン情報をサイトに割り当てます。

  • POST <cluster-ip>/dna/intent/api/v2/credential-to-site/${siteId}

    デバイスのログイン情報をサイト V2 に割り当てます。

サイト設計 API

このリリースでは、次のサイト設計 API が廃止予定としてマークされています。

  • POST <cluster-ip>/dna/intent/api/v1/networkprofile/${networkProfileId}/site/${siteId}

    関連付けします。

  • DELETE <cluster-ip>/dna/intent/api/v1/networkprofile/${networkProfileId}/site/${siteId}

    関連付けを解除します。

サイト API

このリリースでは、次のサイト API が廃止予定としてマークされています。

  • GET <cluster-ip>/dna/intent/api/v1/site-member/${id}/member

    サイトに割り当てられているデバイスを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/assign-device-to-site/${siteId}/device

    サイトにデバイスを割り当てます。

  • POST <cluster-ip>/dna/intent/api/v1/site

    サイトを作成します。

  • DELETE <cluster-ip>/dna/intent/api/v1/site/${siteId}

    サイトを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/site/${siteId}

    サイトを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/site

    サイトを取得します。

  • GET <cluster-ip>/dna/intent/api/v2/site

    サイト V2 を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/site/count

    サイト数を取得します。

  • GET <cluster-ip>/dna/intent/api/v1/membership/${siteId}

    メンバーシップを取得します。

  • GET <cluster-ip>/dna/intent/api/v2/site/count

    サイト数 V2 を取得します。

タスク API

このリリースでは、次のタスク API が廃止予定としてマークされています。

  • GET <cluster-ip>/dna/intent/api/v1/task

    タスクを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/task/${taskId}

    ID でタスクを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/task/operation/${operationId}/${offset}/${limit}

    OperationId でタスクを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/task/${taskId}/tree

    タスクツリーを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/task/count

    タスク数を取得します。

ワイヤレス API

このリリースでは、次のワイヤレス API が廃止予定としてマークされています。

  • POST <cluster-ip>/dna/intent/api/v1/wireless/profile

    ワイヤレスプロファイルを作成します。

  • GET <cluster-ip>/dna/intent/api/v1/wireless/profile

    ワイヤレスプロファイルを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wireless-profile/${wirelessProfileName}

    ワイヤレスプロファイルを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/wireless/profile

    ワイヤレスプロファイルを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/wireless/rf-profile

    RF プロファイルを取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wireless/rf-profile/${rfProfileName}

    RF プロファイルを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/wireless/rf-profile

    RFプロファイルを作成または更新します。

  • GET <cluster-ip>/dna/intent/api/v1/wireless/dynamic-interface

    ダイナミックインターフェイスを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/wireless/dynamic-interface

    ダイナミックインターフェイスを作成または更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/wireless/dynamic-interface

    ダイナミックインターフェイスを削除します。

  • POST <cluster-ip>/dna/intent/api/v1/enterprise-ssid

    エンタープライズ SSID を作成します。

  • PUT <cluster-ip>/dna/intent/api/v1/enterprise-ssid

    エンタープライズ SSID を更新します。

  • Delete <cluster-ip>/dna/intent/api/v1/enterprise-ssid/${ssidName}

    エンタープライズ SSID を削除します。

  • GET <cluster-ip>/dna/intent/api/v1/enterprise-ssid

    エンタープライズ SSID を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/business/ssid/${ssidName}/${managedAPLocations}

    SSID を削除し、デバイスにプロビジョニングします。

  • POST <cluster-ip>/dna/intent/api/v1/business/ssid

    SSID を作成およびプロビジョニングします。

  • GET <cluster-ip>/dna/intent/api/v1/task/count

    AP のプロビジョニング。

  • POST <cluster-ip>/dna/intent/api/v1/wireless/ap-provision

    プロビジョニングを更新します。

  • POST <cluster-ip>/dna/intent/api/v1/wireless/provision

    プロビジョニングします。

後方互換性を損なう API の変更

なし

表 4. Catalyst Center プラットフォーム 2.3.7.5 の新機能および変更された機能
機能 説明

記載場所

監査ログ レポート

Catalyst Center プラットフォーム リリースでは、新しい監査ログレポートがサポートされています。

詳細については、以下を参照してください。

新しい API

LAN 自動化 API

Catalyst Center プラットフォーム は、次の LAN 自動化 API をサポートしています。

  • POST <cluster-ip>/dna/intent/api/v2/lan-automation

    LAN 自動化開始 V2。

  • PUT <cluster-ip>/dna/intent/api/v2/lan-automation/${id}

    LAN 自動化の停止とデバイス V2 の更新。

新しい LAN 自動化 API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Site Management] ドロップダウンリストを展開し、[LAN Automation] を選択します。

レポート API

Catalyst Center プラットフォーム は、次のレポート API をサポートしています。

  • GET <cluster-ip>/dna/data/api/v1/flexible-report/schedule/${reportId}

    レポート ID でフレキシブルレポートのスケジュールを取得します。

  • GET <cluster-ip>/dna/data/api/v1/flexible-report/report/${reportId}/executions

    レポート ID で実行 ID を取得します。

  • POST <cluster-ip>/dna/data/api/v1/flexible-report/report/${reportId}/execute

    フレキシブルレポートを実行します。

  • PUT <cluster-ip>/dna/data/api/v1/flexible-report/schedule/${reportId}

    フレキシブルレポートのスケジュールを更新します。

  • GET <cluster-ip>/dna/data/api/v1/flexible-report/schedules

    すべてのフレキシブルレポートのスケジュールを取得します。

  • GET <cluster-ip>/dna/data/api/v1/flexible-report/report/content/${reportId}/${executionId}

    フレキシブルレポートをダウンロードします。

新しいレポート API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Operational Tasks] ドロップダウンリストを展開し、[Reports] を選択します。

SD-Access API

Catalyst Center プラットフォーム は、次の SDA API をサポートしています。

エクストラネットポリシー API

  • GET <cluster-ip>/dna/intent/api/v1/sda/extranetPolicies

    エクストラネットポリシーを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/extranetPolicies

    エクストラネットポリシーを更新します。

  • POST <cluster-ip>/dna/intent/api/v1/sda/extranetPolicies

    エクストラネットポリシーを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/extranetPolicies/count

    エクストラネットポリシー数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/extranetPolicies/${id}

    ID でエクストラネットポリシーを削除します。

ポート割り当て API

  • POST <cluster-ip>/dna/intent/api/v1/sda/portAssignments

    ポート割り当てを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/portAssignments

    ポート割り当てを取得します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/portAssignments

    ポート割り当てを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/portAssignments/count

    ポート割り当て数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/portAssignments/${id}

    ID でポート割り当てを削除します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/portAssignments

    ポート割り当てを削除します。

ファブリックサイト API

  • POST <cluster-ip>/dna/intent/api/v1/sda/fabricSites

    ファブリックサイトを追加します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/fabricSites

    ファブリックサイトを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricSites/${id}

    ID でファブリックサイトを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricSites

    ファブリックサイトを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricSites/count

    ファブリックサイト数を取得します。

ファブリックゾーン API

  • POST <cluster-ip>/dna/intent/api/v1/sda/fabricZones

    ファブリックゾーンを追加します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/fabricZones

    ファブリックゾーンを更新します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricZones/${id}

    ID でファブリックゾーンを削除します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricZones

    ファブリックゾーンを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricZones/count

    ファブリックゾーン数を取得します。

認証プロファイル API

  • PUT <cluster-ip>/dna/intent/api/v1/sda/authenticationProfiles

    認証プロファイルを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/authenticationProfiles

    認証プロファイルを取得します。

一括デバイスプロビジョニング API

  • GET <cluster-ip>/dna/intent/api/v1/sda/provisionDevices

    プロビジョニングされたデバイスを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/sda/provisionDevices

    デバイスをプロビジョニングします。

  • GET <cluster-ip>/dna/intent/api/v1/sda/provisionDevices/count

    プロビジョニングされたデバイス数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/provisionDevices

    プロビジョニングされたデバイスを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/provisionDevices

    デバイスを再プロビジョニングします。

  • DELETE <cluster-ip>/dna/intent/api/v1/ sda/provisionDevices/${id}

    ID でプロビジョニングされたデバイスを削除します。

ファブリックデバイス API

  • POST <cluster-ip>/dna/intent/api/v1/sda/fabricDevices

    ファブリックデバイスを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricDevices

    ファブリックデバイスを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/count

    ファブリックデバイス数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricDevices

    ファブリックデバイスを削除します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/${id}

    ID でファブリックデバイスを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/fabricDevices

    ファブリックデバイスを更新します。

ファブリックデバイスレイヤ 2 ハンドオフ API

  • POST <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs

    ファブリックデバイスのレイヤ 2 ハンドオフを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs

    ファブリックデバイスのレイヤ 2 ハンドオフを取得します。

  • GET <cluster-ip>/ dna/intent/api/v1/sda/fabricDevices/layer2Handoffs/count

    ファブリックデバイスのレイヤ 2 ハンドオフ数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs

    ファブリックデバイスのレイヤ 2 ハンドオフを削除します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/ layer2Handoffs/${id}

    ID でファブリックデバイスのレイヤ 2 ハンドオフを削除します。

ファブリックデバイス IP トランジットレイヤ 3 ハンドオフ API

  • POST <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits

    IP トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits

    IP トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits/count

    IPトランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフの数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits

    IP トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを削除します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits/${id}

    ID で IP トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits

    IP トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを更新します。

ファブリックデバイス SDA トランジットレイヤ 3 ハンドオフ API

  • POST <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits

    SDA トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits

    SDA トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを取得します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits/count

    SDA トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフの数を取得します。

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/ layer3Handoffs/sdaTransits

    SDA トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits

    SDA トランジットを使用したファブリックデバイスのレイヤ 3 ハンドオフを更新します。

エニーキャストゲートウェイ API

  • DELETE <cluster-ip>/dna/intent/api/v1/sda/anycastGateways/${id}

    ID でエニーキャストゲートウェイを削除します。

  • PUT <cluster-ip>/dna/intent/api/v1/sda/anycastGateways

    エニーキャストゲートウェイを更新します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/anycastGateways

    エニーキャストゲートウェイを取得します。

  • POST <cluster-ip>/dna/intent/api/v1/sda/anycastGateways

    エニーキャストゲートウェイを追加します。

  • GET <cluster-ip>/dna/intent/api/v1/sda/anycastGateways/count

    エニーキャストゲートウェイ数を取得します。

新しい SDA API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Connectivity] ドロップダウンリストを展開し、[SDA] を選択します。

API の機能拡張

LAN 自動化 API

  • LAN 自動化デバイス更新 API に、新しい要求本文パラメータ hostnameUpdateDevicesに基づいてデバイスのホスト名を変更するための新しいクエリパラメータ HOSTNAME_UPDATE が含まれるようになりました。

  • ID による LAN 自動化ステータス API と LAN 自動化ステータス API に、3 つの追加のオプションパラメータ discoveryLeveldiscoveryTimeout、および discoveryDevices が含まれるようになりました。これらは、ユーザーが LAN 自動化開始 V2 API を使用して LAN 自動化を開始するときに、応答本文に表示されます。

デバイス API

  • このリリースでは、IPv6 アドレスを指定して、サイトへのデバイスの割り当て API でデバイスを割り当てることができます。

  • デバイスリストのエクスポート API で、password パラメータがオプションになりました。

  • このリリースでは、Catalyst Center プラットフォーム は、指定した範囲によるデバイスインターフェイスの取得 API、ID によるインターフェイス情報の取得 API、IP によるインターフェイスの取得 API、OSPF インターフェイスの取得 API、ISIS インターフェイスの取得 API、インターフェイス名によるインターフェイスの取得 API、すべてのインターフェイスの取得 API、および ID によるインターフェイスの取得 API の応答パラメータにおける、次の変更をサポートしています。

    • addresseslastOutgoingPacketTimelastIncomingPacketTimemtu、および name 応答パラメータが上記の API に含まれるようになりました。

    • poweroverethernetnetworkdevice_idmanagedNetworkElementUrlmanagedNetworkElementmanagedComputeElementUrl、および managedComputeElement 応答パラメータは、上記の API から削除されました。

ネットワーク設定 API

このリリースでは、予約 IP サブプールの取得 API に新しい groupName 要求クエリパラメータが追加されました。siteId パラメータはオプションになりました。

(注)  

 

siteId パラメータを省略すると、次のようになります。

  • ignoreInheritedGroups パラメータを使用する必要があります。

  • 応答の最大ページサイズは 1,000 エントリです。

廃止された API

なし

後方互換性を損なう API の変更

なし

表 5. Catalyst Center プラットフォーム 2.3.7.4 の新機能および変更された機能
機能 説明

Catalyst Center への名称変更

統合プラットフォームを中心に製品を統合するというビジョンの一環として、このリリースでは Cisco DNA Center プラットフォームの名称を Catalyst Center プラットフォーム に変更します。Catalyst Center の機能は Cisco DNA Center と同じままです。

新しい API

ユーザー API とロール API

Catalyst Center プラットフォーム は、次のユーザーとロール API をサポートしています。

  • POST <cluster-ip>/dna/system/api/v1/users/external-servers/aaa-attribute

    AAA 属性 API を追加および更新します。

  • GET <cluster-ip>/dna/system/api/v1/users/external-servers/aaa-attribute

    AAA 属性 API を取得します。

  • DELETE <cluster-ip>/dna/system/api/v1/users/external-servers/aaa-attribute

    AAA 属性 API を削除します。

  • POST <cluster-ip>/dna/system/api/v1/users/external-authentication

    外部認証設定 API を管理します。

  • GET <cluster-ip>/dna/system/api/v1/users/external-authentication

    外部認証設定 API を取得します。

新しいユーザーとロール API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] > [User and Roles] の順に選択します。

ITSM 統合 API

Catalyst Center プラットフォーム は、次の ITSM 統合 API をサポートしています。

GET <cluster-ip>/dna/intent/api/v1/integration-settings/status

ITSM 統合ステータスを取得します。

新しい ITSM 統合 API にアクセスするには、メニューアイコンをクリックして次を選択します。 [Platform] > [Developer Toolkit] > [APIs] の順に選択します。

[Integration] ドロップダウンリストを展開し、[ITSM Integration] を選択します。

API の機能拡張

デバイス API

デバイスへのユーザー定義フィールドの追加 API で、value 要求パラメータが必須属性になりました。

ディスカバリ API

グローバルログイン情報 V2 の作成 API およびグローバルログイン情報 V2 の更新 API の要求パラメータである httpRead.name および httpWrite.name は、それぞれ httpRead.description および httpWrite.descriptionに変更されました。

廃止された API

デバイス API

すべてのデバイスのデバイス設定の取得 API は廃止されました。