Cisco DNA Center プラットフォーム は、次の新しいインストールとアップグレードの機能強化をサポートします。

• インストールの機能強化：Cisco DNA Center リリース 1.3.1.0 をインストールする場合、Cisco DNA Center プラットフォーム リリース 1.3.1.0 もインストールします。このリリースの Cisco DNA Center と Cisco DNA Center プラットフォーム をインストールすると、Cisco DNA Center REST API バンドルはデフォルトで有効になり、アクティブになります。

• アップグレードの機能強化：Cisco DNA Center プラットフォーム リリース 1.3 からリリース 1.3.1.0 へのアップグレード後、Cisco DNA Center REST API バンドルはデフォルトで有効になり、アクティブになります。以前の Cisco DNA Center プラットフォーム リリースからアップグレードするには、Cisco DNA Center REST API バンドルを無効にしてから再度有効にする必要があります。

Cisco DNA Center プラットフォーム は、このリリースで次の更新された API GUI の変更をサポートします。

• [Authentication] ドメインが [APIs] GUI の階層の最上位に移動されました。

  階層を表示するには、[Platform] > [Manage] > [Developer Toolkit] > [APIs] をクリックします。

• イベント、通知、およびサブスクリプションの API メソッドを含む新しい [Event Management] ドメイン。

• 新しい [Policy] ドメイン。

  [Policy] ドメインの新しい API については、「アプリケーションポリシー API」を参照してください。

• [Operational Tools] ドメインの名前が [Operational Tasks] に変更されました。

• [Know your Network] ドメインで、[Networks] の名称が [Topology] に変更されます。

• [Site Management] ドメイン内：

  • [Site Profile] の名称が [Site Design] に変更されました。

  • [PnP] の名称が [Device Onboarding (PnP)] に変更されました。

  • [SWIM] の名称が [Software Image Management (SWIM)] に変更されました。

  • [Template Programmer] の名称が [Configuration Templates] に変更されました。

このリリースでは、次の Assurance イベント通知機能がサポートされています。

• Cisco DNA Center プラットフォーム は、ユーザーが電子メールまたは REST API エンドポイント通知の受信を考慮できる重要な Assurance の問題のリストを GUI で公開します。

• Assurance の問題の公開されたリストから、ユーザーが通知を希望する問題を選択する機能。

• ユーザーが GUI を使用して、電子メールや REST API エンドポイントなどの通知メカニズムを選択する機能。

• 選択に基づいて、選択基準に一致する問題が発生すると、外部通知が自動的に送信されます。

Assurance イベント通知に関して、次のデータがユーザーに送信されます。

• タイプ（ネットワークデバイス、クライアント、アプリケーション、またはセンサー）

• API コールバック用の問題識別子（イベント受信者はクエリを返し、関心のある問題についての付加的な詳細情報を取得可能）

• 問題に関係するデバイス、クライアント、アプリケーション、またはセンサーの一意の識別子（必要に応じて名前または MAC アドレス）（イベント受信者は、該当するエンティティについての付加的な詳細情報を取得するために API コールを行うことが可能）

• 問題の概要：これがイベント名になります。

• 問題の説明：これがイベントの概要になります。

• 問題の URL：Cisco DNA Center の問題の詳細 URL ページ（イベントコンテキストリンク）

• 問題のカテゴリ：Assurance の問題のカテゴリは、電子メール本文の一部に使用されます。

• 問題 API の詳細：Cisco DNA Center の問題エンリッチメント API へのディープリンク

Cisco DNA Center プラットフォーム GUI の [Events] で Assurance イベントを表示および登録できます。[Platform] > [Developer Toolkit] > [Events] の順にクリックして、このウィンドウにアクセスし、イベントを登録します。これらの手順の詳細については、『Cisco DNA Center Platform User Guide』を参照してください。

Cisco DNA Center プラットフォーム は、次の電子メールイベント機能をサポートします。

• ユーザーが通知するイベントを選択する [Events] のオプションをサポートします。

• 1 日あたり 1000 通の電子メールの上限しきい値をサポートします。

• 最大 20 の電子メールアドレスまたは電子メールエイリアスをサポートします。

• 通知の原因となったすべてのイベントの監査ログをサポートします。

電子メールイベント通知の設定は、Cisco DNA Center GUI の [Settings] で行います。[System Settings] > [Settings] > [Email configuration] をクリックして、GUI ウィンドウにアクセスし、電子メールイベント通知を設定します。電子メールイベント通知の登録は、Cisco DNA Center プラットフォーム GUI の [Events] で行います。[Platform] > [Developer Toolkit] > [Events] の順にクリックして、このウィンドウにアクセスし、イベントを登録します。これらの手順の詳細については、『Cisco DNA Center Platform User Guide』を参照してください。

この Cisco DNA Center リリースでの IT サービス管理（ITSM）統合の更新事項と変更点は次のとおりです。

• [Network Events for REST API Endpoint] バンドルは廃止されました。Cisco DNA Center プラットフォーム の旧リリースでこのバンドルを設定し、スケジュール済みイベントに使用している場合、このリリースでは動作しないため注意が必要です。その場合は、特定のネットワークイベントに対して個々の REST API エンドポイントを再設定する必要があります。

  （注）	さらに、このバンドルの [Scheduler] は、[Developer Toolkit] の [Integration Flows] に表示されません。

  新しい GUI を使用して、イベントの REST API エンドポイントを再設定します。[Platform] > [Developer Toolkit] > [Events] をクリックします。このウィンドウに一覧表示されているイベントを確認し、設定する特定のイベント（の名前）をクリックします。このウィンドウでイベント名をクリックした後、イベントの詳細を確認してから、[Subscribe] をクリックして REST API エンドポイントを作成します。イベントの REST API エンドポイントの設定に関する詳細については、『Cisco DNA Center Platform User Guide』を参照してください。

  重要	イベント通知は、スケジュール設定された時間に従ってではなく、イベントが実際に発生したときに送信されるようになりました。

• このリリースにアップグレードすると、以前に選択した設定がイベント設定から失われます。ユーザーによる設定項目を再度設定する必要もあります。[Platform] > [Manage] > [Configurations] > [Event Settings] をクリックして GUI ウィンドウにアクセスし、ユーザーによる設定項目を再度設定します。

• [Device Image Outdated] イベントの設定（SWIM イベント用）が以前に選択されていた場合、このリリースにアップグレードすると設定が失われます。この SWIM イベントを再度設定する必要があります。[Platform] > [Manage] > [Configurations] > [Event Settings] をクリックして GUI ウィンドウにアクセスし、この SWIM イベントの設定を再度設定します。

• [SWIM Events for REST API Endpoint] バンドルの場合、このリリースへのアップグレード後、設定はデフォルトで削除されます。最新の設定を取得して機能させるには、このバンドルの更新オプションをクリックする必要があります。バンドルの更新については、「バンドルの更新」を参照してください。

• [Network Issue Monitor and Enrichment for ITSM (ServiceNow)] バンドルが Cisco DNA Center プラットフォーム リリース バージョン 1.3 で実行されていた場合、アップグレード後に機能するように次の手順を実行します。

  1. Cisco DNA Center のホームページで、[Platform] > [Manage] > [Bundles] の順にクリックします。

  2. [Network Issue Monitor and Enrichment for ITSM (ServiceNow)] バンドルを見つけて、[Update] ボタンをクリックします。

  3. 次に、[Configure] ボタンをクリックします。

  4. [Activate] ボタンをクリックして設定を保存し、このバンドルがアップグレード後に機能するようにします。

• 多数のネットワークイベント API が、[Network Issue Monitor and Enrichment for ITSM (ServiceNow)] バンドルから [Cisco DNA Center REST API] バンドルに移行されています。旧リリースでこれらのネットワークイベント API を使用している場合、このリリースでは動作しないため注意が必要です。その場合は、[Cisco DNA Center REST API] バンドル内に配置されているデータとサンプルを使用して、目的に応じたネットワークイベント API を再作成する必要があります。

  （注）	さらに、このバンドルの [Scheduler] は、[Developer Toolkit] の [Integration Flows] に表示されません。

  [Cisco DNA Center REST API] バンドルに移行した API は次のとおりです。

  • 問題エンリッチメントの詳細の取得

  • ユーザーエンリッチメントの詳細の取得

  • デバイスエンリッチメントの詳細の取得

  • クライアント エンリッチメントの詳細の取得

  [Platform] > [Manage] > [Bundles] > [Cisco DNA Center REST API] の順にクリックします。開いた [Cisco DNA Center REST API] ウィンドウで、[Contents] タブ > [API] をクリックし、前述の API のいずれかが見つかるまで API のリストを下にスクロールします。データとサンプルを使用して API を再作成します。

  これらの 4 つの API には、[Platform] > [Developer Toolkit] > [APIs] > [Know Your Network] の順にクリックし、該当するサブドメイン（[Devices]、[Clients]、[Users]、または [Issues]）をクリックしてアクセスすることもできます。

  これらのバンドルの詳細については、『Cisco DNA Center Platform User Guide』を参照してください。

• このリリースでは、Cisco DNA Center プラットフォーム で通知できる Assurance イベントの数が削減されています。[Platform] > [Manage] > [Configurations] > [Event Settings] または [Platform] > [Developer Toolkit] > [Events] をクリックして、利用可能な Assurance イベントを表示できます。

• [Runtime Dashboard] には、アップグレード後 6 時間が経過するまで、以前の優先順位（P1 ～ P5）が表示されます（最小時間フィルタ）。

Cisco DNA Center プラットフォーム は、このリリースで、更新された次の ITSM 拡張機能をサポートします。

• ServiceNow（ITSM）ツールと Cisco DNA Center の間の以下を含む強化された例外処理。

  • Cisco DNA Center と ServiceNow の間のタイムアウト。

  • Cisco DNA Center から ServiceNow に向けたチケットが作成されるはずのところ、チケットが作成されていない場合に発生する可能性のあるエラー。

  • Cisco DNA Center が変更管理情報を受信しない場合に、変更管理ステージで発生する可能性のあるエラー。

  • Cisco DNA Center から ServiceNow でチケットを閉じる必要がある場合に発生する可能性のあるエラー。

• Cisco DNA Assurance の問題と、Cisco DNA Center プラットフォーム に一覧表示されているイベントとの間のアクティブな同期。

  （注）	このリリースでは、[Platform] タブに表示されるイベントが Assurance の問題の全リストと同期されるようになりました。たとえば、Assurance に 50 の問題がある場合、50 のイベントが [Platform] ページに表示されます。このページは、ITSM にマッピングするように設定でき、数値に不一致がないように設定することが可能です。

Cisco DNA Center ITSM 統合に関する詳細については、『Cisco DNA Center ITSM Integration Guide』を参照してください。

Cisco DNA アプリは現在、次の Cisco DNA Center および ServiceNow リリースで動作するように認定されています。

Cisco DNA Center リリースバージョン：

• GA 1.2.8

• GA 1.2.10

• GA 1.2.12

• GA 1.3

• GA 1.3.0.3

• GA 1.3.1.0

ServiceNow リリースバージョン：

• マドリッド

• London

• Kingston

Cisco DNA Center ITSM 統合に関する詳細については、『Cisco DNA Center ITSM Integration Guide』を参照してください。

Cisco DNA Center プラットフォーム は、このリリースで次の新しいレポート機能をサポートします。

• レポートに含めるレポートフィールドのサブセットを選択して、CSV、JSON、または Tableau データ抽出ファイルとしてエクスポートできるようになりました。

  SWIM データおよびレポートの場合は、 [CSV] と [Tableau Data Extract] の両方のファイルタイプについて、個々のフィールドを選択できます。クライアントデータおよびレポートの場合は、[クライアントの詳細（Client Detail）] を選択してから、 [CSV]、[Tableau Data Extract]、[JSON] の各ファイルタイプについて、個々のフィールドを選択できます。インベントリデータおよびレポートの場合は、 [CSV] と [Tableau Data Extract] の両方のファイルタイプについて、個々のフィールドを選択できます。

• Cisco DNA Center プラットフォームから送信された電子メールからレポートをダウンロードできるようになりました。

  電子メールには、レポートをダウンロードできるリンクが含まれています。

  GUI で実際のレポートをスケジュールするときに、電子メールを設定します。[Platform] > [Developer Toolkit] > [Data and Reports] をクリックします。[Data and Reports] の [Catalog] ウィンドウで、レポートタイプ（[SWIM]、[Client]、または [Inventory]）の [Schedule] をクリックします。フィルタとスケジュールを適用するには、GUI ウィンドウの下部にある [Send to] フィールドに電子メールアドレスを入力します。これらの手順の詳細については、『Cisco DNA Center Platform User Guide』を参照してください。

Cisco DNA Center プラットフォーム は、新しい非ファブリックワイヤレス API をサポートします。非ファブリックワイヤレス API のマニュアルには、Cisco DNA Center プラットフォーム GUI または Cisco DevNet を使用してアクセスできます。

GUI を使用して新しい API にアクセスするには、[Platform] > [Developer Toolkit] > [APIs] > [Connectivity] > [Non-Fabric Wireless] を選択します。次の新しいメソッドがサポートされています。

アクセスポイントのプロビジョニングと再プロビジョニング

• POST <cluster-ip>/dna/intent/api/v1/wireless/ap-provision

  アクセスポイントのプロビジョニングまたは再プロビジョニングに使用されるメソッド。

  このメソッドの前提条件は次のとおりです。

  • 該当するアクセスポイントを含む管理対象 AP ロケーション、RF プロファイル、コントローラである必要があります。

  • サイトの値には全階層を含める必要があります（たとえば、Global/zzz/ccc/aaa）。

RF プロファイルの作成、読み取り、更新、および削除（CRUD）または RF プロファイルの取得

• GET <cluster-ip>/dna/intent/api/v1/wireless/rf-profile

  GET <cluster-ip>/dna/intent/api/v1/wireless/rf-profile?rf-profile=<RF Profile Name>

  1 つ以上の RF プロファイルを取得するために使用されるメソッド。

• POST <cluster-ip>/dna/intent/api/v1/wireless/rf-profile

  1 つまたは複数の RF プロファイルを作成または更新するために使用されるメソッド。

• DELETE <cluster-ip>/dna/intent/api/v1/wireless/rf-profile/${rf-profile-name}

  RF プロファイルを削除するために使用されるメソッド。

Cisco DevNet の Cisco DNA Center プラットフォーム 非ファブリックワイヤレス API の詳細については、『 Cisco DNA Center Platform Intent APIs』を参照してください。Cisco DNA Center プラットフォーム GUI を使用した API へのアクセスと API の表示については、『Cisco DNA Center Platform User Guide』を参照してください。

Cisco DNA Center プラットフォーム は、新しいアプリケーションポリシー API をサポートしています。アプリケーションポリシー API には、次の機能があります。

• アプリケーションおよびアプリケーションセットの作成のサポート。

• アプリケーションおよびアプリケーションセットの編集のサポート。

• アプリケーションおよびアプリケーションセットの削除のサポート。

アプリケーションポリシー API のマニュアルには、Cisco DNA Center プラットフォーム GUI または Cisco DevNet を使用してアクセスできます。GUI を使用して新しい API にアクセスするには、[Platform] > [Developer Toolkit] > [APIs] > [Policy] > [Application Policy] を選択します。次の新しいメソッドがサポートされています。

• GET <cluster-ip>/dna//intent/api/v${majorVersion}/applications

  オフセット/制限または名前を使用してアプリケーションを取得するメソッド。

• GET <cluster-ip>/dna/intent/api/v${majorVersion}/applications-count

  既存のアプリケーションの数を取得するメソッド。

• GET <cluster-ip>/dna/intent/api/v1/application-policy-application-set

  すべてのアプリケーションセットをリストとして取得するメソッド。

• GET <cluster-ip>/dna/intent/api/v1/application-policy-application-set-count

  既存のアプリケーションセットの数を取得するメソッド。

• POST <cluster-ip>/dna/intent/api/v${majorVersion}/applications

  新しい 1 つまたは複数のカスタムアプリケーションを作成するメソッド。

• POST <cluster-ip>/dna/intent/api/v1/application-policy-application-set

  新しいアプリケーションセットを作成するメソッド。

• PUT <cluster-ip>/dna/intent/api/v${majorVersion}/applications

  既存の 1 つまたは複数のアプリケーションを編集するメソッド。

• DELETE <cluster-ip>/dna/intent/api/v${majorVersion}/applications

  既存のアプリケーションを ID を使用して削除するメソッド。クエリパラメータは次のとおりです。

  • id = [application_id]

  • 例：id = 0ba43f74-caa3-4a80-a9b8-fc5e64260dc2

• DELETE <cluster-ip>/dna/intent/api/v1/application-policy-application-set

  既存のアプリケーションセットを ID を使用して削除するメソッド。クエリパラメータは次のとおりです。

  • id = [application_set_id]

  • 例：id = 02260050-2313-4768-8696-78de240d0db3

Cisco DevNet の Cisco DNA Center プラットフォーム アプリケーションポリシー API の詳細については、『Cisco DNA Center Platform Intent APIs』を参照してください。Cisco DNA Center プラットフォーム GUI を使用した API へのアクセスと API の表示については、『Cisco DNA Center Platform User Guide』を参照してください。

Cisco DNA Center プラットフォーム は、更新された SDA API をサポートしています。SDA API のマニュアルには、Cisco DNA Center プラットフォーム GUI または Cisco DevNet を使用してアクセスできます。SDA API には次の機能があります。

• SDA ファブリックにおけるホストオンボーディングのためのデフォルト認証テンプレート（プロファイル）選択を管理する機能のサポート。

• 仮想ネットワークに IP アドレスプールを追加する機能のサポート。

• ユーザーデバイスとアクセスポイントのポート割り当てを管理する機能のサポート。

• SDA ファブリックにおけるエッジデバイスのライフサイクル管理のサポート。

GUI を使用して更新された API にアクセスするには、[Platform] > [Developer Toolkit] > [APIs] > [Connectivity] > [Fabric Wired] を選択します。次の新しいメソッドがサポートされています。

SDA ファブリックにおけるホストオンボーディングのためのデフォルト認証テンプレート（プロファイル）選択

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

  SDA ファブリックのデフォルトの認証プロファイルテンプレートを更新します。

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

  SDA ファブリックにデフォルトの認証プロファイルを追加します。

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

  SDA ファブリックからデフォルトの認証プロファイルを取得します。

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

  SDA ファブリックからデフォルトの認証プロファイルを削除します。

仮想ネットワークへの IP プールの追加（SDA セグメントのライフサイクル管理）

• 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 プールを削除します。

ユーザーデバイスのポート割り当て

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

  SDA ファブリックにユーザーデバイスのポート割り当てを追加します。

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

  SDA ファブリックのユーザーデバイスのポート割り当てを取得します。

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

  SDA ファブリックのユーザーデバイスのポート割り当てを削除します。

SDA ファブリックでのエッジデバイスのライフサイクル管理

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

  SDA ファブリックにエッジデバイスを追加します。

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

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

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

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

ボーダーデバイスビジネス 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 ファブリックからボーダーデバイスを削除します。

Cisco DevNet の Cisco DNA Center プラットフォーム SDA API の詳細については、『Cisco DNA Center Platform Intent APIs』を参照してください。Cisco DNA Center プラットフォーム GUI を使用した API へのアクセスと API の表示については、『Cisco DNA Center Platform User Guide』を参照してください。

Cisco DNA Center プラットフォーム は、新しいネットワーク設定 API をサポートします。ネットワーク設定 API のマニュアルには、Cisco DNA Center プラットフォーム GUI または Cisco DevNet を使用してアクセスできます。

GUI を使用して新しい API にアクセスするには、[Platform] > [Developer Toolkit] > [APIs] > [Site Management] > [Network Settings] を選択します。次の新しいメソッドがサポートされています。

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

  すべてのサービス プロバイダー プロファイルを取得するメソッド。

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

  デバイスのログイン情報の詳細を取得するメソッド。

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

  グローバル IP プールの詳細を取得するメソッド。

• DELETE <cluster-ip>/dna/intent/api/v1/device-credential/{id}

  CLI、SNMPV3、SNMP READ、SNMP WRITE、HTTP READ、HTTP WRITE などのデバイスのログイン情報を削除するメソッド。

• DELETE <cluster-ip>/dna/intent/api/v1/sp-profile/{sp-profile-name}

  サービスプロバイダー/QoS プロファイルを削除するメソッド。

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

  グローバル IP プールを削除するメソッド。

Cisco DevNet の Cisco DNA Center プラットフォーム ネットワーク設定 API の詳細については、『Cisco DNA Center Platform Intent APIs』を参照してください。Cisco DNA Center プラットフォーム GUI を使用した API へのアクセスと API の表示については、『Cisco DNA Center Platform User Guide』を参照してください。

このリリースでは、[Know Your Network] ドメインの GET Site および GET Membership API に対して次の機能強化が行われました。

GUI を使用して更新された API にアクセスするには、[Platform] > [Developer Toolkit] > [APIs] > [Know Your Network] > [Sites] を選択します。次の更新されたメソッドがサポートされています。

• GET Site：

  • レスポンスペイロードからステータスフラグを削除しました。

  • リクエストヘッダーの runsync 属性を削除しました。

  • レスポンスペイロードから systemGroup 属性、groupTypeList 属性を削除しました。

  • grouphierarchy、groupNamehierarchy から sitehierarchy および siteNameHierarchy に名称を変更しました。

• Get Membership：

  • URL パラメータが /dna/intent/api/v1/site/{siteId}/device に変更されました。

  • 子サイトとそのデバイスの両方を返すように説明を追加しました。

  • レスポンスペイロードから Instanceid、authEndtityId、displayName、authEntityClass を削除しました。

Cisco DevNet の Cisco DNA Center プラットフォーム Know Your Network API の詳細については、『Cisco DNA Center Platform Intent APIs』を参照してください。Cisco DNA Center プラットフォーム GUI を使用した API へのアクセスと API の表示については、『Cisco DNA Center Platform User Guide』を参照してください。

いくつかのバグを解決し、Cisco DNA Center プラットフォームのパフォーマンスと安定性が向上しました。

次に、Cisco DNA Center と IP Address Manager の統合に関する制限事項と回避策を示します。

• Infoblox

  • Infoblox には名前属性が表示されません。したがって、Infoblox のコメントフィールドには、同期中に IP プール名が入力されます。

  • プールのインポートでは、コメントフィールドの最初の 50 文字が使用されます。コメントにスペースがある場合は、アンダースコアに置き換えられます。

  • インポートされたプールの IP プール名が更新されると、コメントが上書きされ、新しい名前が反映されます。

• BlueCat：現時点では BlueCat の統合に伴う制限はありません。

重要なデータを含むレポートが Cisco DNA Center プラットフォーム で生成できないことがあります。このような場合は、フィルタを使用してレポートサイズを縮小し、このような障害を防ぐことを推奨します。