AWS Lambda 関数の使用 - AWS Toolkit for VS Code
前提条件Lambda 関数の呼び出しLambda 関数の削除Lambda 関数のダウンロード新しい Lambda 関数の更新のデプロイ既存の Lambda 関数の更新のアップロードLambda 関数を AWS SAM プロジェクトに変換する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS Lambda 関数の使用

AWS Toolkit for Visual Studio Code を使用すると、ローカル VS Code 環境で AWS Lambda 関数を操作できます。Toolkit を使用すると AWS 、IDE を離れることなく、Lambda 関数を作成、編集、テスト、デバッグ、デプロイできます。 AWS Lambda サービスの詳細については、 AWS Lambdaデベロッパーガイドを参照してください。

以下のセクションでは、 で Lambda 関数の使用を開始する方法について説明します AWS Toolkit for Visual Studio Code。

注記

を使用して Lambda 関数を既に作成している場合は AWS Management Console、Toolkit から呼び出すことができます。さらに、Lambda 関数を VS Code に開くこともできます。詳細については AWS Lambda console、このユーザーガイドのAWS Lambda console 「IDE への 」トピックを参照してください。VS Code で新しい Lambda 関数を作成するには、このユーザーガイドの「新しいサーバーレスアプリケーション (ローカル) の作成」トピックで説明されているステップに従います。

前提条件

AWS Toolkit で AWS Lambda サービスを使用するには、次の条件を満たす必要があります。

  • の最新バージョン AWS Toolkit for Visual Studio Code がインストールされ、 AWS 認証情報を使用してセットアップされます。

  • AWS Identity and Access Management (IAM) 管理のアクセス許可とポリシーは、 AWS Lambda サービスと連携するように設定されています。アクセス許可を設定し、互換性のある AWS 管理ポリシーを作成する方法の詳細については、「 AWS Lambda デベロッパーガイド」のAWS Identity and Access Management 「 for AWS Lambda 」トピックを参照してください。

  • 既存の AWS Lambda 関数がある、または作成方法に精通している。Lambda 関数を作成する方法については、 AWS Lambda デベロッパーガイドの「最初の Lambda 関数を作成する」トピックを参照してください。

Lambda 関数の呼び出し

AWS アカウントから VS Code に Lambda 関数を呼び出すには、次の手順を実行します。

  1. から AWS Toolkit for Visual Studio Code、 AWS エクスプローラーを展開します。

  2. AWS エクスプローラーから、Lambda を展開して Lambda リソースを表示します。

  3. 呼び出す Lambda 関数のコンテキストメニューを開き (右クリック）、クラウドで呼び出しを選択するか、クラウドアイコンで呼び出しを選択して、VS Code でリモート呼び出し設定メニューを開きます。

  4. リモート呼び出し設定メニューから、ペイロード設定を指定し、イベントに必要な追加情報を追加します。

    注記

    最初の呼び出しプロセスは、 AWS エクスプローラーのクラウドで呼び出しを選択するとすぐに実行を開始できます。VS Code ターミナルの OUTPUT タブに出力が表示されます。

  5. リモート呼び出しボタンを選択して関数を呼び出します。VS Code ターミナルの OUTPUT タブに出力が表示されます。

Lambda 関数の削除

Lambda 関数を削除するには、次の手順を実行します。

警告

この手順は、AWS CloudFormation に関連付けられている Lambda 関数の削除には使用しないでください。これらの関数は、 AWS CloudFormation スタックを通じて削除する必要があります。

  1. から AWS Toolkit for Visual Studio Code、 AWS エクスプローラーを展開します。

  2. AWS エクスプローラーから、Lambda を展開して Lambda リソースを表示します。

  3. 削除する Lambda 関数を右クリックし、削除を選択します。

  4. プロンプトが表示されたら、関数を削除することを確認します。

関数が削除されると、 AWS エクスプローラーに表示されなくなります。

Lambda 関数のダウンロード

リモート Lambda 関数から VS Code ワークスペースにコードをダウンロードして、編集とデバッグを行うことができます。

注記

Lambda 関数をダウンロードするには、アクセス可能なフォルダを持つ VS Code ワークスペースで作業する必要があり、 AWS Toolkit は Node.js および Python ランタイムを使用する Lambda 関数でのみこの機能をサポートします。

  1. から AWS Toolkit for Visual Studio Code、 AWS エクスプローラーを展開します。

  2. AWS エクスプローラーから、Lambda を展開して Lambda リソースを表示します。

  3. ダウンロードする Lambda 関数を右クリックし、ダウンロードを選択します。

  4. Lambda 関数が VS Code エディタで開き、ダウンロードが完了すると AWS エクスプローラーに表示されます。 AWS Toolkit は、VS Code 実行パネルにも起動設定を作成し、 を使用して Lambda 関数をローカルで実行およびデバッグできるようにします AWS Serverless Application Model。の使用の詳細については AWS SAM、「」を参照してくださいテンプレートからのサーバーレスアプリケーションの実行とデバッグ (ローカル)。

新しい Lambda 関数の更新のデプロイ

ローカルマシンの指定されていない一時的な場所から、新しい Lambda 関数に更新をデプロイできます。

注記

Lambda ファイルに未デプロイの変更がある場合、VS Code エディタと AWS エクスプローラーで変更されたファイルの横にある M アイコンによって通知されます。

VS Code エディタからのデプロイ

  1. VS Code エディタで Lambda 関数からファイルを開き、ファイルを変更します。

  2. VS Code のメインメニューから手動で保存するか、 option+s (Mac) ctrl+s (Windows) を押します。

  3. VS Code は、クラウドへの変更のデプロイを自動的に求めるプロンプトを表示し、デプロイボタンを選択してデプロイを確認します。

  4. VS Code はデプロイのステータスを更新し、プロセスが完了すると通知します。

AWS Explorer からのデプロイ

  1. VS Code エディタで Lambda 関数からファイルを開き、ファイルを変更します。

  2. Toolkit から AWS 、 AWS エクスプローラーを展開します。

  3. AWS エクスプローラーから、変更をデプロイする Lambda 関数を使用して AWS リージョンを展開します。

  4. AWS リージョンから Lambda を展開し、変更をデプロイする関数に移動します。

  5. 関数の横にあるクイックメニューから、コードの保存とデプロイアイコンを選択します。

  6. VS Code はデプロイのステータスを更新し、プロセスが完了すると通知します。

既存の Lambda 関数の更新のアップロード

次の手順では、既存の Lambda 関数に加えられたローカルの変更をアップロードする方法について説明します。この機能は、Lambda がサポートするランタイムによるアップロードをサポートします。

警告

Lambda 関数をアップロードする前に、次の点に注意してください。

  • この方法でコードを更新しても、デプロイや AWS CloudFormation スタックの作成に AWS SAM CLI は使用されません。

  • Toolkit AWS はコードを検証しません。クラウドに変更をアップロードする前に、コードを検証し、関数をテストします (複数可）。

Zip アーカイブのアップロード

  1. から AWS Toolkit for Visual Studio Code、 AWS エクスプローラーを展開します。

  2. AWS エクスプローラーから、Lambda を展開して Lambda リソースを表示します。

  3. 変更をアップロードする Lambda 関数を右クリックし、Lambda のアップロード... を選択してアップロードタイプの選択メニューを開きます。

  4. ZIP Archive を選択して、ローカルディレクトリZIP Archive内の を見つけます。

  5. プロンプトが表示されたら、アップロードを確認して、選択した のアップロードを開始しますZIP Archive。

  6. アップロードのステータスは VS Code に表示され、アップロードプロセスが完了すると通知されます。

構築せずにディレクトリをアップロードする

  1. から AWS Toolkit for Visual Studio Code、 AWS エクスプローラーを展開します。

  2. AWS エクスプローラーから、Lambda を展開して Lambda リソースを表示します。

  3. 変更をアップロードする Lambda 関数を右クリックし、Lambda のアップロード... を選択してアップロードタイプの選択メニューを開きます。

  4. ディレクトリを選択して、ディレクトリのビルド画面に進みます。

  5. ビルドディレクトリ画面で、いいえ を選択してアップロードするローカルディレクトリを選択します。

  6. プロンプトが表示されたら、アップロードを確認して選択したディレクトリをアップロードします。

  7. アップロードのステータスは VS Code に表示され、アップロードプロセスが完了すると通知されます。

ビルドを含むディレクトリのアップロード
注記

以下の点に注意してください。

  • この手順には CLI AWS Serverless Application Model が必要です。

  • Toolkit は、アップロード前に一致するハンドラーを検出できないこと AWS を通知します。

  • Lambda 関数にアタッチされているハンドラーを変更するには、 AWS Lambda console または を使用します AWS Command Line Interface。

  1. から AWS Toolkit for Visual Studio Code、 AWS エクスプローラーを展開します。

  2. AWS エクスプローラーから、Lambda を展開して Lambda リソースを表示します。

  3. 変更をアップロードする Lambda 関数を右クリックし、Lambda のアップロード... を選択してアップロードタイプの選択メニューを開きます。

  4. ディレクトリを選択して、ディレクトリのビルド画面に進みます。

  5. ビルドディレクトリ画面から「はい」を選択し、アップロードするローカルディレクトリを選択します。

  6. プロンプトが表示されたら、アップロードを確認して、選択したディレクトリの構築とアップロードを開始します。

  7. アップロードのステータスは VS Code に表示され、アップロードプロセスが完了すると通知されます。

Lambda 関数を AWS SAM プロジェクトに変換する

Lambda 関数を AWS SAM スタックに変換するには、次の手順を実行します。

警告

現在、Lambda 関数を AWS SAM プロジェクトに変換するときは、リソースのサブセットのみがサポートされています。変換後に不足しているリソースを見つけるには、Lambda コンソールを確認し、 AWS SAM テンプレートに手動で追加します。サポートされているリソースとサポートされていないリソースの詳細については、「 AWS CloudFormation デベロッパーガイド」の「リソースタイプのサポート」トピックを参照してください。

  1. Toolkit から AWS 、 AWS エクスプローラーを展開します。

  2. AWS エクスプローラーから、 AWS SAM プロジェクトに変換する Lambda 関数を使用して AWS リージョンを展開します。

  3. AWS リージョンから Lambda を展開し、 AWS SAM スタックに変換する関数に移動します。

  4. Lambda 関数の横にあるクイックメニューから、SAM アプリケーションに変換アイコンを選択してローカルファイルシステムを参照し、新しい AWS SAM プロジェクトの場所を指定します。

  5. AWS Toolkit が Lambda 関数の AWS SAM プロジェクトへの変換を開始する場所を指定すると、VS Code はプロセスのステータスに関する更新を提供します。

    注記

    このプロセスには数分かかることがあります。

  6. VS Code からプロンプトが表示されたら、スタック名を入力し、Enterキーを押して続行します。

  7. VS Code はプロジェクトのステータスを引き続き更新し、プロセスが完了すると に通知し、新しい AWS SAM プロジェクトを VS Code ワークスペースとして開きます。