翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # aws-ラムダ-ssmstringパラメータ ![](https://docs.aws.amazon.com/ja_jp/solutions/latest/constructs/images/experimental.png) すべてのクラスは積極的に開発されており、将来のバージョンでは下位互換性がない変更または削除の対象となります。これらは、[セマンティックバージョン管理](https://semver.org/)モデル。つまり、これらのパッケージを使用するかもしれませんが、このパッケージの新しいバージョンにアップグレードするときにソースコードを更新する必要があるかもしれません。 **注意:** 正しく機能するためには、プロジェクト内の AWS ソリューション構築パッケージと AWS CDK パッケージが同じバージョンである必要があります。 | **言語** | **パッケージ** | | --- | --- | | ![](https://docs.aws.amazon.com/ja_jp/solutions/latest/constructs/images/python.png) Python | aws\_solutions\_constructs.aws\_lambda\_ssm\_string\_parameter | | ![](https://docs.aws.amazon.com/ja_jp/solutions/latest/constructs/images/typescript.png) TypesScript | @aws-solutions-constructs/aws-lambda-ssmstringparameter | | ![](https://docs.aws.amazon.com/ja_jp/solutions/latest/constructs/images/java.png) 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); ``` *パラメータ* + scope[`Construct`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html) + id`string` + props[`LambdaToSsmstringparameterProps`](#pattern-construct-props-43) ## パターン構成プロパティ | **名前** | **タイプ** | **説明** | | --- | --- | --- | | ExistingLambdaObj？ | [`lambda.Function`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html) | Lambda Functionオブジェクトの既存のインスタンス。これとlambdaFunctionPropsはエラーを発生させます。 | | LambdaFunctionProps？ | [`lambda.FunctionProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html) | Lambda 関数のデフォルトプロパティを上書きするオプションのユーザー指定のプロパティ。の場合は無視されます。existingLambdaObjが提供される。 | | ExistingStringParameterObj？ | [`ssm.StringParameter`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ssm.StringParameter.html) | SSM String パラメータオブジェクトの既存のインスタンス。これとstringParameterPropsはエラーを発生させます。 | | StringParameterProps？ | [`ssm.StringParameterProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ssm.StringParameterProps.html) | SSM String パラメータのデフォルトプロップを上書きするオプションのユーザ提供の小道具です。もしexistingStringParameterObjが設定されていない場合、stringParameterPropsは必須です。はサポートされる唯一の方法です。[`ssm.StringParameterProps.type`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ssm.StringParameterProps.html#type)、[`STRING`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ssm.ParameterType.html#string)別の値が指定されている場合は、オーバーライドされます。 | | StringParameterEnvironmentVariableName? | string | Lambda 関数に設定された SSM String パラメーター環境変数のオプション名。 | | 既存のVPCかな？ | [`ec2.IVpc`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.IVpc.html) | このパターンをデプロイするオプションの既存の VPC。VPC にデプロイされると、Lambda 関数は VPC 内の ENI を使用してネットワークリソースにアクセスし、インターフェイスエンドポイントが VPC for AWS Systems Manager パラメータに作成されます。既存の VPC が提供されている場合、deployVpcプロパティが、true。これは、ec2.IVpcを使用して、クライアントがスタックの外部に存在する VPC を提供できるようにします。[`ec2.Vpc.fromLookup()`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.Vpc.html#static-fromwbrlookupscope-id-options)方法。 | | vPCProps? | [`ec2.VpcProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.VpcProps.html) | 新しい 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`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html) | のインスタンスを返します。lambda.Function構成によって作成されます。 | | 文字列Parameter | [`ssm.StringParameter`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ssm.StringParameter.html) | のインスタンスを返します。ssm.StringParameter構成によって作成されます。 | | vpc? | [`ec2.IVpc`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.IVpc.html) | パターンによって使用される 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 ![](https://docs.aws.amazon.com/ja_jp/solutions/latest/constructs/images/aws-lambda-ssmstringparameter.png) ## GitHub
このパターンのコードを表示するには、問題を作成/表示し、プル要求などを行います。
@aws-ソリューション-構築/aws-lambda-ssmstringパラメータ