Amazon CloudSearch と API Gateway の統合

にサインインし AWS マネジメントコンソール、https://console.aws.amazon.com/apigateway で API Gateway コンソールを開きます。

[API を作成] を選択するか、API Gateway を初めて使用する場合は [開始する] を選択します。

[REST API] (プライベートではない) で、[構築] を選択します。

名前と、必要に応じて説明を入力した後、[API を作成] をクリックします。

[アクション]、[メソッドを作成] の順に選択します。ドロップダウンメニューから GET を選択して確定します。

[Integration Type] で､[AWS Service] を選択します｡

AWS [リージョン] で、Amazon CloudSearch ドメインが置かれているリージョンを選択します。

AWS [サービス] で、[CloudSearch] を選択します。

AWS [サブドメイン] で、Amazon CloudSearch ドメインの検索エンドポイントのサブドメインを指定します。

例えば、ドメインの検索エンドポイントが search-my-test-asdf5asdfasdfasdfasd5asdfg.us-west-1.cloudsearch.amazonaws.com の場合、search-my-test-asdf5ambgebbgmmodhhq5asdfg を指定します。

HTTP Method で GET を選択します。

[アクションの種類] で、[パス上書きの使用] を選択し、/2013-01-01/search を入力します。

実行ロール で、my-api-gateway-role の ARN (例: arn:aws:iam::123456789012:role/my-api-gateway-role) を指定します。

コンテンツの処理で、パススルー を選択し、デフォルトのタイムアウトを使用して保存を選択します。

[メソッドリクエスト] を選択します。

リクエストの検証で、クエリ文字列パラメータおよびヘッダーの検証を選択して、確定します。

[URL クエリ文字列パラメータ] を展開します。[クエリ文字列を追加] を選択し、文字列に q と名前を付けて確定します。必要に応じてクエリ文字列をマークします。

メソッドの実行を選択して、メソッドの要約に戻ります。

統合リクエストを選択します。

[URL クエリ文字列パラメータ] を展開します。[クエリ文字列を追加] を選択します。文字列に q と名前を付け、method.request.querystring.q のマッピングを指定して、確定します。

メソッドの実行ページに移動します。

テストを選択します。

[クエリ文字列] で、Amazon CloudSearch ドメインの一部のデータに一致するクエリ文字列を入力します。IMDb 映画データを使用している場合は、q=thor を試してみてください。

テストを選択します。

レスポンス本文に、次のように検索結果が含まれていることを検証します。

{
  "status": {
    "rid": "rcWTo8IsviEK+own",
    "time-ms": 1
  },
  "hits": {
    "found": 7,
    "start": 0,
    "hit": [
      {
        "id": "tt0800369",
        "fields": {
          "rating": "7.0",
          "genres": [
            "Action",
            "Adventure",
            "Fantasy"
          ],
          "title": "Thor",
          "release_date": "2011-04-21T00:00:00Z",
          "plot": "The powerful but arrogant god Thor is cast out of Asgard to live amongst humans in Midgard (Earth), where he soon becomes one of their finest defenders.",
          "rank": "135",
          "running_time_secs": "6900",
          "directors": [
            "Kenneth Branagh",
            "Joss Whedon"
          ],
          "image_url": "http://ia.media-imdb.com/images/M/MV5BMTYxMjA5NDMzNV5BMl5BanBnXkFtZTcwOTk2Mjk3NA@@._V1_SX400_.jpg",
          "year": "2011",
          "actors": [
            "Chris Hemsworth",
            "Anthony Hopkins",
            "Natalie Portman"
          ]
        }
      },
      ...
    ]
  }
}