# タグ伝達
<a name="lambda-managed-instances-tag-propagation"></a>

タグ伝達を使用すると、キャパシティプロバイダー設定で一連のタグを指定でき、Lambda は Amazon EC2 インスタンス、Amazon EBS ボリューム、ENI を含む、Lambda が作成するすべてのマネージドリソースにこれらのタグを自動的に適用します。これにより、手動による介入やカスタムオートメーションを必要とせずに、コスト配分、サービスコントロールポリシー (SCP)、コンプライアンス要件の一貫したタグ付けが可能になります。

## タグ伝達の設定
<a name="lambda-managed-instances-tag-propagation-configuring"></a>

`CreateCapacityProvider` または `UpdateCapacityProvider` API を使用してキャパシティプロバイダーを作成または更新するときに、`PropagateTags` 設定を指定します。

**PropagateTags パラメータ:**
+ **モード** (必須) – タグ伝達モード:
  + `Explicit` – `ExplicitTags` で指定されたタグをマネージドリソースに伝達します。
  + `None` – タグ伝達を有効にします。デフォルトで適用されるシステムタグを除いて、マネージドリソースにカスタムタグは適用されません。
+ **ExplicitTags** (モードが `Explicit` の場合に必須) – マネージドリソースに適用するキーと値のペアのマップ。最大 40 個のタグを指定できます。

**重要**  
タグ伝達は、設定の適用後にプロビジョニングされた新しいマネージドリソースにのみ適用されます。既存のリソースは遡及的にタグ付けされません。

## 例
<a name="lambda-managed-instances-tag-propagation-examples"></a>

**タグ伝達を使用してキャパシティプロバイダーを作成する (AWS CLI):**

```
aws lambda create-capacity-provider \
  --capacity-provider-name my-capacity-provider \
  --vpc-config SubnetIds=subnet-12345,subnet-67890,SecurityGroupIds=sg-12345 \
  --permissions-config CapacityProviderOperatorRoleArn=arn:aws:iam::123456789012:role/MyOperatorRole \
  --propagate-tags '{"Mode": "Explicit", "ExplicitTags": {"CostCenter": "12345", "Environment": "Production"}}'
```

**既存のキャパシティプロバイダーを更新してタグ伝達を有効にする:**

```
aws lambda update-capacity-provider \
  --capacity-provider-name my-capacity-provider \
  --propagate-tags '{"Mode": "Explicit", "ExplicitTags": {"CostCenter": "12345", "Environment": "Production"}}'
```

**タグ伝達を無効にする:**

```
aws lambda update-capacity-provider \
  --capacity-provider-name my-capacity-provider \
  --propagate-tags '{"Mode": "None"}'
```

## タグ伝達動作
<a name="lambda-managed-instances-tag-propagation-behavior"></a>
+ `PropagateTags` 設定の変更は、更新後にプロビジョニングされたリソースにのみ影響します。以前起動したリソースは、元のタグを保持します。
+ タグ伝達タグは、キャパシティプロバイダー自体の `Tags` パラメータとは別のものです。キャパシティプロバイダータグはキャパシティプロバイダーリソースを識別します。伝達されたタグは、キャパシティプロバイダーが起動するマネージドリソースに適用されます。
+ 伝達されたタグは、ターゲットリソースの AWS リソースタグ制限にカウントされます。