Attribution d’un nom personnalisé à une ressource CloudFormation - AWS CloudFormation
Exemple

Il s’agit du nouveau Guide de référence des modèles CloudFormation . 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.

Attribution d’un nom personnalisé à une ressource CloudFormation

Vous pouvez attribuer des noms personnalisés aux types de ressources pris en charge dans votre modèle CloudFormation, afin de les rendre plus significatifs et plus facilement identifiables. Par défaut, CloudFormation génère un IF physique unique pour nommer une ressource. Par exemple, CloudFormation peut nommer un compartiment Amazon S3 avec l'ID physique suivant : MyStack-MyBucket-abcdefghijk1. Avec des noms personnalisés, vous pouvez définir un nom qui est plus facile à lire et à identifier, comme production-app-logs ou business-metrics.

Toutes les ressources ne prennent pas en charge les noms personnalisés. Chaque service AWS détermine de manière indépendante quels types de ressources acceptent les noms personnalisés.

Les noms de ressource doivent être uniques dans l'ensemble de vos piles actives. Si vous réutilisez des modèles pour créer plusieurs piles, vous devez modifier ou supprimer les noms personnalisés à partir du modèle. Si vous ne spécifiez aucun nom, CloudFormation génère un ID physique unique pour le nom de la ressource. Les noms doivent commencer par une lettre, doivent contenir uniquement des lettres ASCII, des chiffres et des tirets, et ne doivent pas se terminer par un tiret ni contenir deux tirets consécutifs.

De même, ne gérez pas les ressources d'une pile en dehors de CloudFormation. Par exemple, si vous renommez une ressource qui fait partie d'une pile sans utiliser CloudFormation, vous pourriez recevoir une erreur lorsque vous essayez de mettre à jour ou de supprimer cette pile.

Important

Vous ne pouvez pas effectuer une mise à jour qui entraîne le remplacement d'une ressource dont le nom est personnalisé. Si vous devez remplacer la ressource, spécifiez un nouveau nom.

Exemple

Si vous souhaitez utiliser un nom personnalisé, définissez une propriété de nom pour cette ressource dans votre modèle CloudFormation. Chaque ressource qui prend en charge des noms personnalisés inclut sa propre propriété que vous spécifiez. Par exemple, pour nommer une table DynamoDB, utilisez la propriété TableName comme dans l'exemple suivant :

JSON

"myDynamoDBTable" : {
   "Type" : "AWS::DynamoDB::Table",
   "Properties" : {
      "KeySchema" : {
         "HashKeyElement": {
            "AttributeName" : "AttributeName1",
            "AttributeType" : "S"
         },
         "RangeKeyElement" : {
            "AttributeName" : "AttributeName2",
            "AttributeType" : "N"
         }
      },
      "ProvisionedThroughput" : {
         "ReadCapacityUnits" : "5",
         "WriteCapacityUnits" : "10"
      },
      "TableName" : "SampleTable"
   }
}

YAML

myDynamoDBTable: 
  Type: AWS::DynamoDB::Table
  Properties: 
    KeySchema: 
      HashKeyElement: 
        AttributeName: "AttributeName1"
        AttributeType: "S"
      RangeKeyElement: 
        AttributeName: "AttributeName2"
        AttributeType: "N"
    ProvisionedThroughput: 
      ReadCapacityUnits: "5"
      WriteCapacityUnits: "10"
    TableName: "SampleTable"