Amazon パターンによる API ゲートウェイディスカバリー

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：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にアクセスして、利用可能なすべてのアプリを表示し、ストアに要求を送信する方法を確認してください。リリースされたすべてのアプリのリリースメモ情報については、「ServiceNow Store バージョンの履歴リリースノート」を参照してください。

    必須条件

    AWS前提条件を確認する
    詳細については、「 AWS パターンを使用したディスカバリー」の前提条件セクションを参照してください。
    重複を避けるために従来のデータモデル CI を廃止する
    CI の重複を避けるには、スケジュールジョブをアクティブ化して、従来のデータモデル CI を廃止としてマークします。詳細については、「従来の AWS API ゲートウェイデータモデル CI の廃止」を参照してください。

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

    ディスカバリー は、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 エンドポイント