# AWS API Gateway用API定義の取得

AWS API Gatewayと互換性があるJSONファイルとして、API定義をTalend Cloud API Designerからエクスポートします。

## 始める前に

* cURLをインストール済みであること。詳細は、[cURLのドキュメンテーション](https://curl.haxx.se/docs/)をご覧ください。
* Talend Cloudから個人用のアクセストークンが生成されていること。詳細は、[パーソナルアクセストークンを生成](https://help.qlik.com/talend/r/ja-JP/Cloud/management-console-user-guide/cloud-access-token)をご覧ください。
* Talend Cloud API DesignerでAPIを作成済みであること。

## 手順

1. コマンドラインを開き、次のコマンドを入力して自分のAPI定義をエクスポートします:
   ```
   curl --header "Authorization:Bearer {userToken}" -X GET -o {outFile}.json https://apid.{region}.cloud.talend.com/api/v1/api-definitions/{api-id}?format=OpenApi3Aws
   ```
2. 正しいパラメーターを追加します:
   | パラメーター | 説明 |
   | --- | --- |
   | {userToken} | Talend Cloudから生成されたトークン。 |
   | {outFile} | API定義のパスとファイル名。例: contactsapi.json |
   | {region} | 使用するTalend Cloudアカウントのリージョン。値は次のようになります。<br><br><ul> <li> <span>us-west</span> </li> <li> <span>us</span> </li> <li> <span>eu</span> </li> <li> <span>ap</span> </li> <li> <span>au</span> </li> </ul><br><br>詳細は、[Talend CloudのリージョンとURL](https://help.qlik.com/talend/r/ja-JP/Cloud/links-regions-urls)をご覧ください。 |
   | {api-id} | 取得するAPIバージョンのID。取得するためには、Talend Cloud API DesignerでAPIを開き、[Settings] (設定) &gt; [MANAGEMENT API] (管理API)に移動するか、/api-definitionsエンドポイントでGETメソッドを使ってAPI定義のリストをIDと共に取得します。 |
3. コマンドを実行します。

## タスクの結果

API定義はAWS API Gatewayと互換性があるJSONファイルとしてエクスポートされ、選択したディレクトリーに保存されます。

API Gateway互換性モードによるAPI定義のエクスポートの詳細は、[Talend Cloud API Designerユーザーガイド](https://help.qlik.com/talend/r/ja-JP/Cloud/api-designer-user-guide)をご覧ください。