Fn::ForEach - AWS CloudFormation
Dichiarazione ParametriValore restituitoFunzioni supportateEsempi

Questa è la nuova guida AWS CloudFormation di riferimento per i modelli. Aggiorna i segnalibri e i link. Per informazioni su come iniziare CloudFormation, consulta la Guida per l'AWS CloudFormation utente.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Fn::ForEach

La funzione Fn::ForEach intrinseca accetta una raccolta e un frammento e applica gli elementi della raccolta all'identificatore nel frammento fornito. Fn::ForEachpuò contenere altre funzioni intrinseche, inclusa Fn::ForEach se stessa, ed essere utilizzata nelle sezioniOutputs, e Resources (incluse le Conditions proprietà delle risorse). Non può essere utilizzato in nessuna delle seguenti sezioni,,AWSTemplateFormatVersion, DescriptionMetadata,Transform, Parameters MappingsRules, o Hooks sezioni.

Se si utilizza la funzione Fn::ForEach intrinseca nel modello, è necessario utilizzare anche la. Trasformazione AWS::LanguageExtensions

L'utilizzo della funzione intrinseca Fn::ForEach non modifica le quote, che si applicano al modello risultante. Le quote includono la dimensione massima di un modello e il numero massimo di risorse in un modello. Per ulteriori informazioni, consulta Comprendere le AWS CloudFormation quote nella Guida per l'AWS CloudFormation utente.

Dichiarazione

JSON

"Fn::ForEach::LoopLogicalName": [
  "Identifier",
  ["Value1","Value2"], // Collection
  {"OutputKey": {OutputValue}}
]

YAML

'Fn::ForEach::LoopLogicalName':
    - Identifier
    - - Value1 # Collection
      - Value2
    - 'OutputKey':
        OutputValue

Parametri

Nome logico del ciclo

Un ID logico per il ciclo. Il nome deve essere univoco all'interno del modello e non può essere in conflitto con alcun valore di ID logico nella Resources sezione del modello. Questo nome non è presente nell'output trasformato. Viene utilizzato come riferimento interno all'interno del CloudFormation modello stesso.

Identificatore

Un identificatore per il segnaposto che viene sostituito nei parametri and. OutputKey OutputValue Tutte le istanze di ${Identifier} o &{Identifier} nei OutputValue parametri OutputKey and verranno sostituite con i valori del parametro. Collection

Raccolta

La raccolta di valori su cui iterare. Può essere una matrice in questo parametro oppure può essere un Ref su un CommaDelimitedList. Quando si utilizza&{Identifier}, è possibile passare caratteri non alfanumerici in. Collection

Chiave di uscita

La chiave nel modello trasformato. ${Identifier}o &{Identifier} deve essere inclusa nel OutputKey parametro. Ad esempio, se Fn::ForEach viene utilizzato nella Resources sezione del modello, si tratta dell'ID logico di ogni risorsa.

La &{} sintassi consente l'utilizzo di caratteri non alfanumerici nel Collection parametro. OutputKey Per un esempio di ciò, vedere. Passaggio di caratteri non alfanumerici all'interno del modulo CollectionFn::ForEach

Valore di output

Il valore che viene replicato nel modello trasformato per ogni elemento del Collection parametro. Ad esempio, se Fn::ForEach viene utilizzato nella Resources sezione del modello, si tratta del frammento del modello che viene ripetuto per configurare ogni risorsa.

Valore restituito

Un oggetto espanso che contiene il frammento dell'oggetto ripetuto una volta per ogni elemento della raccolta, in cui l'identificatore nel frammento viene sostituito con l'elemento della raccolta.

Funzioni supportate

È possibile utilizzare le funzioni seguenti in una funzione Fn::ForEach.

Esempi

Puoi trovare esempi per le Resources sezioni ConditionsOutputs, e inEsempi.