演習 - バックエンド API を作成する - Training

この演習では、次のアクションを実行する方法について学習します。

前提条件

アクティブなサブスクリプションがある Azure アカウント。アカウントを取得済みでない場合は、https://azure.com/free から無料評価版にサインアップできます。

再入力の手間を省くために、CLI コマンドで使用する変数を設定してみましょう。 <myLocation> を、ご自分にとって意味のある地域に置き換えてください。 APIM 名はグローバルに一意の名前にする必要があります。次のスクリプトによってランダムな文字列が生成されます。 <myEmail> を、アクセスできるメールアドレスに置き換えます。
```
myApiName=az204-apim-$RANDOM
myLocation=<myLocation>
myEmail=<myEmail>
```
リソースグループを作成する。次のコマンドによって az204-apim-rg という名前のリソースグループが作成されます。
```
az group create --name az204-apim-rg --location $myLocation
```
APIM インスタンスを作成します。 az apim create コマンドは、インスタンスの作成に使用されます。 --sku-name Consumption オプションは、チュートリアルのプロセスを高速化するために使用されます。
```
az apim create -n $myApiName \
    --location $myLocation \
    --publisher-email $myEmail  \
    --resource-group az204-apim-rg \
    --publisher-name AZ204-APIM-Exercise \
    --sku-name Consumption 
```
Note

操作は約 5 分で完了します。

このセクションでは、OpenAPI の仕様のバックエンド API をインポートおよび発行する方法を示します。

一覧から [OpenAPI] を選択して、ポップアップで [完全] を選択します。

The OpenAPI dialog box. Fields are detailed in the following table.

フォームに入力するには、次の表の値を使用します。記載されていないフィールドはすべて既定値のままにすることができます。

設定	値	説明
OpenAPI 仕様	`https://conferenceapi.azurewebsites.net?format=json`	API を実装するサービスを参照します。要求は、このアドレスに転送されます。フォームに必要な情報の大部分は、入力後に自動的に設定されます。
表示名	Demo Conference API(デモ会議 API)	この名前は開発者ポータルに表示されます。
名前	demo-conference-api	API の一意の名前を指定します。
説明	自動的に設定される	API の任意の説明を指定します。
API URL サフィックス	conference	サフィックスは、API Management サービスのベース URL に付加されます。 API Management では API がサフィックスによって識別されるため、サフィックスは、特定の発行者のすべての API で一意である必要があります。

Demo Conference API が作成され、バックエンドを指定する必要があります。

右側にあるブレードで [設定] を選択して、[Web サービス URL] フィールドに https://conferenceapi.azurewebsites.net/ と入力します。
[サブスクリプションが必要] チェックボックスをオフにします。
[保存] を選択します。

API がインポートされ、バックエンドが構成されたので、次は API をテストします。

[Test] を選択します。
[GetSpeakers] を選択します。クエリパラメーターとヘッダーがあれば、このページの [クエリパラメーター] と [ヘッダー] に表示されます。 Ocp-Apim-Subscription-Key には、この API に関連付けられているサブスクリプションキーが自動的に入力されます。
[Send] を選択します。

バックエンドは 200 OK といくつかのデータで応答します。

この演習で作成したリソースの使用が完了したら、次のコマンドを使用し、リソースグループとすべての関連リソースを削除できます。

az group delete --name az204-apim-rg