aws-ラムダ-ssmstringパラメータ

すべてのクラスは積極的に開発されており、将来のバージョンでは下位互換性がない変更または削除の対象となります。これらは、セマンティックバージョン管理モデル。つまり、これらのパッケージを使用するかもしれませんが、このパッケージの新しいバージョンにアップグレードするときにソースコードを更新する必要があるかもしれません。

注意: 正しく機能するためには、プロジェクト内の AWS ソリューション構築パッケージと AWS CDK パッケージが同じバージョンである必要があります。

言語	パッケージ
Python	aws_solutions_constructs.aws_lambda_ssm_string_parameter
TypesScript	@aws-solutions-constructs/aws-lambda-ssmstringparameter
Java	software.amazon.awsconstructs.services.lambdassmstringparameter

Overview

この AWS ソリューション構成では、AWS Lambda 関数と AWS Systems Manager Parameter Store 文字列パラメーターが最小権限で実装されます。

TypeScript の最小限のデプロイ可能なパターン定義は次のとおりです。

const { LambdaToSsmstringparameterProps,  LambdaToSsmstringparameter } from '@aws-solutions-constructs/aws-lambda-ssmstringparameter';

const props: LambdaToSsmstringparameterProps = {
    lambdaFunctionProps: {
      runtime: lambda.Runtime.NODEJS_14_X,
      // This assumes a handler function in lib/lambda/index.js
      code: lambda.Code.fromAsset(`${__dirname}/lambda`),
      handler: 'index.handler'
    }, 
    stringParameterProps: { stringValue: "test-string-value" }
};

new LambdaToSsmstringparameter(this, 'test-lambda-ssmstringparameter-stack', props);

Initializer

new LambdaToSsmstringparameter(scope: Construct, id: string, props: LambdaToSsmstringparameterProps);

パラメータ

• scopeConstruct

• idstring

• propsLambdaToSsmstringparameterProps

パターン構成プロパティ

名前	タイプ	説明
ExistingLambdaObj？	lambda.Function	Lambda Functionオブジェクトの既存のインスタンス。これとlambdaFunctionPropsはエラーを発生させます。
LambdaFunctionProps？	lambda.FunctionProps	Lambda 関数のデフォルトプロパティを上書きするオプションのユーザー指定のプロパティ。の場合は無視されます。existingLambdaObjが提供される。
ExistingStringParameterObj？	ssm.StringParameter	SSM String パラメータオブジェクトの既存のインスタンス。これとstringParameterPropsはエラーを発生させます。
StringParameterProps？	ssm.StringParameterProps	SSM String パラメータのデフォルトプロップを上書きするオプションのユーザ提供の小道具です。もしexistingStringParameterObjが設定されていない場合、stringParameterPropsは必須です。はサポートされる唯一の方法です。ssm.StringParameterProps.type、STRING別の値が指定されている場合は、オーバーライドされます。
StringParameterEnvironmentVariableName?	string	Lambda 関数に設定された SSM String パラメーター環境変数のオプション名。
既存のVPCかな？	ec2.IVpc	このパターンをデプロイするオプションの既存の VPC。VPC にデプロイされると、Lambda 関数は VPC 内の ENI を使用してネットワークリソースにアクセスし、インターフェイスエンドポイントが VPC for AWS Systems Manager パラメータに作成されます。既存の VPC が提供されている場合、deployVpcプロパティが、true。これは、ec2.IVpcを使用して、クライアントがスタックの外部に存在する VPC を提供できるようにします。ec2.Vpc.fromLookup()方法。
vPCProps?	ec2.VpcProps	新しい VPC のデフォルトプロパティを上書きするオプションのユーザー指定のプロパティ。enableDnsHostnames,enableDnsSupport,natGatewaysおよびsubnetConfigurationはパターンによって設定されるため、ここで指定されたプロパティの値はすべて上書きされます。もしdeployVpcではありませんtrueの場合、このプロパティは無視されます。
DeployVPC？	boolean	に基づいて新しい VPC を作成するかどうかvpcPropsこのパターンを展開します。これをに設定するtrueは、パターンを実行するために、最小限のほとんどのプライベート VPC をデプロイします。 CDK プログラムで使用される各アベイラビリティーゾーンに 1 つずつ分離されたサブネット。 enableDnsHostnamesおよびenableDnsSupportはどちらもtrue。 このプロパティがに設定されている場合true、次にexistingVpcは指定できません。デフォルトは false です。
StringParameterPermissions	string	Lambda 関数に付与するオプションの SSM String パラメーターのアクセス許可。次のいずれかを指定できます。Read,ReadWrite。

パターンプロパティ

名前	タイプ	説明
LambdaFunction	lambda.Function	のインスタンスを返します。lambda.Function構成によって作成されます。
文字列Parameter	ssm.StringParameter	のインスタンスを返します。ssm.StringParameter構成によって作成されます。
vpc?	ec2.IVpc	パターンによって使用される VPC 上のインターフェイスを返します（存在する場合）。これは、パターンによって作成された VPC、またはパターンコンストラクタに提供された VPC です。

デフォルト設定

オーバーライドなしでこのパターンをすぐに実装すると、次のデフォルトが設定されます。

AWS Lambda 関数

• Lambda 関数の制限付き特権アクセス IAM ロールを設定します。

• NodeJS Lambda 関数のキープアライブで接続を再利用できるようにします。

• X-Ray トレースを有効にします。

• 環境変数の設定:

  • SSM_STRING_PARAMETER_NAME (デフォルト)

  • AWS_NODEJS_CONNECTION_REUSE_ENABLED（ノード10.x以上の機能の場合）

Amazon AWS Systems Manager パラメータストア文字列

• 関連付けられた AWS Lambda 関数の読み取り専用アクセスを有効にします。

• 指定された値を使用して新しい SSM String パラメータを作成します。

• CloudFormation スタックを削除するときは、SSM ストリングパラメーターを保持します。

Architecture

GitHub

このパターンのコードを表示するには、問題を作成/表示し、プル要求などを行います。
	@aws-ソリューション-構築/aws-lambda-ssmstringパラメータ