いつでも、リリースバージョンのサポートされている API のリストを表示できます。

必要に応じて、角度アイコン（[>]）をクリックして、API サブドメインを表示します。

API を選択した後、各列に次の情報が表示されます。

• [Method]：サポートされるメソッドには、GET、POST、PUT、および DELETE が含まれます。

• [Name]：slide-in pane および説明、機能、タグ、パラメータ、応答、モデルスキーマなどの追加情報にアクセスするためのリンク。

• [Description]：メソッドの簡単な説明。

• [URL]：メソッドの URL 値。

• アイコン（...）：コードプレビュースニペットまたは [Try It] オプションを作成するためのリンクにアクセスします。

API メソッドに関する次の情報が表示されます。

• [DESCRIPTION]：API の簡単な説明。

• [FEATURES]：メソッドと URL の情報。

• [TAGS]：API を使用する状況を含む API 識別子。タグがない API もあることに注意してください。

• [PARAMETERS]：説明、データタイプ（ブール値または文字列）、デフォルト値、必要な値を含む API のパラメータ。

• [RESPONSES]：考えられる HTTP 応答。

• [MODEL SCHEMAS]：データモデル（[Model] タブ）または実際の応答の JSON 形式（[Model Schema] タブ）として応答を提供します。サンプルコードは、[Code Preview] ボタンから入手可能です。

• [POLICIES]：API レート制限機能。ポリシーは特定の API に適用されます。これらのポリシーは、クライアント IP アドレスごとの時間間隔あたりの API コール数を設定します。

次の言語がサポートされています。

• シェル

• ノード：HTTP

• ノード：Unirest

• ノード：Request

• Python

• Ruby

• javascript

• JQuery

• PHP

• Go

• Ansible

使用するコードプレビューサンプルを確認またはコピーした後、[Close] をクリックします。

応答またはエラーコードを確認した後、[Close] をクリックします。

Cisco DNA Center が 202（承認）HTTP ステータスコードを返した場合、結果の本文には、元のリクエストが生成した非同期タスクに関する詳細情報のクエリに使用できるタスク ID と URL が含まれます。たとえば、非常に長いタスクが完了したかどうかを判断するためにこの情報を使用できます。詳細については、「Getting Information about Asynchronous Operations」を参照してください。

次の情報が表示されます。

• [Name]：統合フローと追加情報が入手可能な slide-in pane にアクセスするリンクの名前。

  統合フローが REST ベースのトリガータイプの場合、統合フロー名をクリックすると、説明、タグ、パラメータ、応答、モデルスキーマ、ポリシーなどの追加データが表示されます。

  統合フローがスケジュールベースのトリガータイプの場合、統合フロー名をクリックすると、スケジュールを設定するための slide-in pane が表示されます。この slide-in pane には、[DESCRIPTION]、[TAGS]、および [HOW TO USE THIS FLOW] の内容が表示されます。

• [Description]：統合フローの簡単な説明。

• [Trigger]：REST ベースまたはスケジュールベース。

• アイコン（[...]）：コードプレビューを作成するためのリンク、または [Try It] オプションにアクセスします。統合フローがスケジュールベースの場合、このアイコンは [Schedule Flow] オプションにアクセスします。

slide-in paneが開き、REST ベースの統合フローに関する詳細が示されます。詳細を確認してから、slide-in paneを閉じることができます。

これらの選択肢は、REST ベースでトリガーされた統合フローの場合にのみ表示されます。スケジュールベースの統合フローでは、マウスを合わせたときに、[Schedule Flow] メニュー項目が提示されます。

使用するコードを確認またはコピーした後、[Close] をクリックします。

メソッドを試した後、[Try It] ウィンドウ内で応答またはエラーコードを確認し、[Close] をクリックします。

Cisco DNA Center が 202（承認）HTTP ステータスコードを返した場合、結果の本文には、元のリクエストが生成した非同期タスクに関する詳細情報のクエリに使用できるタスク ID と URL が含まれます。たとえば、非常に長いタスクが完了したかどうかを判断するためにこの情報を使用できます。詳細については、「Getting Information about Asynchronous Operations」を参照してください。

• [DESCRIPTION]：統合フローの説明と目的。

• [TAGS]：タグは、どの Cisco DNA Center コンポーネントが、バンドルによって使用されるか、または影響を受けるかを示します。

• [HOW TO USE THIS FLOW]：スケジュール設定オプション。

GUI を使用して、統合フローをスケジュールすることができます。

• [Run Now]：[Run Now] を選択し、[Schedule] ボタンをクリックして統合フローを実行します。

• [Run Later]：[Run Later] を選択し、日付、時刻、およびタイムゾーンを入力します。[Schedule] ボタンをクリックして、指定した日付、時刻、およびタイムゾーンで統合フローを実行します。

• [Recurring]：[Recurring] を選択し、次のオプションを設定します。

  • [Repeats]：統合フローを繰り返す頻度として毎日または毎週を選択します。

  • [Run at Interval]：統合フローを実行する時間間隔を設定します。

  • [Set Schedule Start]：開始日を設定します。

  • [Set Schedule End]：終了日を設定します。

  設定された時間に統合を実行するには、[Schedule] ボタンをクリックします。

[Events Notifications] ウィンドウが表示されます。

各通知はタイルで表され、通知の詳細を表示するためのリンクが含まれています。

サポートされているチャネルは、[REST]、[PAGERDUTY]、[SNMP]、[SYSLOG]、[WEBEX]、[EMAIL] です。

[Notification Details] スライドインペインには、選択したチャネルに基づいて次の通知の詳細が表示されます。

• [Name]：イベントの名前。

• [Description]：イベントの説明

• サイト

• [Event]

• [REST]：REST 通知の詳細を表示する場合にのみ表示されます。[REST] エリアには、次の情報が表示されます。

  • [URL]：イベントが送信される REST API エンドポイントの URL アドレス。

  • [Method]：PUT メソッドまたは POST メソッド。

  • [Trust certificate]：REST API エンドポイント通知に信頼できる証明書が必要かどうか。

  • [Headers]：[Header Name] と [Header Value]。

• [PAGERDUTY]：PAGERDUTY 通知の詳細を表示する場合にのみ表示されます。[PAGERDUTY] エリアには、次の情報が表示されます。

  • [PagerDuty Events API URL]

  • [PagerDuty Integration Key]

  • [PagerDuty Events API Version]

• [SNMP]：[SNMP] 通知の詳細を表示する場合にのみ表示されます。

• [SYSLOG]：[SYSLOG] 通知の詳細を表示する場合にのみ表示されます。

• [WEBEX]：[WEBEX] 通知の詳細を表示する場合にのみ表示されます。

• [EMAIL]：[EMAIL] 通知の詳細を表示する場合にのみ表示されます。[EMAIL] エリアには、E メール受信者の [From] と [To] と E メールの [Subject] が表示されます。

1. [Name] 名フィールドに一意の名前を入力します。

2. [Description] 名フィールドに、それぞれのイベントの説明を入力します。

3. [Site and Events] を展開し、[Select a site] ドロップダウンリストからサイトを選択します。

4. イベントの横にあるプラスアイコンをクリックするか、[Add All] をクリックしてすべてのイベントをそれぞれの通知に追加します。

5. 通知からイベントを削除するには、削除するイベントの横にあるプラスアイコンをクリックするか、[Remove All] をクリックして、それぞれの通知からすべてのイベントを削除します。

6. [Configuration] を展開して、選択した通知チャネルの構成を編集します。

   [Configuration] 領域で詳細を指定するには、『Cisco DNA Center ユーザガイド』の「Create an Event Notification」を参照してください。

   （注）	[Configuration] 領域で使用できる名前フィールドは、選択した通知チャネルのタイプによって異なります。

[Event Details] タブに表示されるデータは次のとおりです。

• [Description]：イベントとそれを発生させるトリガーの簡単な説明。

• [Event ID]：イベントの識別番号。

• [Version]：イベントのバージョン番号。

• [Namespace]： イベントの名前空間。

• [Severity]：1 〜 5。

  （注）	シビラティ（重大度） 1 は最も重要または重大な優先度であり、このタイプのイベントに割り当てる必要があります。

• [Domain]：イベントが属する REST API ドメイン。

• [Sub Domain]：イベントが属する REST API ドメインの配下のサブグループ。

• [Category]：エラー、警告、情報、アラート、タスクの進捗状況、タスクの完了。

• [Note]：イベントの理解に役立つ追加情報。

• [Event Link]：REST URL を使用したイベントブロードキャスト。

• [Tags]：イベントの影響を受ける Cisco DNA Center のコンポーネントを示すタグ。このリリースのタグのデフォルト値は、ASSURANCE にアシュアランスの特定の問題を示すシンタックスを付けた値です。

• [Supported Endpoints]：イベント通知（電子メール、REST API、または SNMP トラップ、Webex）でサポートされるエンドポイントタイプ。

• [Model Schema]：イベントに関するモデルスキーマが提示されます。

  • [Details]：イベントのモデルスキーマの詳細の例。

  • [REST Schema]：イベントの REST スキーマのフォーマット。

通知をイベントに関連付けると、[Notifications] タブに [Try-It Now] ボタンが表示されます。イベント通知シミュレーションを実行するには、[Try-It Now] をクリックします。詳細については、「イベント通知シミュレーションの使用」を参照してください。