チュートリアル: プライベート REST API を作成する

https://console.aws.amazon.com/cloudformation で AWS CloudFormation コンソール を開きます。

[スタックの作成] を選択し、[With new resources (standard) 新しいリソースを使用 (標準)] を選択します。

[Specify template (テンプレートの指定)] で、[Upload a template file (テンプレートファイルのアップロード)] を選択します。

ダウンロードしたテンプレートを選択します。

[Next (次へ)] を選択します。

[Stack name] (スタックの名前) で、private-api-tutorial と入力し、[Next] (次へ) を選択します。

[Configure stack options] (スタックオプションの設定) で、[Next] (次へ) を選択します。

[Capabilities] (機能) で、AWS CloudFormation がアカウントに IAM リソースを作成できることを承認します。

[送信] を選択します。

https://console.aws.amazon.com/apigateway で API Gateway コンソールにサインインします。

[Create API] (API を作成) を選択し、[REST API] で [Build] (構築) を選択します。

[API 名] に「private-api-tutorial」と入力します。

[API エンドポイントタイプ] で、[プライベート] を選択します。

[VPC エンドポイント ID] に、AWS CloudFormation スタックの [出力] からの VPC エンドポイント ID を入力します。

API の作成 を選択します。

https://console.aws.amazon.com/apigateway で API Gateway コンソールにサインインします。

API を選択します。

[メソッドの作成] を選択します。

[メソッドタイプ] で、[GET] を選択します。

[統合タイプ] で、[Lambda 関数] を選択します。

[Lambda プロキシ統合]を有効にします。Lambda プロキシ統合では、API Gateway は定義された構造を使用して Lambda にイベントを送信し、Lambda 関数からの応答を HTTP 応答に変換します。

[Lambda function] (Lambda 関数) には、ステップ 1 で AWS CloudFormation テンプレートを使用して作成した関数を選択します。関数の名前は private-api-tutorial で始まります。

[メソッドの作成] を選択します。

https://console.aws.amazon.com/apigateway で API Gateway コンソールにサインインします。

API を選択します。

[リソースポリシー]、[ポリシーを作成] の順に選択します。

以下のポリシーを入力します。vpceID を、AWS CloudFormation スタックの [Outputs] (出力) からの VPC エンドポイント ID に置き換えます。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Principal": "*",
            "Action": "execute-api:Invoke",
            "Resource": "execute-api:/*",
            "Condition": {
                "StringNotEquals": {
                    "aws:sourceVpce": "vpceID"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": "*",
            "Action": "execute-api:Invoke",
            "Resource": "execute-api:/*"
        }
    ]
}

[Save changes] (変更の保存) をクリックします。

https://console.aws.amazon.com/apigateway で API Gateway コンソールにサインインします。

API を選択します。

[API のデプロイ] を選択します。

[ステージ] で [新規ステージ] を選択します。

[Stage name (ステージ名)] に test と入力します。

(オプション) [説明] に説明を入力します。

[デプロイ] を選択します。

API Gateway コンソール (https://console.aws.amazon.com/apigateway) にサインインします。

API を選択します。

メインナビゲーションペインで、[ステージ]、[テスト] ステージの順に選択します。

[ステージの詳細] で、コピーアイコンを選択して API の呼び出し URL をコピーします。URL は https://abcdef123.execute-api.us-west-2.amazonaws.com/test のようになります。ステップ 1 で作成した VPC エンドポイントではプライベート DNS が有効になっているため、提供された URL を使用して API を呼び出すことができます。

curl を使用して、VPC の外部からの API の呼び出しを試みる

curl https://abcdef123.execute-api.us-west-2.amazonaws.com/test

Curl は、API のエンドポイントを解決できないことを示します。別の応答が返された場合は、ステップ 2 に戻り、API のエンドポイントタイプに [Private] (プライベート) を選択します。

curl: (6) Could not resolve host: abcdef123.execute-api.us-west-2.amazonaws.com/test

Amazon EC2 コンソール (https://console.aws.amazon.com/ec2/) を開きます。

[Instances] を選択します。

ステップ 1 で AWS CloudFormation テンプレートを使用して作成した private-api-tutorial という名前のインスタンスを選択します。

[Connect] (接続) を選択し、[Session Manager] を選択します。

[Connect] (接続) を選択して、インスタンスへのブラウザベースのセッションを起動します。

Session Manager セッションで、curl を使用して API を呼び出します。Amazon VPC でインスタンスを使用しているため、API を呼び出すことができます。

curl https://abcdef123.execute-api.us-west-2.amazonaws.com/test

応答 Hello from Lambda! が得られたことを確認します。

https://console.aws.amazon.com/apigateway で API Gateway コンソールにサインインします。

[API] ページで API を選択します。[API アクション]、[API を削除] の順に選択し、選択を確定します。

AWS CloudFormation コンソール (https://console.aws.amazon.com/cloudformation) を開きます。

AWS CloudFormation スタックを選択します。

[Delete] (削除) を選択し、選択を確定します。