Dies ist das neue *CloudFormation Template Reference Guide*. Bitte aktualisieren Sie Ihre Lesezeichen und Links. Hilfe zu den ersten CloudFormation Schritten finden Sie im [AWS CloudFormation Benutzerhandbuch](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Beispiele
**Topics**
+ [Beispiele für `Fn::ForEach` im Abschnitt „`Resources`“](intrinsic-function-reference-foreach-example-resource.md)
+ [Beispiele für `Fn::ForEach` im Abschnitt „`Outputs`“](intrinsic-function-reference-foreach-example-outputs.md)
+ [Beispiele für `Fn::ForEach` im Abschnitt „`Conditions`“](intrinsic-function-reference-foreach-example-conditions.md)
# Beispiele für `Fn::ForEach` im Abschnitt „`Resources`“
Diese Beispiele demonstrieren die Verwendung der intrinsischen Funktion `Fn::ForEach` im Abschnitt „`Resources`“. Weitere Informationen zu diesem Abschnitt finden Sie unter [Ressourcen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html) im *AWS CloudFormation -Benutzerhandbuch*.
**Topics**
+ [Replizieren einer Amazon-SNS-Ressource](#intrinsic-function-reference-foreach-example-replicate-resource)
+ [Replizieren einer Amazon-DynamoDB-Ressource](#intrinsic-function-reference-foreach-example-replicate-ddb-resource)
+ [Replizieren mehrerer Ressourcen](#intrinsic-function-reference-foreach-example-replicate-multiple-resources)
+ [Replizieren mehrerer Ressourcen mithilfe verschachtelter `Fn::ForEach`-Schleifen](#intrinsic-function-reference-foreach-example-nested-loop-resources)
+ [Verweisen auf replizierte Eigenschaften für eine Amazon-EC2-Ressource](#intrinsic-function-reference-foreach-example-reference-replicated-resource)
+ [Replizieren von Eigenschaften für eine Amazon-EC2-Ressource](#intrinsic-function-reference-foreach-example-replicate-resource-properties)
+ [Übergabe von nicht-alphanumerischen Zeichen innerhalb der `Collection` für `Fn::ForEach`](#intrinsic-function-reference-foreach-example-non-alphanumeric)
## Replizieren einer Amazon-SNS-Ressource
In diesem Beispielausschnitt wird eine Liste mit vier Amazon-SNS-Themen zurückgegeben. Dabei entspricht die logische ID den Elementen in der Sammlung (`Success`, `Failure`, `Timeout`, `Unknown`), mit einem passenden `TopicName` und `FifoTopic` ist auf `true` gesetzt.
**Anmerkung**
Für Vorlagen, die sowohl mit FIFO- als auch mit Standardthemen arbeiten müssen, können Sie die Eigenschaft `DisplayName` anstelle von `TopicName`verwenden. Auf diese Weise können CloudFormation Themennamen automatisch mit dem entsprechenden `.fifo` Suffix generiert werden, wenn dies der Fall `FifoTopic` ist`true`. Ersetzen Sie einfach `TopicName` durch `DisplayName: !Ref TopicName` im Abschnitt `Properties` .
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Resources": {
"Fn::ForEach::Topics": [
"TopicName",
["Success", "Failure", "Timeout", "Unknown"],
{
"SnsTopic${TopicName}": {
"Type": "AWS::SNS::Topic",
"Properties": {
"TopicName": {"Fn::Sub": "${TopicName}.fifo"},
"FifoTopic": true
}
}
}
]
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
'Fn::ForEach::Topics':
- TopicName
- [Success, Failure, Timeout, Unknown]
- 'SnsTopic${TopicName}':
Type: AWS::SNS::Topic
Properties:
TopicName: !Sub '${TopicName}.fifo'
FifoTopic: true
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
SnsTopicSuccess:
Type: AWS::SNS::Topic
Properties:
TopicName: Success.fifo
FifoTopic: true
SnsTopicFailure:
Type: AWS::SNS::Topic
Properties:
TopicName: Failure.fifo
FifoTopic: true
SnsTopicTimeout:
Type: AWS::SNS::Topic
Properties:
TopicName: Timeout.fifo
FifoTopic: true
SnsTopicUnknown:
Type: AWS::SNS::Topic
Properties:
TopicName: Unknown.fifo
FifoTopic: true
```
## Replizieren einer Amazon-DynamoDB-Ressource
In diesem Beispielausschnitt werden vier [AWS::DynamoDB::Table](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-dynamodb-table.html)-Ressourcen mit Namen wie `Points`, `Score` usw. erstellt.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Resources": {
"Fn::ForEach::Tables": [
"TableName",
["Points", "Score", "Name", "Leaderboard"],
{
"DynamoDB${TableName}": {
"Type": "AWS::DynamoDB::Table",
"Properties": {
"TableName": {
"Ref": "TableName"
},
"AttributeDefinitions": [
{
"AttributeName": "id",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "id",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": "5",
"WriteCapacityUnits": "5"
}
}
}
}
]
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
'Fn::ForEach::Tables':
- TableName
- [Points, Score, Name, Leaderboard]
- 'DynamoDB${TableName}':
Type: AWS::DynamoDB::Table
Properties:
TableName: !Ref TableName
AttributeDefinitions:
- AttributeName: id
AttributeType: S
KeySchema:
- AttributeName: id
KeyType: HASH
ProvisionedThroughput:
ReadCapacityUnits: '5'
WriteCapacityUnits: '5'
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
DynamoDBPoints:
Type: AWS::DynamoDB::Table
Properties:
TableName: Points
AttributeDefinitions:
- AttributeName: id
AttributeType: S
KeySchema:
- AttributeName: id
KeyType: HASH
ProvisionedThroughput:
ReadCapacityUnits: '5'
WriteCapacityUnits: '5'
DynamoDBScore:
Type: AWS::DynamoDB::Table
Properties:
TableName: Score
AttributeDefinitions:
- AttributeName: id
AttributeType: S
KeySchema:
- AttributeName: id
KeyType: HASH
ProvisionedThroughput:
ReadCapacityUnits: '5'
WriteCapacityUnits: '5'
DynamoDBName:
Type: AWS::DynamoDB::Table
Properties:
TableName: Name
AttributeDefinitions:
- AttributeName: id
AttributeType: S
KeySchema:
- AttributeName: id
KeyType: HASH
ProvisionedThroughput:
ReadCapacityUnits: '5'
WriteCapacityUnits: '5'
DynamoDBLeaderboard:
Type: AWS::DynamoDB::Table
Properties:
TableName: Leaderboard
AttributeDefinitions:
- AttributeName: id
AttributeType: S
KeySchema:
- AttributeName: id
KeyType: HASH
ProvisionedThroughput:
ReadCapacityUnits: '5'
WriteCapacityUnits: '5'
```
## Replizieren mehrerer Ressourcen
In diesem Beispiel werden mehrere Instanzen von [AWS::EC2::NatGateway](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-natgateway.html)und [AWS: :EC2: :EIP](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-eip.html) unter Verwendung der Namenskonvention von erstellt. `"{ResourceType}${Identifier}"` Sie können mehrere Ressourcentypen in einer `Fn::ForEach`-Schleife deklarieren, um eine einzige Kennung zu nutzen.
Eindeutige Werte für jedes Element in der Sammlung werden im Abschnitt `Mappings` definiert, wo die intrinsische Funktion [`Fn::FindInMap`](intrinsic-function-reference-findinmap.md) verwendet wird, um auf den entsprechenden Wert zu verweisen. Wenn `Fn::FindInMap` den entsprechenden Bezeichner nicht finden kann, wird die Eigenschaft `Condition` nicht gesetzt und zu `!Ref AWS:::NoValue`aufgelöst.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Conditions": {
"TwoNatGateways": {"Fn::Equals": [{"Ref": "AWS::Region"}, "us-east-1"]},
"ThreeNatGateways": {"Fn::Equals": [{"Ref": "AWS::Region"}, "us-west-2"]}
},
"Mappings": {
"NatGateway": {
"Condition": {
"B": "TwoNatGateways",
"C": "ThreeNatGateways"
}
}
},
"Resources": {
"VPC": {
"Type": "AWS::EC2::VPC",
"Properties": {"CidrBlock": "10.0.0.0/16"}
},
"PublicSubnetA": {
"Type": "AWS::EC2::Subnet",
"Properties": {
"VpcId": {"Ref": "VPC"},
"CidrBlock": "10.0.1.0/24",
"AvailabilityZone": {"Fn::Select": [0, {"Fn::GetAZs": ""}]}
}
},
"PublicSubnetB": {
"Type": "AWS::EC2::Subnet",
"Properties": {
"VpcId": {"Ref": "VPC"},
"CidrBlock": "10.0.2.0/24",
"AvailabilityZone": {"Fn::Select": [1, {"Fn::GetAZs": ""}]}
}
},
"PublicSubnetC": {
"Type": "AWS::EC2::Subnet",
"Properties": {
"VpcId": {"Ref": "VPC"},
"CidrBlock": "10.0.3.0/24",
"AvailabilityZone": {"Fn::Select": [2, {"Fn::GetAZs": ""}]}
}
},
"Fn::ForEach::NatGatewayAndEIP": [
"Identifier",
[ "A", "B", "C" ],
{
"NatGateway${Identifier}": {
"Type": "AWS::EC2::NatGateway",
"Properties": {
"AllocationId": {"Fn::GetAtt": [{"Fn::Sub": "NatGatewayAttachment${Identifier}"}, "AllocationId"]},
"SubnetId": {"Ref": {"Fn::Sub": "PublicSubnet${Identifier}"}}
},
"Condition": {"Fn::FindInMap": ["NatGateway", "Condition", {"Ref": "Identifier"}, {"DefaultValue": {"Ref": "AWS::NoValue"}}]}
},
"NatGatewayAttachment${Identifier}": {
"Type": "AWS::EC2::EIP",
"Properties": {
"Domain": "vpc"
},
"Condition": {"Fn::FindInMap": ["NatGateway", "Condition", {"Ref": "Identifier"}, {"DefaultValue": {"Ref": "AWS::NoValue"}}]}
}
}
]
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Conditions:
TwoNatGateways: !Equals [!Ref "AWS::Region", "us-east-1"]
ThreeNatGateways: !Equals [!Ref "AWS::Region", "us-west-2"]
Mappings:
NatGateway:
Condition:
B: TwoNatGateways
C: ThreeNatGateways
Resources:
VPC:
Type: AWS::EC2::VPC
Properties:
CidrBlock: 10.0.0.0/16
PublicSubnetA:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.1.0/24
AvailabilityZone: !Select [0, !GetAZs ""]
PublicSubnetB:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.2.0/24
AvailabilityZone: !Select [1, !GetAZs ""]
PublicSubnetC:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.3.0/24
AvailabilityZone: !Select [2, !GetAZs ""]
Fn::ForEach::NatGatewayAndEIP:
- Identifier
- - A
- B
- C
- NatGateway${Identifier}:
Type: AWS::EC2::NatGateway
Properties:
AllocationId: !GetAtt
- !Sub NatGatewayAttachment${Identifier}
- AllocationId
SubnetId: !Ref
Fn::Sub: PublicSubnet${Identifier}
Condition: !FindInMap
- NatGateway
- Condition
- !Ref Identifier
- DefaultValue: !Ref AWS::NoValue
NatGatewayAttachment${Identifier}:
Type: AWS::EC2::EIP
Properties:
Domain: vpc
Condition: !FindInMap
- NatGateway
- Condition
- !Ref Identifier
- DefaultValue: !Ref AWS::NoValue
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Conditions:
TwoNatGateways: !Equals [!Ref "AWS::Region", "us-east-1"]
ThreeNatGateways: !Equals [!Ref "AWS::Region", "us-west-2"]
Resources:
VPC:
Type: AWS::EC2::VPC
Properties:
CidrBlock: 10.0.0.0/16
PublicSubnetA:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.1.0/24
AvailabilityZone: !Select [0, !GetAZs ""]
PublicSubnetB:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.2.0/24
AvailabilityZone: !Select [1, !GetAZs ""]
PublicSubnetC:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.3.0/24
AvailabilityZone: !Select [2, !GetAZs ""]
NatGatewayA:
Type: AWS::EC2::NatGateway
Properties:
AllocationId: !GetAtt
- NatGatewayAttachmentA
- AllocationId
SubnetId: !Ref PublicSubnetA
NatGatewayB:
Type: AWS::EC2::NatGateway
Properties:
AllocationId: !GetAtt
- NatGatewayAttachmentB
- AllocationId
SubnetId: !Ref PublicSubnetB
Condition: TwoNatGateways
NatGatewayC:
Type: AWS::EC2::NatGateway
Properties:
AllocationId: !GetAtt
- NatGatewayAttachmentC
- AllocationId
SubnetId: !Ref PublicSubnetC
Condition: ThreeNatGateways
NatGatewayAttachmentA:
Type: AWS::EC2::EIP
Properties:
Domain: vpc
NatGatewayAttachmentB:
Type: AWS::EC2::EIP
Properties:
Domain: vpc
Condition: TwoNatGateways
NatGatewayAttachmentC:
Type: AWS::EC2::EIP
Properties:
Domain: vpc
Condition: ThreeNatGateways
```
## Replizieren mehrerer Ressourcen mithilfe verschachtelter `Fn::ForEach`-Schleifen
In diesem Beispiel werden verschachtelte `Fn::ForEach`-Schleifen verwendet, um drei Ressourcen ([AWS::EC2::NetworkAcl](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-natgateway.html), [AWS::EC2::Subnet](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-subnet.html) und [AWS::EC2::SubnetNetworkAclAssociation](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-subnetnetworkaclassociation.html)) einander zuzuordnen.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Resources": {
"VPC": {
"Type": "AWS::EC2::VPC",
"Properties": {
"CidrBlock": "10.0.0.0/16",
"EnableDnsSupport": "true",
"EnableDnsHostnames": "true"
}
},
"Fn::ForEach::SubnetResources": [
"Prefix",
[
"Transit",
"Public"
],
{
"Nacl${Prefix}Subnet": {
"Type": "AWS::EC2::NetworkAcl",
"Properties": {
"VpcId": {
"Ref": "VPC"
}
}
},
"Fn::ForEach::LoopInner": [
"Suffix",
[
"A",
"B",
"C"
],
{
"${Prefix}Subnet${Suffix}": {
"Type": "AWS::EC2::Subnet",
"Properties": {
"VpcId": {
"Ref": "VPC"
}
}
},
"Nacl${Prefix}Subnet${Suffix}Association": {
"Type": "AWS::EC2::SubnetNetworkAclAssociation",
"Properties": {
"SubnetId": {
"Ref": {
"Fn::Sub": "${Prefix}Subnet${Suffix}"
}
},
"NetworkAclId": {
"Ref": {
"Fn::Sub": "Nacl${Prefix}Subnet"
}
}
}
}
}
]
}
]
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
VPC:
Type: AWS::EC2::VPC
Properties:
CidrBlock: 10.0.0.0/16
EnableDnsSupport: 'true'
EnableDnsHostnames: 'true'
'Fn::ForEach::SubnetResources':
- Prefix
- [Transit, Public]
- 'Nacl${Prefix}Subnet':
Type: AWS::EC2::NetworkAcl
Properties:
VpcId: !Ref 'VPC'
'Fn::ForEach::LoopInner':
- Suffix
- [A, B, C]
- '${Prefix}Subnet${Suffix}':
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref 'VPC'
'Nacl${Prefix}Subnet${Suffix}Association':
Type: AWS::EC2::SubnetNetworkAclAssociation
Properties:
SubnetId: !Ref
'Fn::Sub': '${Prefix}Subnet${Suffix}'
NetworkAclId: !Ref
'Fn::Sub': 'Nacl${Prefix}Subnet'
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
VPC:
Type: AWS::EC2::VPC
Properties:
CidrBlock: 10.0.0.0/16
EnableDnsSupport: 'true'
EnableDnsHostnames: 'true'
NaclTransitSubnet:
Type: AWS::EC2::NetworkAcl
Properties:
VpcId: !Ref VPC
TransitSubnetA:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
NaclTransitSubnetAAssociation:
Type: AWS::EC2::SubnetNetworkAclAssociation
Properties:
SubnetId: !Ref TransitSubnetA
NetworkAclId: !Ref NaclTransitSubnet
TransitSubnetB:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
NaclTransitSubnetBAssociation:
Type: AWS::EC2::SubnetNetworkAclAssociation
Properties:
SubnetId: !Ref TransitSubnetB
NetworkAclId: !Ref NaclTransitSubnet
TransitSubnetC:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
NaclTransitSubnetCAssociation:
Type: AWS::EC2::SubnetNetworkAclAssociation
Properties:
SubnetId: !Ref TransitSubnetC
NetworkAclId: !Ref NaclTransitSubnet
NaclPublicSubnet:
Type: AWS::EC2::NetworkAcl
Properties:
VpcId: !Ref VPC
PublicSubnetA:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
NaclPublicSubnetAAssociation:
Type: AWS::EC2::SubnetNetworkAclAssociation
Properties:
SubnetId: !Ref PublicSubnetA
NetworkAclId: !Ref NaclPublicSubnet
PublicSubnetB:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
NaclPublicSubnetBAssociation:
Type: AWS::EC2::SubnetNetworkAclAssociation
Properties:
SubnetId: !Ref PublicSubnetB
NetworkAclId: !Ref NaclPublicSubnet
PublicSubnetC:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
NaclPublicSubnetCAssociation:
Type: AWS::EC2::SubnetNetworkAclAssociation
Properties:
SubnetId: !Ref PublicSubnetC
NetworkAclId: !Ref NaclPublicSubnet
```
## Verweisen auf replizierte Eigenschaften für eine Amazon-EC2-Ressource
In diesem Beispiel wird die intrinsische Funktion `Fn::ForEach` verwendet, um auf replizierte [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-instance.html)-Ressourcen zu verweisen.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Mappings": {
"Instances": {
"InstanceType": {
"B": "m5.4xlarge",
"C": "c5.2xlarge"
},
"ImageId": {"A": "ami-id1"}
}
},
"Resources": {
"Fn::ForEach::Instances": [
"Identifier",
[
"A",
"B",
"C"
],
{
"Instance${Identifier}": {
"Type": "AWS::EC2::Instance",
"Properties": {
"InstanceType": {"Fn::FindInMap": ["Instances", "InstanceType", {"Ref": "Identifier"}, {"DefaultValue": "m5.xlarge"}]},
"ImageId": {"Fn::FindInMap": ["Instances", "ImageId", {"Ref": "Identifier"}, {"DefaultValue": "ami-id-default"}]}
}
}
}
]
},
"Outputs": {
"SecondInstanceId": {
"Description": "Instance Id for InstanceB",
"Value": {"Ref": "InstanceB"}
},
"SecondPrivateIp": {
"Description": "Private IP for InstanceB",
"Value": {
"Fn::GetAtt": [
"InstanceB",
"PrivateIp"
]
}
}
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Mappings:
Instances:
InstanceType:
B: m5.4xlarge
C: c5.2xlarge
ImageId:
A: ami-id1
Resources:
'Fn::ForEach::Instances':
- Identifier
- [A, B, C]
- 'Instance${Identifier}':
Type: AWS::EC2::Instance
Properties:
InstanceType: !FindInMap [Instances, InstanceType, !Ref 'Identifier', {DefaultValue: m5.xlarge}]
ImageId: !FindInMap [Instances, ImageId, !Ref 'Identifier', {DefaultValue: ami-id-default}]
Outputs:
SecondInstanceId:
Description: Instance Id for InstanceB
Value: !Ref 'InstanceB'
SecondPrivateIp:
Description: Private IP for InstanceB
Value: !GetAtt [InstanceB, PrivateIp]
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
InstanceA:
Type: AWS::EC2::Instance
Properties:
InstanceType: m5.xlarge
ImageId: ami-id1
InstanceB:
Type: AWS::EC2::Instance
Properties:
InstanceType: m5.4xlarge
ImageId: ami-id-default
InstanceC:
Type: AWS::EC2::Instance
Properties:
InstanceType: c5.2xlarge
ImageId: ami-id-default
Outputs:
SecondInstanceId:
Description: Instance Id for InstanceB
Value: !Ref InstanceB
SecondPrivateIp:
Description: Private IP for InstanceB
Value: !GetAtt [InstanceB, PrivateIp]
```
## Replizieren von Eigenschaften für eine Amazon-EC2-Ressource
In diesem Beispiel wird die intrinsische Funktion `Fn::ForEach` verwendet, um Eigenschaften wie `ImageId`, `InstanceType` und `AvailabilityZone` für eine [AWS::EC2::Instance](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-instance.html)-Ressource zu wiederholen.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Mappings": {
"InstanceA": {
"Properties": {
"ImageId": "ami-id1",
"InstanceType": "m5.xlarge"
}
},
"InstanceB": {
"Properties": {
"ImageId": "ami-id2"
}
},
"InstanceC": {
"Properties": {
"ImageId": "ami-id3",
"InstanceType": "m5.2xlarge",
"AvailabilityZone": "us-east-1a"
}
}
},
"Resources": {
"Fn::ForEach::Instances": [
"InstanceLogicalId",
[ "InstanceA", "InstanceB", "InstanceC" ],
{
"${InstanceLogicalId}": {
"Type": "AWS::EC2::Instance",
"Properties": {
"DisableApiTermination": true,
"UserData": {
"Fn::Base64": {
"Fn::Join": [
"",
[
"#!/bin/bash\n",
"yum update -y\n",
"yum install -y httpd.x86_64\n",
"systemctl start httpd.service\n",
"systemctl enable httpd.service\n",
"echo \"Hello World from $(hostname -f)\" > /var/www/html/index.html\n"
]
]
}
},
"Fn::ForEach::Properties": [
"PropertyName",
[ "ImageId", "InstanceType", "AvailabilityZone" ],
{
"${PropertyName}": {
"Fn::FindInMap": [
{ "Ref": "InstanceLogicalId" },
"Properties",
{ "Ref": "PropertyName"},
{
"DefaultValue": { "Ref": "AWS::NoValue" }
}
]
}
}
]
}
}
}
]
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Mappings:
InstanceA:
Properties:
ImageId: ami-id1
InstanceType: m5.xlarge
InstanceB:
Properties:
ImageId: ami-id2
InstanceC:
Properties:
ImageId: ami-id3
InstanceType: m5.2xlarge
AvailabilityZone: us-east-1a
Resources:
'Fn::ForEach::Instances':
- InstanceLogicalId
- [InstanceA, InstanceB, InstanceC]
- '${InstanceLogicalId}':
Type: AWS::EC2::Instance
Properties:
DisableApiTermination: true
UserData:
Fn::Base64: !Sub |
#!/bin/bash
yum update -y
yum install -y httpd.x86_64
systemctl start httpd.service
systemctl enable httpd.service
echo "Hello World from $(hostname -f)" > /var/www/html/index.html
'Fn::ForEach::Properties':
- PropertyName
- [ImageId, InstanceType, AvailabilityZone]
- '${PropertyName}':
'Fn::FindInMap':
- Ref: 'InstanceLogicalId'
- Properties
- Ref: 'PropertyName'
- {DefaultValue: !Ref 'AWS::NoValue'}
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
InstanceA:
Type: AWS::EC2::Instance
Properties:
DisableApiTermination: true
UserData:
Fn::Base64:
!Sub |
#!/bin/bash
yum update -y
yum install -y httpd.x86_64
systemctl start httpd.service
systemctl enable httpd.service
echo "Hello World from $(hostname -f)" > /var/www/html/index.html
ImageId: ami-id1
InstanceType: m5.xlarge
InstanceB:
Type: AWS::EC2::Instance
Properties:
DisableApiTermination: true
UserData:
Fn::Base64:
!Sub |
#!/bin/bash
yum update -y
yum install -y httpd.x86_64
systemctl start httpd.service
systemctl enable httpd.service
echo "Hello World from $(hostname -f)" > /var/www/html/index.html
ImageId: ami-id2
InstanceC:
Type: AWS::EC2::Instance
Properties:
DisableApiTermination: true
UserData:
Fn::Base64:
!Sub |
#!/bin/bash
yum update -y
yum install -y httpd.x86_64
systemctl start httpd.service
systemctl enable httpd.service
echo "Hello World from $(hostname -f)" > /var/www/html/index.html
ImageId: ami-id3
InstanceType: m5.2xlarge
AvailabilityZone: us-east-1a
```
## Übergabe von nicht-alphanumerischen Zeichen innerhalb der `Collection` für `Fn::ForEach`
In diesem Beispiel wird die Syntax `&{}` verwendet, die es erlaubt, die nicht-alphanumerischen Zeichen (`.` und `/`) in den IP-Adressen innerhalb des `Collection`zu übergeben.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Parameters": {
"IpAddresses": {
"Type": "CommaDelimitedList",
"Default": "10.0.2.0/24,10.0.3.0/24,10.0.4.0/24"
}
},
"Resources": {
"VPC": {
"Type": "AWS::EC2::VPC",
"Properties": {
"CidrBlock": "10.0.0.0/16",
"EnableDnsSupport": "true",
"EnableDnsHostnames": "true"
}
},
"Fn::ForEach::Subnets": [
"CIDR",
{
"Ref": "IpAddresses"
},
{
"Subnet&{CIDR}": {
"Type": "AWS::EC2::Subnet",
"Properties": {
"VpcId": {
"Ref": "VPC"
},
"CidrBlock": {
"Ref": "CIDR"
}
}
}
}
]
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Parameters:
IpAddresses:
Type: CommaDelimitedList
Default: '10.0.2.0/24,10.0.3.0/24,10.0.4.0/24'
Resources:
VPC:
Type: AWS::EC2::VPC
Properties:
CidrBlock: 10.0.0.0/16
EnableDnsSupport: 'true'
EnableDnsHostnames: 'true'
'Fn::ForEach::Subnets':
- CIDR
- !Ref IpAddresses
- 'Subnet&{CIDR}':
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: !Ref CIDR
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Parameters:
IpAddresses:
Type: CommaDelimitedList
Default: '10.0.2.0/24,10.0.3.0/24,10.0.4.0/24'
Resources:
VPC:
Type: AWS::EC2::VPC
Properties:
CidrBlock: 10.0.0.0/16
EnableDnsSupport: 'true'
EnableDnsHostnames: 'true'
Subnet1002024:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.2.0/24
Subnet1003024:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.3.0/24
Subnet1004024:
Type: AWS::EC2::Subnet
Properties:
VpcId: !Ref VPC
CidrBlock: 10.0.4.0/24
```
# Beispiele für `Fn::ForEach` im Abschnitt „`Outputs`“
Diese Beispiele demonstrieren die Verwendung der intrinsischen Funktion `Fn::ForEach` im Abschnitt „`Outputs`“. Weitere Informationen zu diesem Abschnitt finden Sie unter [Ausgänge](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html) im *AWS CloudFormation -Benutzerhandbuch*.
**Topics**
+ [Verweisen auf replizierte `AWS::S3::Bucket`-Ressourcen](#intrinsic-function-reference-foreach-example-replicate-outputs)
+ [Verweisen auf replizierte `AWS::EC2::Instance`-Ressourcen](#intrinsic-function-reference-foreach-example-replicate-conditions)
## Verweisen auf replizierte `AWS::S3::Bucket`-Ressourcen
In diesem Beispiel werden verschachtelte `Fn::ForEach`-Schleifen im Abschnitt `Outputs` verwendet, um die Länge der Vorlage zu reduzieren.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Resources": {
"Fn::ForEach::Buckets": [
"Identifier",
[ "A", "B", "C" ],
{
"S3Bucket${Identifier}": {
"Type": "AWS::S3::Bucket",
"Properties": {
"AccessControl": "PublicRead",
"MetricsConfigurations": [
{
"Id": {"Fn::Sub": "EntireBucket${Identifier}"}
}
],
"WebsiteConfiguration": {
"IndexDocument": "index.html",
"ErrorDocument": "error.html",
"RoutingRules": [
{
"RoutingRuleCondition": {
"HttpErrorCodeReturnedEquals": "404",
"KeyPrefixEquals": "out1/"
},
"RedirectRule": {
"HostName": "ec2-11-22-333-44.compute-1.amazonaws.com",
"ReplaceKeyPrefixWith": "report-404/"
}
}
]
}
},
"DeletionPolicy": "Retain",
"UpdateReplacePolicy": "Retain"
}
}
]
},
"Outputs": {
"Fn::ForEach::BucketOutputs": [
"Identifier",
[ "A", "B", "C" ],
{
"Fn::ForEach::GetAttLoop": [
"Property",
[ "Arn", "DomainName", "WebsiteURL" ],
{
"S3Bucket${Identifier}${Property}": {
"Value": {"Fn::GetAtt": [{"Fn::Sub": "S3Bucket${Identifier}"}, {"Ref": "Property"}]}
}
}
]
}
]
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
'Fn::ForEach::Buckets':
- Identifier
- [A, B, C]
- 'S3Bucket${Identifier}':
Type: AWS::S3::Bucket
Properties:
AccessControl: PublicRead
MetricsConfigurations:
- Id: !Sub 'EntireBucket${Identifier}'
WebsiteConfiguration:
IndexDocument: index.html
ErrorDocument: error.html
RoutingRules:
- RoutingRuleCondition:
HttpErrorCodeReturnedEquals: '404'
KeyPrefixEquals: out1/
RedirectRule:
HostName: ec2-11-22-333-44.compute-1.amazonaws.com
ReplaceKeyPrefixWith: report-404/
DeletionPolicy: Retain
UpdateReplacePolicy: Retain
Outputs:
'Fn::ForEach::BucketOutputs':
- Identifier
- [A, B, C]
- 'Fn::ForEach::GetAttLoop':
- Property
- [Arn, DomainName, WebsiteURL]
- 'S3Bucket${Identifier}${Property}':
Value: !GetAtt [!Sub 'S3Bucket${Identifier}', !Ref Property]
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
S3BucketA:
Type: AWS::S3::Bucket
Properties:
AccessControl: PublicRead
MetricsConfigurations:
- Id: EntireBucketA
WebsiteConfiguration:
IndexDocument: index.html
ErrorDocument: error.html
RoutingRules:
- RoutingRuleCondition:
HttpErrorCodeReturnedEquals: '404'
KeyPrefixEquals: out1/
RedirectRule:
HostName: ec2-11-22-333-44.compute-1.amazonaws.com
ReplaceKeyPrefixWith: report-404/
DeletionPolicy: Retain
UpdateReplacePolicy: Retain
S3BucketB:
Type: AWS::S3::Bucket
Properties:
AccessControl: PublicRead
MetricsConfigurations:
- Id: EntireBucketB
WebsiteConfiguration:
IndexDocument: index.html
ErrorDocument: error.html
RoutingRules:
- RoutingRuleCondition:
HttpErrorCodeReturnedEquals: '404'
KeyPrefixEquals: out1/
RedirectRule:
HostName: ec2-11-22-333-44.compute-1.amazonaws.com
ReplaceKeyPrefixWith: report-404/
DeletionPolicy: Retain
UpdateReplacePolicy: Retain
S3BucketC:
Type: AWS::S3::Bucket
Properties:
AccessControl: PublicRead
MetricsConfigurations:
- Id: EntireBucketC
WebsiteConfiguration:
IndexDocument: index.html
ErrorDocument: error.html
RoutingRules:
- RoutingRuleCondition:
HttpErrorCodeReturnedEquals: '404'
KeyPrefixEquals: out1/
RedirectRule:
HostName: ec2-11-22-333-44.compute-1.amazonaws.com
ReplaceKeyPrefixWith: report-404/
DeletionPolicy: Retain
UpdateReplacePolicy: Retain
Outputs:
S3BucketAArn:
Value: !GetAtt [S3BucketA, Arn]
S3BucketADomainName:
Value: !GetAtt [S3BucketA, DomainName]
S3BucketAWebsiteURL:
Value: !GetAtt [S3BucketA, WebsiteURL]
S3BucketBArn:
Value: !GetAtt [S3BucketB, Arn]
S3BucketBDomainName:
Value: !GetAtt [S3BucketB, DomainName]
S3BucketBWebsiteURL:
Value: !GetAtt [S3BucketB, WebsiteURL]
S3BucketCArn:
Value: !GetAtt [S3BucketC, Arn]
S3BucketCDomainName:
Value: !GetAtt [S3BucketC, DomainName]
S3BucketCWebsiteURL:
Value: !GetAtt [S3BucketC, WebsiteURL]
```
## Verweisen auf replizierte `AWS::EC2::Instance`-Ressourcen
Dieses Beispiel verweist auf replizierte Ressourcen in dem `Resources` Abschnitt unter Verwendung der generierten Logik IDs.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Mappings": {
"Instances": {
"InstanceType": {
"B": "m5.4xlarge",
"C": "c5.2xlarge"
},
"ImageId": {"A": "ami-id1"}
}
},
"Resources": {
"Fn::ForEach::Instances": [
"Identifier",
[ "A", "B", "C" ],
{
"Instance${Identifier}": {
"Type": "AWS::EC2::Instance",
"Properties": {
"InstanceType": {"Fn::FindInMap": ["Instances", "InstanceType", {"Ref": "Identifier"}, {"DefaultValue": "m5.xlarge"}]},
"ImageId": {"Fn::FindInMap": ["Instances", "ImageId", {"Ref": "Identifier"}, {"DefaultValue": "ami-id-default"}]}
}
}
}
]
},
"Outputs": {
"SecondInstanceId": {
"Description": "Instance Id for InstanceB",
"Value": {"Ref": "InstanceB"}
},
"SecondPrivateIp": {
"Description": "Private IP for InstanceB",
"Value": {
"Fn::GetAtt": [
"InstanceB",
"PrivateIp"
]
}
}
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Mappings:
Instances:
InstanceType:
B: m5.4xlarge
C: c5.2xlarge
ImageId:
A: ami-id1
Resources:
'Fn::ForEach::Instances':
- Identifier
- [A, B, C]
- 'Instance${Identifier}':
Type: AWS::EC2::Instance
Properties:
InstanceType: !FindInMap [Instances, InstanceType, !Ref Identifier, DefaultValue: m5.xlarge]
ImageId: !FindInMap [Instances, ImageId, !Ref Identifier, DefaultValue: ami-id-default]
Outputs:
SecondInstanceId:
Description: Instance Id for InstanceB
Value: !Ref InstanceB
SecondPrivateIp:
Description: Private IP for InstanceB
Value: !GetAtt [InstanceB, PrivateIp]
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Resources:
InstanceA:
Type: AWS::EC2::Instance
Properties:
InstanceType: m5.xlarge
ImageId: ami-id1
InstanceB:
Type: AWS::EC2::Instance
Properties:
InstanceType: m5.4xlarge
ImageId: ami-id-default
InstanceC:
Type: AWS::EC2::Instance
Properties:
InstanceType: c5.2xlarge
ImageId: ami-id-default
Outputs:
SecondInstanceId:
Description: Instance Id for InstanceB
Value: !Ref InstanceB
SecondPrivateIp:
Description: Private IP for InstanceB
Value: !GetAtt [InstanceB, PrivateIp]
```
# Beispiele für `Fn::ForEach` im Abschnitt „`Conditions`“
Diese Beispiele demonstrieren die Verwendung der intrinsischen Funktion `Fn::ForEach` im Abschnitt „`Conditions`“. Weitere Informationen zu diesem Abschnitt finden Sie unter [Bedingungen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/conditions-section-structure.html) im *AWS CloudFormation -Benutzerhandbuch*.
**Wichtig**
`Conditions` muss die zweite aufgelistete Eigenschaft oder eine spätere sein. Die Stack-Erstellung schlägt fehl, wenn `Conditions` die erste Eigenschaft ist, die im Vorlagenfragmentparameter von `Fn::ForEach` aufgeführt ist.
```
Resources:
'Fn::ForEach::Topics':
- LogicalId
- !Ref TopicList
- '${LogicalId}':
Condition: !Sub 'TopicCondition${LogicalId}'
Type: AWS::SNS::Topic
Properties:
TopicName: !Sub 'My${LogicalId}'
```
`Conditions` muss als zweiter Schlüssel oder später hinzugefügt werden, damit die Stack-Erstellung erfolgreich ist:
```
Resources:
'Fn::ForEach::Topics':
- LogicalId
- !Ref TopicList
- '${LogicalId}':
Type: AWS::SNS::Topic
Condition: !Sub 'TopicCondition${LogicalId}'
Properties:
TopicName: !Sub 'My${LogicalId}'
```
**Topics**
+ [Replizieren einer einzelnen Bedingung](#intrinsic-function-reference-foreach-example-replicated-single-condition)
## Replizieren einer einzelnen Bedingung
In diesem Beispiel wird die intrinsische Funktion `Fn::ForEach` im Abschnitt `Conditions` verwendet, um mehrere ähnliche Bedingungen mit unterschiedlichen Eigenschaften zu replizieren.
### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Transform": "AWS::LanguageExtensions",
"Parameters": {
"ParamA": {
"Type": "String",
"AllowedValues": [
"true",
"false"
]
},
"ParamB": {
"Type": "String",
"AllowedValues": [
"true",
"false"
]
},
"ParamC": {
"Type": "String",
"AllowedValues": [
"true",
"false"
]
},
"ParamD": {
"Type": "String",
"AllowedValues": [
"true",
"false"
]
}
},
"Conditions": {
"Fn::ForEach::CheckTrue": [
"Identifier",
["A", "B", "C", "D"],
{
"IsParam${Identifier}Enabled": {
"Fn::Equals": [
{"Ref": {"Fn::Sub": "Param${Identifier}"}},
"true"
]
}
}
]
},
"Resources": {
"WaitConditionHandle": {
"Type": "AWS::CloudFormation::WaitConditionHandle"
}
}
}
```
### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Parameters:
ParamA:
Type: String
AllowedValues:
- 'true'
- 'false'
ParamB:
Type: String
AllowedValues:
- 'true'
- 'false'
ParamC:
Type: String
AllowedValues:
- 'true'
- 'false'
ParamD:
Type: String
AllowedValues:
- 'true'
- 'false'
Conditions:
'Fn::ForEach::CheckTrue':
- Identifier
- [A, B, C, D]
- 'IsParam${Identifier}Enabled': !Equals
- !Ref
'Fn::Sub': 'Param${Identifier}'
- 'true'
Resources:
WaitConditionHandle:
Type: AWS::CloudFormation::WaitConditionHandle
```
Die transformierte Vorlage entspricht der folgenden Vorlage:
```
AWSTemplateFormatVersion: 2010-09-09
Parameters:
ParamA:
Type: String
AllowedValues:
- 'true'
- 'false'
ParamB:
Type: String
AllowedValues:
- 'true'
- 'false'
ParamC:
Type: String
AllowedValues:
- 'true'
- 'false'
ParamD:
Type: String
AllowedValues:
- 'true'
- 'false'
Conditions:
IsParamAEnabled: !Equals
- !Ref ParamA
- 'true'
IsParamBEnabled: !Equals
- !Ref ParamB
- 'true'
IsParamCEnabled: !Equals
- !Ref ParamC
- 'true'
IsParamDEnabled: !Equals
- !Ref ParamD
- 'true'
Resources:
WaitConditionHandle:
Type: AWS::CloudFormation::WaitConditionHandle
```