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.

# CloudFormation Exemples d'ingestion : définition des ressources
<a name="cfn-ingest-ex-define-resource"></a>

Lorsque vous utilisez AMS CloudFormation ingest, vous personnalisez un CloudFormation modèle et vous le soumettez à AMS dans une RFC avec le type de modification d'ingestion ( CloudFormation ct-36cn2avfrrj9v). Pour créer un CloudFormation modèle qui peut être réutilisé plusieurs fois, vous ajoutez les paramètres de configuration de la pile à l'entrée d'exécution du type de modification d' CloudFormation ingestion plutôt que de les coder en dur dans le CloudFormation modèle. Le principal avantage est que vous pouvez réutiliser le modèle.

Le schéma de saisie du type de modification AMS CloudFormation ingest vous permet de choisir jusqu'à soixante paramètres dans un CloudFormation modèle et de fournir des valeurs personnalisées.

Cet exemple montre comment définir une propriété de ressource, qui peut être utilisée dans divers CloudFormation modèles, en tant que paramètre dans le CT d' CloudFormation ingestion AMS. Les exemples de cette section montrent spécifiquement l'utilisation des rubriques SNS.

**Topics**
+ [Exemple 1 : coder en dur la `TopicName` propriété de la CloudFormation SNSTopic ressource](#cfn-ingest-example-1)
+ [Exemple 2 : Utiliser une SNSTopic ressource pour référencer un paramètre dans le type de modification AMS](#cfn-ingest-example-2)
+ [Exemple 3 : créer une rubrique SNS en soumettant un fichier de paramètres d'exécution JSON avec le type de modification AMS ingest](#cfn-ingest-example-3)
+ [Exemple 4 : Soumettre un nouveau type de modification qui fait référence au même CloudFormation modèle](#cfn-ingest-example-4)
+ [Exemple 5 : utilisation des valeurs de paramètres par défaut dans le CloudFormation modèle](#cfn-ingest-example-5)

## Exemple 1 : coder en dur la `TopicName` propriété de la CloudFormation SNSTopic ressource
<a name="cfn-ingest-example-1"></a>

Dans cet exemple, vous devez coder en dur la `TopicName` propriété de la CloudFormation SNSTopic ressource dans le CloudFormation modèle. Notez que la `Parameters` section est vide. 

Pour disposer d'un CloudFormation modèle qui vous permet de modifier la valeur du SNSTopic nom d'une nouvelle pile sans avoir à créer un nouveau CloudFormation modèle, vous pouvez utiliser la `Parameters` section AMS du type de modification d' CloudFormation ingestion pour effectuer cette configuration. Ce faisant, vous utiliserez le même CloudFormation modèle ultérieurement pour créer une nouvelle pile portant un `SNSTopic` nom différent.

```
{
  "AWSTemplateFormatVersion" : "2010-09-09",
  "Description" : "My SNS Topic",
  "Parameters" : {
  },
  "Resources" : {
    "SNSTopic" : {
      "Type" : "AWS::SNS::Topic",
      "Properties" : {
        "TopicName" : "MyTopicName"
      }
    }
  }
}
```



## Exemple 2 : Utiliser une SNSTopic ressource pour référencer un paramètre dans le type de modification AMS
<a name="cfn-ingest-example-2"></a>

Dans cet exemple, vous utilisez une `TopicName` propriété de `SNSTopic` ressource définie dans le CloudFormation modèle pour référencer a `Parameter` dans le type de modification AMS.

```
{
  "AWSTemplateFormatVersion" : "2010-09-09",
  "Description" : "My SNS Topic",
  "Parameters" : {
    "TopicName" : {
      "Type" : "String",
      "Description" : "Topic ID",
      "Default" : "MyTopicName"
    }
  },
  "Resources" : {
    "SNSTopic" : {
      "Type" : "AWS::SNS::Topic",
      "Properties" : {
        "TopicName" : { "Ref" : "TopicName"}
      }
    }
  }
}
```

## Exemple 3 : créer une rubrique SNS en soumettant un fichier de paramètres d'exécution JSON avec le type de modification AMS ingest
<a name="cfn-ingest-example-3"></a>

Dans cet exemple, vous soumettez un fichier de paramètres d'exécution JSON avec le CT d'ingestion AMS qui crée le sujet SNS. `TopicName` Le sujet SNS doit être défini dans le CloudFormation modèle de la manière modifiable illustrée dans cet exemple. 

```
{
  "Name": "cfn-ingest",
  "Description": "CFNIngest Web Application Stack",
  "CloudFormationTemplateS3Endpoint": "$S3_PRESIGNED_URL",
  "VpcId": "VPC_ID",
  "Tags": [
    {"Key": "Enviroment Type", "Value": "Dev"}
  ],
  "Parameters": [
    {"Name": "TopicName", "Value": "MyTopic1"}
  ],
  "TimeoutInMinutes": 60
}
```

## Exemple 4 : Soumettre un nouveau type de modification qui fait référence au même CloudFormation modèle
<a name="cfn-ingest-example-4"></a>

Cet exemple JSON modifie la `TopicName` valeur SNS sans modifier le CloudFormation modèle. Au lieu de cela, vous soumettez un nouveau type de changement Deployment \$1 Ingestion \$1 Stack from CloudFormation Template \$1 Create qui fait référence au même modèle CFN.

```
{
  "Name": "cfn-ingest",
  "Description": "CFNIngest Web Application Stack",
  "CloudFormationTemplateS3Endpoint": "$S3_PRESIGNED_URL",
  "VpcId": "VPC_ID",
  "Tags": [
    {"Key": "Enviroment Type", "Value": "Dev"}
  ],
  "Parameters": [
    {"Name": "TopicName", "Value": "MyTopic2"}
  ],
  "TimeoutInMinutes": 60
}
```

## Exemple 5 : utilisation des valeurs de paramètres par défaut dans le CloudFormation modèle
<a name="cfn-ingest-example-5"></a>

Dans cet exemple, le SNS `TopicName` = « MyTopicName » est créé car aucune `TopicName` valeur n'a été fournie dans le paramètre `Parameters` d'exécution. Si vous ne fournissez pas de `Parameters` définitions, les valeurs des paramètres par défaut du CloudFormation modèle sont utilisées.

```
{
  "Name": "cfn-ingest",
  "Description": "CFNIngest Web Application Stack",
  "CloudFormationTemplateS3Endpoint": "$S3_PRESIGNED_URL",
  "VpcId": "VPC_ID",
  "Tags": [
    {"Key": "Enviroment Type", "Value": "Dev"}
  ],
  "TimeoutInMinutes": 60
}
```