Amazon パターンを使用した API Gateway ディスカバリー

  • リリースバージョン: Yokohama
  • 更新日 2025年07月31日
  • 所要時間：4分

    • ServiceNow ディスカバリー アプリケーションと サービスマッピング アプリケーションは、Amazon AWS API Gateway パターンを使用して、Amazon API Gateway と他のエンティティへの接続を検索します。 これらのリソースを検出するには、ServiceNow Storeから最新バージョンの ディスカバリーとサービスマッピングパターン アプリケーションに更新する必要がある場合があります。

    バージョン 1.29.0 以降 ディスカバリーとサービスマッピングパターン Amazon AWS API Gateway パターンデータモデルが変更されています。

    図 : 1. 新しい Amazon AWS API Gateway パターンデータモデル
    Amazon AWS API Gateway パターンの新しいデータモデルの関係

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

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

    必須条件

    AWS前提条件を確認する
    詳細については、「 パターンを使用した Amazon AWS Cloud コンポーネントのディスカバリー」の前提条件セクションを参照してください。

    水平ディスカバリー中に ディスカバリー によって収集されるデータ

    ディスカバリー は、Amazon AWS API Gateway パターンの実行時に CMDB にデータを入力します。

    表 : 1. AWS API Gateway [cmdb_ci_aws_api_gateway]
    フィールド 説明
    名前 [name] 「aws-gateway-」+ アカウント ID + リージョンを連結します。

    例: aws-gateway-0000000000000-us-east-1。
    ID [id] 「aws-gateway-」+ アカウント ID + リージョンを連結します。

    例: aws-gateway-0000000000000-us-east-1。
    インストールステータス [install_status] AWSゲートウェイのインストールステータス。デフォルト値は [インストール済み] です。
    運用ステータス [operational_status] AWS ゲートウェイの運用ステータス。デフォルト値は [運用] です。
    表 : 2. マネージド API [cmdb_ci_managed_api]
    フィールド 説明
    ID [id] 「https://」+ API ID + 「.execute-api." + region + 「.amazonaws.com」を連結します。

    例: https://a1b2c3d4e5.execute-api.us-east-1.amazonaws.com。
    名前 [name] API の名前。
    説明 [short_description] API の説明。
    インストールステータス [install_status] API のインストールステータス。デフォルト値は [インストール済み] です。
    運用ステータス [operational_status] API の運用ステータス。デフォルト値は [運用] です。
    タイプ [type] API のタイプ:REST。
    バージョン [version] API のバージョン。
    完全修飾ドメイン名 [fqdn] API ID + ".execute-api." + region + ".amazonaws.com" を連結します。

    例: a1b2c3d4e5.execute-api.us-east-1.amazonaws.com。
    表 : 3. DNS 名 [cmdb_ci_dns_name]
    フィールド 説明
    名前 [name] DNS ホストの一意の名前または IP アドレス。
    IP アドレス [ip_address] DNS ホストの IP アドレス。
    図 : 2. Amazon API ゲートウェイ依存関係ビュー
    依存関係ビューマップ上の aWS API ゲートウェイの CI および接続

    関係性

    ディスカバリー は、API Gateway ディスカバリーをサポートするためにこれらの関係 Amazon 作成します。

    CI リレーションシップ CI
    AWS API Gateway [cmdb_ci_aws_api_gateway] Provides::Provided by マネージド API [cmdb_ci_managed_api]
    マネージド API [cmdb_ci_managed_api] Hosted on::Hosts AWS データセンター [cmdb_ci_aws_datacenter]
    マネージド API [cmdb_ci_managed_api] Uses::Used by DNS 名 [cmdb_ci_dns_name]
    DNS 名 [cmdb_ci_dns_name] Hosted on::Hosts AWS データセンター [cmdb_ci_aws_datacenter]
    キー値 [cmdb_key_value] 参照 マネージド API [cmdb_ci_managed_api]

    タグディスカバリー

    Amazon AWS API Gateway パターンはタグを収集し、キー値 [cmdb_key_value] テーブルに入力します。

    表 : 4. キー値 [cmdb_key_value]
    フィールド 説明
    キー [key] タグ名。
    値 [value] タグ値。
    構成アイテム [configuration_item] マネージド API [cmdb_ci_managed_api] テーブルを参照します。

    トップダウンディスカバリー中に サービスマッピング によって検出される接続

    サービスマッピング は、アプリケーションサービスのコンテキストで AWS API Gateway のトップダウンディスカバリーを実行します。AWS API Gateway の発信接続を検出します。
    • AWS Lambda
    • 仮想プライベートクラウド用 VPC リンク
    • API Gateway で設定済み URL として定義された HTTP エンドポイント