Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Especificar recursos con AWS CloudFormation
Amazon Personalize está integrado con AWS CloudFormation un servicio que le ayuda a modelar y configurar sus AWS recursos para que pueda dedicar menos tiempo a crear y administrar sus recursos e infraestructura. Crea una plantilla que describe todos los AWS recursos que puede especificar (como los grupos de conjuntos de datos de Amazon Personalize). CloudFormation a continuación, aprovisiona y configura esos recursos por usted.
Cuando la utilices CloudFormation, podrás reutilizar la plantilla para configurar tus recursos de Amazon Personalize de forma coherente y repetida. Describa sus recursos una vez y, a continuación, aprovisione los mismos recursos una y otra vez en varias Cuentas de AWS regiones.
**Topics**
+ [Amazon Personalize y CloudFormation plantillas](#working-with-templates)
+ [CloudFormation Plantillas de ejemplo para los recursos de Amazon Personalize](#personalize-template-example)
+ [Obtenga más información sobre CloudFormation](#learn-more-cloudformation)
## Amazon Personalize y CloudFormation plantillas
Para aprovisionar y configurar los recursos de Amazon Personalize y los servicios relacionados, debe comprender las [plantillas de CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html). Las plantillas son archivos de texto con formato JSON o YAML. Estas plantillas describen los recursos que desea aprovisionar en sus CloudFormation pilas. Si no estás familiarizado con JSON o YAML, puedes usar CloudFormation Designer para ayudarte a empezar con CloudFormation las plantillas. Para obtener más información, consulte [¿Qué es Designer de CloudFormation ?](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/working-with-templates-cfn-designer.html) en la *Guía del usuario de AWS CloudFormation *.
Amazon Personalize permite especificar conjuntos de datos, grupos de conjuntos de datos, trabajos de importación de conjuntos de datos, esquemas y soluciones en CloudFormation. Para obtener más información, consulte la [Referencia de tipos de recursos de Amazon Personalize](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Personalize.html) en la *Guía del usuario de AWS CloudFormation *.
## CloudFormation Plantillas de ejemplo para los recursos de Amazon Personalize
Los siguientes ejemplos CloudFormation de plantillas muestran cómo especificar distintos recursos de 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'
```
------
## Obtenga más información sobre CloudFormation
Para obtener más información CloudFormation, consulte los siguientes recursos:
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
+ [AWS CloudFormation guía del usuario](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
+ [CloudFormation Referencia de la API](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html)
+ [Guía del usuario de la interfaz de la línea de comandos de AWS CloudFormation](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html)