Fn::ForEach - AWS CloudFormation
Dichiarazione ParametriValore restituitoFunzioni supportateEsempi

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 intrinseca Fn::ForEach prende una raccolta e un frammento e applica gli elementi della raccolta all'identificatore nel frammento fornito. Fn::ForEach può contenere altre funzioni intrinseche, inclusa Fn::ForEach stessa, ed essere utilizzata nelle sezioni Conditions, Outputs, Resources (incluse le proprietà delle risorse). Non può essere utilizzato nelle sezioni Versione del formato, Description, Metadata, Transform, Parameters, Mappings, Rules o Hooks Per alcuni esempi, consulta Esempi.

Importante

È necessario utilizzare Trasformazione AWS::LanguageExtensions per utilizzare la funzione intrinseca Fn::ForEach.

Importante

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 Comprendi le CloudFormation quote.

Dichiarazione

JSON

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

YAML

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

Parametri

UniqueLoopName

Un nome per questo loop. Il nome deve essere univoco all'interno del modello e non può essere in conflitto con alcun valore di ID logico nella sezione CloudFormation modello Resources sintassi del modello. Questo nome non è presente nell'output trasformato.

Identifier

L'identificatore da sostituire nei parametri OutputKey e OutputValue che rappresentano il frammento di modello che viene replicato. Tutte le istanze di${Identifier}, or&{Identifier}, nei OutputValue parametri OutputKey e vengono sostituite con i valori del parametro. Collection

Collection

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 il&{Identifier}, è possibile passare caratteri non alfanumerici in. Collection

OutputKey

La chiave nel modello trasformato. ${Identifier}o &{Identifier} deve essere inclusa nel OutputKey parametro. Ad esempio, se Fn::ForEach viene utilizzato nella sezione Resources del modello, questo è l'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

OutputValue

Il valore che viene replicato nel modello trasformato per ogni elemento del parametro Collection. Ad esempio, se Fn::ForEach viene utilizzato nella sezione Resources del modello, questo è il 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

Per alcuni esempi, consulta Esempi.