サポート終了通知: 2026 年 10 月 7 日に、 AWS はサポートを終了します AWS Proton。2026 年 10 月 7 日以降、 AWS Proton コンソールまたは AWS Proton リソースにアクセスできなくなります。デプロイされたインフラストラクチャはそのまま残ります。詳細については、[AWS Proton 「サービス廃止と移行ガイド](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html)」を参照してください。

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

# AWS Proton パラメータ
<a name="parameters"></a>

あなたの infrastructure as Code (IaC) ファイルにパラメータを定義して使用すると、ファイルの柔軟性が高まり、再利用可能になります。IaC ファイルでパラメータ値を読み取るには、パラメータ AWS Proton *namespace* のパラメータ名を参照します。 は、リソースのプロビジョニング中に生成されるレンダリングされた IaC ファイルにパラメータ値 AWS Proton を挿入します。 AWS CloudFormation IaC パラメータを処理するために、 は [Jinja](https://jinja.palletsprojects.com/en/2.11.x/) AWS Proton を使用します。Terraform IaC パラメータを処理するために、 は Terraform パラメータ値ファイル AWS Proton を生成し、HCL に組み込まれているパラメータ化機能に依存します。

では[CodeBuild プロビジョニング](ag-works-prov-methods.md#ag-works-prov-methods-codebuild)、コードがインポートできる入力ファイル AWS Proton を生成します。このファイルは、あなたのテンプレートのマニフェスト内のプロパティに応じて、JSON ファイルか HCL ファイルになります。詳細については、「[CodeBuild プロビジョニングパラメータの詳細と例](parameters-codebuild.md)」を参照してください。

あなたの環境、サービス、コンポーネントの IaC ファイルまたはプロビジョニングコードのパラメータは、以下の要件で参照できます。
+ 各パラメータ名の長さが 100 文字を超えてはなりません。
+ パラメータの名前空間とリソース名の組み合わせの長さが、リソース名の文字制限を超えてはなりません。

AWS Proton これらのクォータを超えると、プロビジョニングは失敗します。

## パラメータタイプ
<a name="param-name-types"></a>

以下のパラメータタイプは、 AWS Proton IaC ファイルで参照できます。

**入力パラメータ**  
環境とサービスインスタンスでは、環境やサービステンプレートに関連付けた[スキーマファイル](ag-schema.md)内で定義した入力パラメータを受け取ることができます。リソースの IaC ファイルにあるリソースの入力パラメータを参照できます。コンポーネント IaC ファイルは、コンポーネントがアタッチされているサービスインスタンスの入力パラメータを参照できます。  
AWS Proton は入力パラメータ名をスキーマファイルと照合し、IaC ファイルで参照されているパラメータと照合して、リソースのプロビジョニング中に仕様ファイルで指定した入力値を挿入します。

**出力パラメータ**  
出力は、あなたのどの IaC ファイルでも定義できます。出力には、テンプレートがプロビジョニングするリソースの名前、ID、ARN の場合もあれば、テンプレートの入力の 1 つを渡す方法である場合もあります。これらの出力は、他のリソースの IaC ファイルで参照できます。  
CloudFormation IaC ファイルでは、`Outputs:` ブロック内の出力パラメータを定義します。Terraform IaC ファイルでは、`output` ステートメントを使用して各出力パラメータを定義します。

**リソースパラメータ**  
AWS Proton は自動的に AWS Proton リソースパラメータを作成します。これらのパラメータは、 AWS Proton リソースオブジェクトのプロパティを公開します。リソースパラメータの例は `environment.name` です。

## IaC ファイルでの AWS Proton パラメータの使用
<a name="param-name-spaces"></a>

IaC ファイルでパラメータ値を読み取るには、パラメータ名前空間で AWS Proton パラメータの名前を参照します。 AWS CloudFormation IaC ファイルの場合、*Jinja* 構文を使用し、パラメータを中括弧と引用符のペアで囲みます。

以下の表は、サポートされている各テンプレート言語のリファレンス構文と例です。


| テンプレート言語 | 構文 | 例:「VPC」という名前の環境入力 | 
| --- | --- | --- | 
|  CloudFormation  |  `"{{ parameter-name }}"`  |  `"{{ environment.inputs.VPC }}"`  | 
|  Terraform  |  `var.parameter-name`  |  `var.environment.inputs.VPC` [生成された Terraform 変数定義](ag-infrastructure-tmp-files-terraform.md#compiled-tform)  | 

**注記**  
あなたの IaC ファイル内で [CloudFormation 動的パラメータ](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html)を使用する場合、誤解による Jinja エラーを防ぐため、それらを[エスケープ](https://jinja.palletsprojects.com/en/2.11.x/templates/#escaping)する必要があります。詳細については、[トラブルシューティング AWS Proton](ag-troubleshooting.md)を参照してください。

次の表に、すべての AWS Proton リソースパラメータの名前空間名を示します。各テンプレートファイルタイプでは、パラメータ名前空間の異なるサブセットを使用できます。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/proton/latest/userguide/parameters.html)

詳細と例については、さまざまなリソースタイプとテンプレート言語の IaC テンプレートファイル内のパラメータに関するサブトピックを参照してください。

**Topics**
+ [パラメータタイプ](#param-name-types)
+ [IaC ファイルでの AWS Proton パラメータの使用](#param-name-spaces)
+ [環境 CloudFormation IaC ファイルパラメータの詳細と例](env-parameters.md)
+ [サービス CloudFormation IaC ファイルパラメータの詳細と例](svc-parameters.md)
+ [コンポーネント CloudFormation IaC ファイルパラメータの詳細と例](comp-parameters.md)
+ [CloudFormation IaC ファイルのパラメータフィルター](parameter-filters.md)
+ [CodeBuild プロビジョニングパラメータの詳細と例](parameters-codebuild.md)
+ [Terraform Infrastructure as Code (IaC) ファイルパラメータの詳細と例](env-parameters-tform.md)