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.
# Spécifier les ressources avec AWS CloudFormation
Amazon Personalize est intégré à AWS CloudFormation un service qui vous aide à modéliser et à configurer vos AWS ressources afin que vous puissiez passer moins de temps à créer et à gérer vos ressources et votre infrastructure. Vous créez un modèle qui décrit toutes les AWS ressources que vous pouvez spécifier (telles que les groupes de jeux de données Amazon Personalize). CloudFormation fournit et configure ensuite ces ressources pour vous.
Lorsque vous l'utilisez CloudFormation, vous pouvez réutiliser votre modèle pour configurer vos ressources Amazon Personalize de manière cohérente et répétée. Décrivez vos ressources une seule fois, puis fournissez les mêmes ressources encore et encore dans plusieurs Comptes AWS régions.
**Topics**
+ [Amazon Personalize et CloudFormation modèles](#working-with-templates)
+ [Exemples CloudFormation de modèles pour les ressources Amazon Personalize](#personalize-template-example)
+ [En savoir plus sur CloudFormation](#learn-more-cloudformation)
## Amazon Personalize et CloudFormation modèles
Pour fournir et configurer des ressources pour Amazon Personalize et les services associés, vous devez comprendre les [CloudFormation modèles](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html). Les modèles sont des fichiers texte formatés en JSON ou YAML. Ces modèles décrivent les ressources que vous souhaitez mettre à disposition dans vos CloudFormation piles. Si vous n'êtes pas familiarisé avec JSON ou YAML, vous pouvez utiliser CloudFormation Designer pour vous aider à démarrer avec les CloudFormation modèles. Pour plus d’informations, consultez [Qu’est-ce que CloudFormation Designer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/working-with-templates-cfn-designer.html) dans le *Guide de l’utilisateur AWS CloudFormation *.
Amazon Personalize prend en charge la spécification d'ensembles de données, de groupes de données, de tâches d'importation de jeux de données, de schémas et de solutions dans. CloudFormation Pour plus d'informations, consultez la [référence au type de ressource Amazon Personalize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Personalize.html) dans le *guide de AWS CloudFormation l'utilisateur*.
## Exemples CloudFormation de modèles pour les ressources Amazon Personalize
Les exemples de CloudFormation modèles suivants vous montrent comment spécifier différentes ressources Amazon Personalize.
**Topics**
+ [CreateDatasetGroup](#cfn-create-dataset-group)
+ [CreateDataset](#cfn-create-dataset)
+ [CreateSchema](#cfn-create-schema)
+ [CreateSolution](#cfn-create-solution)
### CreateDatasetGroup
------
#### [ JSON ]
```
{
"AWSTemplateFormatVersion":"2010-09-09",
"Resources":{
"MyDatasetGroup": {
"Type": "AWS::Personalize::DatasetGroup",
"Properties": {
"Name": "my-dataset-group-name"
}
}
}
}
```
------
#### [ YAML ]
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
MyDatasetGroup:
Type: 'AWS::Personalize::DatasetGroup'
Properties:
Name: my-dataset-group-name
```
------
### CreateDataset
------
#### [ JSON ]
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Resources": {
"MyDataset": {
"Type": "AWS::Personalize::Dataset",
"Properties": {
"Name": "my-dataset-name",
"DatasetType": "Interactions",
"DatasetGroupArn": "arn:aws:personalize:us-west-2:123456789012:dataset-group/dataset-group-name",
"SchemaArn": "arn:aws:personalize:us-west-2:123456789012:schema/schema-name",
"DatasetImportJob": {
"JobName": "my-import-job-name",
"DataSource": {
"DataLocation": "s3://amzn-s3-demo-bucket/file-name.csv"
},
"RoleArn": "arn:aws:iam::123456789012:role/personalize-role"
}
}
}
}
}
```
------
#### [ YAML ]
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
MyDataset:
Type: 'AWS::Personalize::Dataset'
Properties:
Name: my-dataset-name
DatasetType: Interactions
DatasetGroupArn: 'arn:aws:personalize:us-west-2:123456789012:dataset-group/dataset-group-name'
SchemaArn: 'arn:aws:personalize:us-west-2:123456789012:schema/schema-name'
DatasetImportJob:
JobName: my-import-job-name
DataSource:
DataLocation: 's3://amzn-s3-demo-bucket/file-name.csv'
RoleArn: 'arn:aws:iam::123456789012:role/personalize-role'
```
------
### CreateSchema
------
#### [ JSON ]
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Resources": {
"MySchema": {
"Type": "AWS::Personalize::Schema",
"Properties": {
"Name": "my-schema-name",
"Schema": "{\"type\": \"record\",\"name\": \"Interactions\", \"namespace\": \"com.amazonaws.personalize.schema\", \"fields\": [ { \"name\": \"USER_ID\", \"type\": \"string\" }, { \"name\": \"ITEM_ID\", \"type\": \"string\" }, { \"name\": \"TIMESTAMP\", \"type\": \"long\"}], \"version\": \"1.0\"}"
}
}
}
}
```
------
#### [ YAML ]
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
MySchema:
Type: AWS::Personalize::Schema
Properties:
Name: "my-schema-name"
Schema: >-
{"type": "record","name": "Interactions", "namespace":
"com.amazonaws.personalize.schema", "fields": [ { "name": "USER_ID",
"type": "string" }, { "name": "ITEM_ID", "type": "string" }, { "name":
"TIMESTAMP", "type": "long"}], "version": "1.0"}
```
------
### CreateSolution
------
#### [ JSON ]
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Resources": {
"MySolution": {
"Type": "AWS::Personalize::Solution",
"Properties": {
"Name": "my-solution-name",
"DatasetGroupArn": "arn:aws:personalize:us-west-2:123456789012:dataset-group/my-dataset-group-name",
"RecipeArn": "arn:aws:personalize:::recipe/aws-user-personalization",
"SolutionConfig": {
"EventValueThreshold" : ".05"
}
}
}
}
}
```
------
#### [ YAML ]
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
MySolution:
Type: 'AWS::Personalize::Solution'
Properties:
Name: my-solution-name
DatasetGroupArn: >-
arn:aws:personalize:us-west-2:123456789012:dataset-group/my-dataset-group-name
RecipeArn: 'arn:aws:personalize:::recipe/aws-user-personalization'
SolutionConfig:
EventValueThreshold: '.05'
```
------
## En savoir plus sur CloudFormation
Pour en savoir plus CloudFormation, consultez les ressources suivantes :
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
+ [AWS CloudFormation guide de l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
+ [CloudFormation Référence d’API](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html)
+ [AWS CloudFormation Guide de l'utilisateur de l'interface de ligne de commande](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html)