不一致 API 拡張クラス

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：6分

    • CMDB CI クラスモデルアプリは、一致しない API のクラスを追加または更新します。API [cmdb_ci_api] および API コンポーネント [cmdb_ci_api_component] クラスへの入力に適した構造になっていない API エンドポイントは、代わりに不一致 API エンドポイント [cmdb_ci_unmatched_api_endpoint] クラスに入力されます。不一致 API は通常、セキュリティスキャナーや観測可能性ツールなどの統合で使用されます。

    CMDB CI クラスモデルは、CMDBクラス階層を拡張するクラスモデルを追加するServiceNow Storeアプリです。新規または更新されたクラスには、クラスの説明、識別ルール、識別子エントリ、および該当する場合は依存関係が含まれます。その後、追加したクラスは、他の CMDB クラスと同じように使用できます。ディスカバリーとサービスマッピングパターンなどのアプリケーションは、クラス拡張を使用して CI に入力し、さまざまなテクノロジーやソフトウェアを検出できます。

    すべてのリリースノートの全文CMDB CI クラスモデルを参照してください。

    ストアでアプリを要求する

    ServiceNow Storeにアクセスして、利用可能なすべてのアプリを表示し、ストアに要求を送信する方法を確認してください。リリースされたすべてのアプリのリリースメモ情報については、「ServiceNow Store バージョンの履歴リリースノート」を参照してください。

    不一致 API

    API [cmdb_ci_api] および API コンポーネント [cmdb_ci_api_component] クラスへの入力に適した構造になっていない API エンドポイントは、代わりに不一致 API エンドポイント [cmdb_ci_unmatched_api_endpoint] クラスに入力されます。不一致 API は通常、セキュリティスキャナーや観測可能性ツールなどの統合で使用されます。

    クラス

    このセクションでは、 CMDB CI クラスモデル アプリが追加または更新するクラスを一覧表示します。

    CMDB CI クラスモデル：リリース 1.49.0 では、不一致 API エンドポイントに次のクラスが追加されています。 このアプリが拡張する可能性があるクラスを含む、ベースシステム内のクラスのリストについては、「CMDB テーブルの説明」を参照してください。

    クラス 拡張 説明
    不一致 API エンドポイント

    [cmdb_ci_unmatched_api_endpoint]

    		 構成アイテム

    cmdb_ci

    		 cmdb_ci_api または cmdb_ci_api_component を入力できない非構造化エンドポイントを持つ API。

    クラス属性

    CMDB CI クラスモデル：リリース 1.49.0 では、不一致 API エンドポイント [cmdb_ci_unmatched_api_endpoint] クラスに次の属性が追加されています。

    表 : 1. 不一致 API エンドポイント [cmdb_ci_unmatched_api_endpoint]
    属性 データタイプ 説明
    メソッド 文字列 API のバックエンドプロトコルタイプ。例：
    • Lambda
    • HTTP
    • 論理アプリ
    プロトコル 文字列 通信プロトコル。例：HTTP、HTTPS。
    URL 文字列 (1024) 呼び出されるリソースの URL。
    ID 文字列 (1024) ソースシステムからの一意の識別子。
    インターネットフェーシング ブーリアン コンポーネントがパブリックインターネットから到達可能かどうかを示すブール値。コンポーネントが到達可能な場合は 1 または「true」を指定します。
    認証 文字列 承認または認証方法のタイプ。例：
    • 基本
    • キー
    • OAuth
    • なし
    要求データタイプ 文字列 (255) 要求内のデータタイプのリスト。例：
    • CC
    • メール
    • アドレス
    応答データタイプ 文字列 (255) 応答内のデータタイプのリスト。例：
    • CC
    • メール
    • アドレス

    重要な関係構造

    不一致 API エンドポイント [cmdb_ci_unmatched_api_endpoint] CMDB クラスおよび検出された API エンドポイント [api_endpoint_discovered] 非 CMDB テーブルは、非構造化 API データが取り込まれ、統合ハブ ETL の機能を超えて処理する必要があるシナリオを対象としています。

    検出された API エンドポイント [api_endpoint_discovered] は、API [cmdb_ci_api] および API コンポーネント [cmdb_ci_api_component] クラスの生データのステージングテーブルとしても機能します。検出された API エンドポイント [api_endpoint_discovered] テーブルに最初に入力できるのは、適切に構造化されたデータソースから取得されていない、または標準の識別ルールを適用できない API データです。その後、顧客定義の統合を使用して、API [cmdb_ci_api] および API コンポーネント [cmdb_ci_api_component] の品質と条件の要件に一致する適切な形式のデータを昇格させ、最も適切なテーブルに入力できます。

    データが正しく解析できない場合や、予期しない方式で構造化されている場合は、代わりに顧客定義の統合を使用することで、不一致 API エンドポイント [cmdb_ci_unmatched_api_endpoint] テーブルに入力できます。

    検出された API エンドポイント [api_endpoint_discovered] テーブルに入力されたデータは、30 日ごとに消去されます。

    表 : 2. 検出された API エンドポイント [api_endpoint_discovered]
    属性 データタイプ 説明
    名前 文字列 (100) API エンドポイントの名前。
    メソッド 文字列 REST API のメソッド。例：
    • GET
    • POST
    • DELETE
    URL 文字列 (1024) 呼び出されるリソースの URL。
    タイプ 選択リスト API のタイプ。以下を指定できます。
    • REST
    • SOAP
    • HTTP
    • gRPC
    • GraphQL
    • Websocket
    認証 文字列 承認または認証方法のタイプ。例：
    • 基本
    • キー
    • OAuth
    • なし
    インターネットフェーシング ブーリアン コンポーネントがパブリックインターネットから到達可能かどうかを示すブール値。コンポーネントが到達可能な場合は 1 または「true」を指定します。
    要求データタイプ 文字列 (255) 要求内のデータタイプのリスト。例：
    • CC
    • メール
    • アドレス
    応答データタイプ 文字列 (255) 応答内のデータタイプのリスト。例：
    • CC
    • メール
    • アドレス
    ヘッダー 文字列 (255) ヘッダー名のカンマ区切りリスト。
    構成アイテム 参照 一致する CMDB CI (API コンポーネントまたは不一致 API エンドポイント) への参照。

    関連する非CMDB テーブル

    不一致 API 拡張クラスは、API 展開 [api_deployment] の非 CMDB テーブルを関連リストとして使用します。

    表 : 3. API 展開 [api_deployment]
    属性 データタイプ 説明
    名前 文字列 (100) API 展開の名前。
    API 参照 展開済み API (cmdb_ci_api) への参照。
    不一致 API エンドポイント 参照 API が既存の API と一致しない場合の、不一致 API エンドポイントへの参照 (cmdb_ci_unmatched_api_endpoint)。
    構成アイテム 参照 構成アイテムへの参照。API の展開先 CI が既知の場合、これは通常、手動で参照として指定されます。