API 拡張クラス
CMDB CI クラスモデル ServiceNow Storeアプリは、API (アプリケーションプログラミングインターフェイス) のクラスを追加または更新します。
CMDB CI クラスモデルアプリは、クラスの説明、識別ルール、識別子エントリ、および該当する場合は依存関係を含む、CMDBクラス階層を拡張するクラスモデルを追加します。追加したクラスは、他の CMDB クラスと同じように使用できます。ディスカバリーとサービスマッピングパターン などのアプリケーションは、クラス拡張を使用して CI に入力し、テクノロジーとソフトウェアを検出できます。
ストアでアプリを要求する
ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。
API 一覧
API は、コンピュータープログラムが相互に通信できるようにする一連の定義とプロトコルであり、アプリケーションソフトウェアをビルドまたは統合できるようにします。API は通常、Web ベースのテクノロジーを使用して他の API と通信します。API は通常、プログラムでジョブやタスクを実行したり、データを表示、インポート、エクスポート、削除、または変更したりするために使用されます。
- API のヴィジビリティを向上させます。
- API エンドポイントに関連するセキュリティの問題と脆弱性を特定します。
クラス
このセクションでは、 CMDB CI クラスモデル ストアアプリが追加または更新するクラスを一覧表示します。 詳細については、 コミュニティの記事「API 用 CMDB の新しいデータモデル」を参照してください。
CMDB CI クラスモデル:リリース 1.49.0 では、API に次のクラスが追加されています。 このアプリが拡張する可能性のあるクラスを含む、 ベースシステム内のクラスのリストについては、「 CMDB テーブルの説明」を参照してください。
| クラス | 拡張 | 説明 |
|---|---|---|
| API [cmdb_ci_api] |
構成アイテム cmdb_ci |
2 つのコンピュータープログラムが、通常は Web ベースのテクノロジーを使用して相互に通信できるようにする API。例：ChatAPI (https://[apiID].execute-api.use-east-2.amazonaws.com)。 |
| API コンポーネント [cmdb_ci_api_component] |
構成アイテム cmdb_ci |
機能やデータ交換を容易にする API 定義に関連する再利用可能なオブジェクト。[API ヘッダー] 関連リスト。例：GET https://[instance].service-now.com/api/now/table/{tablename}。 |
| API フロントエンド [cmdb_ci_api_frontend] |
API コンポーネント [cmdb_ci_api_component] |
クライアントまたはユーザーがやり取りまたは要求を行う API の部分。例：GET https://[apiID].execute-api.us-east-2.amazonaws.com/{proxy+} |
| API バックエンド [cmdb_ci_api_backend] |
API コンポーネント [cmdb_ci_api_component] |
サーバーなどのバックエンドサービスとやり取りすることによって要求を満たす API の部分。例：Lambda:Chat-API-Proxy。 |
| API ゲートウェイ [cmdb_ci_api_gateway] |
アプリケーション [cmdb_ci_appl] |
クライアント API 要求を一元化し、バックエンドのプロセスとサービスを管理する API インフラストラクチャ。例：Kong ゲートウェイ。 |
| マネージド API [cmdb_ci_managed_api] |
構成アイテム [cmdb_ci_api] |
ゲートウェイまたは管理サービスから検出された API。このクラスの API のゲートウェイへの依存関係を適用できます。 |
クラス属性
CMDB CI クラスモデル:リリース 1.49.0 では、それぞれのクラスに次の属性が追加されています。
| 属性 | データタイプ | 説明 |
|---|---|---|
| ベース URL | 文字列 (1024) | すべての API コンポーネントの拡張元となるベースアドレス。 |
| ID | 文字列 (1024) | ソースシステムからの一意の識別子。 |
| タイプ | 選択リスト | API のタイプ。以下を指定できます。
|
| バージョン | 数値 | API のバージョン。 |
| 仕様の場所 | URL | API 仕様の場所への URL。例：OpenAPI の仕様定義。 |
| 属性 | データタイプ | 説明 |
|---|---|---|
| メソッド | 文字列 | REST API のメソッド。例：
|
| プロトコル | 文字列 | 通信プロトコル。例：HTTP、HTTPS。 |
| ホスト | 文字列 (100) | API をホストするシステム。 |
| パス | 文字列 (1024) | API がたどる特定のルート。 |
| ポート | 文字列 | 通信ポート。例：80、443 など。 |
| URL | 文字列 (1024) | 呼び出されるリソースの URL。 |
| ID | 文字列 (1024) | ソースシステムからの一意の識別子。 |
| インターネットフェーシング | ブーリアン | コンポーネントがパブリックインターネットから到達可能かどうかを示すブール値。コンポーネントが到達可能な場合は 1 または「true」を指定します。 |
| 認証 | 文字列 | 承認または認証方法のタイプ。例：
|
| 要求データタイプ | 文字列 (255) | 要求内のデータタイプのリスト。例：
|
| 応答データタイプ | 文字列 (255) | 応答内のデータタイプのリスト。例：
|
| 属性 | データタイプ | 説明 |
|---|---|---|
| 親 ID | 参照先 [cmdb_ci_api_frontend] | 親 API コンポーネントへの参照。 |
| 属性 | データタイプ | 説明 |
|---|---|---|
| タイプ | 文字列 | API のバックエンドプロトコルタイプ。例：
|
| 属性 | データタイプ | 説明 |
|---|---|---|
| ID | 文字列 (255) | ソースシステムからの一意の識別子。 |
重要な関係構造
API クラスと Kong クラスには、いくつかの重要な関係を定義する必要があります。
| 親クラス | 関係 | 子クラス | 関係性タイプ |
|---|---|---|---|
| API [cmdb_ci_api] |
Uses::Used by | API コンポーネント [cmdb_ci_api_component] |
提案済み |
| API ゲートウェイ [cmdb_ci_api_gateway] |
Provides::Provided By | マネージド API [cmdb_ci_managed_api] |
依存 |
| API フロントエンド [cmdb_ci_api_frontend] |
Use End Point To::Use End Point From | API バックエンド [cmdb_ci_api_backend] |
提案済み |
| API バックエンド [cmdb_ci_api_backend] |
Uses::Used By | Kong ロードバランサー [cmdb_ci_kong_lb] |
提案済み |
関連する非 CMDB テーブル
CMDB CI クラスモデル v 1.49.0 では、これらの非 CMDB テーブルが次の API 拡張クラスの関連リストとして導入されています。
- API 関連リスト
表 : 7. API 展開 [api_deployment] 属性 データタイプ 説明 名前 文字列 (100) API 展開の名前。 API 参照 展開済み API (cmdb_ci_api) への参照。 不一致 API エンドポイント 参照 API が既存の API と一致しない場合の、不一致 API エンドポイントへの参照 (cmdb_ci_unmatched_api_endpoint)。 構成アイテム 参照 構成アイテムへの参照。API の展開先 CI が既知の場合、これは通常、手動で参照として指定されます。 注:API 展開の非 CMDB テーブルは、API [cmdb_ci_api] クラスと不一致 API エンドポイント [cmdb_ci_unmatched_api_endpoint] クラスの両方に関連しています。- API コンポーネント関連リスト
表 : 8. API ヘッダー [api_header] 属性 データタイプ 説明 名前 文字列 (100) API ヘッダーの名前。 API コンポーネント 参照 API ヘッダーが定義されているコンポーネントへの参照 (cmdb_ci_api_component)。 不一致 API エンドポイント 参照 エンドポイントを既存の API またはコンポーネントと一致させることができない場合の、一致していない API への参照 (cmdb_ci_unmatched_endpoint)。 - API ゲートウェイ関連リスト
表 : 9. API コンシューマー [api_consumer] 属性 データタイプ 説明 ユーザー名 文字列 (100) API コンシューマーの名前。
注:api_policyテーブルの [コンシューマー ] フィールドは参照フィールドです。[API ポリシー] リストの [ユーザー名] フィールドにユーザー名を表示するには、ユーザー名の display 属性をtrueに設定する必要があります。属性がtrueに設定されていない場合、リストには代わりにシステム ID が表示されます。ID 文字列 (255) ソースシステムからの一意の識別子。 カスタム ID 文字列 (100) ユーザーの代替表示名。 API ゲートウェイ 参照 コンシューマーが定義されているゲートウェイへの参照 (cmdb_ci_api_gateway)。