---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Amazon API Gateway ディスカバリー

# Amazon API Gateway ディスカバリー {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

ServiceNow ディスカバリー と サービスマッピング の各アプリケーションでは、他のエンティティに対する AWS API Gateway と接続を検索できます。 これらのリソースを検出するには、ServiceNow Store から ディスカバリーとサービスマッピングパターン アプリケーションをアップデートする必要があります。
ディスカバリー および サービスマッピング は、Amazon AWS API Gateway パターンを使用して、水平ディスカバリーとトップダウンディスカバリーを実行します。

このパターンを ServiceNow プラットフォームで使用するには、Kingston リリース以降を使用します。

## ストアでアプリを要求する {#aws-api-gateway-discovery__section_b5k_lfm_rlb}

[ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「[ServiceNow Storeバージョン履歴のリリースノート](https://www.servicenow.com/docs/bundle/store-release-notes/page/release-notes/store/sn-store-release-notes.html)」を参照してください。{#aws-api-gateway-discovery__inline-send-to-store}

## 必須条件 {#aws-api-gateway-discovery__section_wf1_tn2_ycb}

認証情報が設定されている AWS サービスアカウント
:   Now Platform® で、次の情報を使用してサービスアカウントを設定します。

    * アカウント ID。API Gateway が属する Amazon アカウント ID です。AWS マネジメントコンソールに表示されるアカウント ID を使用します。サービスアカウントフォームからディスカバリーを実行できます。
    * AWS クラウドに到達するためにアカウント ID で必要とされる適切な AWS 認証情報。

    {#aws-api-gateway-discovery__ul_trn_xyk_ddb}

    製品ドキュメントで ディスカバリー および サービスマッピング のサービスアカウントを参照してください。

更新セット
:   Jakarta または Istanbul バージョンのインスタンスの場合は、「[KB0679927](https://support.servicenow.com/kb_view.do?sysparm_article=KB0679927)：AWS Lambda トップダウンディスカバリー更新セット (AWS Lambda top-down discovery update set)」で用意されている更新セットをインポートします。サービスマッピング には、この更新セットが必要です。

ユーザーアクセス
:   AWS コンソールで、API Gateway の GET アクションのためだけに `apigateway:GET` 関数を実行する権限をユーザーに与えます。

## 水平ディスカバリー中に ディスカバリー によって収集されるデータ {#aws-api-gateway-discovery__section_fg5_mgf_ycb}

{#aws-api-gateway-discovery__table_hgv_jjd_ssb__entry__2}

| テーブルとフィールド | 追加情報 |
|-|-|
| クラウドゲートウェイ \[cmdb_ci_cloud_gateway\] ||
| オブジェクト ID | ゲートウェイの ID。 |
| 簡単な説明 | ゲートウェイの簡単な説明。 |
| DNS 名 \[cmdb_ci_dns_name\] ||
| 名前 | DNS ホストの一意の名前または IP アドレス。 |
| IP アドレス | DNS ホストの IP アドレス。 |
| AWS リソース名エンドポイント \[cmdb_ci_endpoint_arn\] ||
| ホスト | エンドポイントのホスト名または IP アドレス。 |
| ARN | ゲートウェイが接続するその他の AWS エンティティの ID (Amazon リソースネーム)。 |
[ ]

{#aws-api-gateway-discovery__table_hgv_jjd_ssb}

## 構成アイテム (CI) 関係 {#aws-api-gateway-discovery__section_zgx_wrj_cdb}

以下の関係は、Amazon API Gateway ディスカバリーをサポートするために作成されています。{#aws-api-gateway-discovery__table_bhf_412_ycb__entry__3}

| CI | 関係 | CI |
|-|-|-|
| クラウドゲートウェイ \[cmdb_ci_cloud_gateway\] | Uses:Used by | DNS 名 \[cmdb_ci_dns_name\] |
| クラウドゲートウェイ \[cmdb_ci_cloud_gateway\] | Hosted on:Hosts | AWS データセンター \[cmdb_ci_aws_datacenter\] AWS データセンターには、アベイラビリティゾーン、サービスアカウントなどの他の AWS CI との関係性があります。詳細については、製品ドキュメントの AWS と Azure クラウドディスカバリーの箇所を参照してください。 |
[ ]

{#aws-api-gateway-discovery__table_bhf_412_ycb}

## トップダウンディスカバリー中に サービスマッピング によって検出される接続 {#aws-api-gateway-discovery__section_knp_fjd_908}

サービスマッピング は、アプリケーションサービスのコンテキストで AWS API Gateway のトップダウンディスカバリーを実行します。AWS API Gateway の発信接続を検出します。

* AWS Lambda
* 仮想プライベートクラウド用 VPC リンク
* API Gateway で設定済み URL として定義された HTTP エンドポイント
{#aws-api-gateway-discovery__ul_nm5_3by_fdb}

## トラブルシューティング {#aws-api-gateway-discovery__section_sf2_nsj_yhb}

マッピングプロセスが期待どおりに進行しない場合は、次の提案に従ってください。{#aws-api-gateway-discovery__table_ggn_ypj_yhb__entry__3}

| 症状 | 原因 | ソリューション |
|-|-|-|
| ディスカバリーに失敗しました。ディスカバリーメッセージには、REST タイムアウトによって発生したエラーに関する情報が含まれています。 | 展開で REST コール応答を送信する CI が多数あります。MID サーバー は mid.sa.cloud.request_timeout パラメーターで制御される制限時間を超えずに REST コール応答を処理することはできません。 | デフォルトで、mid.sa.cloud.request_timeout パラメーターは 3 万ミリ秒に設定されています。 関連する MID サーバー に対してこのパラメーターの値を増やし、ディスカバリーを再実行します。 注: 関連する MID サーバー の \[設定パラメーター\] 関連リストにこのパラメーターが表示されない場合は、追加する必要があります。 |
| デバッグセッション中にパターンデザイナーでエラーが発生しました。パターンデザイナーのメッセージに、タイムアウトによって発生したエラーに関する情報が含まれています。 | パターンデザイナーは、(ディスカバリー時ではなく) パターンデバッグ中のタイムアウトが原因で失敗します。 | デフォルトで、sa.debugger.max_timeout パラメーターは 240 秒に設定されています。 関連する MID サーバー に対してこのパラメーターの値を増やします。 |
[ ]

{#aws-api-gateway-discovery__table_ggn_ypj_yhb}
* **[AWS API Gateway および AWS Lambda を検出するためのテストパターン](https://servicenow-prod.fluidtopics.net/9Ri3DE3h3kXpKng3o8Cxtg)**   
  Amazon AWS API Gateway \[cmdb_ci_cloud_gateway\] パターンと Amazon AWS Lambda \[cmdb_ci_cloud_function\] パターンを使用して、水平ディスカバリーおよびトップダウンディスカバリーを実行します。結果が想定どおりであることを確認します。

**関連タスク**   

* [AWS API Gateway および AWS Lambda を検出するためのテストパターン](https://servicenow-prod.fluidtopics.net/9Ri3DE3h3kXpKng3o8Cxtg "Amazon AWS API Gateway [cmdb_ci_cloud_gateway] パターンと Amazon AWS Lambda [cmdb_ci_cloud_function] パターンを使用して、水平ディスカバリーおよびトップダウンディスカバリーを実行します。結果が想定どおりであることを確認します。")