# Azure API ManagementにAPI定義をインポート

Azure API ManagementにAPI定義をインポートします。

## 始める前に

* Azure API Manangementにアクセスできること。
* Microsoft PowerShellがインストール済みであること。詳細は、[Microsoft PowerShellドキュメンテーション](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell?view=powershell-6)を参照してください。
* Azure PowerShellモジュールがインストール済みであること。詳細は、[Microsoft Azureドキュメンテーション](https://docs.microsoft.com/en-us/powershell/azure/install-az-ps?view=azps-2.4.0)を参照してください。
* API定義をエクスポート済みであること。

## 手順

1. コマンドラインを開きます。
2. コマンドごとにコンテキストを設定しなくてもいいよう、次のコマンドを実行し、変数としてこれを追加します:
   ```
   $ApiMgmtContext = New-AzApiManagementContext -ResourceGroupName "{ResourceGroupName}" -ServiceName "{ServiceName}"
   ```
   | パラメーター | 説明 |
   | --- | --- |
   | {ResourceGroupName} | サービスに関連付けられているリソースのグループ。Microsoft Azureポータルで見つかります。 |
   | servicename | サービスの名前。Microsoft Azureポータルで見つかります。 |
3. 次のコマンドを入力してファイルをアップロードします:
   ```
   Import-AzApiManagementApi -Context $ApiMgmtContext -SpecificationFormat "{format}" -SpecificationPath "{yourfile}" -Path "{api-url-suffix}" 
   ```
4. 正しいパラメーターを追加します:
   | パラメーター | 説明 |
   | --- | --- |
   | {format} | インポートするAPI定義の形式。値は次のようになります:<br><br><ul> <li> <span>Swagger</span> (推奨)</li> <li> <span>Wadl</span> </li> <li> <span>Wsdl</span> </li> <li> <span>OpenApi</span> </li> </ul> |
   | {yourfile} | エクスポートしたAPI定義のパスとファイル名。 |
   | {api-url-suffix} | 使用するAPIのパブリックURLの最後に追加するWeb APIパス。 |

## タスクの結果

APIがインポートされ、そのAPIに関する情報(IDなど)がコマンドラインで返されます。この情報は更新に使用できます。使用するAPI定義はAzureポータルでチェックできます。

![AzureポータルでのAPI定義。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/az_import.png)

Import-AzApiManagementApiコマンドの詳細は、[Azureドキュメンテーション](https://docs.microsoft.com/en-us/powershell/module/az.apimanagement/Import-AzApiManagementApi?view=azps-2.4.0)を参照してください。