Transformation AWS::LanguageExtensions - AWS CloudFormation
UtilisationSupport pour des fonctions supplémentairesConsidérationsExemplesRessources connexes

Il s'agit du nouveau guide AWS CloudFormation de référence des modèles. Veuillez mettre à jour vos favoris et vos liens. Pour obtenir de l'aide pour démarrer CloudFormation, consultez le guide de AWS CloudFormation l'utilisateur.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Transformation AWS::LanguageExtensions

Cette rubrique décrit comment utiliser la AWS::LanguageExtensions transformation pour activer des fonctions et fonctionnalités supplémentaires qui ne sont pas disponibles par défaut.

AWS::LanguageExtensionsIl s'agit d'une CloudFormation macro qui, lorsqu'elle est référencée dans votre modèle de pile, met à jour toute fonction intrinsèque définie par la transformation à sa valeur résolue dans le modèle lorsque vous créez ou mettez à jour une pile à l'aide d'un ensemble de modifications.

En incluant cette transformation dans votre CloudFormation modèle, vous pouvez accéder à des fonctionnalités supplémentaires, telles queFn::ForEach, qui permettent des opérations plus avancées telles que l'itération. Vous pouvez également utiliser des fonctions intrinsèques dans des endroits où elles ne sont généralement pas autorisées, comme les Fn::GetAtt fonctions in Ref et.

Utilisation

Pour utiliser la AWS::LanguageExtensions transformation, vous devez la déclarer au niveau supérieur de votre CloudFormation modèle. Vous ne pouvez pas utiliser AWS::LanguageExtensions comme transformation incorporée dans une autre section de modèle.

La déclaration doit utiliser la chaîne littérale AWS::LanguageExtensions comme valeur. Vous ne pouvez pas utiliser de paramètre ou de fonction pour spécifier la valeur de transformation.

Syntaxe

Pour déclarer cette transformation dans votre CloudFormation modèle, utilisez la syntaxe suivante :

JSON

{
  "Transform":"AWS::LanguageExtensions",
  "Resources":{
    ...
  }
}

YAML

Transform: AWS::LanguageExtensions
Resources:
  ...

La AWS::LanguageExtensions transformation est une déclaration autonome sans paramètres supplémentaires.

Support pour des fonctions supplémentaires

La AWS::LanguageExtensions transformation prend en charge les fonctions supplémentaires suivantes :

Considérations

Lors de l'utilisation de la transformation AWS::LanguageExtensions, gardez à l'esprit les considérations suivantes :

  • Lorsque vous mettez à jour une pile qui utilise la AWS::LanguageExtensions transformation, nous vous recommandons de ne pas utiliser l'option Utiliser un modèle existant dans la CloudFormation console, ni l'option de ligne de commande équivalente--use-previous-template. La AWS::LanguageExtensions transformation résout les paramètres en valeurs littérales pendant le traitement. Lorsque vous utilisez--use-previous-template, CloudFormation utilise ce modèle traité avec les anciennes valeurs littérales, empêchant ainsi l'application de nouvelles valeurs de paramètres et de mises à jour des paramètres de Systems Manager. Fournissez plutôt le modèle d'origine pour vous assurer que les paramètres sont résolus à nouveau avec les valeurs actuelles.

  • La forme courte YAML abrégée n'est pas prise en charge dans un modèle pour les fonctions intrinsèques fournies par la transformation AWS::LanguageExtensions. Utilisez des références explicites aux fonctions. Par exemple, utilisez Fn::Length plutôt que !Length.

  • La AWS SAM CLI ne prend actuellement pas en charge la fonction Fn::ForEach intrinsèque de la AWS::LanguageExtensions transformation.

  • Si vous utilisez plusieurs transformations, utilisez un format de liste. Si vous utilisez des macros personnalisées, placez les transformations AWS fournies après vos macros personnalisées. Si vous utilisez à la fois les transformations AWS::LanguageExtensions et AWS::Serverless, la transformation AWS::LanguageExtensions doit venir avant la transformation AWS::Serverless dans la liste.

  • Les fonctions et attributs fournis par la AWS::LanguageExtensions transformation ne sont pris en charge que dans les Outputs sections ResourcesConditions, et de votre modèle.

Exemples

Les exemples suivants montrent comment utiliser la AWS::LanguageExtensions transformation pour utiliser la fonction Fn::Length intrinsèque définie par la transformation.

JSON

{
    "AWSTemplateFormatVersion": "2010-09-09",
    "Transform": "AWS::LanguageExtensions",
    "Parameters": {
        "QueueList": {
            "Type": "CommaDelimitedList"
        },
        "QueueNameParam": {
            "Description": "Name for your SQS queue",
            "Type": "String"
        }
    },
    "Resources": {
        "Queue": {
            "Type": "AWS::SQS::Queue",
            "Properties": {
                "QueueName": {
                    "Ref": "QueueNameParam"
                },
                "DelaySeconds": {
                    "Fn::Length": {
                        "Ref": "QueueList"
                    }
                }
            }
        }
    }
}

YAML

AWSTemplateFormatVersion: 2010-09-09
Transform: AWS::LanguageExtensions
Parameters:
  QueueList:
    Type: CommaDelimitedList
  QueueNameParam:
    Description: Name for your SQS queue
    Type: String
Resources:
  Queue:
    Type: AWS::SQS::Queue
    Properties:
      QueueName: !Ref QueueNameParam
      DelaySeconds:
        'Fn::Length': !Ref QueueList

Pour plus d'exemples, consultez les rubriques suivantes.

Pour obtenir des informations générales sur l'utilisation des macros, voir Effectuer un traitement personnalisé sur des CloudFormation modèles à l'aide de modèles de macros dans le Guide de AWS CloudFormation l'utilisateur.