# AWS API GatewayでAPI定義をアップデート

既存の定義をアップデートできるよう、JSONファイルをAPI Gatewayにインポートします。

## 始める前に

* AWS APIゲートにアクセスできること。
* AWS CLIをインストール済みであること。詳細は、[\[Installing the AWS CLI\] (AWS CLIのインストール)](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)を参照してください。
* API定義をJSONファイルとしてエクスポート済みであること。
* APIの以前のバージョンがAWS API Gatewayにアップグレードされていること。

## 手順

1. コマンドラインを開き、次のコマンドを入力してファイルをアップロードします:
   ```
   aws apigateway put-rest-api --rest-api-id {api-id} --mode {mode} --body 'file://{yourfile}.json'
   ```
2. 正しいパラメーターを追加します:
   | パラメーター | 説明 |
   | --- | --- |
   | {api-id} | アップデートするAPIのAWS API GatewayID。 |
   | [Mode] (モード) | インポート時の動作。この値は、APIの以前のバージョンを新しいバージョンに上書きする場合はoverwriteに、2つのバージョンをマージする場合はmergeになります。 |
   | {yourfile} | エクスポートしたAPI定義のパスとファイル名。 |
3. コマンドを実行します。

## タスクの結果

定義したモードに応じて、API定義がマージまたは上書きされます。AWS API Gatewayコンソールのアップデートをチェックできます。

このサンプルでは、/contactsリソースの最初のバージョンとそのオペレーションだけを含んでいるAPI定義がアップロードされていました。次に、/companiesリソースを含んでいる2番目のバージョンがアップロードされ、以前のバージョンとマージされました。

![マージされたAPI定義のスクリーンショット。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/aws_2.png)

put-rest-apiコマンドの詳細は、[AWSドキュメンテーション](https://docs.aws.amazon.com/cli/latest/reference/apigateway/put-rest-api.html)をご覧ください。