API Gateway コンソールを使用して API キーをセットアップする - Amazon API Gateway

API Gateway コンソールを使用して API キーをセットアップする

API キーを設定するには、以下の作業を行います。

  • API キーを要求するよう API メソッドを設定します。

  • リージョンの API 用に API キーを作成またはインポートします。

API キーを設定するには、事前に API を設定し、それをステージにデプロイしている必要があります。

API Gateway コンソールを使用して API を作成し、デプロイする方法については、「Amazon API Gateway での REST API の作成」および「Amazon API Gateway での REST API のデプロイ」をそれぞれ参照してください。

メソッドで API キーを要求する

次の手順では、API キーを要求する API メソッドを設定する方法について説明します。

API キーを要求する API メソッドを設定するには

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

  2. API Gateway のメインナビゲーションペインで、[Resources (リソース)] を選択します。

  3. [リソース] で、新しいメソッドを作成するか、既存のメソッドを選択します。

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

  5. [認証の設定] セクションで、[必要な API キー] に、[true] を選択します。

  6. チェックマークアイコンを選択して、設定を保存します。

  7. API をデプロイまたは再デプロイして要件を満たします。

API Key Required オプションを false に設定し、上記の手順を実行しない場合、そのメソッドに対しては API ステージに関連付けられている API キーが使用されません。

API キーを作成する

使用量プランで使う API キーをすでに作成またはインポートした場合、この手順および次の手順を省略できます。

API キーを作成するには

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

  2. API Gateway のメインナビゲーションペインで、[API Keys (API キー)] を選択します。

  3. [アクション] ドロップダウンメニューから、[API キーの作成] を選択します。

    
                            使用量プランの API キーの作成
  4. [API キーの作成] で、以下の操作を行います。

    1. [Name (名前)] 入力フィールドに、API キー名 (例: MyFirstKey) を入力します。

    2. [Auto Generate (自動生成)] を選択してキーバリューを生成する API Gateway を取得するか、[Custom (カスタム)] を選択してキーを手動で入力します。

    3. [Save] を選択します。

    
                            使用量プランの API キーの作成
  5. 必要に応じてさらに API キーを作成するには、前述の手順を繰り返します。

API キーをインポートする

次の手順は、使用プランで API キーをインポートする方法について説明します。

API キーをインポートするには

  1. メインナビゲーションペインで、[API キー] を選択します。

  2. [アクション] ドロップダウンメニューから、[API キーのインポート] を選択します。

  3. カンマ区切りのキーファイルをロードするには、[CSV ファイルの選択] を選択します。キーを手動で入力することもできます。ファイル形式の詳細については、「API Gateway API キーファイルの形式」を参照してください。

    
                            API 使用量プランのエンティティ
  4. エラーが発生した場合、[警告を失敗とみなす] を選択してインポートを停止するか、[警告を無視する] を選択して、エラーが発生した場合に、有効なキーエントリのインポートを継続します。

  5. 選択した API キーのインポートを開始するには、[インポート] を選択します。

API キーをセットアップしたので、「使用量プランの作成と使用」に進むことができます。