Type de nom

Pour certaines ressources, vous pouvez spécifier un nom personnalisé. Par défaut, AWS CloudFormation génère un identifiant physique unique pour nommer une ressource. Par exemple, CloudFormation vous pouvez nommer un compartiment Amazon S3 avec l'ID physique suivantMyStack-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.

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 pas de nom, CloudFormation génère un identifiant physique unique pour nommer la ressource. Les noms doivent commencer par une lettre, ne contenir que des ASCII lettres, des chiffres et des traits d'union, et ne pas se terminer par un tiret ni contenir deux traits d'union consécutifs.

De plus, ne gérez pas les ressources de la pile en dehors de CloudFormation. Par exemple, si vous renommez une ressource qui fait partie d'une pile sans l'utiliser CloudFormation, une erreur peut s'afficher chaque fois que vous tentez de mettre à jour ou de supprimer cette pile.

Exemple

Si vous souhaitez utiliser un nom personnalisé, spécifiez une propriété de nom pour cette ressource dans votre CloudFormation modèle. 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 :

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

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

Ressources prises en charge

Les types de ressources suivants prennent en charge les noms personnalisés :