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.

# Referencia de la API
<a name="API_Reference"></a>

Esta sección proporciona documentación sobre las operaciones de API de Amazon Personalize. Para ver una lista de los puntos de conexión de Amazon Personalize por región, consulte [Regiones y puntos de conexión de AWS](https://docs.aws.amazon.com/general/latest/gr/personalize.html) en la *Referencia general de AWS *.

**Topics**
+ [Acciones](API_Operations.md)
+ [Data Types](API_Types.md)
+ [Errores comunes](CommonErrors.md)
+ [Parámetros comunes](CommonParameters.md)

# Acciones
<a name="API_Operations"></a>

Amazon Personalize admite las siguientes acciones:
+  [CreateBatchInferenceJob](API_CreateBatchInferenceJob.md) 
+  [CreateBatchSegmentJob](API_CreateBatchSegmentJob.md) 
+  [CreateCampaign](API_CreateCampaign.md) 
+  [CreateDataDeletionJob](API_CreateDataDeletionJob.md) 
+  [CreateDataset](API_CreateDataset.md) 
+  [CreateDatasetExportJob](API_CreateDatasetExportJob.md) 
+  [CreateDatasetGroup](API_CreateDatasetGroup.md) 
+  [CreateDatasetImportJob](API_CreateDatasetImportJob.md) 
+  [CreateEventTracker](API_CreateEventTracker.md) 
+  [CreateFilter](API_CreateFilter.md) 
+  [CreateMetricAttribution](API_CreateMetricAttribution.md) 
+  [CreateRecommender](API_CreateRecommender.md) 
+  [CreateSchema](API_CreateSchema.md) 
+  [CreateSolution](API_CreateSolution.md) 
+  [CreateSolutionVersion](API_CreateSolutionVersion.md) 
+  [DeleteCampaign](API_DeleteCampaign.md) 
+  [DeleteDataset](API_DeleteDataset.md) 
+  [DeleteDatasetGroup](API_DeleteDatasetGroup.md) 
+  [DeleteEventTracker](API_DeleteEventTracker.md) 
+  [DeleteFilter](API_DeleteFilter.md) 
+  [DeleteMetricAttribution](API_DeleteMetricAttribution.md) 
+  [DeleteRecommender](API_DeleteRecommender.md) 
+  [DeleteSchema](API_DeleteSchema.md) 
+  [DeleteSolution](API_DeleteSolution.md) 
+  [DescribeAlgorithm](API_DescribeAlgorithm.md) 
+  [DescribeBatchInferenceJob](API_DescribeBatchInferenceJob.md) 
+  [DescribeBatchSegmentJob](API_DescribeBatchSegmentJob.md) 
+  [DescribeCampaign](API_DescribeCampaign.md) 
+  [DescribeDataDeletionJob](API_DescribeDataDeletionJob.md) 
+  [DescribeDataset](API_DescribeDataset.md) 
+  [DescribeDatasetExportJob](API_DescribeDatasetExportJob.md) 
+  [DescribeDatasetGroup](API_DescribeDatasetGroup.md) 
+  [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) 
+  [DescribeEventTracker](API_DescribeEventTracker.md) 
+  [DescribeFeatureTransformation](API_DescribeFeatureTransformation.md) 
+  [DescribeFilter](API_DescribeFilter.md) 
+  [DescribeMetricAttribution](API_DescribeMetricAttribution.md) 
+  [DescribeRecipe](API_DescribeRecipe.md) 
+  [DescribeRecommender](API_DescribeRecommender.md) 
+  [DescribeSchema](API_DescribeSchema.md) 
+  [DescribeSolution](API_DescribeSolution.md) 
+  [DescribeSolutionVersion](API_DescribeSolutionVersion.md) 
+  [GetSolutionMetrics](API_GetSolutionMetrics.md) 
+  [ListBatchInferenceJobs](API_ListBatchInferenceJobs.md) 
+  [ListBatchSegmentJobs](API_ListBatchSegmentJobs.md) 
+  [ListCampaigns](API_ListCampaigns.md) 
+  [ListDataDeletionJobs](API_ListDataDeletionJobs.md) 
+  [ListDatasetExportJobs](API_ListDatasetExportJobs.md) 
+  [ListDatasetGroups](API_ListDatasetGroups.md) 
+  [ListDatasetImportJobs](API_ListDatasetImportJobs.md) 
+  [ListDatasets](API_ListDatasets.md) 
+  [ListEventTrackers](API_ListEventTrackers.md) 
+  [ListFilters](API_ListFilters.md) 
+  [ListMetricAttributionMetrics](API_ListMetricAttributionMetrics.md) 
+  [ListMetricAttributions](API_ListMetricAttributions.md) 
+  [ListRecipes](API_ListRecipes.md) 
+  [ListRecommenders](API_ListRecommenders.md) 
+  [ListSchemas](API_ListSchemas.md) 
+  [ListSolutions](API_ListSolutions.md) 
+  [ListSolutionVersions](API_ListSolutionVersions.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StartRecommender](API_StartRecommender.md) 
+  [StopRecommender](API_StopRecommender.md) 
+  [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateCampaign](API_UpdateCampaign.md) 
+  [UpdateDataset](API_UpdateDataset.md) 
+  [UpdateMetricAttribution](API_UpdateMetricAttribution.md) 
+  [UpdateRecommender](API_UpdateRecommender.md) 
+  [UpdateSolution](API_UpdateSolution.md) 

Eventos de Amazon Personalize admite las siguientes acciones:
+  [PutActionInteractions](API_UBS_PutActionInteractions.md) 
+  [PutActions](API_UBS_PutActions.md) 
+  [PutEvents](API_UBS_PutEvents.md) 
+  [PutItems](API_UBS_PutItems.md) 
+  [PutUsers](API_UBS_PutUsers.md) 

Versión ejecutable de Amazon Personalize admite las siguientes acciones:
+  [GetActionRecommendations](API_RS_GetActionRecommendations.md) 
+  [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) 
+  [GetRecommendations](API_RS_GetRecommendations.md) 

# Amazon Personalize
<a name="API_Operations_Amazon_Personalize"></a>

Amazon Personalize admite las siguientes acciones:
+  [CreateBatchInferenceJob](API_CreateBatchInferenceJob.md) 
+  [CreateBatchSegmentJob](API_CreateBatchSegmentJob.md) 
+  [CreateCampaign](API_CreateCampaign.md) 
+  [CreateDataDeletionJob](API_CreateDataDeletionJob.md) 
+  [CreateDataset](API_CreateDataset.md) 
+  [CreateDatasetExportJob](API_CreateDatasetExportJob.md) 
+  [CreateDatasetGroup](API_CreateDatasetGroup.md) 
+  [CreateDatasetImportJob](API_CreateDatasetImportJob.md) 
+  [CreateEventTracker](API_CreateEventTracker.md) 
+  [CreateFilter](API_CreateFilter.md) 
+  [CreateMetricAttribution](API_CreateMetricAttribution.md) 
+  [CreateRecommender](API_CreateRecommender.md) 
+  [CreateSchema](API_CreateSchema.md) 
+  [CreateSolution](API_CreateSolution.md) 
+  [CreateSolutionVersion](API_CreateSolutionVersion.md) 
+  [DeleteCampaign](API_DeleteCampaign.md) 
+  [DeleteDataset](API_DeleteDataset.md) 
+  [DeleteDatasetGroup](API_DeleteDatasetGroup.md) 
+  [DeleteEventTracker](API_DeleteEventTracker.md) 
+  [DeleteFilter](API_DeleteFilter.md) 
+  [DeleteMetricAttribution](API_DeleteMetricAttribution.md) 
+  [DeleteRecommender](API_DeleteRecommender.md) 
+  [DeleteSchema](API_DeleteSchema.md) 
+  [DeleteSolution](API_DeleteSolution.md) 
+  [DescribeAlgorithm](API_DescribeAlgorithm.md) 
+  [DescribeBatchInferenceJob](API_DescribeBatchInferenceJob.md) 
+  [DescribeBatchSegmentJob](API_DescribeBatchSegmentJob.md) 
+  [DescribeCampaign](API_DescribeCampaign.md) 
+  [DescribeDataDeletionJob](API_DescribeDataDeletionJob.md) 
+  [DescribeDataset](API_DescribeDataset.md) 
+  [DescribeDatasetExportJob](API_DescribeDatasetExportJob.md) 
+  [DescribeDatasetGroup](API_DescribeDatasetGroup.md) 
+  [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) 
+  [DescribeEventTracker](API_DescribeEventTracker.md) 
+  [DescribeFeatureTransformation](API_DescribeFeatureTransformation.md) 
+  [DescribeFilter](API_DescribeFilter.md) 
+  [DescribeMetricAttribution](API_DescribeMetricAttribution.md) 
+  [DescribeRecipe](API_DescribeRecipe.md) 
+  [DescribeRecommender](API_DescribeRecommender.md) 
+  [DescribeSchema](API_DescribeSchema.md) 
+  [DescribeSolution](API_DescribeSolution.md) 
+  [DescribeSolutionVersion](API_DescribeSolutionVersion.md) 
+  [GetSolutionMetrics](API_GetSolutionMetrics.md) 
+  [ListBatchInferenceJobs](API_ListBatchInferenceJobs.md) 
+  [ListBatchSegmentJobs](API_ListBatchSegmentJobs.md) 
+  [ListCampaigns](API_ListCampaigns.md) 
+  [ListDataDeletionJobs](API_ListDataDeletionJobs.md) 
+  [ListDatasetExportJobs](API_ListDatasetExportJobs.md) 
+  [ListDatasetGroups](API_ListDatasetGroups.md) 
+  [ListDatasetImportJobs](API_ListDatasetImportJobs.md) 
+  [ListDatasets](API_ListDatasets.md) 
+  [ListEventTrackers](API_ListEventTrackers.md) 
+  [ListFilters](API_ListFilters.md) 
+  [ListMetricAttributionMetrics](API_ListMetricAttributionMetrics.md) 
+  [ListMetricAttributions](API_ListMetricAttributions.md) 
+  [ListRecipes](API_ListRecipes.md) 
+  [ListRecommenders](API_ListRecommenders.md) 
+  [ListSchemas](API_ListSchemas.md) 
+  [ListSolutions](API_ListSolutions.md) 
+  [ListSolutionVersions](API_ListSolutionVersions.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StartRecommender](API_StartRecommender.md) 
+  [StopRecommender](API_StopRecommender.md) 
+  [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateCampaign](API_UpdateCampaign.md) 
+  [UpdateDataset](API_UpdateDataset.md) 
+  [UpdateMetricAttribution](API_UpdateMetricAttribution.md) 
+  [UpdateRecommender](API_UpdateRecommender.md) 
+  [UpdateSolution](API_UpdateSolution.md) 

# CreateBatchInferenceJob
<a name="API_CreateBatchInferenceJob"></a>

Genera recomendaciones por lotes basadas en una lista de elementos o de usuarios almacenados en Amazon S3 y exporta las recomendaciones a un bucket de Amazon S3.

Para generar recomendaciones por lotes, especifique el ARN de una versión de la solución y un URI de Amazon S3 para los datos de entrada y salida. Para la personalización de usuarios, elementos populares y soluciones de clasificación personalizadas, el trabajo de inferencia por lotes genera una lista de elementos recomendados para cada ID de usuario del archivo de entrada. Para las soluciones de elementos relacionadas, el trabajo genera una lista de elementos recomendados para cada ID de elemento del archivo de entrada.

Para obtener más información, consulte [Creación de un trabajo de inferencia por lotes](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html).

 Si usa la receta Similar-Items, Amazon Personalize puede agregar temas descriptivos a las recomendaciones por lotes. Para generar temas, establezca el modo del trabajo en `THEME_GENERATION` y especifique el nombre del campo que contiene los nombres de los elementos en los datos de entrada.

 Para obtener más información sobre la generación de temas, consulte [Recomendaciones por lotes con temas del Generador de contenidos](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html). 

No puede obtener recomendaciones de lotes con Trending-Now ni con las recetas. Next-Best-Action

## Sintaxis de la solicitud
<a name="API_CreateBatchInferenceJob_RequestSyntax"></a>

```
{
   "batchInferenceJobConfig": { 
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      }
   },
   "batchInferenceJobMode": "string",
   "filterArn": "string",
   "jobInput": { 
      "s3DataSource": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "numResults": number,
   "roleArn": "string",
   "solutionVersionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ],
   "themeGenerationConfig": { 
      "fieldsForThemeGeneration": { 
         "itemName": "string"
      }
   }
}
```

## Parámetros de la solicitud
<a name="API_CreateBatchInferenceJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobConfig"></a>
Los detalles de configuración de un trabajo de inferencia por lotes.  
Tipo: objeto [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)  
Obligatorio: no

 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobMode"></a>
Modo del trabajo de inferencia por lotes. Para generar temas descriptivos para grupos de elementos similares, establezca el modo de trabajo en `THEME_GENERATION`. Si no quiere generar temas, use el valor predeterminado `BATCH_INFERENCE`.  
 Al recibir recomendaciones por lotes con temas, incurrirá en costos adicionales. Para obtener más información, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).   
Tipo: cadena  
Valores válidos: `BATCH_INFERENCE | THEME_GENERATION`   
Obligatorio: no

 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-filterArn"></a>
El ARN del filtro que se va a aplicar al trabajo de inferencia por lotes. Para obtener más información, consulte [Filtrado de recomendaciones de lote](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobInput"></a>
La ruta de Amazon S3 que lleva al archivo de entrada en el que basar sus recomendaciones. El material de entrada debe estar en formato JSON.  
Tipo: objeto [BatchInferenceJobInput](API_BatchInferenceJobInput.md)  
Obligatorio: sí

 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobName"></a>
El nombre del trabajo de inferencia por lotes que se va a crear.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [jobOutput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobOutput"></a>
La ruta al bucket de Amazon S3 donde se almacenará el resultado del trabajo.  
Tipo: objeto [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)  
Obligatorio: sí

 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-numResults"></a>
El número de recomendaciones que se van a recuperar.  
Tipo: entero  
Obligatorio: no

 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-roleArn"></a>
El ARN del rol de Amazon Identity and Access Management que tiene permisos de lectura y escritura en los buckets de Amazon S3 de entrada y salida, respectivamente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: sí

 ** [solutionVersionArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de la solución que se va a utilizar para generar las recomendaciones de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-tags"></a>
Una lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) para aplicar al trabajo de inferencia por lotes.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-themeGenerationConfig"></a>
Para los trabajos de generación de temas, especifique el nombre de la columna del conjunto de datos de elementos que contiene el nombre de cada elemento.  
Tipo: objeto [ThemeGenerationConfig](API_ThemeGenerationConfig.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateBatchInferenceJob_ResponseSyntax"></a>

```
{
   "batchInferenceJobArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateBatchInferenceJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [batchInferenceJobArn](#API_CreateBatchInferenceJob_ResponseSyntax) **   <a name="personalize-CreateBatchInferenceJob-response-batchInferenceJobArn"></a>
El ARN del trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateBatchInferenceJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateBatchInferenceJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob) 

# CreateBatchSegmentJob
<a name="API_CreateBatchSegmentJob"></a>

Crea un trabajo de segmento por lotes. La operación puede gestionar hasta 50 millones de registros y el archivo de entrada debe estar en formato JSON. Para obtener más información, consulte [Obtención de recomendaciones por lotes y segmentos de usuario](https://docs.aws.amazon.com/personalize/latest/dg/recommendations-batch.html).

## Sintaxis de la solicitud
<a name="API_CreateBatchSegmentJob_RequestSyntax"></a>

```
{
   "filterArn": "string",
   "jobInput": { 
      "s3DataSource": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "numResults": number,
   "roleArn": "string",
   "solutionVersionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateBatchSegmentJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [filterArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-filterArn"></a>
El ARN del filtro que se va a aplicar al trabajo de segmentación por lotes. Para obtener más información, consulte [Filtrado de recomendaciones de lote](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [jobInput](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobInput"></a>
La ruta de Amazon S3 para los datos de entrada utilizados para generar el trabajo de segmentación por lotes.  
Tipo: objeto [BatchSegmentJobInput](API_BatchSegmentJobInput.md)  
Obligatorio: sí

 ** [jobName](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobName"></a>
El nombre del trabajo de segmentación por lotes que se va a crear.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [jobOutput](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobOutput"></a>
La ruta de Amazon S3 del bucket donde se almacenará el resultado del trabajo.  
Tipo: objeto [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md)  
Obligatorio: sí

 ** [numResults](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-numResults"></a>
El número de usuarios previsto que generará el trabajo de segmentación por lotes para cada línea de datos de entrada. El número máximo de usuarios por segmento es de 5 millones.  
Tipo: entero  
Obligatorio: no

 ** [roleArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-roleArn"></a>
El ARN del rol de Amazon Identity and Access Management que tiene permisos de lectura y escritura en los buckets de Amazon S3 de entrada y salida, respectivamente.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: sí

 ** [solutionVersionArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de la solución que desea que el trabajo de segmentación por lotes use para generar segmentos por lote.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [tags](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-tags"></a>
Una lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) para aplicar al trabajo de segmentación por lotes.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateBatchSegmentJob_ResponseSyntax"></a>

```
{
   "batchSegmentJobArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateBatchSegmentJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [batchSegmentJobArn](#API_CreateBatchSegmentJob_ResponseSyntax) **   <a name="personalize-CreateBatchSegmentJob-response-batchSegmentJobArn"></a>
El ARN del trabajo de segmentación por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateBatchSegmentJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateBatchSegmentJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchSegmentJob) 

# CreateCampaign
<a name="API_CreateCampaign"></a>

**importante**  
 Generará costos de campaña mientras esté activa. Para evitar costos innecesarios, asegúrese de eliminar la campaña cuando haya terminado. Para obtener información sobre los costos de campaña, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).

Crea una campaña que implementa una versión de solución. Cuando un cliente llama al [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)y [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) APIs, en la solicitud, se especifica una campaña.

 **Valor TPS mínimo aprovisionado y escalado automático** 

**importante**  
 Un valor elevado de `minProvisionedTPS` aumentará los costos. Le recomendamos empezar con 1 para `minProvisionedTPS` (el valor predeterminado). Realiza un seguimiento de tu consumo mediante CloudWatch las métricas de Amazon y auméntalo `minProvisionedTPS` según sea necesario.

 Al crear una campaña de Amazon Personalize, puede especificar el número mínimo de transacciones aprovisionadas por segundo (`minProvisionedTPS`) para la campaña. Este es el rendimiento de transacciones de línea base para la campaña aprovisionada por Amazon Personalize. Establece el cargo de facturación mínimo de la campaña mientras esté activa. Una transacción es una solicitud `GetRecommendations` o `GetPersonalizedRanking` simple. El valor predeterminado de `minProvisionedTPS` es 1.

 Si su TPS aumenta más de `minProvisionedTPS`, Amazon Personalize escala automáticamente la capacidad aprovisionada hacia arriba y hacia abajo, pero nunca por debajo de `minProvisionedTPS`. Se produce un breve retraso durante el aumento de la capacidad que podría provocar la pérdida de transacciones. Cuando se reduce el tráfico, la capacidad vuelve al valor de `minProvisionedTPS`. 

Se le cobrará por el valor de TPS mínimo aprovisionado o, si sus solicitudes superan el valor de `minProvisionedTPS`, el TPS real. El TPS real es el número total de solicitudes de recomendación que realiza. Te recomendamos empezar con un nivel bajo`minProvisionedTPS`, realizar un seguimiento de tu uso mediante CloudWatch las métricas de Amazon y, a continuación, aumentarlo `minProvisionedTPS` según sea necesario.

Para obtener más información sobre los costos de las campañas, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).

 **Estado** 

Una campaña puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Para conocer el estado de la campaña, llama [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html).

**nota**  
Espera a que el `status` de la campaña sea `ACTIVE` antes de pedir recomendaciones a la campaña.

**Relacionado APIs**
+  [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) 
+  [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) 
+  [UpdateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) 
+  [DeleteCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) 

## Sintaxis de la solicitud
<a name="API_CreateCampaign_RequestSyntax"></a>

```
{
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      },
      "syncWithLatestSolutionVersion": boolean
   },
   "minProvisionedTPS": number,
   "name": "string",
   "solutionVersionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateCampaign_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [campaignConfig](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-campaignConfig"></a>
Los detalles de la configuración de una campaña.  
Tipo: objeto [CampaignConfig](API_CampaignConfig.md)  
Obligatorio: no

 ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-minProvisionedTPS"></a>
Especifica el número mínimo de transacciones aprovisionadas (recomendaciones) por segundo solicitadas que Amazon Personalize va a admitir. Un valor elevado de `minProvisionedTPS` aumentará su factura. Le recomendamos empezar con 1 para `minProvisionedTPS` (el valor predeterminado). Realiza un seguimiento de tu consumo mediante CloudWatch las métricas de Amazon y auméntalo `minProvisionedTPS` según sea necesario.  
Tipo: entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** [name](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-name"></a>
Un nombre para la nueva campaña. El nombre de la campaña debe ser único en la cuenta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-solutionVersionArn"></a>
Nombre de recurso de Amazon (ARN) del modelo entrenado que se implementará con la campaña. Para especificar la versión más reciente de la solución, especifique el ARN de la *solución* en formato `SolutionArn/$LATEST`. Debes usar este formato si lo `syncWithLatestSolutionVersion` configuras `True` en [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html).   
 Para implementar un modelo que no sea la última versión de solución, especifique el ARN de la versión de solución.   
 Para obtener más información sobre las actualizaciones de campaña automáticas, consulte [Habilitación de las actualizaciones de campaña automáticas](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update).   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [tags](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican a la campaña.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateCampaign_ResponseSyntax"></a>

```
{
   "campaignArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateCampaign_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [campaignArn](#API_CreateCampaign_ResponseSyntax) **   <a name="personalize-CreateCampaign-response-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateCampaign_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateCampaign_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign) 

# CreateDataDeletionJob
<a name="API_CreateDataDeletionJob"></a>

Crea un trabajo por lotes que elimina por lotes todas las referencias a usuarios específicos de un grupo de conjuntos de datos de Amazon Personalize. Especifique los usuarios que se eliminarán en un archivo CSV de ID de usuario en un bucket de Amazon S3. Una vez finalizado un trabajo, Amazon Personalize ya no utiliza los datos de los usuarios para el entrenamiento y deja de tener en cuenta a los usuarios al generar segmentos de usuarios. Para obtener más información sobre cómo crear un trabajo de eliminación de datos, consulte [Eliminación de usuarios](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html).
+ El archivo de entrada debe ser un archivo CSV con una sola columna USER\$1ID que muestre los usuarios. IDs Para obtener más información sobre cómo preparar el archivo CSV, consulte [Cómo preparar el archivo de eliminación de datos y cargarlo en Amazon S3](https://docs.aws.amazon.com/personalize/latest/dg/prepare-deletion-input-file.html).
+ Para conceder permiso a Amazon Personalize para acceder al archivo CSV de entrada de los ID de usuario, debe especificar un rol de servicio de IAM que tenga permiso para leer el origen de datos. Este rol necesita los permisos `GetObject` y `ListBucket` para el bucket y el contenido. Estos permisos son los mismos que en la importación de datos. Para obtener información sobre cómo conceder acceso a su bucket de Amazon S3, consulte [Concesión de acceso a los recursos de Amazon S3 para Amazon Personalize](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html). 

 Tras crear un trabajo, es posible que se tarde hasta un día en eliminar todas las referencias a los usuarios de los conjuntos de datos y modelos. Hasta que se complete el trabajo, Amazon Personalize seguirá utilizando los datos durante el entrenamiento. Y si utiliza una receta de segmentación de usuarios, es posible que los usuarios aparezcan en segmentos de usuarios. 

 **Estado** 

Un trabajo de eliminación de datos puede tener uno de los siguientes estados:
+ PENDING > IN\$1PROGRESS > COMPLETED -o- FAILED

Para obtener el estado del trabajo de eliminación de datos, llame a [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html)API operation y especifique el nombre de recurso de Amazon (ARN) del trabajo. Si el estado es FAILED, la respuesta incluye una clave `failureReason` que describe el motivo del error en el trabajo.

**Relacionado APIs**
+  [ListDataDeletionJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDataDeletionJobs.html) 
+  [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) 

## Sintaxis de la solicitud
<a name="API_CreateDataDeletionJob_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "jobName": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateDataDeletionJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-datasetGroupArn"></a>
Nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que tiene los conjuntos de datos cuyos registros desea eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [dataSource](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-dataSource"></a>
Bucket de Amazon S3 que contiene la lista de ID de los usuarios que se eliminarán.  
Tipo: objeto [DataSource](API_DataSource.md)  
Obligatorio: sí

 ** [jobName](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-jobName"></a>
Nombre del trabajo de eliminación de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [roleArn](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-roleArn"></a>
Nombre de recurso de Amazon (ARN) del rol de IAM que tiene permisos para leer el origen de datos de Amazon S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: sí

 ** [tags](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al trabajo de eliminación de datos.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateDataDeletionJob_ResponseSyntax"></a>

```
{
   "dataDeletionJobArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateDataDeletionJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [dataDeletionJobArn](#API_CreateDataDeletionJob_ResponseSyntax) **   <a name="personalize-CreateDataDeletionJob-response-dataDeletionJobArn"></a>
Nombre de recurso de Amazon (ARN) del trabajo de eliminación de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateDataDeletionJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateDataDeletionJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataDeletionJob) 

# CreateDataset
<a name="API_CreateDataset"></a>

Crea un conjunto de datos vacío y lo agrega al grupo de conjuntos de datos especificado. Se utiliza [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)para importar los datos de entrenamiento a un conjunto de datos.

Existen 5 tipos de conjuntos de datos:
+ Interacciones de elementos
+ Items
+ Users
+ Interacciones de acción
+ Acciones

Cada conjunto de datos tiene asociado un esquema con los tipos de campo necesarios. Solo es necesario el conjunto de datos `Item interactions` para entrenar un modelo (también denominado creación de una solución).

Un conjunto de datos puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Para obtener el estado del conjunto de datos, llama [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html).

**Relacionado APIs**
+  [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) 
+  [ListDatasets](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasets.html) 
+  [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) 
+  [DeleteDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDataset.html) 

## Sintaxis de la solicitud
<a name="API_CreateDataset_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "datasetType": "string",
   "name": "string",
   "schemaArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateDataset_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjunto de datos al que se va a agregar el conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [datasetType](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-datasetType"></a>
El tipo de conjunto de datos.  
Uno de los siguientes valores (no se distingue entre mayúsculas y minúsculas):  
+ Interacciones
+ Items
+ Users
+ Acciones
+ Action\$1Interactions
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `^[A-Za-z_]+$`   
Obligatorio: sí

 ** [name](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-name"></a>
Nombre del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [schemaArn](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-schemaArn"></a>
El ARN del esquema que se debe asociar al conjunto de datos. El esquema define los campos de un conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [tags](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al conjunto de datos.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateDataset_ResponseSyntax"></a>

```
{
   "datasetArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateDataset_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetArn](#API_CreateDataset_ResponseSyntax) **   <a name="personalize-CreateDataset-response-datasetArn"></a>
El ARN del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateDataset_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateDataset_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataset) 

# CreateDatasetExportJob
<a name="API_CreateDatasetExportJob"></a>

 Crea un trabajo que exporta datos desde su conjunto de datos a un bucket de Amazon S3. Para permitir que Amazon Personalize exporte los datos de entrenamiento, debe especificar un rol de IAM vinculado al servicio que otorgue a Amazon Personalize permisos de `PutObject` para su bucket de Amazon S3. Para obtener más información, consulte [Exportación de un conjunto de datos](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html) en la guía para desarrolladores de Amazon Personalize. 

 **Estado** 

Un trabajo de exportación de conjunto de datos puede aparecer en uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED

 Para obtener el estado del trabajo de exportación [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html), llama y especifica el nombre de recurso de Amazon (ARN) del trabajo de exportación del conjunto de datos. La exportación del conjunto de datos finaliza cuando el estado es ACTIVE. Si el estado muestra CREATE FAILED, la respuesta incluye una clave `failureReason` que describe el motivo del error en el trabajo. 

## Sintaxis de la solicitud
<a name="API_CreateDatasetExportJob_RequestSyntax"></a>

```
{
   "datasetArn": "string",
   "ingestionMode": "string",
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateDatasetExportJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos que contiene los datos que se van a exportar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-ingestionMode"></a>
Los datos que se van a exportar, en función de cómo los haya importado. Puede optar por exportar solo `BULK` los datos que haya importado mediante un trabajo de importación de conjuntos de datos, solo `PUT` los datos que haya importado de forma incremental (mediante la consola PutUsers y PutItems las operaciones) o `ALL` para ambos tipos. PutEvents El valor predeterminado es `PUT`.   
Tipo: cadena  
Valores válidos: `BULK | PUT | ALL`   
Obligatorio: no

 ** [jobName](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobName"></a>
Nombre para el trabajo de exportación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [jobOutput](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobOutput"></a>
La ruta al bucket de Amazon S3 donde se almacena el resultado del trabajo.  
Tipo: objeto [DatasetExportJobOutput](API_DatasetExportJobOutput.md)  
Obligatorio: sí

 ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-roleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de servicio de IAM que tiene permisos para añadir datos al bucket de Amazon S3 de salida.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: sí

 ** [tags](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al trabajo de exportación del conjunto de datos.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateDatasetExportJob_ResponseSyntax"></a>

```
{
   "datasetExportJobArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateDatasetExportJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetExportJobArn](#API_CreateDatasetExportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetExportJob-response-datasetExportJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de exportación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateDatasetExportJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateDatasetExportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetExportJob) 

# CreateDatasetGroup
<a name="API_CreateDatasetGroup"></a>

Crea un grupo de conjuntos de datos vacío. Un grupo de conjuntos de datos es un contenedor para los recursos de Amazon Personalize. Un grupo de conjuntos de datos puede contener como máximo tres conjuntos de datos, uno para cada tipo de conjunto de datos:
+ Interacciones de elementos
+ Items
+ Users
+ Acciones
+ Interacciones de acción

 Un grupo de conjuntos de datos puede ser un grupo de conjuntos de datos de dominio, en el que se especifica un dominio y se utilizan recursos preconfigurados, como recomendaciones, o un grupo de conjuntos de datos personalizados, en el que se utilizan recursos personalizados, como una solución con una versión de solución, que se implementa con una campaña. Si empieza con un grupo de conjuntos de datos de dominio, puede añadir recursos personalizados, como soluciones y versiones de soluciones entrenadas con recetas para casos de uso personalizados e implementadas con campañas. 

Un grupo de conjuntos de datos puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING

Para obtener el estado del grupo de conjuntos de datos, llame [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html). Si el estado muestra CREATE FAILED, la respuesta incluye una clave `failureReason` que describe el motivo del error en la creación.

**nota**  
Debe esperar a que el valor `status` del grupo de conjuntos de datos sea `ACTIVE` antes de agregar un conjunto de datos al grupo.

Puede especificar una clave AWS Key Management Service (KMS) para cifrar los conjuntos de datos del grupo. Si especifica una clave de KMS, también debe incluir un rol (de IAM) AWS Identity and Access Management que tenga permiso para acceder a la clave.

**APIs que requieren un ARN de grupo de conjuntos de datos en la solicitud**
+  [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) 
+  [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) 
+  [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 

**Relacionado APIs**
+  [ListDatasetGroups](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetGroups.html) 
+  [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) 
+  [DeleteDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDatasetGroup.html) 

## Sintaxis de la solicitud
<a name="API_CreateDatasetGroup_RequestSyntax"></a>

```
{
   "domain": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateDatasetGroup_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [domain](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-domain"></a>
El dominio del grupo de conjuntos de datos. Especifique un dominio para crear un grupo de conjuntos de datos de dominio. El dominio que especifique determina los esquemas predeterminados de los conjuntos de datos y los casos de uso disponibles para los recomendadores. Si no especifica un dominio, creará un grupo de conjuntos de datos personalizados con versiones de soluciones que puede implementar con una campaña.   
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND`   
Obligatorio: no

 ** [kmsKeyArn](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-kmsKeyArn"></a>
El nombre de recurso de Amazon (ARN) de una clave AWS Key Management Service (KMS) utilizada para cifrar los conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `arn:aws.*:kms:.*:[0-9]{12}:key/.*`   
Obligatorio: no

 ** [name](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-name"></a>
El nombre del nuevo grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [roleArn](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-roleArn"></a>
El ARN del rol AWS Identity and Access Management (IAM) que tiene permisos para acceder a la clave AWS Key Management Service (KMS). La especificación de un rol de IAM solo es válida cuando también se especifica una clave de KMS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: no

 ** [tags](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al grupo de conjuntos de datos.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateDatasetGroup_ResponseSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "domain": "string"
}
```

## Elementos de respuesta
<a name="API_CreateDatasetGroup_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) **   <a name="personalize-CreateDatasetGroup-response-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del nuevo grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

 ** [domain](#API_CreateDatasetGroup_ResponseSyntax) **   <a name="personalize-CreateDatasetGroup-response-domain"></a>
El dominio para el nuevo grupo de conjuntos de datos de dominio.  
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND` 

## Errores
<a name="API_CreateDatasetGroup_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateDatasetGroup_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetGroup) 

# CreateDatasetImportJob
<a name="API_CreateDatasetImportJob"></a>

Crea un trabajo que importa datos de entrenamiento de un origen de datos (bucket de Amazon S3) a un conjunto de datos de Amazon Personalize. Para permitir que Amazon Personalize importe los datos de entrenamiento, debe especificar un rol de servicio de IAM que tenga permiso para leer el origen de datos, ya que Amazon Personalize hace una copia de sus datos y los procesa internamente. Para obtener información sobre cómo conceder acceso a su bucket de Amazon S3, consulte [Concesión de acceso a los recursos de Amazon S3 para Amazon Personalize](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html). 

Si ya ha creado un recomendador o ha implementado una versión de solución personalizada con una campaña, la forma en que los nuevos registros masivos influyen en las recomendaciones depende del caso de uso del dominio o de la receta que utilice. Para obtener más información, consulta [Influencia de los nuevos datos en las recomendaciones en tiempo real](https://docs.aws.amazon.com/personalize/latest/dg/how-new-data-influences-recommendations.html).

**importante**  
De forma predeterminada, un trabajo de importación de conjuntos de datos reemplaza cualquier dato existente en el conjunto de datos que haya importado de manera masiva. Para agregar nuevos registros sin reemplazar los datos existentes, especifique INCREMENTAL para el modo de importación de la CreateDatasetImportJob operación.

 **Estado** 

Un trabajo de importación del conjunto de datos puede aparecer en uno de los siguientes estados:
+ CREATE PENDING (CREACIÓN PENDIENTE) > CREATE IN\$1PROGRESS (CREACIÓN EN CURSO) > ACTIVE (ACTIVO) o CREATE FAILED (ERROR AL CREAR)

Para obtener el estado del trabajo de importación [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html), llama e indica el nombre de recurso de Amazon (ARN) del trabajo de importación del conjunto de datos. La importación del conjunto de datos finaliza cuando el estado es ACTIVO. Si el estado muestra CREATE FAILED, la respuesta incluye una clave `failureReason` que describe el motivo del error en el trabajo.

**nota**  
La importación lleva tiempo. Deberá esperar hasta que el estado pase a ACTIVE antes de entrenar un modelo con el conjunto de datos.

**Relacionado APIs**
+  [ListDatasetImportJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetImportJobs.html) 
+  [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) 

## Sintaxis de la solicitud
<a name="API_CreateDatasetImportJob_RequestSyntax"></a>

```
{
   "datasetArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "importMode": "string",
   "jobName": "string",
   "publishAttributionMetricsToS3": boolean,
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateDatasetImportJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-datasetArn"></a>
El ARN del conjunto de datos que recibe los datos importados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [dataSource](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-dataSource"></a>
El bucket de Amazon S3 que contiene los datos de entrenamiento que se importarán.  
Tipo: objeto [DataSource](API_DataSource.md)  
Obligatorio: sí

 ** [importMode](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-importMode"></a>
Especifique cómo agregar los nuevos registros a un conjunto de datos existente. El modo de importación predeterminado es `FULL`. Si no ha importado registros masivos al conjunto de datos anteriormente, solo puede especificar `FULL`.  
+ Especifique `FULL` para que se sobrescriban todos los datos masivos existentes en el conjunto de datos. Los datos que ha importado individualmente no se reemplazan.
+ Especifique `INCREMENTAL` si desea anexar los nuevos registros a los datos existentes en su conjunto de datos. Amazon Personalize reemplaza cualquier registro con el mismo identificador por el nuevo.
Tipo: cadena  
Valores válidos: `FULL | INCREMENTAL`   
Obligatorio: no

 ** [jobName](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-jobName"></a>
Nombre para el trabajo de importación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [publishAttributionMetricsToS3](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-publishAttributionMetricsToS3"></a>
Si ha creado una atribución de métricas, especifique si desea publicar las métricas de este trabajo de importación en Amazon S3  
Tipo: Booleano  
Obligatorio: no

 ** [roleArn](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-roleArn"></a>
El ARN del rol de IAM que tiene permisos de lectura del origen de datos de Amazon S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: no

 ** [tags](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al trabajo de importación del conjunto de datos.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateDatasetImportJob_ResponseSyntax"></a>

```
{
   "datasetImportJobArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateDatasetImportJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetImportJobArn](#API_CreateDatasetImportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetImportJob-response-datasetImportJobArn"></a>
El ARN del trabajo de importación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateDatasetImportJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateDatasetImportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetImportJob) 

# CreateEventTracker
<a name="API_CreateEventTracker"></a>

Crea un rastreador de eventos que se usa al agregar datos de eventos a un grupo de conjuntos de datos específico mediante la [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.

**nota**  
Solo se puede asociar un único rastreador de ventas con un grupo de conjuntos de datos. Se producirá un error si llama a `CreateEventTracker` utilizando el mismo grupo de conjuntos de datos que un rastreador de eventos existente.

Al crear un rastreador de eventos, la respuesta incluye un ID de seguimiento, que se transfiere como parámetro cuando se utiliza la [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)operación. A continuación, Amazon Personalize anexa los datos del evento al conjunto de datos de interacciones de elementos del grupo de conjuntos de datos que especifique en el rastreador de eventos. 

El rastreador de eventos de puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Para obtener el estado del rastreador de eventos, llama [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html).

**nota**  
El rastreador de eventos debe estar en estado ACTIVO antes de usar el ID de seguimiento.

**Relacionado APIs**
+  [ListEventTrackers](https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html) 
+  [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) 
+  [DeleteEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html) 

## Sintaxis de la solicitud
<a name="API_CreateEventTracker_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "name": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateEventTracker_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) **   <a name="personalize-CreateEventTracker-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que recibe los datos del evento.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [name](#API_CreateEventTracker_RequestSyntax) **   <a name="personalize-CreateEventTracker-request-name"></a>
El nombre del rastreador de eventos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [tags](#API_CreateEventTracker_RequestSyntax) **   <a name="personalize-CreateEventTracker-request-tags"></a>
Una lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) para aplicar al rastreador de eventos.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateEventTracker_ResponseSyntax"></a>

```
{
   "eventTrackerArn": "string",
   "trackingId": "string"
}
```

## Elementos de respuesta
<a name="API_CreateEventTracker_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) **   <a name="personalize-CreateEventTracker-response-eventTrackerArn"></a>
El ARN del rastreador de eventos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

 ** [trackingId](#API_CreateEventTracker_ResponseSyntax) **   <a name="personalize-CreateEventTracker-response-trackingId"></a>
ID del rastreador de eventos. Incluye este ID en las solicitudes a la [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.

## Errores
<a name="API_CreateEventTracker_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateEventTracker_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker) 

# CreateFilter
<a name="API_CreateFilter"></a>

Crea un filtro de recomendaciones. Para obtener más información, consulte [Filtrado de recomendaciones por lotes y segmentos de usuario](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).

## Sintaxis de la solicitud
<a name="API_CreateFilter_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "filterExpression": "string",
   "name": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateFilter_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-datasetGroupArn"></a>
El ARN del grupo de conjuntos de datos al que pertenecerá el filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [filterExpression](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-filterExpression"></a>
La expresión del filtro define qué elementos se incluyen en las recomendaciones o se excluyen de estas. La expresión de filtro debe seguir reglas de formato específicas. Para obtener información sobre la estructura y la sintaxis de la expresión de filtro, consulte [Expresiones de filtro](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2500.  
Obligatorio: sí

 ** [name](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-name"></a>
Nombre del filtro que se va a crear.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [tags](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al filtro.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateFilter_ResponseSyntax"></a>

```
{
   "filterArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateFilter_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [filterArn](#API_CreateFilter_ResponseSyntax) **   <a name="personalize-CreateFilter-response-filterArn"></a>
El ARN del nuevo filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateFilter_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateFilter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateFilter) 

# CreateMetricAttribution
<a name="API_CreateMetricAttribution"></a>

Crea una atribución de métricas. La atribución de métricas crea informes sobre los datos que importa en Amazon Personalize. En función de cómo haya importado los datos, puede ver los informes en Amazon CloudWatch o Amazon S3. Para obtener más información, consulte [Medición del impacto de las recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).

## Sintaxis de la solicitud
<a name="API_CreateMetricAttribution_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "metrics": [ 
      { 
         "eventType": "string",
         "expression": "string",
         "metricName": "string"
      }
   ],
   "metricsOutputConfig": { 
      "roleArn": "string",
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "name": "string"
}
```

## Parámetros de la solicitud
<a name="API_CreateMetricAttribution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-datasetGroupArn"></a>
El Nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos de destino para la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [metrics](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-metrics"></a>
Una lista de atributos de métrica para la atribución de métricas. Cada atributo de métrica especifica un tipo de evento que se debe rastrear y una función. Las funciones disponibles son `SUM()` o `SAMPLECOUNT()`. Para las funciones SUM(), proporcione el tipo de conjunto de datos (interacciones o elementos) y la columna que se va a sumar como parámetro. Por ejemplo, SUM(Items.PRICE).  
Tipo: matriz de objetos [MetricAttribute](API_MetricAttribute.md)  
Miembros de la matriz: número máximo de 10 elementos.  
Obligatorio: sí

 ** [metricsOutputConfig](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-metricsOutputConfig"></a>
Los detalles de configuración de salida para la atribución de métricas.  
Tipo: objeto [MetricAttributionOutput](API_MetricAttributionOutput.md)  
Obligatorio: sí

 ** [name](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-name"></a>
Un nombre para la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateMetricAttribution_ResponseSyntax"></a>

```
{
   "metricAttributionArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateMetricAttribution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [metricAttributionArn](#API_CreateMetricAttribution_ResponseSyntax) **   <a name="personalize-CreateMetricAttribution-response-metricAttributionArn"></a>
El Nombre de recurso de Amazon (ARN) para la nueva atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateMetricAttribution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateMetricAttribution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateMetricAttribution) 

# CreateRecommender
<a name="API_CreateRecommender"></a>

Crea un recomendador con la receta (un caso de uso de un grupo de conjuntos de datos de dominio) que especifique. Usted crea recomendadores para un grupo de conjuntos de datos de dominio y especifica el nombre de recurso de Amazon (ARN) del recomendante cuando realiza una solicitud. [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 

 **Solicitudes de recomendación mínimas por segundo** 

**importante**  
Un valor elevado de `minRecommendationRequestsPerSecond` aumentará su factura. Le recomendamos empezar con 1 para `minRecommendationRequestsPerSecond` (el valor predeterminado). Realiza un seguimiento de tu consumo mediante CloudWatch las métricas de Amazon y auméntalo `minRecommendationRequestsPerSecond` según sea necesario.

Al crear un recomendador, puede configurar las solicitudes de recomendación mínimas por segundo de este. El número mínimo de solicitudes de recomendación por segundo (`minRecommendationRequestsPerSecond`) especifica el rendimiento básico de las solicitudes de recomendación aprovisionado por Amazon Personalize. El valor predeterminado minRecommendationRequests PerSecond es`1`. Una solicitud de recomendación es una operación `GetRecommendations` única. El rendimiento de las solicitudes se mide en solicitudes por segundo y Amazon Personalize utiliza las solicitudes por segundo para derivar las solicitudes por hora y el precio del uso del recomendador. 

 Si sus solicitudes por segundo aumentan más allá de `minRecommendationRequestsPerSecond`, Amazon Personalize escala y reduce automáticamente la capacidad aprovisionada, pero nunca por debajo de `minRecommendationRequestsPerSecond`. Se produce un breve retraso durante el aumento de la capacidad que podría provocar la pérdida de solicitudes.

 Tu factura es la cantidad mínima de solicitudes por hora (en función de minRecommendationRequestsPerSecond) o la cantidad real de solicitudes, que sea mayor. El rendimiento real de las solicitudes utilizado se calcula como el promedio requests/second en un período de una hora. Te recomendamos empezar por el predeterminado`minRecommendationRequestsPerSecond`, realizar un seguimiento de tu uso mediante CloudWatch las métricas de Amazon y, a continuación, aumentarlo `minRecommendationRequestsPerSecond` según sea necesario. 

 **Estado** 

Un recomendador puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE
+ DELETE PENDING > DELETE IN\$1PROGRESS

Para obtener el estado de recomendante, llama [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html).

**nota**  
Espere a que el valor `status` del recomendador sea `ACTIVE` antes de pedirle recomendaciones.

**Relacionado APIs**
+  [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) 
+  [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) 
+  [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) 
+  [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) 

## Sintaxis de la solicitud
<a name="API_CreateRecommender_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "name": "string",
   "recipeArn": "string",
   "recommenderConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "minRecommendationRequestsPerSecond": number,
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         },
         "includedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateRecommender_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos del dominio destino para l recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [name](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-name"></a>
El nombre del recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [recipeArn](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-recipeArn"></a>
El nombre de recurso de Amazon (ARN) de la receta que usará el recomendador. Para un recomendador, una receta es un caso de uso de un grupo de conjuntos de datos de dominio. Solo se pueden usar los casos de uso de grupos de conjuntos de datos de dominio para crear un recomendador. Para obtener información sobre los casos de uso, consulte [Elección de los casos de uso de un recomendador](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html).   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-recommenderConfig"></a>
Los detalles de configuración del recomendador.  
Tipo: objeto [RecommenderConfig](API_RecommenderConfig.md)  
Obligatorio: no

 ** [tags](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al recomendador.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateRecommender_ResponseSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateRecommender_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) **   <a name="personalize-CreateRecommender-response-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateRecommender_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateRecommender_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender) 

# CreateSchema
<a name="API_CreateSchema"></a>

Crea un esquema de Amazon Personalize a partir de la cadena de esquema especificada. El esquema que cree debe estar en formato Avro JSON.

Amazon Personalize reconoce tres variantes de esquema. Cada esquema está asociado a un tipo de conjunto de datos y tiene un conjunto de campos y palabras clave necesarios. Si va a crear un esquema para un conjunto de datos en un grupo de conjunto de datos de dominio, debe proporcionar el dominio del grupo de conjunto de datos de dominio. Especificas un esquema cuando llamas [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html).

Para obtener más información sobre los esquemas, consulte [Datasets and schemas](https://docs.aws.amazon.com/personalize/latest/dg/how-it-works-dataset-schema.html) (Conjuntos de datos y esquemas).

**Relacionado APIs**
+  [ListSchemas](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSchemas.html) 
+  [DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) 
+  [DeleteSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSchema.html) 

## Sintaxis de la solicitud
<a name="API_CreateSchema_RequestSyntax"></a>

```
{
   "domain": "string",
   "name": "string",
   "schema": "string"
}
```

## Parámetros de la solicitud
<a name="API_CreateSchema_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [domain](#API_CreateSchema_RequestSyntax) **   <a name="personalize-CreateSchema-request-domain"></a>
El dominio para el esquema. Si va a crear un esquema para un conjunto de datos en un grupo de conjuntos de datos de dominio, especifique el dominio que eligió al crear el grupo de conjuntos de datos de dominio.  
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND`   
Obligatorio: no

 ** [name](#API_CreateSchema_RequestSyntax) **   <a name="personalize-CreateSchema-request-name"></a>
El nombre para el esquema.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [schema](#API_CreateSchema_RequestSyntax) **   <a name="personalize-CreateSchema-request-schema"></a>
Esquema en formato Avro JSON.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 20 000.  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateSchema_ResponseSyntax"></a>

```
{
   "schemaArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateSchema_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [schemaArn](#API_CreateSchema_ResponseSyntax) **   <a name="personalize-CreateSchema-response-schemaArn"></a>
Nombre de recurso de Amazon (ARN) del esquema creado.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateSchema_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateSchema_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSchema) 

# CreateSolution
<a name="API_CreateSolution"></a>

**importante**  
De forma predeterminada, todas las soluciones nuevas utilizan el entrenamiento automático. Con el entrenamiento automático, incurrirá en costos de entrenamiento mientras la solución esté activa. Para evitar costos innecesarios, cuando haya terminado, puede [actualizar la solución](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) para desactivar el entrenamiento automático. Para obtener información sobre los costos de entrenamiento, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).

Crea la configuración para entrenar un modelo (creación de una versión de solución). Esta configuración incluye la receta que se utilizará en el entrenamiento del modelo y la configuración de entrenamiento opcional, como las columnas que se utilizarán en el entrenamiento y los parámetros de transformación de características. Para obtener más información sobre la configuración de una solución, consulte [Creación y configuración de una solución](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html). 

 De forma predeterminada, las soluciones nuevas utilizan el entrenamiento automático para crear versiones de solución cada siete días. Puede cambiar la frecuencia de entrenamiento. La creación automática de versiones de solución comienza una hora después de que el estado de la solución sea ACTIVE. Si crea de forma manual una versión de solución en menos de una hora, la solución omitirá el primer entrenamiento automático. Para obtener más información, consulte [Configuración del entrenamiento automático](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html).

 Para desactivar el entrenamiento automático, establezca `performAutoTraining` en false. Si desactiva el entrenamiento automático, debe crear manualmente una versión de la solución llamando a la [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html)operación.

Una vez que comience la capacitación, podrá obtener el nombre de recurso de Amazon (ARN) de la versión de la solución con la operación de [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Para obtener su estado, utilice. [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) 

Una vez finalizado el entrenamiento, puede evaluar la precisión del modelo llamando [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html). Cuando esté satisfecho con la versión de la solución, la implemente utilizando [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). La campaña proporciona recomendaciones a un cliente a través de la [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API.

**nota**  
Amazon Personalize no admite la configuración de `hpoObjective` para la optimización de hiperparámetros de solución en este momento.

 **Estado** 

Una solución puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Para conocer el estado de la solución, llama [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html). Si utiliza el entrenamiento manual, el estado debe ser ACTIVE antes de llamar a `CreateSolutionVersion`.

**Relacionado APIs**
+  [UpdateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) 
+  [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) 
+  [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) 
+  [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) 
+  [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) 
+  [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) 
+  [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) 

## Sintaxis de la solicitud
<a name="API_CreateSolution_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "eventType": "string",
   "name": "string",
   "performAutoML": boolean,
   "performAutoTraining": boolean,
   "performHPO": boolean,
   "performIncrementalUpdate": boolean,
   "recipeArn": "string",
   "solutionConfig": { 
      "algorithmHyperParameters": { 
         "string" : "string" 
      },
      "autoMLConfig": { 
         "metricName": "string",
         "recipeList": [ "string" ]
      },
      "autoTrainingConfig": { 
         "schedulingExpression": "string"
      },
      "eventsConfig": { 
         "eventParametersList": [ 
            { 
               "eventType": "string",
               "eventValueThreshold": number,
               "weight": number
            }
         ]
      },
      "eventValueThreshold": "string",
      "featureTransformationParameters": { 
         "string" : "string" 
      },
      "hpoConfig": { 
         "algorithmHyperParameterRanges": { 
            "categoricalHyperParameterRanges": [ 
               { 
                  "name": "string",
                  "values": [ "string" ]
               }
            ],
            "continuousHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ],
            "integerHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ]
         },
         "hpoObjective": { 
            "metricName": "string",
            "metricRegex": "string",
            "type": "string"
         },
         "hpoResourceConfig": { 
            "maxNumberOfTrainingJobs": "string",
            "maxParallelTrainingJobs": "string"
         }
      },
      "optimizationObjective": { 
         "itemAttribute": "string",
         "objectiveSensitivity": "string"
      },
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         },
         "includedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateSolution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que proporciona los datos de entrenamiento.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [eventType](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-eventType"></a>
Si tiene varios tipos de eventos (mediante un campo de esquema `EVENT_TYPE`), este parámetro especifica qué tipo de evento (por ejemplo, “clic” o “me gusta”) se utiliza para entrenar el modelo.  
Si no se proporciona `eventType`, Amazon Personalize utiliza todas las interacciones para el entrenamiento con la misma ponderación, independientemente del tipo.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** [name](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-name"></a>
El nombre de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: sí

 ** [performAutoML](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performAutoML"></a>
No le recomendamos habilitar el machine learning automático. En lugar de eso, puede emparejar su caso de uso con las recetas de Amazon Personalize disponibles. Para obtener más información, consulte [Elección de una receta](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html).
Si se debe realizar un machine learning automatizado (AutoML). El valor predeterminado es `false`. En este caso, debe especificar `recipeArn`.  
Cuando se configura en`true`, Amazon Personalize analiza los datos de entrenamiento y selecciona la receta y los hiperparámetros óptimos de USER\$1PERSONALIZATION. En este caso, debe omitir `recipeArn`. Amazon Personalize determina la receta óptima mediante la ejecución de pruebas con valores diferentes para los hiperparámetros. AutoML alarga el proceso de entrenamiento en comparación con la selección de una receta específica.  
Tipo: Booleano  
Obligatorio: no

 ** [performAutoTraining](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performAutoTraining"></a>
Indica si la solución utiliza el entrenamiento automático para crear nuevas versiones de solución (modelos entrenados). El valor predeterminado es `True` y la solución crea automáticamente nuevas versiones de solución cada siete días. Puede cambiar la frecuencia de entrenamiento mediante la especificación de `schedulingExpression` en `AutoTrainingConfig` como parte de la configuración de la solución. Para obtener más información sobre el entrenamiento automático, consulte [Configuración del entrenamiento automático](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html).  
 La creación automática de versiones de solución comienza una hora después de que el estado de la solución sea ACTIVE. Si crea de forma manual una versión de solución en menos de una hora, la solución omitirá el primer entrenamiento automático.   
 Una vez que comience la capacitación, podrá obtener el nombre de recurso de Amazon (ARN) de la versión de la solución con la operación de [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Para obtener su estado, utilice. [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)   
Tipo: Booleano  
Obligatorio: no

 ** [performHPO](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performHPO"></a>
Si se debe realizar la optimización de hiperparámetros (HPO) en la receta especificada o seleccionada. El valor predeterminado es `false`.  
Al ejecutar AutoML, este parámetro es siempre `true` y no debe configurarlo en `false`.  
Tipo: Booleano  
Obligatorio: no

 ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performIncrementalUpdate"></a>
Si desea realizar actualizaciones de entrenamiento incrementales en su modelo. Cuando está activado, esto permite que el modelo aprenda de los nuevos datos con mayor frecuencia sin necesidad de volver a capacitarse por completo, lo que permite una personalización prácticamente en tiempo real. Este parámetro solo es compatible con las soluciones que utilizan la receta de similitud semántica.  
Tipo: Booleano  
Obligatorio: no

 ** [recipeArn](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-recipeArn"></a>
El nombre de recurso de Amazon (ARN) de la receta que se va a utilizar para el entrenamiento del modelo. Esto es obligatorio cuando `performAutoML` es falso. Para obtener información sobre las distintas recetas de Amazon Personalize y sus recetas ARNs, consulta [Cómo elegir una receta](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html).   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [solutionConfig](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-solutionConfig"></a>
Propiedades de configuración de la solución. Si `performAutoML` se establece en true, Amazon Personalize solo evalúa la sección `autoMLConfig` de la configuración de la solución.  
Amazon Personalize no admite la configuración de `hpoObjective` en este momento.
Tipo: objeto [SolutionConfig](API_SolutionConfig.md)  
Obligatorio: no

 ** [tags](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican a la solución.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateSolution_ResponseSyntax"></a>

```
{
   "solutionArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateSolution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [solutionArn](#API_CreateSolution_ResponseSyntax) **   <a name="personalize-CreateSolution-response-solutionArn"></a>
El ARN de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateSolution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateSolution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution) 

# CreateSolutionVersion
<a name="API_CreateSolutionVersion"></a>

Entrena o reentrena una solución activa en un grupo de conjuntos de datos personalizados. Se crea una solución mediante la [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)operación y debe estar en el estado ACTIVO antes de realizar la llamada`CreateSolutionVersion`. Se crea una nueva versión de la solución cada vez que llama a esta operación.

 **Estado** 

Una versión de la solución puede tener uno de los siguientes estados:
+ CREATE PENDING
+ CREATE IN\$1PROGRESS
+ ACTIVE
+ CREATE FAILED
+ CREATE STOPPING
+ CREATE STOPPED

Para obtener el estado de la versión, llame [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). Espere a que el estado se muestre como ACTIVE antes de llamar a `CreateCampaign`.

Si el estado muestra CREATE FAILED, la respuesta incluye una clave `failureReason` que describe el motivo del error en el trabajo.

**Relacionado APIs**
+  [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) 
+  [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) 
+  [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) 
+  [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 
+  [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) 
+  [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) 

## Sintaxis de la solicitud
<a name="API_CreateSolutionVersion_RequestSyntax"></a>

```
{
   "name": "string",
   "solutionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ],
   "trainingMode": "string"
}
```

## Parámetros de la solicitud
<a name="API_CreateSolutionVersion_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [name](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-name"></a>
El nombre de la versión de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** [solutionArn](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-solutionArn"></a>
El nombre de recurso de Amazon (ARN) de la solución que contiene la información de configuración de entrenamiento.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [tags](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican a la versión de solución.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

 ** [trainingMode](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-trainingMode"></a>
El alcance del entrenamiento que se realizará al crear la versión de la solución. El valor predeterminado es `FULL`. Esto crea un modelo completamente nuevo basado en la totalidad de los datos de entrenamiento de los conjuntos de datos de su grupo de conjuntos de datos.   
Si usa [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html), puede especificar un modo de entrenamiento de `UPDATE`. Esto actualiza el modelo para tener en cuenta nuevos elementos a modo de recomendaciones. No se trata de un reentrenamiento completo. Aún así, debe completar un reentrenamiento completo semanalmente. Si especifica `UPDATE`, Amazon Personalize detendrá las actualizaciones automáticas de la versión de la solución. Para reanudar las actualizaciones, cree una nueva solución con el modo de entrenamiento configurado en `FULL` e impleméntela en una campaña. Para obtener más información acerca de las actualizaciones automáticas, consulte [Actualizaciones automáticas](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#maintaining-with-automatic-updates).   
La opción `UPDATE` solo se puede usar si ya se ha creado una versión de la solución activa a partir de la solución de entrada mediante la opción `FULL` y la solución de entrada se entrenó con la receta [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html) o con la receta [HRNN-Coldstart](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html) heredada.  
Tipo: cadena  
Valores válidos: `FULL | UPDATE | AUTOTRAIN`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateSolutionVersion_ResponseSyntax"></a>

```
{
   "solutionVersionArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateSolutionVersion_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [solutionVersionArn](#API_CreateSolutionVersion_ResponseSyntax) **   <a name="personalize-CreateSolutionVersion-response-solutionVersionArn"></a>
El ARN de la nueva versión de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateSolutionVersion_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_CreateSolutionVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolutionVersion) 

# DeleteCampaign
<a name="API_DeleteCampaign"></a>

Elimina una campaña al eliminar la implementación de la solución. La solución en la que se basa la campaña no se elimina y se puede volver a implementar cuando sea necesario. Ya no se puede especificar una campaña eliminada en una [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)solicitud. Para obtener información sobre la creación de campañas, consulte [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html).

## Sintaxis de la solicitud
<a name="API_DeleteCampaign_RequestSyntax"></a>

```
{
   "campaignArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteCampaign_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [campaignArn](#API_DeleteCampaign_RequestSyntax) **   <a name="personalize-DeleteCampaign-request-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteCampaign_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteCampaign_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteCampaign_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteCampaign) 

# DeleteDataset
<a name="API_DeleteDataset"></a>

Elimina un conjunto de datos. No puede eliminar un conjunto de datos si un `DatasetImportJob` o `SolutionVersion` asociado se encuentra en el estado CREATE PENDING o IN PROGRESS. Para obtener más información sobre cómo eliminar conjuntos de datos, consulte [Eliminación de un conjunto de datos](https://docs.aws.amazon.com/personalize/latest/dg/delete-dataset.html). 

## Sintaxis de la solicitud
<a name="API_DeleteDataset_RequestSyntax"></a>

```
{
   "datasetArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteDataset_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_DeleteDataset_RequestSyntax) **   <a name="personalize-DeleteDataset-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteDataset_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteDataset_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteDataset_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteDataset) 

# DeleteDatasetGroup
<a name="API_DeleteDatasetGroup"></a>

Elimina un grupo de conjuntos de datos. Antes de eliminar un grupo de conjuntos de datos, debe eliminar lo siguiente:
+ Todos los rastreadores de eventos asociados.
+ Todas las soluciones asociadas.
+ Todos los conjuntos de datos del grupo de conjuntos de datos.

## Sintaxis de la solicitud
<a name="API_DeleteDatasetGroup_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteDatasetGroup_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_DeleteDatasetGroup_RequestSyntax) **   <a name="personalize-DeleteDatasetGroup-request-datasetGroupArn"></a>
El ARN del grupo de conjuntos de datos que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteDatasetGroup_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteDatasetGroup_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteDatasetGroup_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteDatasetGroup) 

# DeleteEventTracker
<a name="API_DeleteEventTracker"></a>

Elimina el rastreador de eventos. No elimina el conjunto de datos del grupo de conjuntos de datos. Para obtener más información sobre los rastreadores de eventos, consulte [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html).

## Sintaxis de la solicitud
<a name="API_DeleteEventTracker_RequestSyntax"></a>

```
{
   "eventTrackerArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteEventTracker_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [eventTrackerArn](#API_DeleteEventTracker_RequestSyntax) **   <a name="personalize-DeleteEventTracker-request-eventTrackerArn"></a>
El nombre de recurso de Amazon (ARN) del rastreador de eventos que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteEventTracker_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteEventTracker_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteEventTracker_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteEventTracker) 

# DeleteFilter
<a name="API_DeleteFilter"></a>

Elimina un filtro.

## Sintaxis de la solicitud
<a name="API_DeleteFilter_RequestSyntax"></a>

```
{
   "filterArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteFilter_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [filterArn](#API_DeleteFilter_RequestSyntax) **   <a name="personalize-DeleteFilter-request-filterArn"></a>
El ARN del filtro que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteFilter_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteFilter_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteFilter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteFilter) 

# DeleteMetricAttribution
<a name="API_DeleteMetricAttribution"></a>

Elimina una atribución de métricas.

## Sintaxis de la solicitud
<a name="API_DeleteMetricAttribution_RequestSyntax"></a>

```
{
   "metricAttributionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteMetricAttribution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [metricAttributionArn](#API_DeleteMetricAttribution_RequestSyntax) **   <a name="personalize-DeleteMetricAttribution-request-metricAttributionArn"></a>
El nombre de recurso de Amazon (ARN) de la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteMetricAttribution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteMetricAttribution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteMetricAttribution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteMetricAttribution) 

# DeleteRecommender
<a name="API_DeleteRecommender"></a>

Desactiva y elimina un recomendador. Ya no se puede especificar un recomendante eliminado en una [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)solicitud.

## Sintaxis de la solicitud
<a name="API_DeleteRecommender_RequestSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteRecommender_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [recommenderArn](#API_DeleteRecommender_RequestSyntax) **   <a name="personalize-DeleteRecommender-request-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteRecommender_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteRecommender_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteRecommender_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteRecommender) 

# DeleteSchema
<a name="API_DeleteSchema"></a>

Elimina un esquema. Antes de eliminar un esquema, debe eliminar todos los conjuntos de datos que hacen referencia al esquema. Para obtener más información sobre los esquemas, consulte [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html).

## Sintaxis de la solicitud
<a name="API_DeleteSchema_RequestSyntax"></a>

```
{
   "schemaArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteSchema_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [schemaArn](#API_DeleteSchema_RequestSyntax) **   <a name="personalize-DeleteSchema-request-schemaArn"></a>
Nombre de recurso de Amazon (ARN) del esquema que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteSchema_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteSchema_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteSchema_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteSchema) 

# DeleteSolution
<a name="API_DeleteSolution"></a>

Elimina todas las versiones de una solución y el objeto `Solution` en sí. Antes de eliminar una solución, debe eliminar todas las campañas basadas en la solución. Para determinar qué campañas utilizan la solución, llama [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html)y proporciona el nombre de recurso de Amazon (ARN) de la solución. No puede eliminar una solución si un `SolutionVersion` asociado se encuentra en el estado CREATE PENDING o IN PROGRESS. Para obtener más información sobre las soluciones, consulte [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html).

## Sintaxis de la solicitud
<a name="API_DeleteSolution_RequestSyntax"></a>

```
{
   "solutionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DeleteSolution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [solutionArn](#API_DeleteSolution_RequestSyntax) **   <a name="personalize-DeleteSolution-request-solutionArn"></a>
El ARN de la solución que se va a eliminar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_DeleteSolution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_DeleteSolution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DeleteSolution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteSolution) 

# DescribeAlgorithm
<a name="API_DescribeAlgorithm"></a>

Describe el algoritmo dado.

## Sintaxis de la solicitud
<a name="API_DescribeAlgorithm_RequestSyntax"></a>

```
{
   "algorithmArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeAlgorithm_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [algorithmArn](#API_DescribeAlgorithm_RequestSyntax) **   <a name="personalize-DescribeAlgorithm-request-algorithmArn"></a>
El nombre de recurso de Amazon (ARN) del algoritmo que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeAlgorithm_ResponseSyntax"></a>

```
{
   "algorithm": { 
      "algorithmArn": "string",
      "algorithmImage": { 
         "dockerURI": "string",
         "name": "string"
      },
      "creationDateTime": number,
      "defaultHyperParameterRanges": { 
         "categoricalHyperParameterRanges": [ 
            { 
               "isTunable": boolean,
               "name": "string",
               "values": [ "string" ]
            }
         ],
         "continuousHyperParameterRanges": [ 
            { 
               "isTunable": boolean,
               "maxValue": number,
               "minValue": number,
               "name": "string"
            }
         ],
         "integerHyperParameterRanges": [ 
            { 
               "isTunable": boolean,
               "maxValue": number,
               "minValue": number,
               "name": "string"
            }
         ]
      },
      "defaultHyperParameters": { 
         "string" : "string" 
      },
      "defaultResourceConfig": { 
         "string" : "string" 
      },
      "lastUpdatedDateTime": number,
      "name": "string",
      "roleArn": "string",
      "trainingInputMode": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeAlgorithm_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [algorithm](#API_DescribeAlgorithm_ResponseSyntax) **   <a name="personalize-DescribeAlgorithm-response-algorithm"></a>
Una lista de las propiedades del algoritmo.  
Tipo: objeto [Algorithm](API_Algorithm.md)

## Errores
<a name="API_DescribeAlgorithm_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeAlgorithm_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeAlgorithm) 

# DescribeBatchInferenceJob
<a name="API_DescribeBatchInferenceJob"></a>

Obtiene las propiedades de un trabajo de inferencia por lotes, incluidos el nombre, el nombre del recurso de Amazon (ARN), el estado, las configuraciones de entrada y salida y el ARN de la versión de la solución utilizada para generar las recomendaciones.

## Sintaxis de la solicitud
<a name="API_DescribeBatchInferenceJob_RequestSyntax"></a>

```
{
   "batchInferenceJobArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeBatchInferenceJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [batchInferenceJobArn](#API_DescribeBatchInferenceJob_RequestSyntax) **   <a name="personalize-DescribeBatchInferenceJob-request-batchInferenceJobArn"></a>
El ARN del trabajo de inferencia por lotes que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeBatchInferenceJob_ResponseSyntax"></a>

```
{
   "batchInferenceJob": { 
      "batchInferenceJobArn": "string",
      "batchInferenceJobConfig": { 
         "itemExplorationConfig": { 
            "string" : "string" 
         },
         "rankingInfluence": { 
            "string" : number 
         }
      },
      "batchInferenceJobMode": "string",
      "creationDateTime": number,
      "failureReason": "string",
      "filterArn": "string",
      "jobInput": { 
         "s3DataSource": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "jobName": "string",
      "jobOutput": { 
         "s3DataDestination": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "lastUpdatedDateTime": number,
      "numResults": number,
      "roleArn": "string",
      "solutionVersionArn": "string",
      "status": "string",
      "themeGenerationConfig": { 
         "fieldsForThemeGeneration": { 
            "itemName": "string"
         }
      }
   }
}
```

## Elementos de respuesta
<a name="API_DescribeBatchInferenceJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [batchInferenceJob](#API_DescribeBatchInferenceJob_ResponseSyntax) **   <a name="personalize-DescribeBatchInferenceJob-response-batchInferenceJob"></a>
Información sobre el trabajo de inferencia por lotes especificado.  
Tipo: objeto [BatchInferenceJob](API_BatchInferenceJob.md)

## Errores
<a name="API_DescribeBatchInferenceJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeBatchInferenceJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeBatchInferenceJob) 

# DescribeBatchSegmentJob
<a name="API_DescribeBatchSegmentJob"></a>

Obtiene las propiedades de un trabajo de segmentos por lotes, incluidos el nombre, el nombre del recurso de Amazon (ARN), el estado, las configuraciones de entrada y salida y el ARN de la versión de la solución utilizada para generar segmentos.

## Sintaxis de la solicitud
<a name="API_DescribeBatchSegmentJob_RequestSyntax"></a>

```
{
   "batchSegmentJobArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeBatchSegmentJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [batchSegmentJobArn](#API_DescribeBatchSegmentJob_RequestSyntax) **   <a name="personalize-DescribeBatchSegmentJob-request-batchSegmentJobArn"></a>
El ARN del trabajo de segmento por lotes que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeBatchSegmentJob_ResponseSyntax"></a>

```
{
   "batchSegmentJob": { 
      "batchSegmentJobArn": "string",
      "creationDateTime": number,
      "failureReason": "string",
      "filterArn": "string",
      "jobInput": { 
         "s3DataSource": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "jobName": "string",
      "jobOutput": { 
         "s3DataDestination": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "lastUpdatedDateTime": number,
      "numResults": number,
      "roleArn": "string",
      "solutionVersionArn": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeBatchSegmentJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [batchSegmentJob](#API_DescribeBatchSegmentJob_ResponseSyntax) **   <a name="personalize-DescribeBatchSegmentJob-response-batchSegmentJob"></a>
Información sobre el trabajo de segmentos por lotes especificado.  
Tipo: objeto [BatchSegmentJob](API_BatchSegmentJob.md)

## Errores
<a name="API_DescribeBatchSegmentJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeBatchSegmentJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeBatchSegmentJob) 

# DescribeCampaign
<a name="API_DescribeCampaign"></a>

Describe el la campaña indicada, incluido su estado.

Una campaña puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Cuando `status` es `CREATE FAILED`, la respuesta incluye la clave `failureReason`, que describe el motivo.

Para obtener más información sobre las campañas, consulte [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html).

## Sintaxis de la solicitud
<a name="API_DescribeCampaign_RequestSyntax"></a>

```
{
   "campaignArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeCampaign_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [campaignArn](#API_DescribeCampaign_RequestSyntax) **   <a name="personalize-DescribeCampaign-request-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeCampaign_ResponseSyntax"></a>

```
{
   "campaign": { 
      "campaignArn": "string",
      "campaignConfig": { 
         "enableMetadataWithRecommendations": boolean,
         "itemExplorationConfig": { 
            "string" : "string" 
         },
         "rankingInfluence": { 
            "string" : number 
         },
         "syncWithLatestSolutionVersion": boolean
      },
      "creationDateTime": number,
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "latestCampaignUpdate": { 
         "campaignConfig": { 
            "enableMetadataWithRecommendations": boolean,
            "itemExplorationConfig": { 
               "string" : "string" 
            },
            "rankingInfluence": { 
               "string" : number 
            },
            "syncWithLatestSolutionVersion": boolean
         },
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "minProvisionedTPS": number,
         "solutionVersionArn": "string",
         "status": "string"
      },
      "minProvisionedTPS": number,
      "name": "string",
      "solutionVersionArn": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeCampaign_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [campaign](#API_DescribeCampaign_ResponseSyntax) **   <a name="personalize-DescribeCampaign-response-campaign"></a>
El campo `latestCampaignUpdate` solo se devuelve cuando la campaña ha tenido al menos una llamada de `UpdateCampaign`. 
Las propiedades de la campaña.  
El campo `latestCampaignUpdate` solo se devuelve cuando la campaña ha tenido al menos una llamada de `UpdateCampaign`.
Tipo: objeto [Campaign](API_Campaign.md)

## Errores
<a name="API_DescribeCampaign_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeCampaign_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeCampaign) 

# DescribeDataDeletionJob
<a name="API_DescribeDataDeletionJob"></a>

Describe el trabajo de eliminación de datos creado por [CreateDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataDeletionJob.html), incluido el estado del trabajo.

## Sintaxis de la solicitud
<a name="API_DescribeDataDeletionJob_RequestSyntax"></a>

```
{
   "dataDeletionJobArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeDataDeletionJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [dataDeletionJobArn](#API_DescribeDataDeletionJob_RequestSyntax) **   <a name="personalize-DescribeDataDeletionJob-request-dataDeletionJobArn"></a>
Nombre de recurso de Amazon (ARN) del trabajo de eliminación de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeDataDeletionJob_ResponseSyntax"></a>

```
{
   "dataDeletionJob": { 
      "creationDateTime": number,
      "dataDeletionJobArn": "string",
      "datasetGroupArn": "string",
      "dataSource": { 
         "dataLocation": "string"
      },
      "failureReason": "string",
      "jobName": "string",
      "lastUpdatedDateTime": number,
      "numDeleted": number,
      "roleArn": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeDataDeletionJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [dataDeletionJob](#API_DescribeDataDeletionJob_ResponseSyntax) **   <a name="personalize-DescribeDataDeletionJob-response-dataDeletionJob"></a>
Información sobre el trabajo de eliminación de datos, incluido el estado.  
El estado es uno de los siguientes valores:  
+ PENDIENTE
+ IN\$1PROGRESS
+ COMPLETED
+ ERROR
Tipo: objeto [DataDeletionJob](API_DataDeletionJob.md)

## Errores
<a name="API_DescribeDataDeletionJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeDataDeletionJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDataDeletionJob) 

# DescribeDataset
<a name="API_DescribeDataset"></a>

Describe el conjunto de datos especificado. Para obtener más información sobre los conjuntos de datos, consulte [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html).

## Sintaxis de la solicitud
<a name="API_DescribeDataset_RequestSyntax"></a>

```
{
   "datasetArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeDataset_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_DescribeDataset_RequestSyntax) **   <a name="personalize-DescribeDataset-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeDataset_ResponseSyntax"></a>

```
{
   "dataset": { 
      "creationDateTime": number,
      "datasetArn": "string",
      "datasetGroupArn": "string",
      "datasetType": "string",
      "lastUpdatedDateTime": number,
      "latestDatasetUpdate": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "schemaArn": "string",
         "status": "string"
      },
      "name": "string",
      "schemaArn": "string",
      "status": "string",
      "trackingId": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeDataset_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [dataset](#API_DescribeDataset_ResponseSyntax) **   <a name="personalize-DescribeDataset-response-dataset"></a>
Una lista de las propiedades del conjunto de datos.  
Tipo: objeto [Dataset](API_Dataset.md)

## Errores
<a name="API_DescribeDataset_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeDataset_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDataset) 

# DescribeDatasetExportJob
<a name="API_DescribeDatasetExportJob"></a>

Describe el trabajo de exportación del conjunto de datos creado por [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html), incluido el estado del trabajo de exportación.

## Sintaxis de la solicitud
<a name="API_DescribeDatasetExportJob_RequestSyntax"></a>

```
{
   "datasetExportJobArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeDatasetExportJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetExportJobArn](#API_DescribeDatasetExportJob_RequestSyntax) **   <a name="personalize-DescribeDatasetExportJob-request-datasetExportJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de exportación de conjuntos de datos que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeDatasetExportJob_ResponseSyntax"></a>

```
{
   "datasetExportJob": { 
      "creationDateTime": number,
      "datasetArn": "string",
      "datasetExportJobArn": "string",
      "failureReason": "string",
      "ingestionMode": "string",
      "jobName": "string",
      "jobOutput": { 
         "s3DataDestination": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "lastUpdatedDateTime": number,
      "roleArn": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeDatasetExportJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetExportJob](#API_DescribeDatasetExportJob_ResponseSyntax) **   <a name="personalize-DescribeDatasetExportJob-response-datasetExportJob"></a>
Información sobre el trabajo de exportación de conjuntos de datos, incluido el estado.  
El estado es uno de los siguientes valores:  
+ CREATE PENDING
+ CREATE IN\$1PROGRESS
+ ACTIVE
+ CREATE FAILED
Tipo: objeto [DatasetExportJob](API_DatasetExportJob.md)

## Errores
<a name="API_DescribeDatasetExportJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeDatasetExportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetExportJob) 

# DescribeDatasetGroup
<a name="API_DescribeDatasetGroup"></a>

Describe el grupo de conjuntos de datos especificado. Para obtener más información sobre los grupos de conjuntos de datos, consulte [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html).

## Sintaxis de la solicitud
<a name="API_DescribeDatasetGroup_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeDatasetGroup_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_DescribeDatasetGroup_RequestSyntax) **   <a name="personalize-DescribeDatasetGroup-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeDatasetGroup_ResponseSyntax"></a>

```
{
   "datasetGroup": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "domain": "string",
      "failureReason": "string",
      "kmsKeyArn": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "roleArn": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeDatasetGroup_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetGroup](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="personalize-DescribeDatasetGroup-response-datasetGroup"></a>
Una lista de las propiedades del grupo de conjuntos de datos.  
Tipo: objeto [DatasetGroup](API_DatasetGroup.md)

## Errores
<a name="API_DescribeDatasetGroup_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeDatasetGroup_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetGroup) 

# DescribeDatasetImportJob
<a name="API_DescribeDatasetImportJob"></a>

Describe el trabajo de importación del conjunto de datos creado por [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html), incluido el estado del trabajo de importación.

## Sintaxis de la solicitud
<a name="API_DescribeDatasetImportJob_RequestSyntax"></a>

```
{
   "datasetImportJobArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeDatasetImportJob_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetImportJobArn](#API_DescribeDatasetImportJob_RequestSyntax) **   <a name="personalize-DescribeDatasetImportJob-request-datasetImportJobArn"></a>
El nombre de recurso de Amazon (ARN) de la tarea de importación del conjunto de datos que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeDatasetImportJob_ResponseSyntax"></a>

```
{
   "datasetImportJob": { 
      "creationDateTime": number,
      "datasetArn": "string",
      "datasetImportJobArn": "string",
      "dataSource": { 
         "dataLocation": "string"
      },
      "failureReason": "string",
      "importMode": "string",
      "jobName": "string",
      "lastUpdatedDateTime": number,
      "publishAttributionMetricsToS3": boolean,
      "roleArn": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeDatasetImportJob_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetImportJob](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="personalize-DescribeDatasetImportJob-response-datasetImportJob"></a>
Información sobre el trabajo de importación del conjunto de datos, incluido el estado.  
El estado es uno de los siguientes valores:  
+ CREATE PENDING
+ CREATE IN\$1PROGRESS
+ ACTIVE
+ CREATE FAILED
Tipo: objeto [DatasetImportJob](API_DatasetImportJob.md)

## Errores
<a name="API_DescribeDatasetImportJob_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeDatasetImportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetImportJob) 

# DescribeEventTracker
<a name="API_DescribeEventTracker"></a>

Describe un rastreador de eventos. La respuesta incluye el valor `trackingId` y `status` del rastreador de eventos. Para obtener más información sobre los rastreadores de eventos, consulte [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html).

## Sintaxis de la solicitud
<a name="API_DescribeEventTracker_RequestSyntax"></a>

```
{
   "eventTrackerArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeEventTracker_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [eventTrackerArn](#API_DescribeEventTracker_RequestSyntax) **   <a name="personalize-DescribeEventTracker-request-eventTrackerArn"></a>
El nombre de recurso de Amazon (ARN) del rastreador de eventos que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeEventTracker_ResponseSyntax"></a>

```
{
   "eventTracker": { 
      "accountId": "string",
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "eventTrackerArn": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "status": "string",
      "trackingId": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeEventTracker_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [eventTracker](#API_DescribeEventTracker_ResponseSyntax) **   <a name="personalize-DescribeEventTracker-response-eventTracker"></a>
Un objeto que describe el rastreador de eventos.  
Tipo: objeto [EventTracker](API_EventTracker.md)

## Errores
<a name="API_DescribeEventTracker_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeEventTracker_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeEventTracker) 

# DescribeFeatureTransformation
<a name="API_DescribeFeatureTransformation"></a>

Describe la transformación de la característica dada.

## Sintaxis de la solicitud
<a name="API_DescribeFeatureTransformation_RequestSyntax"></a>

```
{
   "featureTransformationArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeFeatureTransformation_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [featureTransformationArn](#API_DescribeFeatureTransformation_RequestSyntax) **   <a name="personalize-DescribeFeatureTransformation-request-featureTransformationArn"></a>
El nombre de recurso de Amazon (ARN) de la transformación de característica que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeFeatureTransformation_ResponseSyntax"></a>

```
{
   "featureTransformation": { 
      "creationDateTime": number,
      "defaultParameters": { 
         "string" : "string" 
      },
      "featureTransformationArn": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeFeatureTransformation_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [featureTransformation](#API_DescribeFeatureTransformation_ResponseSyntax) **   <a name="personalize-DescribeFeatureTransformation-response-featureTransformation"></a>
Una lista de las FeatureTransformation propiedades.  
Tipo: objeto [FeatureTransformation](API_FeatureTransformation.md)

## Errores
<a name="API_DescribeFeatureTransformation_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeFeatureTransformation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeFeatureTransformation) 

# DescribeFilter
<a name="API_DescribeFilter"></a>

Describe las propiedades del filtro.

## Sintaxis de la solicitud
<a name="API_DescribeFilter_RequestSyntax"></a>

```
{
   "filterArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeFilter_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [filterArn](#API_DescribeFilter_RequestSyntax) **   <a name="personalize-DescribeFilter-request-filterArn"></a>
El ARN del filtro que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeFilter_ResponseSyntax"></a>

```
{
   "filter": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "failureReason": "string",
      "filterArn": "string",
      "filterExpression": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeFilter_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [filter](#API_DescribeFilter_ResponseSyntax) **   <a name="personalize-DescribeFilter-response-filter"></a>
Los detalles del filtro.  
Tipo: objeto [Filter](API_Filter.md)

## Errores
<a name="API_DescribeFilter_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeFilter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeFilter) 

# DescribeMetricAttribution
<a name="API_DescribeMetricAttribution"></a>

Describe una atribución de métricas.

## Sintaxis de la solicitud
<a name="API_DescribeMetricAttribution_RequestSyntax"></a>

```
{
   "metricAttributionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeMetricAttribution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [metricAttributionArn](#API_DescribeMetricAttribution_RequestSyntax) **   <a name="personalize-DescribeMetricAttribution-request-metricAttributionArn"></a>
El nombre de recurso de Amazon (ARN) de la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeMetricAttribution_ResponseSyntax"></a>

```
{
   "metricAttribution": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "metricAttributionArn": "string",
      "metricsOutputConfig": { 
         "roleArn": "string",
         "s3DataDestination": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "name": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeMetricAttribution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [metricAttribution](#API_DescribeMetricAttribution_ResponseSyntax) **   <a name="personalize-DescribeMetricAttribution-response-metricAttribution"></a>
Los detalles de la atribución de métricas.  
Tipo: objeto [MetricAttribution](API_MetricAttribution.md)

## Errores
<a name="API_DescribeMetricAttribution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeMetricAttribution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeMetricAttribution) 

# DescribeRecipe
<a name="API_DescribeRecipe"></a>

Describe una receta.

Una receta contiene tres elementos:
+ Un algoritmo que entrena un modelo.
+ Hiperparámetros que rigen el entrenamiento.
+ Información de transformación de características para modificar los datos de entrada antes del entrenamiento.

Amazon Personalize proporciona un conjunto de recetas predefinidas. Usted especifica una receta al crear una solución con la [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)API. `CreateSolution`entrena un modelo mediante el algoritmo de la receta especificada y un conjunto de datos de entrenamiento. La solución, cuando se implementa como una campaña, puede proporcionar recomendaciones mediante la [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API.

## Sintaxis de la solicitud
<a name="API_DescribeRecipe_RequestSyntax"></a>

```
{
   "recipeArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeRecipe_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [recipeArn](#API_DescribeRecipe_RequestSyntax) **   <a name="personalize-DescribeRecipe-request-recipeArn"></a>
El nombre de recurso de Amazon (ARN) de la receta que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeRecipe_ResponseSyntax"></a>

```
{
   "recipe": { 
      "algorithmArn": "string",
      "creationDateTime": number,
      "description": "string",
      "featureTransformationArn": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "recipeArn": "string",
      "recipeType": "string",
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeRecipe_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [recipe](#API_DescribeRecipe_ResponseSyntax) **   <a name="personalize-DescribeRecipe-response-recipe"></a>
Un objeto que describe la receta.  
Tipo: objeto [Recipe](API_Recipe.md)

## Errores
<a name="API_DescribeRecipe_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeRecipe_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecipe) 

# DescribeRecommender
<a name="API_DescribeRecommender"></a>

Describe el recomendador indicado, incluido su estado.

Un recomendador puede tener uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE
+ DELETE PENDING > DELETE IN\$1PROGRESS

Cuando `status` es `CREATE FAILED`, la respuesta incluye la clave `failureReason`, que describe el motivo.

La clave `modelMetrics` es nula cuando se crea o se elimina el recomendador.

Para obtener más información sobre los recomendantes, consulte [CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html).

## Sintaxis de la solicitud
<a name="API_DescribeRecommender_RequestSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeRecommender_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [recommenderArn](#API_DescribeRecommender_RequestSyntax) **   <a name="personalize-DescribeRecommender-request-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeRecommender_ResponseSyntax"></a>

```
{
   "recommender": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "latestRecommenderUpdate": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "recommenderConfig": { 
            "enableMetadataWithRecommendations": boolean,
            "itemExplorationConfig": { 
               "string" : "string" 
            },
            "minRecommendationRequestsPerSecond": number,
            "trainingDataConfig": { 
               "excludedDatasetColumns": { 
                  "string" : [ "string" ]
               },
               "includedDatasetColumns": { 
                  "string" : [ "string" ]
               }
            }
         },
         "status": "string"
      },
      "modelMetrics": { 
         "string" : number 
      },
      "name": "string",
      "recipeArn": "string",
      "recommenderArn": "string",
      "recommenderConfig": { 
         "enableMetadataWithRecommendations": boolean,
         "itemExplorationConfig": { 
            "string" : "string" 
         },
         "minRecommendationRequestsPerSecond": number,
         "trainingDataConfig": { 
            "excludedDatasetColumns": { 
               "string" : [ "string" ]
            },
            "includedDatasetColumns": { 
               "string" : [ "string" ]
            }
         }
      },
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeRecommender_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [recommender](#API_DescribeRecommender_ResponseSyntax) **   <a name="personalize-DescribeRecommender-response-recommender"></a>
Las propiedades del recomendador.  
Tipo: objeto [Recommender](API_Recommender.md)

## Errores
<a name="API_DescribeRecommender_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeRecommender_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecommender) 

# DescribeSchema
<a name="API_DescribeSchema"></a>

Describe un esquema. Para obtener más información sobre los esquemas, consulte [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html).

## Sintaxis de la solicitud
<a name="API_DescribeSchema_RequestSyntax"></a>

```
{
   "schemaArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeSchema_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [schemaArn](#API_DescribeSchema_RequestSyntax) **   <a name="personalize-DescribeSchema-request-schemaArn"></a>
Nombre de recurso de Amazon (ARN) del esquema que se va a recuperar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeSchema_ResponseSyntax"></a>

```
{
   "schema": { 
      "creationDateTime": number,
      "domain": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "schema": "string",
      "schemaArn": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeSchema_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [schema](#API_DescribeSchema_ResponseSyntax) **   <a name="personalize-DescribeSchema-response-schema"></a>
El esquema solicitado.  
Tipo: objeto [DatasetSchema](API_DatasetSchema.md)

## Errores
<a name="API_DescribeSchema_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeSchema_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSchema) 

# DescribeSolution
<a name="API_DescribeSolution"></a>

Describe una solución. Para obtener más información sobre las soluciones, consulte [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html).

## Sintaxis de la solicitud
<a name="API_DescribeSolution_RequestSyntax"></a>

```
{
   "solutionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeSolution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [solutionArn](#API_DescribeSolution_RequestSyntax) **   <a name="personalize-DescribeSolution-request-solutionArn"></a>
El nombre de recurso de Amazon (ARN) de la solución que se va a describir.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeSolution_ResponseSyntax"></a>

```
{
   "solution": { 
      "autoMLResult": { 
         "bestRecipeArn": "string"
      },
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "eventType": "string",
      "lastUpdatedDateTime": number,
      "latestSolutionUpdate": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "performAutoTraining": boolean,
         "performIncrementalUpdate": boolean,
         "solutionUpdateConfig": { 
            "autoTrainingConfig": { 
               "schedulingExpression": "string"
            },
            "eventsConfig": { 
               "eventParametersList": [ 
                  { 
                     "eventType": "string",
                     "eventValueThreshold": number,
                     "weight": number
                  }
               ]
            }
         },
         "status": "string"
      },
      "latestSolutionVersion": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "solutionVersionArn": "string",
         "status": "string",
         "trainingMode": "string",
         "trainingType": "string"
      },
      "name": "string",
      "performAutoML": boolean,
      "performAutoTraining": boolean,
      "performHPO": boolean,
      "performIncrementalUpdate": boolean,
      "recipeArn": "string",
      "solutionArn": "string",
      "solutionConfig": { 
         "algorithmHyperParameters": { 
            "string" : "string" 
         },
         "autoMLConfig": { 
            "metricName": "string",
            "recipeList": [ "string" ]
         },
         "autoTrainingConfig": { 
            "schedulingExpression": "string"
         },
         "eventsConfig": { 
            "eventParametersList": [ 
               { 
                  "eventType": "string",
                  "eventValueThreshold": number,
                  "weight": number
               }
            ]
         },
         "eventValueThreshold": "string",
         "featureTransformationParameters": { 
            "string" : "string" 
         },
         "hpoConfig": { 
            "algorithmHyperParameterRanges": { 
               "categoricalHyperParameterRanges": [ 
                  { 
                     "name": "string",
                     "values": [ "string" ]
                  }
               ],
               "continuousHyperParameterRanges": [ 
                  { 
                     "maxValue": number,
                     "minValue": number,
                     "name": "string"
                  }
               ],
               "integerHyperParameterRanges": [ 
                  { 
                     "maxValue": number,
                     "minValue": number,
                     "name": "string"
                  }
               ]
            },
            "hpoObjective": { 
               "metricName": "string",
               "metricRegex": "string",
               "type": "string"
            },
            "hpoResourceConfig": { 
               "maxNumberOfTrainingJobs": "string",
               "maxParallelTrainingJobs": "string"
            }
         },
         "optimizationObjective": { 
            "itemAttribute": "string",
            "objectiveSensitivity": "string"
         },
         "trainingDataConfig": { 
            "excludedDatasetColumns": { 
               "string" : [ "string" ]
            },
            "includedDatasetColumns": { 
               "string" : [ "string" ]
            }
         }
      },
      "status": "string"
   }
}
```

## Elementos de respuesta
<a name="API_DescribeSolution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [solution](#API_DescribeSolution_ResponseSyntax) **   <a name="personalize-DescribeSolution-response-solution"></a>
Un objeto que describe la solución.  
Tipo: objeto [Solution](API_Solution.md)

## Errores
<a name="API_DescribeSolution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeSolution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSolution) 

# DescribeSolutionVersion
<a name="API_DescribeSolutionVersion"></a>

Describe una versión específica de una solución. Para obtener más información sobre las soluciones, consulte [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 

## Sintaxis de la solicitud
<a name="API_DescribeSolutionVersion_RequestSyntax"></a>

```
{
   "solutionVersionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_DescribeSolutionVersion_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [solutionVersionArn](#API_DescribeSolutionVersion_RequestSyntax) **   <a name="personalize-DescribeSolutionVersion-request-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_DescribeSolutionVersion_ResponseSyntax"></a>

```
{
   "solutionVersion": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "eventType": "string",
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "performAutoML": boolean,
      "performHPO": boolean,
      "performIncrementalUpdate": boolean,
      "recipeArn": "string",
      "solutionArn": "string",
      "solutionConfig": { 
         "algorithmHyperParameters": { 
            "string" : "string" 
         },
         "autoMLConfig": { 
            "metricName": "string",
            "recipeList": [ "string" ]
         },
         "autoTrainingConfig": { 
            "schedulingExpression": "string"
         },
         "eventsConfig": { 
            "eventParametersList": [ 
               { 
                  "eventType": "string",
                  "eventValueThreshold": number,
                  "weight": number
               }
            ]
         },
         "eventValueThreshold": "string",
         "featureTransformationParameters": { 
            "string" : "string" 
         },
         "hpoConfig": { 
            "algorithmHyperParameterRanges": { 
               "categoricalHyperParameterRanges": [ 
                  { 
                     "name": "string",
                     "values": [ "string" ]
                  }
               ],
               "continuousHyperParameterRanges": [ 
                  { 
                     "maxValue": number,
                     "minValue": number,
                     "name": "string"
                  }
               ],
               "integerHyperParameterRanges": [ 
                  { 
                     "maxValue": number,
                     "minValue": number,
                     "name": "string"
                  }
               ]
            },
            "hpoObjective": { 
               "metricName": "string",
               "metricRegex": "string",
               "type": "string"
            },
            "hpoResourceConfig": { 
               "maxNumberOfTrainingJobs": "string",
               "maxParallelTrainingJobs": "string"
            }
         },
         "optimizationObjective": { 
            "itemAttribute": "string",
            "objectiveSensitivity": "string"
         },
         "trainingDataConfig": { 
            "excludedDatasetColumns": { 
               "string" : [ "string" ]
            },
            "includedDatasetColumns": { 
               "string" : [ "string" ]
            }
         }
      },
      "solutionVersionArn": "string",
      "status": "string",
      "trainingHours": number,
      "trainingMode": "string",
      "trainingType": "string",
      "tunedHPOParams": { 
         "algorithmHyperParameters": { 
            "string" : "string" 
         }
      }
   }
}
```

## Elementos de respuesta
<a name="API_DescribeSolutionVersion_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [solutionVersion](#API_DescribeSolutionVersion_ResponseSyntax) **   <a name="personalize-DescribeSolutionVersion-response-solutionVersion"></a>
La versión de la solución.  
Tipo: objeto [SolutionVersion](API_SolutionVersion.md)

## Errores
<a name="API_DescribeSolutionVersion_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_DescribeSolutionVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSolutionVersion) 

# GetSolutionMetrics
<a name="API_GetSolutionMetrics"></a>

Obtiene las métricas de la versión de solución especificada.

## Sintaxis de la solicitud
<a name="API_GetSolutionMetrics_RequestSyntax"></a>

```
{
   "solutionVersionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_GetSolutionMetrics_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [solutionVersionArn](#API_GetSolutionMetrics_RequestSyntax) **   <a name="personalize-GetSolutionMetrics-request-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de solución para la que se van a obtener métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_GetSolutionMetrics_ResponseSyntax"></a>

```
{
   "metrics": { 
      "string" : number 
   },
   "solutionVersionArn": "string"
}
```

## Elementos de respuesta
<a name="API_GetSolutionMetrics_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [metrics](#API_GetSolutionMetrics_ResponseSyntax) **   <a name="personalize-GetSolutionMetrics-response-metrics"></a>
Las métricas para la versión de la solución. Para obtener más información, consulte [Evaluación de una versión de solución con métricas](https://docs.aws.amazon.com/personalize/latest/dg/working-with-training-metrics.html).  
Tipo: cadena al mapa doble  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.

 ** [solutionVersionArn](#API_GetSolutionMetrics_ResponseSyntax) **   <a name="personalize-GetSolutionMetrics-response-solutionVersionArn"></a>
El mismo ARN de la versión de solución especificado en la solicitud.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_GetSolutionMetrics_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_GetSolutionMetrics_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/GetSolutionMetrics) 

# ListBatchInferenceJobs
<a name="API_ListBatchInferenceJobs"></a>

Obtiene una lista de los trabajos de inferencia por lotes que se han realizado a partir de una versión de solución.

## Sintaxis de la solicitud
<a name="API_ListBatchInferenceJobs_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string",
   "solutionVersionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListBatchInferenceJobs_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [maxResults](#API_ListBatchInferenceJobs_RequestSyntax) **   <a name="personalize-ListBatchInferenceJobs-request-maxResults"></a>
El número máximo de resultados del trabajo de inferencia por lotes que se devolverán en cada página. El valor predeterminado es 100.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListBatchInferenceJobs_RequestSyntax) **   <a name="personalize-ListBatchInferenceJobs-request-nextToken"></a>
El token para solicitar la siguiente página de resultados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

 ** [solutionVersionArn](#API_ListBatchInferenceJobs_RequestSyntax) **   <a name="personalize-ListBatchInferenceJobs-request-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de solución a partir de la que se crearon trabajos de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListBatchInferenceJobs_ResponseSyntax"></a>

```
{
   "batchInferenceJobs": [ 
      { 
         "batchInferenceJobArn": "string",
         "batchInferenceJobMode": "string",
         "creationDateTime": number,
         "failureReason": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "solutionVersionArn": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBatchInferenceJobs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [batchInferenceJobs](#API_ListBatchInferenceJobs_ResponseSyntax) **   <a name="personalize-ListBatchInferenceJobs-response-batchInferenceJobs"></a>
Una lista que contiene información sobre cada trabajo que se devuelve.  
Tipo: matriz de objetos [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListBatchInferenceJobs_ResponseSyntax) **   <a name="personalize-ListBatchInferenceJobs-response-nextToken"></a>
El token que se usará para recuperar la siguiente página de resultados. El valor es `null` cuando no hay más resultados que devolver.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListBatchInferenceJobs_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListBatchInferenceJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListBatchInferenceJobs) 

# ListBatchSegmentJobs
<a name="API_ListBatchSegmentJobs"></a>

Obtiene una lista de los trabajos de segmento por lotes que se han realizado a partir de una versión de solución que especifique.

## Sintaxis de la solicitud
<a name="API_ListBatchSegmentJobs_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string",
   "solutionVersionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListBatchSegmentJobs_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [maxResults](#API_ListBatchSegmentJobs_RequestSyntax) **   <a name="personalize-ListBatchSegmentJobs-request-maxResults"></a>
El número máximo de resultados del trabajo de segmento por lotes que se devolverán en cada página. El valor predeterminado es 100.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListBatchSegmentJobs_RequestSyntax) **   <a name="personalize-ListBatchSegmentJobs-request-nextToken"></a>
El token para solicitar la siguiente página de resultados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

 ** [solutionVersionArn](#API_ListBatchSegmentJobs_RequestSyntax) **   <a name="personalize-ListBatchSegmentJobs-request-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de solución que los trabajos de segmento por lotes utilizaron para generar segmentos por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListBatchSegmentJobs_ResponseSyntax"></a>

```
{
   "batchSegmentJobs": [ 
      { 
         "batchSegmentJobArn": "string",
         "creationDateTime": number,
         "failureReason": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "solutionVersionArn": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListBatchSegmentJobs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [batchSegmentJobs](#API_ListBatchSegmentJobs_ResponseSyntax) **   <a name="personalize-ListBatchSegmentJobs-response-batchSegmentJobs"></a>
Una lista que contiene información sobre cada trabajo que se devuelve.  
Tipo: matriz de objetos [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListBatchSegmentJobs_ResponseSyntax) **   <a name="personalize-ListBatchSegmentJobs-response-nextToken"></a>
El token que se usará para recuperar la siguiente página de resultados. El valor es `null` cuando no hay más resultados que devolver.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListBatchSegmentJobs_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListBatchSegmentJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListBatchSegmentJobs) 

# ListCampaigns
<a name="API_ListCampaigns"></a>

Devuelve una lista de campañas que utilizan la solución dada. Cuando no se especifica una solución, se muestran todas las campañas asociadas a la cuenta. La respuesta proporciona las propiedades para cada campaña, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre las campañas, consulte [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html).

## Sintaxis de la solicitud
<a name="API_ListCampaigns_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string",
   "solutionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListCampaigns_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [maxResults](#API_ListCampaigns_RequestSyntax) **   <a name="personalize-ListCampaigns-request-maxResults"></a>
Número máximo de filas que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListCampaigns_RequestSyntax) **   <a name="personalize-ListCampaigns-request-nextToken"></a>
Un token devuelto en la llamada anterior [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html)para obtener el siguiente conjunto de campañas (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

 ** [solutionArn](#API_ListCampaigns_RequestSyntax) **   <a name="personalize-ListCampaigns-request-solutionArn"></a>
El nombre de recurso de Amazon (ARN) de la solución para la que se mostrarán las campañas. Cuando no se especifica una solución, se muestran todas las campañas asociadas a la cuenta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListCampaigns_ResponseSyntax"></a>

```
{
   "campaigns": [ 
      { 
         "campaignArn": "string",
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListCampaigns_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [campaigns](#API_ListCampaigns_ResponseSyntax) **   <a name="personalize-ListCampaigns-response-campaigns"></a>
Una lista de las campañas.  
Tipo: matriz de objetos [CampaignSummary](API_CampaignSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListCampaigns_ResponseSyntax) **   <a name="personalize-ListCampaigns-response-nextToken"></a>
Un token para obtener el siguiente conjunto de campañas (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListCampaigns_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListCampaigns_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListCampaigns) 

# ListDataDeletionJobs
<a name="API_ListDataDeletionJobs"></a>

Devuelve una lista de los trabajos de eliminación de datos de un grupo de conjuntos de datos ordenados por hora de creación, con el más reciente en primer lugar. Cuando no se especifica un grupo de conjuntos de datos, se enumeran todos los trabajos de eliminación de datos asociados a la cuenta. La respuesta proporciona las propiedades para cada trabajo, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre los trabajos de eliminación de datos, consulte [Eliminación de usuarios](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html).

## Sintaxis de la solicitud
<a name="API_ListDataDeletionJobs_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListDataDeletionJobs_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_ListDataDeletionJobs_RequestSyntax) **   <a name="personalize-ListDataDeletionJobs-request-datasetGroupArn"></a>
Nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos del que se enumeran los trabajos de eliminación de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListDataDeletionJobs_RequestSyntax) **   <a name="personalize-ListDataDeletionJobs-request-maxResults"></a>
Número máximo de trabajos de eliminación de datos que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListDataDeletionJobs_RequestSyntax) **   <a name="personalize-ListDataDeletionJobs-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListDataDeletionJobs` para obtener el siguiente conjunto de trabajos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListDataDeletionJobs_ResponseSyntax"></a>

```
{
   "dataDeletionJobs": [ 
      { 
         "creationDateTime": number,
         "dataDeletionJobArn": "string",
         "datasetGroupArn": "string",
         "failureReason": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListDataDeletionJobs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [dataDeletionJobs](#API_ListDataDeletionJobs_ResponseSyntax) **   <a name="personalize-ListDataDeletionJobs-response-dataDeletionJobs"></a>
Lista de trabajos de eliminación de datos.  
Tipo: matriz de objetos [DataDeletionJobSummary](API_DataDeletionJobSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListDataDeletionJobs_ResponseSyntax) **   <a name="personalize-ListDataDeletionJobs-response-nextToken"></a>
Un token para obtener el siguiente conjunto de trabajos de eliminación de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListDataDeletionJobs_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListDataDeletionJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDataDeletionJobs) 

# ListDatasetExportJobs
<a name="API_ListDatasetExportJobs"></a>

Devuelve una lista de trabajos de exportación de conjuntos de datos que utilizan el conjunto de datos dado. Cuando no se especifica un conjunto de datos, se muestran todos los trabajos de exportación de conjuntos de datos asociados a la cuenta. La respuesta proporciona las propiedades para cada trabajo de exportación de conjuntos de datos, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre los trabajos de exportación de conjuntos de datos, consulte [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html). Para obtener más información sobre los conjuntos de datos, consulte [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html).

## Sintaxis de la solicitud
<a name="API_ListDatasetExportJobs_RequestSyntax"></a>

```
{
   "datasetArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListDatasetExportJobs_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_ListDatasetExportJobs_RequestSyntax) **   <a name="personalize-ListDatasetExportJobs-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos para el que se enumeran los trabajos de exportación de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListDatasetExportJobs_RequestSyntax) **   <a name="personalize-ListDatasetExportJobs-request-maxResults"></a>
Número máximo de trabajos de exportación de conjuntos de datos que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListDatasetExportJobs_RequestSyntax) **   <a name="personalize-ListDatasetExportJobs-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListDatasetExportJobs` para obtener el siguiente conjunto de trabajos de exportación de conjuntos de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListDatasetExportJobs_ResponseSyntax"></a>

```
{
   "datasetExportJobs": [ 
      { 
         "creationDateTime": number,
         "datasetExportJobArn": "string",
         "failureReason": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListDatasetExportJobs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetExportJobs](#API_ListDatasetExportJobs_ResponseSyntax) **   <a name="personalize-ListDatasetExportJobs-response-datasetExportJobs"></a>
Lista de trabajos de exportación de conjuntos de datos.  
Tipo: matriz de objetos [DatasetExportJobSummary](API_DatasetExportJobSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListDatasetExportJobs_ResponseSyntax) **   <a name="personalize-ListDatasetExportJobs-response-nextToken"></a>
Un token para obtener el siguiente conjunto de trabajos de exportación de conjuntos de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListDatasetExportJobs_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListDatasetExportJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetExportJobs) 

# ListDatasetGroups
<a name="API_ListDatasetGroups"></a>

Devuelve una lista de grupos de conjuntos de datos. La respuesta proporciona las propiedades para cada grupo de conjuntos de datos, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre los grupos de conjuntos de datos, consulte [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html).

## Sintaxis de la solicitud
<a name="API_ListDatasetGroups_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListDatasetGroups_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [maxResults](#API_ListDatasetGroups_RequestSyntax) **   <a name="personalize-ListDatasetGroups-request-maxResults"></a>
Número máximo de grupos de conjuntos de datos que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListDatasetGroups_RequestSyntax) **   <a name="personalize-ListDatasetGroups-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListDatasetGroups` para obtener el siguiente conjunto de grupos de conjuntos de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListDatasetGroups_ResponseSyntax"></a>

```
{
   "datasetGroups": [ 
      { 
         "creationDateTime": number,
         "datasetGroupArn": "string",
         "domain": "string",
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListDatasetGroups_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetGroups](#API_ListDatasetGroups_ResponseSyntax) **   <a name="personalize-ListDatasetGroups-response-datasetGroups"></a>
La lista de sus grupos de conjuntos de datos.  
Tipo: matriz de objetos [DatasetGroupSummary](API_DatasetGroupSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListDatasetGroups_ResponseSyntax) **   <a name="personalize-ListDatasetGroups-response-nextToken"></a>
Un token para obtener el siguiente conjunto de grupos de conjuntos de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListDatasetGroups_Errors"></a>

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListDatasetGroups_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetGroups) 

# ListDatasetImportJobs
<a name="API_ListDatasetImportJobs"></a>

Devuelve una lista de trabajos de importación de conjuntos de datos que utilizan el conjunto de datos dado. Cuando no se especifica un conjunto de datos, se muestran todos los trabajos de importación de conjuntos de datos asociados a la cuenta. La respuesta proporciona las propiedades para cada trabajo de importación de conjuntos de datos, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre los trabajos de importación de conjuntos de datos, consulte [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html). Para obtener más información sobre los conjuntos de datos, consulte [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html).

## Sintaxis de la solicitud
<a name="API_ListDatasetImportJobs_RequestSyntax"></a>

```
{
   "datasetArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListDatasetImportJobs_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="personalize-ListDatasetImportJobs-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos para el que se enumeran los trabajos de importación de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="personalize-ListDatasetImportJobs-request-maxResults"></a>
Número máximo de trabajos de importación de conjuntos de datos que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="personalize-ListDatasetImportJobs-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListDatasetImportJobs` para obtener el siguiente conjunto de trabajos de importación de conjuntos de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListDatasetImportJobs_ResponseSyntax"></a>

```
{
   "datasetImportJobs": [ 
      { 
         "creationDateTime": number,
         "datasetImportJobArn": "string",
         "failureReason": "string",
         "importMode": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListDatasetImportJobs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetImportJobs](#API_ListDatasetImportJobs_ResponseSyntax) **   <a name="personalize-ListDatasetImportJobs-response-datasetImportJobs"></a>
Lista de trabajos de importación de conjuntos de datos.  
Tipo: matriz de objetos [DatasetImportJobSummary](API_DatasetImportJobSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListDatasetImportJobs_ResponseSyntax) **   <a name="personalize-ListDatasetImportJobs-response-nextToken"></a>
Un token para obtener el siguiente conjunto de trabajos de importación de conjuntos de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListDatasetImportJobs_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListDatasetImportJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetImportJobs) 

# ListDatasets
<a name="API_ListDatasets"></a>

Devuelve la lista de conjuntos de datos contenidos en el grupo de conjuntos de datos dado. La respuesta proporciona las propiedades para cada conjunto de datos, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre los conjuntos de datos, consulte [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html).

## Sintaxis de la solicitud
<a name="API_ListDatasets_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListDatasets_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_ListDatasets_RequestSyntax) **   <a name="personalize-ListDatasets-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que contiene los conjuntos de datos que se van a enumerar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListDatasets_RequestSyntax) **   <a name="personalize-ListDatasets-request-maxResults"></a>
Número máximo de conjuntos de datos que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListDatasets_RequestSyntax) **   <a name="personalize-ListDatasets-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListDatasets` para obtener el siguiente conjunto de trabajos de importación de conjuntos de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListDatasets_ResponseSyntax"></a>

```
{
   "datasets": [ 
      { 
         "creationDateTime": number,
         "datasetArn": "string",
         "datasetType": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListDatasets_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasets](#API_ListDatasets_ResponseSyntax) **   <a name="personalize-ListDatasets-response-datasets"></a>
Una matriz de objetos `Dataset`. Cada objeto proporciona información de metadatos.  
Tipo: matriz de objetos [DatasetSummary](API_DatasetSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListDatasets_ResponseSyntax) **   <a name="personalize-ListDatasets-response-nextToken"></a>
Un token para obtener el siguiente conjunto de conjuntos de datos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListDatasets_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListDatasets_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasets) 

# ListEventTrackers
<a name="API_ListEventTrackers"></a>

Devuelve la lista de rastreadores de eventos asociados a la cuenta. La respuesta proporciona las propiedades para cada rastreador de eventos, incluido el nombre de recurso de Amazon (ARN) y el ID de seguimiento. Para obtener más información sobre los rastreadores de eventos, consulte [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html).

## Sintaxis de la solicitud
<a name="API_ListEventTrackers_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListEventTrackers_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_ListEventTrackers_RequestSyntax) **   <a name="personalize-ListEventTrackers-request-datasetGroupArn"></a>
El ARN de un grupo de conjuntos de datos utilizado para filtrar la respuesta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListEventTrackers_RequestSyntax) **   <a name="personalize-ListEventTrackers-request-maxResults"></a>
Número máximo de rastreadores de eventos que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListEventTrackers_RequestSyntax) **   <a name="personalize-ListEventTrackers-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListEventTrackers` para obtener el siguiente conjunto de rastreadores de eventos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListEventTrackers_ResponseSyntax"></a>

```
{
   "eventTrackers": [ 
      { 
         "creationDateTime": number,
         "eventTrackerArn": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListEventTrackers_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [eventTrackers](#API_ListEventTrackers_ResponseSyntax) **   <a name="personalize-ListEventTrackers-response-eventTrackers"></a>
Una lista de rastreadores de eventos.  
Tipo: matriz de objetos [EventTrackerSummary](API_EventTrackerSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListEventTrackers_ResponseSyntax) **   <a name="personalize-ListEventTrackers-response-nextToken"></a>
Un token para obtener el siguiente conjunto de rastreadores de eventos (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListEventTrackers_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListEventTrackers_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListEventTrackers) 

# ListFilters
<a name="API_ListFilters"></a>

Enumera todos los filtros que pertenecen a un grupo de conjuntos de datos determinado.

## Sintaxis de la solicitud
<a name="API_ListFilters_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListFilters_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_ListFilters_RequestSyntax) **   <a name="personalize-ListFilters-request-datasetGroupArn"></a>
El ARN del grupo de conjuntos de datos que contiene los filtros.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListFilters_RequestSyntax) **   <a name="personalize-ListFilters-request-maxResults"></a>
Número máximo de filtros que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListFilters_RequestSyntax) **   <a name="personalize-ListFilters-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListFilters` para obtener el siguiente conjunto de filtros (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListFilters_ResponseSyntax"></a>

```
{
   "Filters": [ 
      { 
         "creationDateTime": number,
         "datasetGroupArn": "string",
         "failureReason": "string",
         "filterArn": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListFilters_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Filters](#API_ListFilters_ResponseSyntax) **   <a name="personalize-ListFilters-response-Filters"></a>
Lista de filtros devueltos.  
Tipo: matriz de objetos [FilterSummary](API_FilterSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListFilters_ResponseSyntax) **   <a name="personalize-ListFilters-response-nextToken"></a>
Un token para obtener el siguiente conjunto de filtros (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListFilters_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListFilters_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListFilters) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListFilters) 

# ListMetricAttributionMetrics
<a name="API_ListMetricAttributionMetrics"></a>

Enumera las métricas de la atribución de métricas.

## Sintaxis de la solicitud
<a name="API_ListMetricAttributionMetrics_RequestSyntax"></a>

```
{
   "maxResults": number,
   "metricAttributionArn": "string",
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListMetricAttributionMetrics_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [maxResults](#API_ListMetricAttributionMetrics_RequestSyntax) **   <a name="personalize-ListMetricAttributionMetrics-request-maxResults"></a>
El número máximo de métricas que se devolverán en una página de resultados.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [metricAttributionArn](#API_ListMetricAttributionMetrics_RequestSyntax) **   <a name="personalize-ListMetricAttributionMetrics-request-metricAttributionArn"></a>
El nombre de recurso de Amazon (ARN) de la atribución de métricas para la que se recuperarán atributos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [nextToken](#API_ListMetricAttributionMetrics_RequestSyntax) **   <a name="personalize-ListMetricAttributionMetrics-request-nextToken"></a>
Especifique el token de paginación de una solicitud anterior para recuperar la siguiente página de resultados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListMetricAttributionMetrics_ResponseSyntax"></a>

```
{
   "metrics": [ 
      { 
         "eventType": "string",
         "expression": "string",
         "metricName": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListMetricAttributionMetrics_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [metrics](#API_ListMetricAttributionMetrics_ResponseSyntax) **   <a name="personalize-ListMetricAttributionMetrics-response-metrics"></a>
Las métricas de la atribución de métricas especificada.  
Tipo: matriz de objetos [MetricAttribute](API_MetricAttribute.md)  
Miembros de la matriz: número máximo de 10 elementos.

 ** [nextToken](#API_ListMetricAttributionMetrics_ResponseSyntax) **   <a name="personalize-ListMetricAttributionMetrics-response-nextToken"></a>
Especifique el token de paginación de una solicitud `ListMetricAttributionMetricsResponse` anterior para recuperar la siguiente página de resultados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListMetricAttributionMetrics_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListMetricAttributionMetrics_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListMetricAttributionMetrics) 

# ListMetricAttributions
<a name="API_ListMetricAttributions"></a>

Enumera las atribuciones de métricas.

## Sintaxis de la solicitud
<a name="API_ListMetricAttributions_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListMetricAttributions_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_ListMetricAttributions_RequestSyntax) **   <a name="personalize-ListMetricAttributions-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos de las atribuciones de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListMetricAttributions_RequestSyntax) **   <a name="personalize-ListMetricAttributions-request-maxResults"></a>
El número máximo de atribuciones de métricas que se devolverán en una página de resultados.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListMetricAttributions_RequestSyntax) **   <a name="personalize-ListMetricAttributions-request-nextToken"></a>
Especifique el token de paginación de una solicitud anterior para recuperar la siguiente página de resultados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListMetricAttributions_ResponseSyntax"></a>

```
{
   "metricAttributions": [ 
      { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "metricAttributionArn": "string",
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Elementos de respuesta
<a name="API_ListMetricAttributions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [metricAttributions](#API_ListMetricAttributions_ResponseSyntax) **   <a name="personalize-ListMetricAttributions-response-metricAttributions"></a>
La lista de atribuciones de métricas.  
Tipo: matriz de objetos [MetricAttributionSummary](API_MetricAttributionSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

 ** [nextToken](#API_ListMetricAttributions_ResponseSyntax) **   <a name="personalize-ListMetricAttributions-response-nextToken"></a>
Especifique el token de paginación de una solicitud anterior para recuperar la siguiente página de resultados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

## Errores
<a name="API_ListMetricAttributions_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListMetricAttributions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListMetricAttributions) 

# ListRecipes
<a name="API_ListRecipes"></a>

Devuelve una lista de recetas disponibles. La respuesta proporciona las propiedades para cada receta, incluido el nombre de recurso de Amazon (ARN) de la receta.

## Sintaxis de la solicitud
<a name="API_ListRecipes_RequestSyntax"></a>

```
{
   "domain": "string",
   "maxResults": number,
   "nextToken": "string",
   "recipeProvider": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListRecipes_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [domain](#API_ListRecipes_RequestSyntax) **   <a name="personalize-ListRecipes-request-domain"></a>
 Filtra recetas devueltas por dominio para un grupo de conjuntos de datos de dominio. En la respuesta solo se incluyen las recetas (casos de uso del grupo de conjuntos de datos de dominio) para este dominio. Si no especifica ningún dominio, se devuelven todas las recetas.   
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND`   
Obligatorio: no

 ** [maxResults](#API_ListRecipes_RequestSyntax) **   <a name="personalize-ListRecipes-request-maxResults"></a>
El número máximo de recetas que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListRecipes_RequestSyntax) **   <a name="personalize-ListRecipes-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListRecipes` para obtener el siguiente conjunto de recetas (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

 ** [recipeProvider](#API_ListRecipes_RequestSyntax) **   <a name="personalize-ListRecipes-request-recipeProvider"></a>
El valor predeterminado es `SERVICE`.  
Tipo: cadena  
Valores válidos: `SERVICE`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListRecipes_ResponseSyntax"></a>

```
{
   "nextToken": "string",
   "recipes": [ 
      { 
         "creationDateTime": number,
         "domain": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "recipeArn": "string",
         "status": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRecipes_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [nextToken](#API_ListRecipes_ResponseSyntax) **   <a name="personalize-ListRecipes-response-nextToken"></a>
Un token para obtener el siguiente conjunto de recetas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

 ** [recipes](#API_ListRecipes_ResponseSyntax) **   <a name="personalize-ListRecipes-response-recipes"></a>
La lista de recetas disponibles.  
Tipo: matriz de objetos [RecipeSummary](API_RecipeSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

## Errores
<a name="API_ListRecipes_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListRecipes_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListRecipes) 

# ListRecommenders
<a name="API_ListRecommenders"></a>

Devuelve una lista de los recomendadores de un grupo de conjuntos de datos de dominio determinado. Cuando no se especifica un grupo de conjuntos de datos de dominio, se muestran todos los recomendadores asociados a la cuenta. La respuesta proporciona las propiedades de cada recomendador, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre los recomendantes, consulte [CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html).

## Sintaxis de la solicitud
<a name="API_ListRecommenders_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListRecommenders_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_ListRecommenders_RequestSyntax) **   <a name="personalize-ListRecommenders-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos de dominio para el que se van a enumerar los recomendadores. Cuando no se especifica un grupo de conjuntos de datos de dominio, se muestran todos los recomendadores asociados a la cuenta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListRecommenders_RequestSyntax) **   <a name="personalize-ListRecommenders-request-maxResults"></a>
El número máximo de recomendadores que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListRecommenders_RequestSyntax) **   <a name="personalize-ListRecommenders-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListRecommenders` para obtener el siguiente conjunto de recomendadores (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListRecommenders_ResponseSyntax"></a>

```
{
   "nextToken": "string",
   "recommenders": [ 
      { 
         "creationDateTime": number,
         "datasetGroupArn": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "recipeArn": "string",
         "recommenderArn": "string",
         "recommenderConfig": { 
            "enableMetadataWithRecommendations": boolean,
            "itemExplorationConfig": { 
               "string" : "string" 
            },
            "minRecommendationRequestsPerSecond": number,
            "trainingDataConfig": { 
               "excludedDatasetColumns": { 
                  "string" : [ "string" ]
               },
               "includedDatasetColumns": { 
                  "string" : [ "string" ]
               }
            }
         },
         "status": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListRecommenders_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [nextToken](#API_ListRecommenders_ResponseSyntax) **   <a name="personalize-ListRecommenders-response-nextToken"></a>
Un token para obtener el siguiente conjunto de recomendaciones (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

 ** [recommenders](#API_ListRecommenders_ResponseSyntax) **   <a name="personalize-ListRecommenders-response-recommenders"></a>
Una lista de los recomendadores.  
Tipo: matriz de objetos [RecommenderSummary](API_RecommenderSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

## Errores
<a name="API_ListRecommenders_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListRecommenders_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListRecommenders) 

# ListSchemas
<a name="API_ListSchemas"></a>

Devuelve la lista de esquemas asociados a la cuenta. La respuesta proporciona las propiedades para cada esquema, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre los esquemas, consulte [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html).

## Sintaxis de la solicitud
<a name="API_ListSchemas_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListSchemas_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [maxResults](#API_ListSchemas_RequestSyntax) **   <a name="personalize-ListSchemas-request-maxResults"></a>
Número máximo de esquemas que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListSchemas_RequestSyntax) **   <a name="personalize-ListSchemas-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListSchemas` para obtener el siguiente conjunto de esquemas (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListSchemas_ResponseSyntax"></a>

```
{
   "nextToken": "string",
   "schemas": [ 
      { 
         "creationDateTime": number,
         "domain": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "schemaArn": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListSchemas_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [nextToken](#API_ListSchemas_ResponseSyntax) **   <a name="personalize-ListSchemas-response-nextToken"></a>
Un token que se utiliza para obtener el siguiente conjunto de esquemas (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

 ** [schemas](#API_ListSchemas_ResponseSyntax) **   <a name="personalize-ListSchemas-response-schemas"></a>
Una lista de esquemas.  
Tipo: matriz de objetos [DatasetSchemaSummary](API_DatasetSchemaSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

## Errores
<a name="API_ListSchemas_Errors"></a>

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListSchemas_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSchemas) 

# ListSolutions
<a name="API_ListSolutions"></a>

Devuelve una lista de soluciones de un grupo de conjuntos de datos dado. Cuando no se especifica un grupo de conjuntos de datos, se muestran todas las soluciones asociadas a la cuenta. La respuesta proporciona las propiedades para cada solución, incluido el nombre de recurso de Amazon (ARN). Para obtener más información sobre las soluciones, consulte [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html).

## Sintaxis de la solicitud
<a name="API_ListSolutions_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListSolutions_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_ListSolutions_RequestSyntax) **   <a name="personalize-ListSolutions-request-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [maxResults](#API_ListSolutions_RequestSyntax) **   <a name="personalize-ListSolutions-request-maxResults"></a>
Número máximo de soluciones que se devolverán.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListSolutions_RequestSyntax) **   <a name="personalize-ListSolutions-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListSolutions` para obtener el siguiente conjunto de soluciones (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListSolutions_ResponseSyntax"></a>

```
{
   "nextToken": "string",
   "solutions": [ 
      { 
         "creationDateTime": number,
         "lastUpdatedDateTime": number,
         "name": "string",
         "recipeArn": "string",
         "solutionArn": "string",
         "status": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListSolutions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [nextToken](#API_ListSolutions_ResponseSyntax) **   <a name="personalize-ListSolutions-response-nextToken"></a>
Un token para obtener el siguiente conjunto de soluciones (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

 ** [solutions](#API_ListSolutions_ResponseSyntax) **   <a name="personalize-ListSolutions-response-solutions"></a>
Una lista de las soluciones actuales.  
Tipo: matriz de objetos [SolutionSummary](API_SolutionSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

## Errores
<a name="API_ListSolutions_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListSolutions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSolutions) 

# ListSolutionVersions
<a name="API_ListSolutionVersions"></a>

Devuelve una lista de las versiones de solución de la solución dada. Cuando no se especifica una solución, se muestran todas las versiones de solución asociadas a la cuenta. La respuesta proporciona las propiedades para cada versión de solución, incluido el nombre de recurso de Amazon (ARN).

## Sintaxis de la solicitud
<a name="API_ListSolutionVersions_RequestSyntax"></a>

```
{
   "maxResults": number,
   "nextToken": "string",
   "solutionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListSolutionVersions_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [maxResults](#API_ListSolutionVersions_RequestSyntax) **   <a name="personalize-ListSolutionVersions-request-maxResults"></a>
Número máximo de versiones de solución que se van a devolver.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [nextToken](#API_ListSolutionVersions_RequestSyntax) **   <a name="personalize-ListSolutionVersions-request-nextToken"></a>
Un token devuelto por la llamada anterior a `ListSolutionVersions` para obtener el siguiente conjunto de versiones de solución (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}`   
Obligatorio: no

 ** [solutionArn](#API_ListSolutionVersions_RequestSyntax) **   <a name="personalize-ListSolutionVersions-request-solutionArn"></a>
El nombre de recurso de Amazon (ARN) de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_ListSolutionVersions_ResponseSyntax"></a>

```
{
   "nextToken": "string",
   "solutionVersions": [ 
      { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "solutionVersionArn": "string",
         "status": "string",
         "trainingMode": "string",
         "trainingType": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListSolutionVersions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [nextToken](#API_ListSolutionVersions_ResponseSyntax) **   <a name="personalize-ListSolutionVersions-response-nextToken"></a>
Un token para obtener el siguiente conjunto de versiones de solución (si existen).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1500 caracteres.  
Patrón: `\p{ASCII}{0,1500}` 

 ** [solutionVersions](#API_ListSolutionVersions_ResponseSyntax) **   <a name="personalize-ListSolutionVersions-response-solutionVersions"></a>
Una lista de las versiones de solución que describe las propiedades de la versión.  
Tipo: matriz de objetos [SolutionVersionSummary](API_SolutionVersionSummary.md)  
Miembros de la matriz: número máximo de 100 elementos.

## Errores
<a name="API_ListSolutionVersions_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** InvalidNextTokenException **   
El token no es válido.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListSolutionVersions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSolutionVersions) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Obtenga una lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) adjuntas a un recurso.

## Sintaxis de la solicitud
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
{
   "resourceArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_ListTagsForResource_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="personalize-ListTagsForResource-request-resourceArn"></a>
El nombre de recurso de Amazon (ARN) del recurso.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
{
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Elementos de respuesta
<a name="API_ListTagsForResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="personalize-ListTagsForResource-response-tags"></a>
Etiquetas del recurso.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

## Errores
<a name="API_ListTagsForResource_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListTagsForResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListTagsForResource) 

# StartRecommender
<a name="API_StartRecommender"></a>

Inicia un recomendador con el estado INACTIVE. El inicio de un recomendador no crea ningún modelo nuevo, sino que reanuda la facturación y el reentrenamiento automático del recomendador.

## Sintaxis de la solicitud
<a name="API_StartRecommender_RequestSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_StartRecommender_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [recommenderArn](#API_StartRecommender_RequestSyntax) **   <a name="personalize-StartRecommender-request-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador que se va a iniciar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_StartRecommender_ResponseSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

## Elementos de respuesta
<a name="API_StartRecommender_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [recommenderArn](#API_StartRecommender_ResponseSyntax) **   <a name="personalize-StartRecommender-response-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador iniciado.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_StartRecommender_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_StartRecommender_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StartRecommender) 

# StopRecommender
<a name="API_StopRecommender"></a>

Detiene un recomendador que está en estado ACTIVE. La detención de un recomendador detiene la facturación y su reentrenamiento automático.

## Sintaxis de la solicitud
<a name="API_StopRecommender_RequestSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_StopRecommender_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [recommenderArn](#API_StopRecommender_RequestSyntax) **   <a name="personalize-StopRecommender-request-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador que se va a detener.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_StopRecommender_ResponseSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

## Elementos de respuesta
<a name="API_StopRecommender_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [recommenderArn](#API_StopRecommender_ResponseSyntax) **   <a name="personalize-StopRecommender-response-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador detenido.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_StopRecommender_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_StopRecommender_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StopRecommender) 

# StopSolutionVersionCreation
<a name="API_StopSolutionVersionCreation"></a>

Detiene la creación de una versión de la solución que se encuentra en el estado CREATE\$1PENDING o CREATE IN\$1PROGRESS. 

Según el estado actual de la versión de la solución, el estado de la versión de la solución cambia de la siguiente manera:
+ CREATE\$1PENDING > CREATE\$1STOPPED

  o
+ CREATE\$1IN\$1PROGRESS > CREATE\$1STOPPING > CREATE\$1STOPPED

Se le facturará todo el entrenamiento completado hasta que detenga la creación de la versión de la solución. No podrá reanudar la creación de una versión de la solución una vez que se haya detenido.

## Sintaxis de la solicitud
<a name="API_StopSolutionVersionCreation_RequestSyntax"></a>

```
{
   "solutionVersionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_StopSolutionVersionCreation_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [solutionVersionArn](#API_StopSolutionVersionCreation_RequestSyntax) **   <a name="personalize-StopSolutionVersionCreation-request-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de la solución que desea dejar de crear.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_StopSolutionVersionCreation_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_StopSolutionVersionCreation_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_StopSolutionVersionCreation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StopSolutionVersionCreation) 

# TagResource
<a name="API_TagResource"></a>

Agregue una lista de etiquetas a un recurso.

## Sintaxis de la solicitud
<a name="API_TagResource_RequestSyntax"></a>

```
{
   "resourceArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_TagResource_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="personalize-TagResource-request-resourceArn"></a>
El nombre de recurso de Amazon (ARN) del recurso.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="personalize-TagResource-request-tags"></a>
Las etiquetas que se aplicarán al recurso. Para obtener más información, consulte [Etiquetado de recursos de Amazon Personalize](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html).  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: sí

## Elementos de respuesta
<a name="API_TagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_TagResource_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagsException **   
Ha superado el número máximo de etiquetas que puede aplicar a este recurso.   
Código de estado HTTP: 400

## Véase también
<a name="API_TagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/TagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/TagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/TagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/TagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/TagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/TagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/TagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Elimina las etiquetas especificadas que están adjuntas a un recurso. Para obtener más información, consulte [Eliminación de etiquetas de los recursos de Amazon Personalize](https://docs.aws.amazon.com/personalize/latest/dg/tags-remove.html).

## Sintaxis de la solicitud
<a name="API_UntagResource_RequestSyntax"></a>

```
{
   "resourceArn": "string",
   "tagKeys": [ "string" ]
}
```

## Parámetros de la solicitud
<a name="API_UntagResource_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="personalize-UntagResource-request-resourceArn"></a>
El nombre de recurso de Amazon (ARN) del recurso.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="personalize-UntagResource-request-tagKeys"></a>
Las claves de las etiquetas que se van a eliminar.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.  
Patrón: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
Obligatorio: sí

## Elementos de respuesta
<a name="API_UntagResource_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UntagResource_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

 ** TooManyTagKeysException **   
La solicitud contiene más claves de etiqueta de las que se pueden asociar a un recurso (50 claves de etiqueta por recurso).   
Código de estado HTTP: 400

## Véase también
<a name="API_UntagResource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UntagResource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UntagResource) 

# UpdateCampaign
<a name="API_UpdateCampaign"></a>

 Actualiza una campaña para implementar una versión de solución reentrenada con una campaña existente, cambiar `minProvisionedTPS` de la campaña o modificar la configuración de la campaña. Por ejemplo, puede establecer `enableMetadataWithRecommendations` en true en el caso de una campaña existente.

 Para actualizar una campaña a fin de que comience automáticamente con la versión más reciente de la solución, especifique lo siguiente:
+ Para el parámetro `SolutionVersionArn`, especifique el nombre de recurso de Amazon (ARN) de la solución en el formato `SolutionArn/$LATEST`. 
+  En `campaignConfig`, establezca `syncWithLatestSolutionVersion` en `true`. 

Para actualizar una campaña, el estado de la campaña debe ser ACTIVE o CREATE FAILED. Comprueba el estado de la campaña mediante la [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html)operación.

**nota**  
Puede seguir recibiendo recomendaciones de una campaña mientras haya una actualización en curso. La campaña utilizará la versión de la solución y la configuración de la campaña anterior para generar recomendaciones hasta que el estado de la última actualización de la campaña sea `Active`. 

Para obtener más información sobre la actualización de una campaña, incluidos ejemplos de código, consulte [Actualización de una campaña](https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html). Para obtener información acerca de las campañas, consulte [Creación de una campaña](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html).

## Sintaxis de la solicitud
<a name="API_UpdateCampaign_RequestSyntax"></a>

```
{
   "campaignArn": "string",
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      },
      "syncWithLatestSolutionVersion": boolean
   },
   "minProvisionedTPS": number,
   "solutionVersionArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateCampaign_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [campaignArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [campaignConfig](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignConfig"></a>
Los detalles de la configuración de una campaña.  
Tipo: objeto [CampaignConfig](API_CampaignConfig.md)  
Obligatorio: no

 ** [minProvisionedTPS](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-minProvisionedTPS"></a>
Especifica el número mínimo de transacciones aprovisionadas (recomendaciones) por segundo solicitadas que Amazon Personalize va a admitir. Un valor elevado de `minProvisionedTPS` aumentará su factura. Le recomendamos empezar con 1 para `minProvisionedTPS` (el valor predeterminado). Realiza un seguimiento de tu consumo mediante CloudWatch las métricas de Amazon y `minProvisionedTPS` auméntalas según sea necesario.  
Tipo: entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** [solutionVersionArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-solutionVersionArn"></a>
Nombre de recurso de Amazon (ARN) del nuevo modelo que se va a implementar. Para especificar la versión más reciente de la solución, especifique el ARN de la *solución* en formato `SolutionArn/$LATEST`. Debes usar este formato si lo `syncWithLatestSolutionVersion` configuras `True` en [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html).   
 Para implementar un modelo que no sea la última versión de solución, especifique el ARN de la versión de solución.   
 Para obtener más información sobre las actualizaciones de campaña automáticas, consulte [Habilitación de las actualizaciones de campaña automáticas](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update).   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateCampaign_ResponseSyntax"></a>

```
{
   "campaignArn": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateCampaign_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [campaignArn](#API_UpdateCampaign_ResponseSyntax) **   <a name="personalize-UpdateCampaign-response-campaignArn"></a>
El mismo ARN de campaña que figura en la solicitud.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_UpdateCampaign_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateCampaign_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateCampaign) 

# UpdateDataset
<a name="API_UpdateDataset"></a>

Actualice un conjunto de datos para reemplazar su esquema por uno nuevo o existente. Para obtener más información, consulte [Sustitución del esquema de un conjunto de datos](https://docs.aws.amazon.com/personalize/latest/dg/updating-dataset-schema.html). 

## Sintaxis de la solicitud
<a name="API_UpdateDataset_RequestSyntax"></a>

```
{
   "datasetArn": "string",
   "schemaArn": "string"
}
```

## Parámetros de la solicitud
<a name="API_UpdateDataset_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_UpdateDataset_RequestSyntax) **   <a name="personalize-UpdateDataset-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos que desea actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [schemaArn](#API_UpdateDataset_RequestSyntax) **   <a name="personalize-UpdateDataset-request-schemaArn"></a>
Nombre de recurso de Amazon (ARN) del nuevo esquema que desea utilizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UpdateDataset_ResponseSyntax"></a>

```
{
   "datasetArn": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateDataset_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [datasetArn](#API_UpdateDataset_ResponseSyntax) **   <a name="personalize-UpdateDataset-response-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos que ha actualizado.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_UpdateDataset_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateDataset_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateDataset) 

# UpdateMetricAttribution
<a name="API_UpdateMetricAttribution"></a>

Actualiza una atribución de métricas.

## Sintaxis de la solicitud
<a name="API_UpdateMetricAttribution_RequestSyntax"></a>

```
{
   "addMetrics": [ 
      { 
         "eventType": "string",
         "expression": "string",
         "metricName": "string"
      }
   ],
   "metricAttributionArn": "string",
   "metricsOutputConfig": { 
      "roleArn": "string",
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "removeMetrics": [ "string" ]
}
```

## Parámetros de la solicitud
<a name="API_UpdateMetricAttribution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [addMetrics](#API_UpdateMetricAttribution_RequestSyntax) **   <a name="personalize-UpdateMetricAttribution-request-addMetrics"></a>
Agrega nuevos atributos de métrica a la atribución de métricas.  
Tipo: matriz de objetos [MetricAttribute](API_MetricAttribute.md)  
Miembros de la matriz: número máximo de 10 elementos.  
Obligatorio: no

 ** [metricAttributionArn](#API_UpdateMetricAttribution_RequestSyntax) **   <a name="personalize-UpdateMetricAttribution-request-metricAttributionArn"></a>
El Nombre de recurso de Amazon (ARN) para la atribución de métricas que se va a actualizar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [metricsOutputConfig](#API_UpdateMetricAttribution_RequestSyntax) **   <a name="personalize-UpdateMetricAttribution-request-metricsOutputConfig"></a>
Una configuración de salida para la atribución de métricas.  
Tipo: objeto [MetricAttributionOutput](API_MetricAttributionOutput.md)  
Obligatorio: no

 ** [removeMetrics](#API_UpdateMetricAttribution_RequestSyntax) **   <a name="personalize-UpdateMetricAttribution-request-removeMetrics"></a>
Elimine los atributos de métricas de la atribución de métricas.  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 10 elementos.  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateMetricAttribution_ResponseSyntax"></a>

```
{
   "metricAttributionArn": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateMetricAttribution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [metricAttributionArn](#API_UpdateMetricAttribution_ResponseSyntax) **   <a name="personalize-UpdateMetricAttribution-response-metricAttributionArn"></a>
El nombre de recurso de Amazon (ARN) para la atribución de métricas que ha actualizado.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_UpdateMetricAttribution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
El recurso especificado ya existe.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateMetricAttribution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateMetricAttribution) 

# UpdateRecommender
<a name="API_UpdateRecommender"></a>

Actualiza el recomendador para modificar su configuración. Si actualiza el recomendador para modificar las columnas utilizadas en el entrenamiento, Amazon Personalize inicia automáticamente un reentrenamiento completo de los modelos que respaldan al recomendador. Mientras se completa la actualización, podrá seguir recibiendo recomendaciones del recomendador. El recomendador utiliza la configuración anterior hasta que se complete la actualización. Para realizar un seguimiento del estado de esta actualización, utilice el `latestRecommenderUpdate` devuelto en la operación [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html). 

## Sintaxis de la solicitud
<a name="API_UpdateRecommender_RequestSyntax"></a>

```
{
   "recommenderArn": "string",
   "recommenderConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "minRecommendationRequestsPerSecond": number,
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         },
         "includedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   }
}
```

## Parámetros de la solicitud
<a name="API_UpdateRecommender_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [recommenderArn](#API_UpdateRecommender_RequestSyntax) **   <a name="personalize-UpdateRecommender-request-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador que se va a modificar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [recommenderConfig](#API_UpdateRecommender_RequestSyntax) **   <a name="personalize-UpdateRecommender-request-recommenderConfig"></a>
Los detalles de configuración del recomendador.  
Tipo: objeto [RecommenderConfig](API_RecommenderConfig.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UpdateRecommender_ResponseSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateRecommender_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [recommenderArn](#API_UpdateRecommender_ResponseSyntax) **   <a name="personalize-UpdateRecommender-response-recommenderArn"></a>
El mismo nombre de recurso de Amazon (ARN) de recomendador que se indica en la solicitud.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_UpdateRecommender_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateRecommender_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateRecommender) 

# UpdateSolution
<a name="API_UpdateSolution"></a>

Actualiza una solución de Amazon Personalize para usar una configuración de entrenamiento automático diferente. Al actualizar una solución, puede cambiar si la solución utiliza el entrenamiento automático, así como la frecuencia del entrenamiento. Para obtener más información sobre la actualización de una solución, consulte [Actualización de una solución](https://docs.aws.amazon.com/personalize/latest/dg/updating-solution.html).

Una actualización de solución puede tener uno de los siguientes estados:

CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED

Para obtener el estado de una actualización de la solución, llame a la operación de la [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html)API y busque el estado en`latestSolutionUpdate`. 

## Sintaxis de la solicitud
<a name="API_UpdateSolution_RequestSyntax"></a>

```
{
   "performAutoTraining": boolean,
   "performIncrementalUpdate": boolean,
   "solutionArn": "string",
   "solutionUpdateConfig": { 
      "autoTrainingConfig": { 
         "schedulingExpression": "string"
      },
      "eventsConfig": { 
         "eventParametersList": [ 
            { 
               "eventType": "string",
               "eventValueThreshold": number,
               "weight": number
            }
         ]
      }
   }
}
```

## Parámetros de la solicitud
<a name="API_UpdateSolution_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [performAutoTraining](#API_UpdateSolution_RequestSyntax) **   <a name="personalize-UpdateSolution-request-performAutoTraining"></a>
Indica si la solución utiliza el entrenamiento automático para crear nuevas versiones de solución (modelos entrenados). Puede cambiar la frecuencia de entrenamiento mediante la especificación de `schedulingExpression` en `AutoTrainingConfig` como parte de la configuración de la solución.   
 Si activa el entrenamiento automático, el primero comenzará una hora después de que se complete la actualización de la solución. Si crea de forma manual una versión de solución en menos de una hora, la solución omitirá el primer entrenamiento automático. Para obtener más información sobre el entrenamiento automático, consulte [Configuración del entrenamiento automático](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html).   
 Una vez que comience la capacitación, podrá obtener el nombre de recurso de Amazon (ARN) de la versión de la solución con la operación de [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Para obtener su estado, utilice. [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html)   
Tipo: Booleano  
Obligatorio: no

 ** [performIncrementalUpdate](#API_UpdateSolution_RequestSyntax) **   <a name="personalize-UpdateSolution-request-performIncrementalUpdate"></a>
Si desea realizar actualizaciones de entrenamiento incrementales en su modelo. Cuando está activado, permite que el modelo aprenda de los nuevos datos con mayor frecuencia sin necesidad de volver a capacitarse por completo, lo que permite una personalización prácticamente en tiempo real. Este parámetro solo es compatible con las soluciones que utilizan la receta de similitud semántica.  
Tipo: Booleano  
Obligatorio: no

 ** [solutionArn](#API_UpdateSolution_RequestSyntax) **   <a name="personalize-UpdateSolution-request-solutionArn"></a>
Nombre de recurso de Amazon (ARN) de la solución que se actualizará.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [solutionUpdateConfig](#API_UpdateSolution_RequestSyntax) **   <a name="personalize-UpdateSolution-request-solutionUpdateConfig"></a>
Nuevos detalles de configuración de la solución.  
Tipo: objeto [SolutionUpdateConfig](API_SolutionUpdateConfig.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UpdateSolution_ResponseSyntax"></a>

```
{
   "solutionArn": "string"
}
```

## Elementos de respuesta
<a name="API_UpdateSolution_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [solutionArn](#API_UpdateSolution_ResponseSyntax) **   <a name="personalize-UpdateSolution-response-solutionArn"></a>
El mismo nombre de recurso de Amazon (ARN) de solución que se indica en la solicitud.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_UpdateSolution_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha excedido el límite en el número de solicitudes por segundo.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 400

## Véase también
<a name="API_UpdateSolution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateSolution) 

# Eventos de Amazon Personalize
<a name="API_Operations_Amazon_Personalize_Events"></a>

Eventos de Amazon Personalize admite las siguientes acciones:
+  [PutActionInteractions](API_UBS_PutActionInteractions.md) 
+  [PutActions](API_UBS_PutActions.md) 
+  [PutEvents](API_UBS_PutEvents.md) 
+  [PutItems](API_UBS_PutItems.md) 
+  [PutUsers](API_UBS_PutUsers.md) 

# PutActionInteractions
<a name="API_UBS_PutActionInteractions"></a>

Registra los datos de los eventos de interacción de acciones. Un evento de *interacción de acciones* es una interacción entre un usuario y una *acción*. Por ejemplo, un usuario que realiza una acción, como inscribirse en un programa para miembros o descargar su aplicación.

 Para obtener información sobre cómo registrar interacciones de acción, consulte [Registro de eventos de interacción de acciones](https://docs.aws.amazon.com/personalize/latest/dg/recording-action-interaction-events.html). Para obtener más información sobre las acciones de un conjunto de datos de acciones, consulte [Conjunto de datos de acciones](https://docs.aws.amazon.com/personalize/latest/dg/actions-datasets.html).

## Sintaxis de la solicitud
<a name="API_UBS_PutActionInteractions_RequestSyntax"></a>

```
POST /action-interactions HTTP/1.1
Content-type: application/json

{
   "actionInteractions": [ 
      { 
         "actionId": "string",
         "eventId": "string",
         "eventType": "string",
         "impression": [ "string" ],
         "properties": "string",
         "recommendationId": "string",
         "sessionId": "string",
         "timestamp": number,
         "userId": "string"
      }
   ],
   "trackingId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_UBS_PutActionInteractions_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_UBS_PutActionInteractions_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [actionInteractions](#API_UBS_PutActionInteractions_RequestSyntax) **   <a name="personalize-UBS_PutActionInteractions-request-actionInteractions"></a>
Lista de los eventos de interacción de acciones de la sesión.  
Tipo: Matriz de [ActionInteraction](API_UBS_ActionInteraction.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 10 elementos.  
Obligatorio: sí

 ** [trackingId](#API_UBS_PutActionInteractions_RequestSyntax) **   <a name="personalize-UBS_PutActionInteractions-request-trackingId"></a>
ID de su rastreador de eventos de interacción de acciones. Cuando crea un conjunto de datos de interacciones de acción, Amazon Personalize crea un rastreador de eventos de interacciones de acción de forma automática. Para obtener más información, consulte [ID del rastreador de eventos de interacciones de acción](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-tracker-id.html).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UBS_PutActionInteractions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UBS_PutActionInteractions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UBS_PutActionInteractions_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 404

## Véase también
<a name="API_UBS_PutActionInteractions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutActionInteractions) 

# PutActions
<a name="API_UBS_PutActions"></a>

Agrega una o más acciones a un conjunto de datos de acciones. Para obtener más información, consulte [Importación de acciones de forma individual](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html). 

## Sintaxis de la solicitud
<a name="API_UBS_PutActions_RequestSyntax"></a>

```
POST /actions HTTP/1.1
Content-type: application/json

{
   "actions": [ 
      { 
         "actionId": "string",
         "properties": "string"
      }
   ],
   "datasetArn": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_UBS_PutActions_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_UBS_PutActions_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [actions](#API_UBS_PutActions_RequestSyntax) **   <a name="personalize-UBS_PutActions-request-actions"></a>
Lista de datos de acciones.  
Tipo: Matriz de [Action](API_UBS_Action.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 10 elementos.  
Obligatorio: sí

 ** [datasetArn](#API_UBS_PutActions_RequestSyntax) **   <a name="personalize-UBS_PutActions-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos de acciones al que está agregando las acciones.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UBS_PutActions_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UBS_PutActions_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UBS_PutActions_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 404

## Véase también
<a name="API_UBS_PutActions_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutActions) 

# PutEvents
<a name="API_UBS_PutEvents"></a>

Registra los datos de los eventos de interacción de elementos. Para obtener más información, consulte [Registro de eventos de interacción de elementos](https://docs.aws.amazon.com/personalize/latest/dg/recording-item-interaction-events.html).

**nota**  
 Si usa una AWS Lambda función para llamar a la PutEvents operación, el rol de ejecución de la función debe tener permiso para realizar la `personalize:PutEvents` acción con el comodín `*` en el `Resource` elemento. 

## Sintaxis de la solicitud
<a name="API_UBS_PutEvents_RequestSyntax"></a>

```
POST /events HTTP/1.1
Content-type: application/json

{
   "eventList": [ 
      { 
         "eventId": "string",
         "eventType": "string",
         "eventValue": number,
         "impression": [ "string" ],
         "itemId": "string",
         "metricAttribution": { 
            "eventAttributionSource": "string"
         },
         "properties": "string",
         "recommendationId": "string",
         "sentAt": number
      }
   ],
   "sessionId": "string",
   "trackingId": "string",
   "userId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_UBS_PutEvents_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_UBS_PutEvents_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [eventList](#API_UBS_PutEvents_RequestSyntax) **   <a name="personalize-UBS_PutEvents-request-eventList"></a>
Una lista de datos de eventos de la sesión.  
Tipo: Matriz de [Event](API_UBS_Event.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 10 elementos.  
Obligatorio: sí

 ** [sessionId](#API_UBS_PutEvents_RequestSyntax) **   <a name="personalize-UBS_PutEvents-request-sessionId"></a>
ID de sesión asociado a la visita del usuario. La aplicación genera el sessionId cuando un usuario visita por primera vez su sitio web o utiliza su aplicación. Amazon Personalize usa el sessionId para asociar eventos con el usuario antes de que inicie sesión. Para obtener más información, consulte [Registro de eventos de interacción de elementos](https://docs.aws.amazon.com/personalize/latest/dg/recording-item-interaction-events.html).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** [trackingId](#API_UBS_PutEvents_RequestSyntax) **   <a name="personalize-UBS_PutEvents-request-trackingId"></a>
ID de seguimiento del evento. El ID se genera mediante una llamada a la [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html)API.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** [userId](#API_UBS_PutEvents_RequestSyntax) **   <a name="personalize-UBS_PutEvents-request-userId"></a>
El usuario asociado al evento.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_UBS_PutEvents_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UBS_PutEvents_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UBS_PutEvents_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

## Véase también
<a name="API_UBS_PutEvents_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutEvents) 

# PutItems
<a name="API_UBS_PutItems"></a>

Agrega uno o más elementos a un conjunto de datos de elementos. Para obtener más información, consulte [Importación de elementos de forma individual](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html). 

## Sintaxis de la solicitud
<a name="API_UBS_PutItems_RequestSyntax"></a>

```
POST /items HTTP/1.1
Content-type: application/json

{
   "datasetArn": "string",
   "items": [ 
      { 
         "itemId": "string",
         "properties": "string"
      }
   ]
}
```

## Parámetros de solicitud del URI
<a name="API_UBS_PutItems_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_UBS_PutItems_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_UBS_PutItems_RequestSyntax) **   <a name="personalize-UBS_PutItems-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos de elementos donde se va a añadir el elemento o elementos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [items](#API_UBS_PutItems_RequestSyntax) **   <a name="personalize-UBS_PutItems-request-items"></a>
Una lista de datos de los elementos.  
Tipo: Matriz de [Item](API_UBS_Item.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 10 elementos.  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UBS_PutItems_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UBS_PutItems_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UBS_PutItems_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 404

## Véase también
<a name="API_UBS_PutItems_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutItems) 

# PutUsers
<a name="API_UBS_PutUsers"></a>

Añade uno o más usuarios a un conjunto de datos de usuarios. Para obtener más información, consulte [Importación de usuarios de forma individual](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html).

## Sintaxis de la solicitud
<a name="API_UBS_PutUsers_RequestSyntax"></a>

```
POST /users HTTP/1.1
Content-type: application/json

{
   "datasetArn": "string",
   "users": [ 
      { 
         "properties": "string",
         "userId": "string"
      }
   ]
}
```

## Parámetros de solicitud del URI
<a name="API_UBS_PutUsers_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_UBS_PutUsers_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetArn](#API_UBS_PutUsers_RequestSyntax) **   <a name="personalize-UBS_PutUsers-request-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos de usuarios donde se va a añadir el usuario o usuarios.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [users](#API_UBS_PutUsers_RequestSyntax) **   <a name="personalize-UBS_PutUsers-request-users"></a>
Una lista de datos de los usuarios.  
Tipo: Matriz de [User](API_UBS_User.md) objetos  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 10 elementos.  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_UBS_PutUsers_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_UBS_PutUsers_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

## Errores
<a name="API_UBS_PutUsers_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
No se ha encontrado el recurso especificado.  
Código de estado HTTP: 404

## Véase también
<a name="API_UBS_PutUsers_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutUsers) 

# Versión ejecutable de Amazon Personalize
<a name="API_Operations_Amazon_Personalize_Runtime"></a>

Versión ejecutable de Amazon Personalize admite las siguientes acciones:
+  [GetActionRecommendations](API_RS_GetActionRecommendations.md) 
+  [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) 
+  [GetRecommendations](API_RS_GetRecommendations.md) 

# GetActionRecommendations
<a name="API_RS_GetActionRecommendations"></a>

Devuelve una lista de acciones recomendadas que se ordenan en orden descendente por puntuación de predicción. Use la API `GetActionRecommendations` si tiene una campaña personalizada que implementa una versión de la solución entrenada con una receta PERSONALIZED\$1ACTIONS. 

Para obtener más información sobre las recetas PERSONALIZED\$1ACTIONS, consulte [Recetas PERSONALIZED\$1ACTIONS](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html). Para obtener más información sobre cómo obtener recomendaciones de acciones, consulte [Obtención de recomendaciones de acciones](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html).

## Sintaxis de la solicitud
<a name="API_RS_GetActionRecommendations_RequestSyntax"></a>

```
POST /action-recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "numResults": number,
   "userId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_RS_GetActionRecommendations_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_RS_GetActionRecommendations_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña que se va a utilizar para obtener recomendaciones de acciones. Esta campaña debe desplegar una versión de la solución entrenada con una receta PERSONALIZED\$1ACTIONS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterArn"></a>
ARN del filtro que se aplicará a las recomendaciones devueltas. Para obtener más información, consulte [Filtrado de recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Cuando utilice este parámetro, asegúrese de que el recurso de filtro sea `ACTIVE`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterValues"></a>
Los valores que se van a utilizar al filtrar las recomendaciones. Para cada parámetro de marcador de posición de la expresión de filtro, proporcione el nombre del parámetro (respetando mayúsculas y minúsculas) como clave y los valores del filtro como valor correspondiente. Separe los valores múltiples de un parámetro con una coma.   
En el caso de las expresiones de filtro que utilizan un elemento `INCLUDE` para incluir acciones, debe proporcionar valores para todos los parámetros definidos en la expresión. En el caso de los filtros con expresiones que utilizan un elemento `EXCLUDE` para excluir acciones, puede omitir `filter-values`. En este caso, Amazon Personalize no utiliza esa parte de la expresión para filtrar recomendaciones.  
Para obtener más información, consulte [Filtrado de recomendaciones y segmentos de usuario](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 25 elementos.  
Limitaciones de longitud de clave: longitud máxima de 50 caracteres.  
Patrón de clave: `[A-Za-z0-9_]+`   
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-numResults"></a>
El número de resultados que se devolverá. El valor predeterminado es 5. El máximo es 100.  
Tipo: entero  
Rango válido: valor mínimo de 0.  
Obligatorio: no

 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-userId"></a>
ID del usuario para el que se van a proporcionar recomendaciones de acciones.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_RS_GetActionRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "actionList": [ 
      { 
         "actionId": "string",
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## Elementos de respuesta
<a name="API_RS_GetActionRecommendations_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-actionList"></a>
Lista de recomendaciones de acciones en orden descendente por puntuación de predicción. Puede haber un máximo de 100 acciones en la lista. Para obtener información sobre las puntuaciones de las acciones, consulte [Cómo funciona la puntuación de recomendaciones de acciones](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html).  
Tipo: matriz de objetos [PredictedAction](API_RS_PredictedAction.md)

 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-recommendationId"></a>
El identificador de la recomendación.  
Tipo: cadena

## Errores
<a name="API_RS_GetActionRecommendations_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
El recurso especificado no existe.  
Código de estado HTTP: 404

## Véase también
<a name="API_RS_GetActionRecommendations_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations) 

# GetPersonalizedRanking
<a name="API_RS_GetPersonalizedRanking"></a>

Cambia el orden de una lista de elementos recomendados para un usuario determinado. Se considera que el primer elemento de la lista es el que puede ser el más interesante para el usuario.

**nota**  
La solución relacionada con la campaña se debe haber creado utilizando una receta del tipo PERSONALIZED\$1RANKING.

## Sintaxis de la solicitud
<a name="API_RS_GetPersonalizedRanking_RequestSyntax"></a>

```
POST /personalize-ranking HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "inputList": [ "string" ],
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "userId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_RS_GetPersonalizedRanking_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_RS_GetPersonalizedRanking_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña que se va a utilizar para generar la clasificación personalizada.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: sí

 ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-context"></a>
Los metadatos contextuales que se utilizarán para obtener recomendaciones. Los metadatos contextuales incluyen cualquier información de interacción que pueda ser relevante a la hora de obtener las recomendaciones de un usuario, como la ubicación actual del usuario o el tipo de dispositivo.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 150 elementos.  
Limitaciones de longitud de clave: longitud máxima de 150 caracteres.  
Patrón de clave: `[A-Za-z\d_]+`   
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterArn"></a>
El nombre de recurso de Amazon (ARN) de un filtro que ha creado para incluir o excluir elementos de las recomendaciones para un usuario determinado. Para obtener más información, consulte [Filtrado de recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterValues"></a>
Los valores que se van a utilizar al filtrar las recomendaciones. Para cada parámetro de marcador de posición de la expresión de filtro, proporcione el nombre del parámetro (respetando mayúsculas y minúsculas) como clave y los valores del filtro como valor correspondiente. Separe los valores múltiples de un parámetro con una coma.   
En el caso de las expresiones de filtro que utilizan un elemento `INCLUDE` para incluir elementos, debe proporcionar valores para todos los parámetros definidos en la expresión. En el caso de los filtros con expresiones que utilizan un objeto `EXCLUDE` para excluir elementos, puede omitir la expresión `filter-values`. En este caso, Amazon Personalize no utiliza esa parte de la expresión para filtrar recomendaciones.  
Para obtener más información, consulte [Filtrado de recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 25 elementos.  
Limitaciones de longitud de clave: longitud máxima de 50 caracteres.  
Patrón de clave: `[A-Za-z0-9_]+`   
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-inputList"></a>
Una lista de elementos (por `itemId`) para clasificar. Si un elemento no estaba incluido en el conjunto de datos de entrenamiento, se añade al final de la lista reclasificada. Si incluye metadatos en las recomendaciones, el máximo es 50. De lo contrario, el máximo es 500.  
Tipo: matriz de cadenas  
Limitaciones de longitud: longitud máxima de 256 caracteres.  
Obligatorio: sí

 ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-metadataColumns"></a>
Si ha habilitado los metadatos en las recomendaciones al crear o actualizar la campaña, especifique las columnas de metadatos del conjunto de datos de elementos que se van a incluir en la clasificación personalizada. La clave de asignación es `ITEMS` y el valor es una lista de nombres de columnas de su conjunto de datos de elementos. El número máximo de columnas que puede proporcionar es 10.  
 Para obtener información sobre cómo habilitar los metadatos para una campaña, consulte [Habilitación de los metadatos en las recomendaciones para una campaña](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata).   
Tipo: mapa de cadena a matriz de cadenas  
Entradas de mapa: número máximo de 1 elemento.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Miembros de la matriz: número máximo de 99 elementos.  
Limitaciones de longitud: longitud máxima de 150 caracteres.  
Obligatorio: no

 ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-userId"></a>
El usuario para el que quiere que la campaña proporcione una clasificación personalizada.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256 caracteres.  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_RS_GetPersonalizedRanking_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "personalizedRanking": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## Elementos de respuesta
<a name="API_RS_GetPersonalizedRanking_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-personalizedRanking"></a>
Una lista de elementos por orden de interés más probable para el usuario. El máximo es 500.  
Tipo: matriz de objetos [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-recommendationId"></a>
El identificador de la recomendación.  
Tipo: cadena

## Errores
<a name="API_RS_GetPersonalizedRanking_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
El recurso especificado no existe.  
Código de estado HTTP: 404

## Véase también
<a name="API_RS_GetPersonalizedRanking_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 

# GetRecommendations
<a name="API_RS_GetRecommendations"></a>

Devuelve una lista de elementos recomendados. Para las campañas, se requiere el nombre del recurso de Amazon (ARN) de la campaña y la entrada requerida de usuario y elemento depende del tipo de receta utilizado para crear la solución que respalda la campaña, de la siguiente manera:
+ USER\$1PERSONALIZATION: `userId` obligatorio, `itemId` no utilizado
+ RELATED\$1ITEMS: `itemId` obligatorio, `userId` no utilizado

**nota**  
Las campañas respaldadas por una solución creada con una receta del tipo PERSONALIZED\$1RANKING utilizan la API [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md).

 Para los recomendadores, se requiere el ARN del recomendador y la entrada requerida de usuario y elemento dependen del caso de uso (receta basada en el dominio) que respalda al recomendador. Para obtener información sobre los requisitos de los casos de uso, consulte [Elección de los casos de uso de un recomendador](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). 

## Sintaxis de la solicitud
<a name="API_RS_GetRecommendations_RequestSyntax"></a>

```
POST /recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "itemId": "string",
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "numResults": number,
   "promotions": [ 
      { 
         "filterArn": "string",
         "filterValues": { 
            "string" : "string" 
         },
         "name": "string",
         "percentPromotedItems": number
      }
   ],
   "recommenderArn": "string",
   "userId": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_RS_GetRecommendations_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_RS_GetRecommendations_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [campaignArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña que se va a utilizar para obtener recomendaciones.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [context](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-context"></a>
Los metadatos contextuales que se utilizarán para obtener recomendaciones. Los metadatos contextuales incluyen cualquier información de interacción que pueda ser relevante a la hora de obtener las recomendaciones de un usuario, como la ubicación actual del usuario o el tipo de dispositivo.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 150 elementos.  
Limitaciones de longitud de clave: longitud máxima de 150 caracteres.  
Patrón de clave: `[A-Za-z\d_]+`   
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** [filterArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-filterArn"></a>
ARN del filtro que se aplicará a las recomendaciones devueltas. Para obtener más información, consulte [Filtrado de recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Cuando utilice este parámetro, asegúrese de que el recurso de filtro sea `ACTIVE`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [filterValues](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-filterValues"></a>
Los valores que se van a utilizar al filtrar las recomendaciones. Para cada parámetro de marcador de posición de la expresión de filtro, proporcione el nombre del parámetro (respetando mayúsculas y minúsculas) como clave y los valores del filtro como valor correspondiente. Separe los valores múltiples de un parámetro con una coma.   
En el caso de las expresiones de filtro que utilizan un elemento `INCLUDE` para incluir elementos, debe proporcionar valores para todos los parámetros definidos en la expresión. En el caso de los filtros con expresiones que utilizan un objeto `EXCLUDE` para excluir elementos, puede omitir la expresión `filter-values`. En este caso, Amazon Personalize no utiliza esa parte de la expresión para filtrar recomendaciones.  
Para obtener más información, consulte [Filtrado de recomendaciones y segmentos de usuario](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 25 elementos.  
Limitaciones de longitud de clave: longitud máxima de 50 caracteres.  
Patrón de clave: `[A-Za-z0-9_]+`   
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** [itemId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-itemId"></a>
El ID del elemento para el que se van a ofrecer recomendaciones.  
Necesario para el tipo de receta `RELATED_ITEMS`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** [metadataColumns](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-metadataColumns"></a>
Si ha habilitado los metadatos en las recomendaciones al crear o actualizar la campaña o el recomendador, especifique las columnas de metadatos del conjunto de datos de elementos que se van a incluir en las recomendaciones de elementos. La clave de asignación es `ITEMS` y el valor es una lista de nombres de columnas de su conjunto de datos de elementos. El número máximo de columnas que puede proporcionar es 10.  
 Para obtener información sobre cómo habilitar los metadatos para una campaña, consulte [Habilitación de los metadatos en las recomendaciones para una campaña](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata). Para obtener información sobre cómo habilitar los metadatos para un recomendador, consulte [Habilitación de los metadatos en las recomendaciones para un recomendador](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata).   
Tipo: mapa de cadena a matriz de cadenas  
Entradas de mapa: número máximo de 1 elemento.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Miembros de la matriz: número máximo de 99 elementos.  
Limitaciones de longitud: longitud máxima de 150 caracteres.  
Obligatorio: no

 ** [numResults](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-numResults"></a>
El número de resultados que se devolverá. El valor predeterminado es 25. Si incluye metadatos en las recomendaciones, el máximo es 50. De lo contrario, el máximo es 500.  
Tipo: entero  
Rango válido: valor mínimo de 0.  
Obligatorio: no

 ** [promotions](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-promotions"></a>
Las promociones que se aplican a la solicitud de recomendación. Una promoción define reglas empresariales adicionales que se aplican a un subconjunto configurable de elementos recomendados.  
Tipo: Matriz de objetos [Promotion](API_RS_Promotion.md)  
Miembros de la matriz: número máximo de 1 elemento.  
Obligatorio: no

 ** [recommenderArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador que se va a utilizar para obtener recomendaciones. Proporcione el ARN de un recomendador si creó un grupo de conjuntos de datos de dominio con un recomendador para un caso de uso de dominio.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** [userId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-userId"></a>
El ID del usuario para el que se van a proporcionar recomendaciones.  
Necesario para el tipo de receta `USER_PERSONALIZATION`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_RS_GetRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "itemList": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

## Elementos de respuesta
<a name="API_RS_GetRecommendations_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [itemList](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-itemList"></a>
Lista de recomendaciones ordenadas en orden descendente por puntuación de predicción. Puede haber un máximo de 500 elementos en la lista.  
Tipo: matriz de objetos [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-recommendationId"></a>
El identificador de la recomendación.  
Tipo: cadena

## Errores
<a name="API_RS_GetRecommendations_Errors"></a>

 ** InvalidInputException **   
Proporcione un valor válido para el campo o el parámetro.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
El recurso especificado no existe.  
Código de estado HTTP: 404

## Véase también
<a name="API_RS_GetRecommendations_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetRecommendations) 

# Data Types
<a name="API_Types"></a>

Amazon Personalize admite los siguientes tipos de datos:
+  [Algorithm](API_Algorithm.md) 
+  [AlgorithmImage](API_AlgorithmImage.md) 
+  [AutoMLConfig](API_AutoMLConfig.md) 
+  [AutoMLResult](API_AutoMLResult.md) 
+  [AutoTrainingConfig](API_AutoTrainingConfig.md) 
+  [BatchInferenceJob](API_BatchInferenceJob.md) 
+  [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) 
+  [BatchInferenceJobInput](API_BatchInferenceJobInput.md) 
+  [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) 
+  [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) 
+  [BatchSegmentJob](API_BatchSegmentJob.md) 
+  [BatchSegmentJobInput](API_BatchSegmentJobInput.md) 
+  [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) 
+  [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) 
+  [Campaign](API_Campaign.md) 
+  [CampaignConfig](API_CampaignConfig.md) 
+  [CampaignSummary](API_CampaignSummary.md) 
+  [CampaignUpdateSummary](API_CampaignUpdateSummary.md) 
+  [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) 
+  [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) 
+  [DataDeletionJob](API_DataDeletionJob.md) 
+  [DataDeletionJobSummary](API_DataDeletionJobSummary.md) 
+  [Dataset](API_Dataset.md) 
+  [DatasetExportJob](API_DatasetExportJob.md) 
+  [DatasetExportJobOutput](API_DatasetExportJobOutput.md) 
+  [DatasetExportJobSummary](API_DatasetExportJobSummary.md) 
+  [DatasetGroup](API_DatasetGroup.md) 
+  [DatasetGroupSummary](API_DatasetGroupSummary.md) 
+  [DatasetImportJob](API_DatasetImportJob.md) 
+  [DatasetImportJobSummary](API_DatasetImportJobSummary.md) 
+  [DatasetSchema](API_DatasetSchema.md) 
+  [DatasetSchemaSummary](API_DatasetSchemaSummary.md) 
+  [DatasetSummary](API_DatasetSummary.md) 
+  [DatasetUpdateSummary](API_DatasetUpdateSummary.md) 
+  [DataSource](API_DataSource.md) 
+  [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) 
+  [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) 
+  [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) 
+  [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) 
+  [EventParameters](API_EventParameters.md) 
+  [EventsConfig](API_EventsConfig.md) 
+  [EventTracker](API_EventTracker.md) 
+  [EventTrackerSummary](API_EventTrackerSummary.md) 
+  [FeatureTransformation](API_FeatureTransformation.md) 
+  [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) 
+  [Filter](API_Filter.md) 
+  [FilterSummary](API_FilterSummary.md) 
+  [HPOConfig](API_HPOConfig.md) 
+  [HPOObjective](API_HPOObjective.md) 
+  [HPOResourceConfig](API_HPOResourceConfig.md) 
+  [HyperParameterRanges](API_HyperParameterRanges.md) 
+  [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) 
+  [MetricAttribute](API_MetricAttribute.md) 
+  [MetricAttribution](API_MetricAttribution.md) 
+  [MetricAttributionOutput](API_MetricAttributionOutput.md) 
+  [MetricAttributionSummary](API_MetricAttributionSummary.md) 
+  [OptimizationObjective](API_OptimizationObjective.md) 
+  [Recipe](API_Recipe.md) 
+  [RecipeSummary](API_RecipeSummary.md) 
+  [Recommender](API_Recommender.md) 
+  [RecommenderConfig](API_RecommenderConfig.md) 
+  [RecommenderSummary](API_RecommenderSummary.md) 
+  [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) 
+  [S3DataConfig](API_S3DataConfig.md) 
+  [Solution](API_Solution.md) 
+  [SolutionConfig](API_SolutionConfig.md) 
+  [SolutionSummary](API_SolutionSummary.md) 
+  [SolutionUpdateConfig](API_SolutionUpdateConfig.md) 
+  [SolutionUpdateSummary](API_SolutionUpdateSummary.md) 
+  [SolutionVersion](API_SolutionVersion.md) 
+  [SolutionVersionSummary](API_SolutionVersionSummary.md) 
+  [Tag](API_Tag.md) 
+  [ThemeGenerationConfig](API_ThemeGenerationConfig.md) 
+  [TrainingDataConfig](API_TrainingDataConfig.md) 
+  [TunedHPOParams](API_TunedHPOParams.md) 

Eventos de Amazon Personalize admite los siguientes tipos de datos:
+  [Action](API_UBS_Action.md) 
+  [ActionInteraction](API_UBS_ActionInteraction.md) 
+  [Event](API_UBS_Event.md) 
+  [Item](API_UBS_Item.md) 
+  [MetricAttribution](API_UBS_MetricAttribution.md) 
+  [User](API_UBS_User.md) 

Versión ejecutable de Amazon Personalize admite los siguientes tipos de datos:
+  [PredictedAction](API_RS_PredictedAction.md) 
+  [PredictedItem](API_RS_PredictedItem.md) 
+  [Promotion](API_RS_Promotion.md) 

# Amazon Personalize
<a name="API_Types_Amazon_Personalize"></a>

Amazon Personalize admite los siguientes tipos de datos:
+  [Algorithm](API_Algorithm.md) 
+  [AlgorithmImage](API_AlgorithmImage.md) 
+  [AutoMLConfig](API_AutoMLConfig.md) 
+  [AutoMLResult](API_AutoMLResult.md) 
+  [AutoTrainingConfig](API_AutoTrainingConfig.md) 
+  [BatchInferenceJob](API_BatchInferenceJob.md) 
+  [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md) 
+  [BatchInferenceJobInput](API_BatchInferenceJobInput.md) 
+  [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md) 
+  [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md) 
+  [BatchSegmentJob](API_BatchSegmentJob.md) 
+  [BatchSegmentJobInput](API_BatchSegmentJobInput.md) 
+  [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md) 
+  [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md) 
+  [Campaign](API_Campaign.md) 
+  [CampaignConfig](API_CampaignConfig.md) 
+  [CampaignSummary](API_CampaignSummary.md) 
+  [CampaignUpdateSummary](API_CampaignUpdateSummary.md) 
+  [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md) 
+  [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md) 
+  [DataDeletionJob](API_DataDeletionJob.md) 
+  [DataDeletionJobSummary](API_DataDeletionJobSummary.md) 
+  [Dataset](API_Dataset.md) 
+  [DatasetExportJob](API_DatasetExportJob.md) 
+  [DatasetExportJobOutput](API_DatasetExportJobOutput.md) 
+  [DatasetExportJobSummary](API_DatasetExportJobSummary.md) 
+  [DatasetGroup](API_DatasetGroup.md) 
+  [DatasetGroupSummary](API_DatasetGroupSummary.md) 
+  [DatasetImportJob](API_DatasetImportJob.md) 
+  [DatasetImportJobSummary](API_DatasetImportJobSummary.md) 
+  [DatasetSchema](API_DatasetSchema.md) 
+  [DatasetSchemaSummary](API_DatasetSchemaSummary.md) 
+  [DatasetSummary](API_DatasetSummary.md) 
+  [DatasetUpdateSummary](API_DatasetUpdateSummary.md) 
+  [DataSource](API_DataSource.md) 
+  [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md) 
+  [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md) 
+  [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md) 
+  [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md) 
+  [EventParameters](API_EventParameters.md) 
+  [EventsConfig](API_EventsConfig.md) 
+  [EventTracker](API_EventTracker.md) 
+  [EventTrackerSummary](API_EventTrackerSummary.md) 
+  [FeatureTransformation](API_FeatureTransformation.md) 
+  [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md) 
+  [Filter](API_Filter.md) 
+  [FilterSummary](API_FilterSummary.md) 
+  [HPOConfig](API_HPOConfig.md) 
+  [HPOObjective](API_HPOObjective.md) 
+  [HPOResourceConfig](API_HPOResourceConfig.md) 
+  [HyperParameterRanges](API_HyperParameterRanges.md) 
+  [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md) 
+  [MetricAttribute](API_MetricAttribute.md) 
+  [MetricAttribution](API_MetricAttribution.md) 
+  [MetricAttributionOutput](API_MetricAttributionOutput.md) 
+  [MetricAttributionSummary](API_MetricAttributionSummary.md) 
+  [OptimizationObjective](API_OptimizationObjective.md) 
+  [Recipe](API_Recipe.md) 
+  [RecipeSummary](API_RecipeSummary.md) 
+  [Recommender](API_Recommender.md) 
+  [RecommenderConfig](API_RecommenderConfig.md) 
+  [RecommenderSummary](API_RecommenderSummary.md) 
+  [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md) 
+  [S3DataConfig](API_S3DataConfig.md) 
+  [Solution](API_Solution.md) 
+  [SolutionConfig](API_SolutionConfig.md) 
+  [SolutionSummary](API_SolutionSummary.md) 
+  [SolutionUpdateConfig](API_SolutionUpdateConfig.md) 
+  [SolutionUpdateSummary](API_SolutionUpdateSummary.md) 
+  [SolutionVersion](API_SolutionVersion.md) 
+  [SolutionVersionSummary](API_SolutionVersionSummary.md) 
+  [Tag](API_Tag.md) 
+  [ThemeGenerationConfig](API_ThemeGenerationConfig.md) 
+  [TrainingDataConfig](API_TrainingDataConfig.md) 
+  [TunedHPOParams](API_TunedHPOParams.md) 

# Algorithm
<a name="API_Algorithm"></a>

Describe un algoritmo personalizado.

## Contenido
<a name="API_Algorithm_Contents"></a>

 ** algorithmArn **   <a name="personalize-Type-Algorithm-algorithmArn"></a>
El nombre de recurso de Amazon (ARN) del algoritmo.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** algorithmImage **   <a name="personalize-Type-Algorithm-algorithmImage"></a>
El URI del contenedor de Docker para la imagen del algoritmo.  
Tipo: objeto [AlgorithmImage](API_AlgorithmImage.md)  
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-Algorithm-creationDateTime"></a>
La fecha y la hora (en tiempo Unix) en que se creó el algoritmo.  
Tipo: marca temporal  
Obligatorio: no

 ** defaultHyperParameterRanges **   <a name="personalize-Type-Algorithm-defaultHyperParameterRanges"></a>
Especifica los hiperparámetros predeterminados, sus rangos y si se pueden ajustar. Se puede determinar el valor de un hiperparámetro ajustable durante la optimización de hiperparámetros (HPO).  
Tipo: objeto [DefaultHyperParameterRanges](API_DefaultHyperParameterRanges.md)  
Obligatorio: no

 ** defaultHyperParameters **   <a name="personalize-Type-Algorithm-defaultHyperParameters"></a>
Especifica los hiperparámetros predeterminados.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** defaultResourceConfig **   <a name="personalize-Type-Algorithm-defaultResourceConfig"></a>
Especifica el número máximo predeterminado de trabajos de entrenamiento y trabajos de entrenamiento en paralelo.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-Algorithm-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez el algoritmo.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-Algorithm-name"></a>
El nombre del algoritmo  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** roleArn **   <a name="personalize-Type-Algorithm-roleArn"></a>
El nombre de recurso de Amazon (ARN) del rol.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** trainingInputMode **   <a name="personalize-Type-Algorithm-trainingInputMode"></a>
Modo de entrada de entrenamiento.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_Algorithm_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Algorithm) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Algorithm) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Algorithm) 

# AlgorithmImage
<a name="API_AlgorithmImage"></a>

Describe una imagen de algoritmo.

## Contenido
<a name="API_AlgorithmImage_Contents"></a>

 ** dockerURI **   <a name="personalize-Type-AlgorithmImage-dockerURI"></a>
El URI del contenedor de Docker para la imagen del algoritmo.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256 caracteres.  
Obligatorio: sí

 ** name **   <a name="personalize-Type-AlgorithmImage-name"></a>
El nombre de la imagen del algoritmo.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

## Véase también
<a name="API_AlgorithmImage_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AlgorithmImage) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AlgorithmImage) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AlgorithmImage) 

# AutoMLConfig
<a name="API_AutoMLConfig"></a>

Cuando la solución ejecuta AutoML (`performAutoML` es true en [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)), Amazon Personalize determina qué receta, de la lista especificada, optimiza la métrica dada. Amazon Personalize luego utiliza esa receta para la solución.

## Contenido
<a name="API_AutoMLConfig_Contents"></a>

 ** metricName **   <a name="personalize-Type-AutoMLConfig-metricName"></a>
La métrica que se optimizará.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** recipeList **   <a name="personalize-Type-AutoMLConfig-recipeList"></a>
La lista de recetas candidatas.  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 100 elementos.  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Véase también
<a name="API_AutoMLConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLConfig) 

# AutoMLResult
<a name="API_AutoMLResult"></a>

Cuando la solución ejecuta AutoML (`performAutoML` se cumple en [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)), especifica la receta que optimiza mejor la métrica especificada.

## Contenido
<a name="API_AutoMLResult_Contents"></a>

 ** bestRecipeArn **   <a name="personalize-Type-AutoMLResult-bestRecipeArn"></a>
El nombre de recurso de Amazon (ARN) de la mejor receta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Véase también
<a name="API_AutoMLResult_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoMLResult) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoMLResult) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoMLResult) 

# AutoTrainingConfig
<a name="API_AutoTrainingConfig"></a>

La configuración de entrenamiento automático que se debe usar cuando el valor de `performAutoTraining` es true.

## Contenido
<a name="API_AutoTrainingConfig_Contents"></a>

 ** schedulingExpression **   <a name="personalize-Type-AutoTrainingConfig-schedulingExpression"></a>
Especifica la frecuencia con la que se entrenan automáticamente las nuevas versiones de solución. Especifique una expresión de frecuencia con el formato rate(*valor* *unidad*). En “valor”, especifique un número comprendido entre 1 y 30. En “unidad”, especifique `day` o `days`. Por ejemplo, para crear automáticamente una nueva versión de solución cada cinco días, especifique `rate(5 days)`. El valor predeterminado es cada siete días.  
Para obtener más información sobre el entrenamiento automático, consulte [Creación y configuración de una solución](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 16.  
Patrón: `rate\(\d+ days?\)`   
Obligatorio: no

## Véase también
<a name="API_AutoTrainingConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/AutoTrainingConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/AutoTrainingConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/AutoTrainingConfig) 

# BatchInferenceJob
<a name="API_BatchInferenceJob"></a>

Contiene información sobre un trabajo de inferencia por lotes.

## Contenido
<a name="API_BatchInferenceJob_Contents"></a>

 ** batchInferenceJobArn **   <a name="personalize-Type-BatchInferenceJob-batchInferenceJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** batchInferenceJobConfig **   <a name="personalize-Type-BatchInferenceJob-batchInferenceJobConfig"></a>
Un mapa de cadena a cadena de los detalles de configuración de un trabajo de inferencia por lotes.  
Tipo: objeto [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)  
Obligatorio: no

 ** batchInferenceJobMode **   <a name="personalize-Type-BatchInferenceJob-batchInferenceJobMode"></a>
El modo del trabajo.  
Tipo: cadena  
Valores válidos: `BATCH_INFERENCE | THEME_GENERATION`   
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-BatchInferenceJob-creationDateTime"></a>
La hora en la que se creó el trabajo de inferencia por lotes.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-BatchInferenceJob-failureReason"></a>
Si se produjo un error en el trabajo de inferencia por lotes, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** filterArn **   <a name="personalize-Type-BatchInferenceJob-filterArn"></a>
El ARN del filtro usado en el trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** jobInput **   <a name="personalize-Type-BatchInferenceJob-jobInput"></a>
La ruta de Amazon S3 que lleva a los datos de entrada utilizados para generar el trabajo de inferencia por lotes.  
Tipo: objeto [BatchInferenceJobInput](API_BatchInferenceJobInput.md)  
Obligatorio: no

 ** jobName **   <a name="personalize-Type-BatchInferenceJob-jobName"></a>
El nombre del trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** jobOutput **   <a name="personalize-Type-BatchInferenceJob-jobOutput"></a>
El bucket de Amazon S3 que contiene los datos de salida generados por el trabajo de inferencia por lotes.  
Tipo: objeto [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)  
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-BatchInferenceJob-lastUpdatedDateTime"></a>
La hora en la que se actualizó por última vez el trabajo de inferencia por lotes.  
Tipo: marca temporal  
Obligatorio: no

 ** numResults **   <a name="personalize-Type-BatchInferenceJob-numResults"></a>
El número de recomendaciones generadas por el trabajo de inferencia por lotes. Este número incluye los mensajes de error generados por los registros de entrada con error.  
Tipo: entero  
Obligatorio: no

 ** roleArn **   <a name="personalize-Type-BatchInferenceJob-roleArn"></a>
El ARN del rol de Amazon Identity and Access Management (IAM) que solicitó el trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: no

 ** solutionVersionArn **   <a name="personalize-Type-BatchInferenceJob-solutionVersionArn"></a>
El nombre del recurso de Amazon (ARN) de la versión de solución desde la que se creó el trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-BatchInferenceJob-status"></a>
El estado del trabajo de inferencia por lotes. El estado es uno de los siguientes valores:  
+ PENDIENTE
+ IN PROGRESS
+ ACTIVE
+ CREATE FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** themeGenerationConfig **   <a name="personalize-Type-BatchInferenceJob-themeGenerationConfig"></a>
La configuración de generación de temas del trabajo.  
Tipo: objeto [ThemeGenerationConfig](API_ThemeGenerationConfig.md)  
Obligatorio: no

## Véase también
<a name="API_BatchInferenceJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJob) 

# BatchInferenceJobConfig
<a name="API_BatchInferenceJobConfig"></a>

Los detalles de configuración de un trabajo de inferencia por lotes.

## Contenido
<a name="API_BatchInferenceJobConfig_Contents"></a>

 ** itemExplorationConfig **   <a name="personalize-Type-BatchInferenceJobConfig-itemExplorationConfig"></a>
Un mapa de cadena a cadena que especifica los hiperparámetros de configuración de la exploración, incluidos `explorationWeight` y `explorationItemAgeCutOff`, que desea utilizar para configurar la cantidad de exploración de elementos que Amazon Personalize utiliza al recomendar artículos. Consulte [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html).  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** rankingInfluence **   <a name="personalize-Type-BatchInferenceJobConfig-rankingInfluence"></a>
Un mapa de los valores de influencia de la clasificación para la POPULARIDAD y la FRESCURA. Para cada clave, especifique un valor numérico entre 0,0 y 1,0 que determine la influencia que tiene ese factor de clasificación en las recomendaciones finales. Un valor más cercano a 1,0 da más peso al factor, mientras que un valor más cercano a 0,0 reduce su influencia. Si no se especifica, ambos valores predeterminados son 0.0.  
Tipo: cadena al mapa doble  
Claves válidas: `POPULARITY | FRESHNESS`   
Rango válido: valor mínimo de 0. El valor máximo es de 1.  
Obligatorio: no

## Véase también
<a name="API_BatchInferenceJobConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWSSDKs, consulta lo siguiente:
+  [AWSSDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobConfig) 
+  [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobConfig) 
+  [AWSSDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobConfig) 

# BatchInferenceJobInput
<a name="API_BatchInferenceJobInput"></a>

La configuración de entrada de un trabajo de inferencia por lotes.

## Contenido
<a name="API_BatchInferenceJobInput_Contents"></a>

 ** s3DataSource **   <a name="personalize-Type-BatchInferenceJobInput-s3DataSource"></a>
El URI de la ubicación de Amazon S3 que contiene los datos de entrada. El bucket de Amazon S3 debe estar en la misma región que el punto de conexión de API al que está llamando.  
Tipo: objeto [S3DataConfig](API_S3DataConfig.md)  
Obligatorio: sí

## Véase también
<a name="API_BatchInferenceJobInput_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobInput) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobInput) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobInput) 

# BatchInferenceJobOutput
<a name="API_BatchInferenceJobOutput"></a>

Los parámetros de configuración de salida de un trabajo de inferencia por lotes.

## Contenido
<a name="API_BatchInferenceJobOutput_Contents"></a>

 ** s3DataDestination **   <a name="personalize-Type-BatchInferenceJobOutput-s3DataDestination"></a>
Información sobre el bucket de Amazon S3 en el que se almacena el resultado del trabajo de inferencia por lotes.  
Tipo: objeto [S3DataConfig](API_S3DataConfig.md)  
Obligatorio: sí

## Véase también
<a name="API_BatchInferenceJobOutput_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobOutput) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobOutput) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobOutput) 

# BatchInferenceJobSummary
<a name="API_BatchInferenceJobSummary"></a>

Una versión truncada de [BatchInferenceJob](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchInferenceJob.html). La operación [ListBatchInferenceJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchInferenceJobs.html) devuelve una lista de resúmenes de trabajos de inferencia por lotes.

## Contenido
<a name="API_BatchInferenceJobSummary_Contents"></a>

 ** batchInferenceJobArn **   <a name="personalize-Type-BatchInferenceJobSummary-batchInferenceJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** batchInferenceJobMode **   <a name="personalize-Type-BatchInferenceJobSummary-batchInferenceJobMode"></a>
El modo del trabajo.  
Tipo: cadena  
Valores válidos: `BATCH_INFERENCE | THEME_GENERATION`   
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-BatchInferenceJobSummary-creationDateTime"></a>
La hora en la que se creó el trabajo de inferencia por lotes.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-BatchInferenceJobSummary-failureReason"></a>
Si se produjo un error en el trabajo de inferencia por lotes, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** jobName **   <a name="personalize-Type-BatchInferenceJobSummary-jobName"></a>
El nombre del trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-BatchInferenceJobSummary-lastUpdatedDateTime"></a>
La hora en la que se actualizó por última vez el trabajo de inferencia por lotes.  
Tipo: marca temporal  
Obligatorio: no

 ** solutionVersionArn **   <a name="personalize-Type-BatchInferenceJobSummary-solutionVersionArn"></a>
El ARN de la versión de solución usada por el trabajo de inferencia por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-BatchInferenceJobSummary-status"></a>
El estado del trabajo de inferencia por lotes. El estado es uno de los siguientes valores:  
+ PENDIENTE
+ IN PROGRESS
+ ACTIVE
+ CREATE FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_BatchInferenceJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchInferenceJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchInferenceJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchInferenceJobSummary) 

# BatchSegmentJob
<a name="API_BatchSegmentJob"></a>

Contiene información sobre un trabajo de segmento por lotes.

## Contenido
<a name="API_BatchSegmentJob_Contents"></a>

 ** batchSegmentJobArn **   <a name="personalize-Type-BatchSegmentJob-batchSegmentJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de segmento por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-BatchSegmentJob-creationDateTime"></a>
La hora en la que se creó el trabajo de segmento por lotes.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-BatchSegmentJob-failureReason"></a>
Si se produjo un error en el trabajo de segmento por lotes, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** filterArn **   <a name="personalize-Type-BatchSegmentJob-filterArn"></a>
El ARN del filtro usado en el trabajo de segmento por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** jobInput **   <a name="personalize-Type-BatchSegmentJob-jobInput"></a>
La ruta de Amazon S3 que lleva a los datos de entrada utilizados para generar el trabajo de segmento por lotes.  
Tipo: objeto [BatchSegmentJobInput](API_BatchSegmentJobInput.md)  
Obligatorio: no

 ** jobName **   <a name="personalize-Type-BatchSegmentJob-jobName"></a>
El nombre del trabajo de segmento por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** jobOutput **   <a name="personalize-Type-BatchSegmentJob-jobOutput"></a>
El bucket de Amazon S3 que contiene los datos de salida generados por el trabajo de segmento por lotes.  
Tipo: objeto [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md)  
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-BatchSegmentJob-lastUpdatedDateTime"></a>
La hora en la que se actualizó por última vez el trabajo de segmento de lotes.  
Tipo: marca temporal  
Obligatorio: no

 ** numResults **   <a name="personalize-Type-BatchSegmentJob-numResults"></a>
El número de usuarios previsto que generará el trabajo de segmentación por lotes para cada línea de datos de entrada. El número máximo de usuarios por segmento es de 5 millones.  
Tipo: entero  
Obligatorio: no

 ** roleArn **   <a name="personalize-Type-BatchSegmentJob-roleArn"></a>
El ARN del rol de Amazon Identity and Access Management (IAM) que solicitó el trabajo de segmento por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: no

 ** solutionVersionArn **   <a name="personalize-Type-BatchSegmentJob-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de solución que el trabajo de segmento por lotes utilizó para generar segmentos por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-BatchSegmentJob-status"></a>
El estado del trabajo de segmento por lotes. El estado es uno de los siguientes valores:  
+ PENDIENTE
+ IN PROGRESS
+ ACTIVE
+ CREATE FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_BatchSegmentJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJob) 

# BatchSegmentJobInput
<a name="API_BatchSegmentJobInput"></a>

La configuración de entrada de un trabajo de segmento por lotes.

## Contenido
<a name="API_BatchSegmentJobInput_Contents"></a>

 ** s3DataSource **   <a name="personalize-Type-BatchSegmentJobInput-s3DataSource"></a>
Los detalles de configuración de un bucket de entrada o salida de Amazon S3.  
Tipo: objeto [S3DataConfig](API_S3DataConfig.md)  
Obligatorio: sí

## Véase también
<a name="API_BatchSegmentJobInput_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobInput) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobInput) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobInput) 

# BatchSegmentJobOutput
<a name="API_BatchSegmentJobOutput"></a>

Los parámetros de configuración de salida de un trabajo de segmento por lotes.

## Contenido
<a name="API_BatchSegmentJobOutput_Contents"></a>

 ** s3DataDestination **   <a name="personalize-Type-BatchSegmentJobOutput-s3DataDestination"></a>
Los detalles de configuración de un bucket de entrada o salida de Amazon S3.  
Tipo: objeto [S3DataConfig](API_S3DataConfig.md)  
Obligatorio: sí

## Véase también
<a name="API_BatchSegmentJobOutput_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobOutput) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobOutput) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobOutput) 

# BatchSegmentJobSummary
<a name="API_BatchSegmentJobSummary"></a>

Una versión truncada del tipo de datos [BatchSegmentJob](https://docs.aws.amazon.com/personalize/latest/dg/API_BatchSegmentJob.html). La operación [ListBatchSegmentJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListBatchSegmentJobs.html) devuelve una lista de resúmenes de trabajos de segmentos por lotes.

## Contenido
<a name="API_BatchSegmentJobSummary_Contents"></a>

 ** batchSegmentJobArn **   <a name="personalize-Type-BatchSegmentJobSummary-batchSegmentJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de segmento por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-BatchSegmentJobSummary-creationDateTime"></a>
La hora en la que se creó el trabajo de segmento por lotes.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-BatchSegmentJobSummary-failureReason"></a>
Si se produjo un error en el trabajo de segmento por lotes, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** jobName **   <a name="personalize-Type-BatchSegmentJobSummary-jobName"></a>
El nombre del trabajo de segmento por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-BatchSegmentJobSummary-lastUpdatedDateTime"></a>
La hora en la que se actualizó por última vez el trabajo de segmento por lotes.  
Tipo: marca temporal  
Obligatorio: no

 ** solutionVersionArn **   <a name="personalize-Type-BatchSegmentJobSummary-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de solución que el trabajo de segmento por lotes utilizó para generar segmentos por lotes.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-BatchSegmentJobSummary-status"></a>
El estado del trabajo de segmento por lotes. El estado es uno de los siguientes valores:  
+ PENDIENTE
+ IN PROGRESS
+ ACTIVE
+ CREATE FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_BatchSegmentJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/BatchSegmentJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/BatchSegmentJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/BatchSegmentJobSummary) 

# Campaign
<a name="API_Campaign"></a>

Un objeto que describe la implementación de una versión de solución. Para obtener información acerca de las campañas, consulte [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html).

## Contenido
<a name="API_Campaign_Contents"></a>

 ** campaignArn **   <a name="personalize-Type-Campaign-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña.   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** campaignConfig **   <a name="personalize-Type-Campaign-campaignConfig"></a>
Los detalles de la configuración de una campaña.  
Tipo: objeto [CampaignConfig](API_CampaignConfig.md)  
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-Campaign-creationDateTime"></a>
La fecha y la hora (en formato Unix) en que se creó la campaña.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-Campaign-failureReason"></a>
Si se produce un error en la campaña, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-Campaign-lastUpdatedDateTime"></a>
La fecha y hora (en formato Unix) en que se actualizó por última vez la campaña.  
Tipo: marca temporal  
Obligatorio: no

 ** latestCampaignUpdate **   <a name="personalize-Type-Campaign-latestCampaignUpdate"></a>
Proporciona un resumen de las propiedades de una actualización de campaña. Para obtener una lista completa, llame a la API [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html).  
El campo `latestCampaignUpdate` solo se devuelve cuando la campaña ha tenido al menos una llamada de `UpdateCampaign`. 
Tipo: objeto [CampaignUpdateSummary](API_CampaignUpdateSummary.md)  
Obligatorio: no

 ** minProvisionedTPS **   <a name="personalize-Type-Campaign-minProvisionedTPS"></a>
Especifica el número mínimo de transacciones aprovisionadas (recomendaciones) por segundo solicitadas. Un valor elevado de `minProvisionedTPS` aumentará su factura. Le recomendamos empezar con 1 para `minProvisionedTPS` (el valor predeterminado). Realice un seguimiento de su uso mediante las métricas de Amazon CloudWatch y aumente el valor de `minProvisionedTPS` según sea necesario.  
Tipo: número entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** name **   <a name="personalize-Type-Campaign-name"></a>
Nombre de la campaña.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** solutionVersionArn **   <a name="personalize-Type-Campaign-solutionVersionArn"></a>
Nombre de recurso de Amazon (ARN) de la versión de solución que usa la campaña.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-Campaign-status"></a>
El estado de la campaña.  
Una campaña puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_Campaign_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Campaign) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Campaign) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Campaign) 

# CampaignConfig
<a name="API_CampaignConfig"></a>

Los detalles de la configuración de una campaña.

## Contenido
<a name="API_CampaignConfig_Contents"></a>

 ** enableMetadataWithRecommendations **   <a name="personalize-Type-CampaignConfig-enableMetadataWithRecommendations"></a>
Indica si los metadatos con recomendaciones están habilitados para la campaña. Si está habilitada, puede especificar las columnas del conjunto de datos de elementos en su solicitud de recomendaciones. Amazon Personalize devuelve estos datos para cada elemento en la respuesta a la recomendación. Para obtener información sobre cómo habilitar los metadatos para una campaña, consulte [Habilitación de los metadatos en las recomendaciones para una campaña](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata).  
 Si habilita los metadatos en las recomendaciones, incurrirá en costos adicionales. Para obtener más información, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).   
Tipo: Booleano  
Obligatorio: no

 ** itemExplorationConfig **   <a name="personalize-Type-CampaignConfig-itemExplorationConfig"></a>
Especifica los hiperparámetros de configuración de la exploración, incluidos `explorationWeight` y `explorationItemAgeCutOff`, que desea utilizar para configurar la cantidad de exploración de elementos que Amazon Personalize utiliza al recomendar artículos. Proporcione datos `itemExplorationConfig` únicamente si la solución utiliza la receta [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html).  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** rankingInfluence **   <a name="personalize-Type-CampaignConfig-rankingInfluence"></a>
Un mapa de los valores de influencia de la clasificación para la POPULARIDAD y la FRESCURA. Para cada clave, especifique un valor numérico entre 0,0 y 1,0 que determine la influencia que tiene ese factor de clasificación en las recomendaciones finales. Un valor más cercano a 1,0 da más peso al factor, mientras que un valor más cercano a 0,0 reduce su influencia. Si no se especifica, ambos valores predeterminados son 0.0.  
Tipo: cadena al mapa doble  
Claves válidas: `POPULARITY | FRESHNESS`   
Rango válido: valor mínimo de 0. El valor máximo es de 1.  
Obligatorio: no

 ** syncWithLatestSolutionVersion **   <a name="personalize-Type-CampaignConfig-syncWithLatestSolutionVersion"></a>
Indica si la campaña se actualiza de forma automática para usar la versión de solución (modelo entrenado) más reciente de una solución. Si especifica `True`, debe especificar el ARN de la *solución* para el parámetro `SolutionVersionArn`. Debe tener el formato `SolutionArn/$LATEST`. El valor predeterminado es `False` y debe actualizar manualmente la campaña para implementar la última versión de solución.   
 Para obtener más información sobre las actualizaciones de campaña automáticas, consulte [Habilitación de las actualizaciones de campaña automáticas](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update).   
Tipo: Booleano  
Obligatorio: no

## Véase también
<a name="API_CampaignConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWSSDKs, consulta lo siguiente:
+  [AWSSDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignConfig) 
+  [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignConfig) 
+  [AWSSDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignConfig) 

# CampaignSummary
<a name="API_CampaignSummary"></a>

Proporciona un resumen de las propiedades de una campaña. Para obtener una lista completa, llame a la API [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html).

## Contenido
<a name="API_CampaignSummary_Contents"></a>

 ** campaignArn **   <a name="personalize-Type-CampaignSummary-campaignArn"></a>
El nombre de recurso de Amazon (ARN) de la campaña.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-CampaignSummary-creationDateTime"></a>
La fecha y la hora (en tiempo Unix) en que se creó la campaña.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-CampaignSummary-failureReason"></a>
Si se produce un error en la campaña, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-CampaignSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez la campaña.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-CampaignSummary-name"></a>
Nombre de la campaña.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-CampaignSummary-status"></a>
El estado de la campaña.  
Una campaña puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_CampaignSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignSummary) 

# CampaignUpdateSummary
<a name="API_CampaignUpdateSummary"></a>

Proporciona un resumen de las propiedades de una actualización de campaña. Para obtener una lista completa, llame a la API [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html).

## Contenido
<a name="API_CampaignUpdateSummary_Contents"></a>

 ** campaignConfig **   <a name="personalize-Type-CampaignUpdateSummary-campaignConfig"></a>
Los detalles de la configuración de una campaña.  
Tipo: objeto [CampaignConfig](API_CampaignConfig.md)  
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-CampaignUpdateSummary-creationDateTime"></a>
La fecha y la hora (en tiempo Unix) en que se creó la actualización de la campaña.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-CampaignUpdateSummary-failureReason"></a>
Si se produce un error en la actualización de la campaña, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-CampaignUpdateSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez la actualización de la campaña.  
Tipo: marca temporal  
Obligatorio: no

 ** minProvisionedTPS **   <a name="personalize-Type-CampaignUpdateSummary-minProvisionedTPS"></a>
Especifica el número mínimo de transacciones aprovisionadas (recomendaciones) por segundo solicitadas que Amazon Personalize va a admitir.  
Tipo: número entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** solutionVersionArn **   <a name="personalize-Type-CampaignUpdateSummary-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de solución implementada.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-CampaignUpdateSummary-status"></a>
El estado de la actualización de la campaña.  
Una actualización de campaña puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_CampaignUpdateSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CampaignUpdateSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CampaignUpdateSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CampaignUpdateSummary) 

# CategoricalHyperParameterRange
<a name="API_CategoricalHyperParameterRange"></a>

Proporciona el nombre y el rango de un hiperparámetro categórico.

## Contenido
<a name="API_CategoricalHyperParameterRange_Contents"></a>

 ** name **   <a name="personalize-Type-CategoricalHyperParameterRange-name"></a>
El nombre del hiperparámetro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** values **   <a name="personalize-Type-CategoricalHyperParameterRange-values"></a>
Una lista de las categorías del hiperparámetro.  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 100 elementos.  
Limitaciones de longitud: longitud máxima de 1000 caracteres.  
Obligatorio: no

## Véase también
<a name="API_CategoricalHyperParameterRange_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CategoricalHyperParameterRange) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CategoricalHyperParameterRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CategoricalHyperParameterRange) 

# ContinuousHyperParameterRange
<a name="API_ContinuousHyperParameterRange"></a>

Proporciona el nombre y el rango de un hiperparámetro continuo.

## Contenido
<a name="API_ContinuousHyperParameterRange_Contents"></a>

 ** maxValue **   <a name="personalize-Type-ContinuousHyperParameterRange-maxValue"></a>
El valor máximo permitido para el hiperparámetro.  
Tipo: doble  
Rango válido: valor mínimo de -1000000.  
Obligatorio: no

 ** minValue **   <a name="personalize-Type-ContinuousHyperParameterRange-minValue"></a>
El valor mínimo permitido para el hiperparámetro.  
Tipo: doble  
Rango válido: valor mínimo de -1000000.  
Obligatorio: no

 ** name **   <a name="personalize-Type-ContinuousHyperParameterRange-name"></a>
El nombre del hiperparámetro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_ContinuousHyperParameterRange_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ContinuousHyperParameterRange) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ContinuousHyperParameterRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ContinuousHyperParameterRange) 

# DataDeletionJob
<a name="API_DataDeletionJob"></a>

Describe un trabajo que elimina por lotes todas las referencias a usuarios específicos de un grupo de conjuntos de datos de Amazon Personalize. Para obtener información sobre cómo crear un trabajo de eliminación de datos, consulte [Eliminación de usuarios](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html).

## Contenido
<a name="API_DataDeletionJob_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DataDeletionJob-creationDateTime"></a>
Fecha y hora de creación (en tiempo Unix) del trabajo de eliminación de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** dataDeletionJobArn **   <a name="personalize-Type-DataDeletionJob-dataDeletionJobArn"></a>
Nombre de recurso de Amazon (ARN) del trabajo de eliminación de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-DataDeletionJob-datasetGroupArn"></a>
Nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos del que el trabajo elimina registros.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** dataSource **   <a name="personalize-Type-DataDeletionJob-dataSource"></a>
Describe el origen de datos que contiene los datos que se cargarán en un conjunto de datos o la lista de registros que se eliminarán de Amazon Personalize.  
Tipo: objeto [DataSource](API_DataSource.md)  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DataDeletionJob-failureReason"></a>
Si se produce un error en un trabajo de eliminación de datos, se indica el motivo.  
Tipo: cadena  
Requerido: no

 ** jobName **   <a name="personalize-Type-DataDeletionJob-jobName"></a>
Nombre del trabajo de eliminación de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DataDeletionJob-lastUpdatedDateTime"></a>
Fecha y hora (en tiempo Unix) en que se actualizó por última vez el trabajo de eliminación de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** numDeleted **   <a name="personalize-Type-DataDeletionJob-numDeleted"></a>
Número de registros eliminados por un trabajo COMPLETED.  
Tipo: entero  
Obligatorio: no

 ** roleArn **   <a name="personalize-Type-DataDeletionJob-roleArn"></a>
Nombre de recurso de Amazon (ARN) del rol de IAM que tiene permisos para leer el origen de datos de Amazon S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-DataDeletionJob-status"></a>
Estado del trabajo de eliminación de datos.  
Un trabajo de eliminación de datos puede tener uno de los siguientes estados:  
+ PENDING > IN\$1PROGRESS > COMPLETED -o- FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DataDeletionJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJob) 

# DataDeletionJobSummary
<a name="API_DataDeletionJobSummary"></a>

Proporciona un resumen de las propiedades de un trabajo de eliminación de datos. Para obtener una lista completa, llame a la operación de la API [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html).

## Contenido
<a name="API_DataDeletionJobSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DataDeletionJobSummary-creationDateTime"></a>
Fecha y hora de creación (en tiempo Unix) del trabajo de eliminación de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** dataDeletionJobArn **   <a name="personalize-Type-DataDeletionJobSummary-dataDeletionJobArn"></a>
Nombre de recurso de Amazon (ARN) del trabajo de eliminación de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-DataDeletionJobSummary-datasetGroupArn"></a>
Nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos en el que el trabajo ha eliminado registros.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DataDeletionJobSummary-failureReason"></a>
Si se produce un error en un trabajo de eliminación de datos, se indica el motivo.  
Tipo: cadena  
Requerido: no

 ** jobName **   <a name="personalize-Type-DataDeletionJobSummary-jobName"></a>
Nombre del trabajo de eliminación de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DataDeletionJobSummary-lastUpdatedDateTime"></a>
Fecha y hora (en tiempo Unix) en que se actualizó por última vez el trabajo de eliminación de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** status **   <a name="personalize-Type-DataDeletionJobSummary-status"></a>
Estado del trabajo de eliminación de datos.  
Un trabajo de eliminación de datos puede tener uno de los siguientes estados:  
+ PENDING > IN\$1PROGRESS > COMPLETED -o- FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DataDeletionJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataDeletionJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataDeletionJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataDeletionJobSummary) 

# Dataset
<a name="API_Dataset"></a>

Proporciona metadatos para un conjunto de datos.

## Contenido
<a name="API_Dataset_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-Dataset-creationDateTime"></a>
La fecha y hora de creación (en tiempo Unix) del conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetArn **   <a name="personalize-Type-Dataset-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos para el que desea metadatos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-Dataset-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** datasetType **   <a name="personalize-Type-Dataset-datasetType"></a>
Uno de los valores siguientes:  
+ Interacciones
+ Items
+ Users
+ Acciones
+ Action\$1Interactions
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `^[A-Za-z_]+$`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-Dataset-lastUpdatedDateTime"></a>
Una marca de tiempo que muestra cuándo se actualizó el conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** latestDatasetUpdate **   <a name="personalize-Type-Dataset-latestDatasetUpdate"></a>
Describe la última actualización del conjunto de datos.  
Tipo: objeto [DatasetUpdateSummary](API_DatasetUpdateSummary.md)  
Obligatorio: no

 ** name **   <a name="personalize-Type-Dataset-name"></a>
Nombre del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** schemaArn **   <a name="personalize-Type-Dataset-schemaArn"></a>
El ARN del esquema asociado.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-Dataset-status"></a>
El estado del conjunto de datos.  
Un conjunto de datos puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** trackingId **   <a name="personalize-Type-Dataset-trackingId"></a>
ID del rastreador de eventos de un conjunto de datos de interacciones de acción. Este ID se especifica en la operación de API `PutActionInteractions`. Amazon Personalize lo usa para dirigir los nuevos datos al conjunto de datos de interacciones de acción en su grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_Dataset_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWSSDKs, consulta lo siguiente:
+  [AWSSDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Dataset) 
+  [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Dataset) 
+  [AWSSDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Dataset) 

# DatasetExportJob
<a name="API_DatasetExportJob"></a>

Describe un trabajo que exporta un conjunto de datos a un bucket de Amazon S3. Para obtener más información, consulte [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html).

Un trabajo de exportación de conjunto de datos puede aparecer en uno de los siguientes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED

## Contenido
<a name="API_DatasetExportJob_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetExportJob-creationDateTime"></a>
La fecha y hora de creación (en tiempo Unix) del trabajo de exportación de un conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetArn **   <a name="personalize-Type-DatasetExportJob-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** datasetExportJobArn **   <a name="personalize-Type-DatasetExportJob-datasetExportJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de exportación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DatasetExportJob-failureReason"></a>
Si se produce un error en un trabajo de exportación de un conjunto de datos, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** ingestionMode **   <a name="personalize-Type-DatasetExportJob-ingestionMode"></a>
Los datos que se van a exportar, en función de cómo los haya importado. Puede optar por exportar los datos `BULK` que haya importado mediante un trabajo de importación de conjuntos de datos, los datos `PUT` que haya importado de forma incremental (mediante las operaciones de consola, PutEvents, PutUsers y PutItems) o `ALL` para ambos tipos. El valor predeterminado es `PUT`.   
Tipo: cadena  
Valores válidos: `BULK | PUT | ALL`   
Obligatorio: no

 ** jobName **   <a name="personalize-Type-DatasetExportJob-jobName"></a>
Nombre del trabajo de exportación.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** jobOutput **   <a name="personalize-Type-DatasetExportJob-jobOutput"></a>
La ruta al bucket de Amazon S3 donde se almacena el resultado del trabajo. Por ejemplo:  
 `s3://bucket-name/folder-name/`   
Tipo: objeto [DatasetExportJobOutput](API_DatasetExportJobOutput.md)  
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetExportJob-lastUpdatedDateTime"></a>
La fecha y la hora (en tiempo de Unix) en que se actualizó por última vez el estado del trabajo de exportación del conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** roleArn **   <a name="personalize-Type-DatasetExportJob-roleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de servicio de IAM que tiene permisos para añadir datos al bucket de Amazon S3 de salida.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-DatasetExportJob-status"></a>
El estado del trabajo de exportación del conjunto de datos.  
Un trabajo de exportación de conjunto de datos puede aparecer en uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DatasetExportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJob) 

# DatasetExportJobOutput
<a name="API_DatasetExportJobOutput"></a>

Los parámetros de configuración de salida de un trabajo de exportación de conjuntos de datos.

## Contenido
<a name="API_DatasetExportJobOutput_Contents"></a>

 ** s3DataDestination **   <a name="personalize-Type-DatasetExportJobOutput-s3DataDestination"></a>
Los detalles de configuración de un bucket de entrada o salida de Amazon S3.  
Tipo: objeto [S3DataConfig](API_S3DataConfig.md)  
Obligatorio: sí

## Véase también
<a name="API_DatasetExportJobOutput_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobOutput) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobOutput) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobOutput) 

# DatasetExportJobSummary
<a name="API_DatasetExportJobSummary"></a>

Proporciona un resumen de las propiedades de un trabajo de exportación de conjuntos de datos. Para obtener una lista completa, llame a la API [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html).

## Contenido
<a name="API_DatasetExportJobSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetExportJobSummary-creationDateTime"></a>
La fecha y hora (en tiempo Unix) en que se creó el trabajo de exportación del conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetExportJobArn **   <a name="personalize-Type-DatasetExportJobSummary-datasetExportJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de exportación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DatasetExportJobSummary-failureReason"></a>
Si se produce un error en un trabajo de exportación de un conjunto de datos, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** jobName **   <a name="personalize-Type-DatasetExportJobSummary-jobName"></a>
Nombre para el trabajo de exportación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetExportJobSummary-lastUpdatedDateTime"></a>
La fecha y la hora (en tiempo de Unix) en que se actualizó por última vez el estado del trabajo de exportación del conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** status **   <a name="personalize-Type-DatasetExportJobSummary-status"></a>
El estado del trabajo de exportación del conjunto de datos.  
Un trabajo de exportación de conjunto de datos puede aparecer en uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DatasetExportJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetExportJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetExportJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetExportJobSummary) 

# DatasetGroup
<a name="API_DatasetGroup"></a>

Un grupo de conjunto de datos es una colección de conjuntos de datos relacionados (interacciones de elementos, usuarios, elementos, acciones, interacciones de acción). Puede crear un grupo de conjuntos de datos mediante una llamada a [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html). A continuación, cree un conjunto de datos y agréguelo a un grupo de conjuntos de datos mediante una llamada a [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html). El grupo de conjuntos de datos se utiliza para crear y entrenar una solución mediante una llamada a [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html). Un grupo de conjuntos de datos solo puede contener un conjunto de datos de cada tipo.

Puede especificar una clave AWS Key Management Service (KMS) para cifrar los conjuntos de datos del grupo.

## Contenido
<a name="API_DatasetGroup_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetGroup-creationDateTime"></a>
La fecha y hora de creación (en tiempo Unix) del grupo de conjuntos de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-DatasetGroup-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** domain **   <a name="personalize-Type-DatasetGroup-domain"></a>
El dominio de un grupo de conjuntos de datos de dominio.  
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DatasetGroup-failureReason"></a>
Si se produce un error al crear un grupo de conjuntos de datos, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** kmsKeyArn **   <a name="personalize-Type-DatasetGroup-kmsKeyArn"></a>
El nombre de recurso de Amazon (ARN) de la clave AWS Key Management Service (KMS) que se utiliza para cifrar los conjuntos datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `arn:aws.*:kms:.*:[0-9]{12}:key/.*`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetGroup-lastUpdatedDateTime"></a>
La fecha y hora de la última actualización (en tiempo Unix) del grupo de conjuntos de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-DatasetGroup-name"></a>
El nombre del grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** roleArn **   <a name="personalize-Type-DatasetGroup-roleArn"></a>
El ARN del rol (de IAM) AWS Identity and Access Management que tiene permisos para acceder a la clave AWS Key Management Service (KMS). La especificación de un rol de IAM solo es válida cuando también se especifica una clave de KMS.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-DatasetGroup-status"></a>
El estado actual del grupo de conjuntos de datos.  
Un grupo de conjuntos de datos puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DatasetGroup_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroup) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroup) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroup) 

# DatasetGroupSummary
<a name="API_DatasetGroupSummary"></a>

Proporciona un resumen de las propiedades de un grupo de conjuntos de datos. Para obtener una lista completa, llame a la API [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html).

## Contenido
<a name="API_DatasetGroupSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetGroupSummary-creationDateTime"></a>
La fecha y hora (en tiempo Unix) en que se creó el grupo de conjuntos de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-DatasetGroupSummary-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** domain **   <a name="personalize-Type-DatasetGroupSummary-domain"></a>
El dominio de un grupo de conjuntos de datos de dominio.  
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DatasetGroupSummary-failureReason"></a>
Si se produce un error en un grupo de conjuntos de datos, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetGroupSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez el grupo de conjuntos de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-DatasetGroupSummary-name"></a>
El nombre del grupo de conjuntos de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-DatasetGroupSummary-status"></a>
El estado del grupo de conjuntos de datos.  
Un grupo de conjuntos de datos puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DatasetGroupSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetGroupSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetGroupSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetGroupSummary) 

# DatasetImportJob
<a name="API_DatasetImportJob"></a>

Describe un trabajo que importa datos de entrenamiento de un origen de datos (bucket de Amazon S3) a un conjunto de datos de Amazon Personalize. Para obtener más información, consulte [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html).

Un trabajo de importación de conjunto de datos puede aparecer en uno de los siguientes estados:
+ CREATE PENDING (CREACIÓN PENDIENTE) > CREATE IN\$1PROGRESS (CREACIÓN EN CURSO) > ACTIVE (ACTIVO) o CREATE FAILED (ERROR AL CREAR)

## Contenido
<a name="API_DatasetImportJob_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetImportJob-creationDateTime"></a>
La fecha y hora de creación (en tiempo Unix) del trabajo de importación de un conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetArn **   <a name="personalize-Type-DatasetImportJob-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos que recibe los datos importados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** datasetImportJobArn **   <a name="personalize-Type-DatasetImportJob-datasetImportJobArn"></a>
El ARN del trabajo de importación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** dataSource **   <a name="personalize-Type-DatasetImportJob-dataSource"></a>
El bucket de Amazon S3 que contiene los datos de entrenamiento que se importarán.  
Tipo: objeto [DataSource](API_DataSource.md)  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DatasetImportJob-failureReason"></a>
Si se produce un error en un trabajo de importación de un conjunto de datos, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** importMode **   <a name="personalize-Type-DatasetImportJob-importMode"></a>
El modo de importación utilizado por el trabajo de importación del conjunto de datos para importar nuevos registros.  
Tipo: cadena  
Valores válidos: `FULL | INCREMENTAL`   
Obligatorio: no

 ** jobName **   <a name="personalize-Type-DatasetImportJob-jobName"></a>
El nombre del trabajo de importación.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetImportJob-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez el conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** publishAttributionMetricsToS3 **   <a name="personalize-Type-DatasetImportJob-publishAttributionMetricsToS3"></a>
Si el trabajo publica métricas en Amazon S3 para una atribución de métricas.  
Tipo: Booleano  
Obligatorio: no

 ** roleArn **   <a name="personalize-Type-DatasetImportJob-roleArn"></a>
El ARN del rol de IAM que tiene permisos de lectura del origen de datos de Amazon S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-DatasetImportJob-status"></a>
El estado del trabajo de importación del conjunto de datos.  
Un trabajo de importación del conjunto de datos puede aparecer en uno de los siguientes estados:  
+ CREATE PENDING (CREACIÓN PENDIENTE) > CREATE IN\$1PROGRESS (CREACIÓN EN CURSO) > ACTIVE (ACTIVO) o CREATE FAILED (ERROR AL CREAR)
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DatasetImportJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJob) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJob) 

# DatasetImportJobSummary
<a name="API_DatasetImportJobSummary"></a>

Proporciona un resumen de las propiedades de un trabajo de importación de conjuntos de datos. Para obtener una lista completa, llame a la API [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html).

## Contenido
<a name="API_DatasetImportJobSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetImportJobSummary-creationDateTime"></a>
La fecha y hora (en tiempo Unix) en que se creó el trabajo de importación del conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetImportJobArn **   <a name="personalize-Type-DatasetImportJobSummary-datasetImportJobArn"></a>
El nombre de recurso de Amazon (ARN) del trabajo de importación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DatasetImportJobSummary-failureReason"></a>
Si se produce un error en un trabajo de importación de un conjunto de datos, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** importMode **   <a name="personalize-Type-DatasetImportJobSummary-importMode"></a>
El modo de importación que el trabajo de importación del conjunto de datos utilizó para actualizar los datos del conjunto de datos. Para obtener más información, consulte [Actualización de datos masivos existentes](https://docs.aws.amazon.com/personalize/latest/dg/updating-existing-bulk-data.html).   
Tipo: cadena  
Valores válidos: `FULL | INCREMENTAL`   
Obligatorio: no

 ** jobName **   <a name="personalize-Type-DatasetImportJobSummary-jobName"></a>
Nombre del trabajo de importación del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetImportJobSummary-lastUpdatedDateTime"></a>
La fecha y la hora (en tiempo de Unix) en que se actualizó por última vez el estado del trabajo de importación del conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** status **   <a name="personalize-Type-DatasetImportJobSummary-status"></a>
El estado del trabajo de importación del conjunto de datos.  
Un trabajo de importación del conjunto de datos puede aparecer en uno de los siguientes estados:  
+ CREATE PENDING (CREACIÓN PENDIENTE) > CREATE IN\$1PROGRESS (CREACIÓN EN CURSO) > ACTIVE (ACTIVO) o CREATE FAILED (ERROR AL CREAR)
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DatasetImportJobSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJobSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJobSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJobSummary) 

# DatasetSchema
<a name="API_DatasetSchema"></a>

Describe el esquema de un conjunto de datos. Para obtener más información sobre los esquemas, consulte [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html).

## Contenido
<a name="API_DatasetSchema_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetSchema-creationDateTime"></a>
La fecha y la hora (en tiempo Unix) en que se creó el esquema.  
Tipo: marca temporal  
Obligatorio: no

 ** domain **   <a name="personalize-Type-DatasetSchema-domain"></a>
El dominio de un esquema que creó para un conjunto de datos en un grupo de conjuntos de datos de dominio.  
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetSchema-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez el esquema.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-DatasetSchema-name"></a>
El nombre del esquema.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** schema **   <a name="personalize-Type-DatasetSchema-schema"></a>
El esquema.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 20 000.  
Obligatorio: no

 ** schemaArn **   <a name="personalize-Type-DatasetSchema-schemaArn"></a>
Nombre de recurso de Amazon (ARN) del esquema.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Véase también
<a name="API_DatasetSchema_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchema) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchema) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchema) 

# DatasetSchemaSummary
<a name="API_DatasetSchemaSummary"></a>

Proporciona un resumen de las propiedades de un esquema de conjuntos de datos. Para obtener una lista completa, llame a la API [DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html).

## Contenido
<a name="API_DatasetSchemaSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetSchemaSummary-creationDateTime"></a>
La fecha y la hora (en tiempo Unix) en que se creó el esquema.  
Tipo: marca temporal  
Obligatorio: no

 ** domain **   <a name="personalize-Type-DatasetSchemaSummary-domain"></a>
El dominio de un esquema que creó para un conjunto de datos en un grupo de conjuntos de datos de dominio.  
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetSchemaSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez el esquema.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-DatasetSchemaSummary-name"></a>
El nombre del esquema.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** schemaArn **   <a name="personalize-Type-DatasetSchemaSummary-schemaArn"></a>
Nombre de recurso de Amazon (ARN) del esquema.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

## Véase también
<a name="API_DatasetSchemaSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSchemaSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSchemaSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSchemaSummary) 

# DatasetSummary
<a name="API_DatasetSummary"></a>

Proporciona un resumen de las propiedades de un conjunto de datos. Para obtener una lista completa, llama a la [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html)API.

## Contenido
<a name="API_DatasetSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetSummary-creationDateTime"></a>
La fecha y hora (en tiempo Unix) en que se creó el conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetArn **   <a name="personalize-Type-DatasetSummary-datasetArn"></a>
El nombre de recurso de Amazon (ARN) del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** datasetType **   <a name="personalize-Type-DatasetSummary-datasetType"></a>
El tipo del conjunto de datos. Uno de los valores siguientes:  
+ Interacciones
+ Items
+ Users
+ Event-Interactions
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `^[A-Za-z_]+$`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez el conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-DatasetSummary-name"></a>
Nombre del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-DatasetSummary-status"></a>
El estado del conjunto de datos.  
Un conjunto de datos puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DatasetSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWSSDKs, consulta lo siguiente:
+  [AWSSDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetSummary) 
+  [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetSummary) 
+  [AWSSDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetSummary) 

# DatasetUpdateSummary
<a name="API_DatasetUpdateSummary"></a>

Describe una actualización de un conjunto de datos.

## Contenido
<a name="API_DatasetUpdateSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetUpdateSummary-creationDateTime"></a>
La fecha y hora de creación (en tiempo Unix) de la actualización del conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-DatasetUpdateSummary-failureReason"></a>
Si se produce un error en la actualización de un conjunto de datos, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetUpdateSummary-lastUpdatedDateTime"></a>
La fecha y hora de la última actualización (en tiempo Unix) del conjunto de datos.  
Tipo: marca temporal  
Obligatorio: no

 ** schemaArn **   <a name="personalize-Type-DatasetUpdateSummary-schemaArn"></a>
El nombre de recurso de Amazon (ARN) del esquema que sustituyó al esquema anterior del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-DatasetUpdateSummary-status"></a>
El estado de la actualización del conjunto de datos.   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DatasetUpdateSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetUpdateSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetUpdateSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetUpdateSummary) 

# DataSource
<a name="API_DataSource"></a>

Describe el origen de datos que contiene los datos que se cargarán en un conjunto de datos o la lista de registros que se eliminarán de Amazon Personalize.

## Contenido
<a name="API_DataSource_Contents"></a>

 ** dataLocation **   <a name="personalize-Type-DataSource-dataLocation"></a>
En los trabajos de importación de conjuntos de datos, la ruta al bucket de Amazon S3 donde se almacenan los datos que desea cargar en el conjunto de datos. En los trabajos de eliminación de datos, la ruta al bucket de Amazon S3 que almacena la lista de registros que se eliminarán.   
 Por ejemplo:   
 `s3://bucket-name/folder-name/fileName.csv`   
Si los archivos CSV se encuentran en un bucket de Amazon S3 y desea que en el trabajo de importación o de eliminación de datos se tengan en cuenta varios archivos, puede especificar la ruta a la carpeta. Con una tarea de eliminación de datos, Amazon Personalize utiliza todos los archivos de la carpeta y de cualquier subcarpeta. Use la siguiente sintaxis con una `/` después del nombre de la carpeta:  
 `s3://bucket-name/folder-name/`   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `(s3|http|https)://.+`   
Obligatorio: no

## Véase también
<a name="API_DataSource_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DataSource) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DataSource) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DataSource) 

# DefaultCategoricalHyperParameterRange
<a name="API_DefaultCategoricalHyperParameterRange"></a>

Proporciona el nombre y el rango predeterminado de un hiperparámetro categórico y si el hiperparámetro se puede ajustar. Se puede determinar el valor de un hiperparámetro ajustable durante la optimización de hiperparámetros (HPO).

## Contenido
<a name="API_DefaultCategoricalHyperParameterRange_Contents"></a>

 ** isTunable **   <a name="personalize-Type-DefaultCategoricalHyperParameterRange-isTunable"></a>
Si el hiperparámetro se puede ajustar.  
Tipo: Booleano  
Obligatorio: no

 ** name **   <a name="personalize-Type-DefaultCategoricalHyperParameterRange-name"></a>
El nombre del hiperparámetro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** values **   <a name="personalize-Type-DefaultCategoricalHyperParameterRange-values"></a>
Una lista de las categorías del hiperparámetro.  
Tipo: matriz de cadenas  
Miembros de la matriz: número máximo de 100 elementos.  
Limitaciones de longitud: longitud máxima de 1000 caracteres.  
Obligatorio: no

## Véase también
<a name="API_DefaultCategoricalHyperParameterRange_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultCategoricalHyperParameterRange) 

# DefaultContinuousHyperParameterRange
<a name="API_DefaultContinuousHyperParameterRange"></a>

Proporciona el nombre y el rango predeterminado de un hiperparámetro continuo y si el hiperparámetro se puede ajustar. Se puede determinar el valor de un hiperparámetro ajustable durante la optimización de hiperparámetros (HPO).

## Contenido
<a name="API_DefaultContinuousHyperParameterRange_Contents"></a>

 ** isTunable **   <a name="personalize-Type-DefaultContinuousHyperParameterRange-isTunable"></a>
Si el hiperparámetro se puede ajustar.  
Tipo: Booleano  
Obligatorio: no

 ** maxValue **   <a name="personalize-Type-DefaultContinuousHyperParameterRange-maxValue"></a>
El valor máximo permitido para el hiperparámetro.  
Tipo: doble  
Rango válido: valor mínimo de -1000000.  
Obligatorio: no

 ** minValue **   <a name="personalize-Type-DefaultContinuousHyperParameterRange-minValue"></a>
El valor mínimo permitido para el hiperparámetro.  
Tipo: doble  
Rango válido: valor mínimo de -1000000.  
Obligatorio: no

 ** name **   <a name="personalize-Type-DefaultContinuousHyperParameterRange-name"></a>
El nombre del hiperparámetro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DefaultContinuousHyperParameterRange_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultContinuousHyperParameterRange) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultContinuousHyperParameterRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultContinuousHyperParameterRange) 

# DefaultHyperParameterRanges
<a name="API_DefaultHyperParameterRanges"></a>

Especifica los hiperparámetros y sus rangos predeterminados. Los hiperparámetros pueden ser categóricos o continuos o tener valores enteros.

## Contenido
<a name="API_DefaultHyperParameterRanges_Contents"></a>

 ** categoricalHyperParameterRanges **   <a name="personalize-Type-DefaultHyperParameterRanges-categoricalHyperParameterRanges"></a>
Los hiperparámetros categóricos y sus rangos predeterminados.  
Tipo: matriz de objetos [DefaultCategoricalHyperParameterRange](API_DefaultCategoricalHyperParameterRange.md)  
Miembros de la matriz: número máximo de 100 elementos.  
Obligatorio: no

 ** continuousHyperParameterRanges **   <a name="personalize-Type-DefaultHyperParameterRanges-continuousHyperParameterRanges"></a>
Los hiperparámetros continuos y sus rangos predeterminados.  
Tipo: matriz de objetos [DefaultContinuousHyperParameterRange](API_DefaultContinuousHyperParameterRange.md)  
Miembros de la matriz: número máximo de 100 elementos.  
Obligatorio: no

 ** integerHyperParameterRanges **   <a name="personalize-Type-DefaultHyperParameterRanges-integerHyperParameterRanges"></a>
Los hiperparámetros con valores enteros y sus rangos predeterminados.  
Tipo: matriz de objetos [DefaultIntegerHyperParameterRange](API_DefaultIntegerHyperParameterRange.md)  
Miembros de la matriz: número máximo de 100 elementos.  
Obligatorio: no

## Véase también
<a name="API_DefaultHyperParameterRanges_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultHyperParameterRanges) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultHyperParameterRanges) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultHyperParameterRanges) 

# DefaultIntegerHyperParameterRange
<a name="API_DefaultIntegerHyperParameterRange"></a>

Proporciona el nombre y el rango predeterminado de un hiperparámetro con valores enteros y si el hiperparámetro se puede ajustar. Se puede determinar el valor de un hiperparámetro ajustable durante la optimización de hiperparámetros (HPO).

## Contenido
<a name="API_DefaultIntegerHyperParameterRange_Contents"></a>

 ** isTunable **   <a name="personalize-Type-DefaultIntegerHyperParameterRange-isTunable"></a>
Indica si el hiperparámetro se puede ajustar.  
Tipo: Booleano  
Obligatorio: no

 ** maxValue **   <a name="personalize-Type-DefaultIntegerHyperParameterRange-maxValue"></a>
El valor máximo permitido para el hiperparámetro.  
Tipo: número entero  
Rango válido: valor máximo de 1000000.  
Obligatorio: no

 ** minValue **   <a name="personalize-Type-DefaultIntegerHyperParameterRange-minValue"></a>
El valor mínimo permitido para el hiperparámetro.  
Tipo: número entero  
Rango válido: valor mínimo de -1000000.  
Obligatorio: no

 ** name **   <a name="personalize-Type-DefaultIntegerHyperParameterRange-name"></a>
El nombre del hiperparámetro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_DefaultIntegerHyperParameterRange_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DefaultIntegerHyperParameterRange) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DefaultIntegerHyperParameterRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DefaultIntegerHyperParameterRange) 

# EventParameters
<a name="API_EventParameters"></a>

Describe los parámetros de evento que se utilizan para en la creación de soluciones.

## Contenido
<a name="API_EventParameters_Contents"></a>

 ** eventType **   <a name="personalize-Type-EventParameters-eventType"></a>
El nombre del tipo de evento que se debe tener en cuenta para la creación de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** eventValueThreshold **   <a name="personalize-Type-EventParameters-eventValueThreshold"></a>
El umbral del tipo de evento. Para crear la solución, solo se tendrán en cuenta los eventos con un valor superior o igual a este umbral.  
Tipo: Doble  
Obligatorio: no

 ** weight **   <a name="personalize-Type-EventParameters-weight"></a>
La ponderación del tipo de evento. Una ponderación más alta significa que el tipo de evento tiene mayor importancia para la solución creada.  
Tipo: doble  
Rango válido: valor mínimo de 0. El valor máximo es de 1.  
Obligatorio: no

## Véase también
<a name="API_EventParameters_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventParameters) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventParameters) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventParameters) 

# EventsConfig
<a name="API_EventsConfig"></a>

Describe la configuración de los eventos, que se utilizan en la creación de soluciones.

## Contenido
<a name="API_EventsConfig_Contents"></a>

 ** eventParametersList **   <a name="personalize-Type-EventsConfig-eventParametersList"></a>
Una lista de parámetros de eventos, que incluye los tipos de evento y los umbrales y ponderaciones de los valores de evento.  
Tipo: matriz de objetos [EventParameters](API_EventParameters.md)  
Miembros de la matriz: número máximo de 10 elementos.  
Obligatorio: no

## Véase también
<a name="API_EventsConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventsConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventsConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventsConfig) 

# EventTracker
<a name="API_EventTracker"></a>

Proporciona información sobre un rastreador de eventos.

## Contenido
<a name="API_EventTracker_Contents"></a>

 ** accountId **   <a name="personalize-Type-EventTracker-accountId"></a>
La cuenta AWS propietaria del rastreador de eventos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-EventTracker-creationDateTime"></a>
La fecha y la hora (en formato Unix) en que se creó el rastreador de eventos.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-EventTracker-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que recibe los datos del evento.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** eventTrackerArn **   <a name="personalize-Type-EventTracker-eventTrackerArn"></a>
El ARN del rastreador de eventos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-EventTracker-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez el rastreador de eventos.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-EventTracker-name"></a>
El nombre del rastreador de eventos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-EventTracker-status"></a>
El estado del rastreador de eventos.  
Un rastreador de eventos puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** trackingId **   <a name="personalize-Type-EventTracker-trackingId"></a>
ID del rastreador de eventos. Incluya este ID en las solicitudes a la API [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_EventTracker_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTracker) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTracker) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTracker) 

# EventTrackerSummary
<a name="API_EventTrackerSummary"></a>

Proporciona un resumen de las propiedades de un rastreador de eventos. Para obtener una lista completa, llame a la API [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html).

## Contenido
<a name="API_EventTrackerSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-EventTrackerSummary-creationDateTime"></a>
La fecha y la hora (en hora Unix) en que se creó el rastreador de eventos.  
Tipo: marca temporal  
Obligatorio: no

 ** eventTrackerArn **   <a name="personalize-Type-EventTrackerSummary-eventTrackerArn"></a>
El nombre de recurso de Amazon (ARN) del rastreador de eventos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-EventTrackerSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez el rastreador de eventos.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-EventTrackerSummary-name"></a>
El nombre del rastreador de eventos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-EventTrackerSummary-status"></a>
El estado del rastreador de eventos.  
Un rastreador de eventos puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_EventTrackerSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/EventTrackerSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/EventTrackerSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/EventTrackerSummary) 

# FeatureTransformation
<a name="API_FeatureTransformation"></a>

Proporciona información sobre la transformación de características. La transformación de características es el proceso de modificar los datos de entrada sin procesar para que tengan un formato más adecuado para el entrenamiento de modelos.

## Contenido
<a name="API_FeatureTransformation_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-FeatureTransformation-creationDateTime"></a>
La fecha y la hora de creación (en tiempo Unix) de la transformación de la característica.  
Tipo: marca temporal  
Obligatorio: no

 ** defaultParameters **   <a name="personalize-Type-FeatureTransformation-defaultParameters"></a>
Proporciona los parámetros predeterminados para la transformación de características.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** featureTransformationArn **   <a name="personalize-Type-FeatureTransformation-featureTransformationArn"></a>
El nombre de recurso de Amazon (ARN) del objeto FeatureTransformation.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-FeatureTransformation-lastUpdatedDateTime"></a>
La fecha y la hora de la última actualización (en tiempo Unix) de la transformación de características.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-FeatureTransformation-name"></a>
El nombre de la transformación de características.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-FeatureTransformation-status"></a>
El estado de la transformación de características.  
Un transformación de características puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_FeatureTransformation_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FeatureTransformation) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FeatureTransformation) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FeatureTransformation) 

# FieldsForThemeGeneration
<a name="API_FieldsForThemeGeneration"></a>

Asignación de cadena a cadena de los detalles de configuración para la generación de temas.

## Contenido
<a name="API_FieldsForThemeGeneration_Contents"></a>

 ** itemName **   <a name="personalize-Type-FieldsForThemeGeneration-itemName"></a>
El nombre de la columna del conjunto de datos de elementos que almacena el nombre de cada elemento del conjunto de datos.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 150 caracteres.  
Patrón: `[A-Za-z_][A-Za-z\d_]*`   
Obligatorio: sí

## Véase también
<a name="API_FieldsForThemeGeneration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FieldsForThemeGeneration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FieldsForThemeGeneration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FieldsForThemeGeneration) 

# Filter
<a name="API_Filter"></a>

Contiene información sobre un filtro de recomendaciones, incluidos su ARN, estado y expresión de filtro.

## Contenido
<a name="API_Filter_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-Filter-creationDateTime"></a>
La hora a la que se creó el filtro.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-Filter-datasetGroupArn"></a>
El ARN del grupo de conjuntos de datos al que pertenece el filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-Filter-failureReason"></a>
Si se produjo un error en el filtro, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** filterArn **   <a name="personalize-Type-Filter-filterArn"></a>
El ARN del filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** filterExpression **   <a name="personalize-Type-Filter-filterExpression"></a>
Especifica el tipo de interacciones entre los elementos que se van a filtrar de los resultados de las recomendaciones. La expresión de filtro debe seguir reglas de formato específicas. Para obtener información sobre la estructura y la sintaxis de la expresión de filtro, consulte [Expresiones de filtro](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2500 caracteres.  
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-Filter-lastUpdatedDateTime"></a>
La hora en la que se actualizó el filtro por última vez.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-Filter-name"></a>
El nombre del filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-Filter-status"></a>
El estado del filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_Filter_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Filter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Filter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Filter) 

# FilterSummary
<a name="API_FilterSummary"></a>

Un breve resumen de los atributos de un filtro.

## Contenido
<a name="API_FilterSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-FilterSummary-creationDateTime"></a>
La hora a la que se creó el filtro.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-FilterSummary-datasetGroupArn"></a>
El ARN del grupo de conjuntos de datos al que pertenece el filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-FilterSummary-failureReason"></a>
Si se produjo un error en el filtro, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** filterArn **   <a name="personalize-Type-FilterSummary-filterArn"></a>
El ARN del filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-FilterSummary-lastUpdatedDateTime"></a>
La hora en la que se actualizó el filtro por última vez.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-FilterSummary-name"></a>
El nombre del filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-FilterSummary-status"></a>
El estado del filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_FilterSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/FilterSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/FilterSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/FilterSummary) 

# HPOConfig
<a name="API_HPOConfig"></a>

Describe las propiedades de la optimización de hiperparámetros (HPO).

## Contenido
<a name="API_HPOConfig_Contents"></a>

 ** algorithmHyperParameterRanges **   <a name="personalize-Type-HPOConfig-algorithmHyperParameterRanges"></a>
Los hiperparámetros y los rangos permitidos.  
Tipo: objeto [HyperParameterRanges](API_HyperParameterRanges.md)  
Obligatorio: no

 ** hpoObjective **   <a name="personalize-Type-HPOConfig-hpoObjective"></a>
La métrica que optimizará durante la HPO.  
Amazon Personalize no admite la configuración de `hpoObjective` en este momento.
Tipo: objeto [HPOObjective](API_HPOObjective.md)  
Obligatorio: no

 ** hpoResourceConfig **   <a name="personalize-Type-HPOConfig-hpoResourceConfig"></a>
Describe la configuración de recursos para HPO.  
Tipo: objeto [HPOResourceConfig](API_HPOResourceConfig.md)  
Obligatorio: no

## Véase también
<a name="API_HPOConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOConfig) 

# HPOObjective
<a name="API_HPOObjective"></a>

La métrica que se optimizará durante la optimización de hiperparámetros (HPO).

**nota**  
Amazon Personalize no admite la configuración de `hpoObjective` en este momento.

## Contenido
<a name="API_HPOObjective_Contents"></a>

 ** metricName **   <a name="personalize-Type-HPOObjective-metricName"></a>
El nombre de la métrica.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** metricRegex **   <a name="personalize-Type-HPOObjective-metricRegex"></a>
Una expresión regular para buscar la métrica en los registros de trabajos de formación.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** type **   <a name="personalize-Type-HPOObjective-type"></a>
El tipo de la métrica. Los valores válidos son `Maximize` y `Minimize`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_HPOObjective_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOObjective) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOObjective) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOObjective) 

# HPOResourceConfig
<a name="API_HPOResourceConfig"></a>

Describe la configuración de recursos para la optimización de hiperparámetros (HPO).

## Contenido
<a name="API_HPOResourceConfig_Contents"></a>

 ** maxNumberOfTrainingJobs **   <a name="personalize-Type-HPOResourceConfig-maxNumberOfTrainingJobs"></a>
La cantidad máxima de trabajos de entrenamiento cuando se crea una versión de la solución. El valor máximo para `maxNumberOfTrainingJobs` es `40`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** maxParallelTrainingJobs **   <a name="personalize-Type-HPOResourceConfig-maxParallelTrainingJobs"></a>
La cantidad máxima de trabajos de entrenamiento paralelos cuando se crea una versión de la solución. El valor máximo para `maxParallelTrainingJobs` es `10`.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_HPOResourceConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HPOResourceConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HPOResourceConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HPOResourceConfig) 

# HyperParameterRanges
<a name="API_HyperParameterRanges"></a>

Especifica los hiperparámetros y sus rangos. Los hiperparámetros pueden ser categóricos o continuos o tener valores enteros.

## Contenido
<a name="API_HyperParameterRanges_Contents"></a>

 ** categoricalHyperParameterRanges **   <a name="personalize-Type-HyperParameterRanges-categoricalHyperParameterRanges"></a>
Los hiperparámetros categóricos y sus rangos.  
Tipo: matriz de objetos [CategoricalHyperParameterRange](API_CategoricalHyperParameterRange.md)  
Miembros de la matriz: número máximo de 100 elementos.  
Obligatorio: no

 ** continuousHyperParameterRanges **   <a name="personalize-Type-HyperParameterRanges-continuousHyperParameterRanges"></a>
Los hiperparámetros continuos y sus rangos.  
Tipo: matriz de objetos [ContinuousHyperParameterRange](API_ContinuousHyperParameterRange.md)  
Miembros de la matriz: número máximo de 100 elementos.  
Obligatorio: no

 ** integerHyperParameterRanges **   <a name="personalize-Type-HyperParameterRanges-integerHyperParameterRanges"></a>
Los hiperparámetros con valores enteros y sus rangos.  
Tipo: matriz de objetos [IntegerHyperParameterRange](API_IntegerHyperParameterRange.md)  
Miembros de la matriz: número máximo de 100 elementos.  
Obligatorio: no

## Véase también
<a name="API_HyperParameterRanges_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/HyperParameterRanges) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/HyperParameterRanges) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/HyperParameterRanges) 

# IntegerHyperParameterRange
<a name="API_IntegerHyperParameterRange"></a>

Proporciona el nombre y el rango de un hiperparámetro de valores enteros.

## Contenido
<a name="API_IntegerHyperParameterRange_Contents"></a>

 ** maxValue **   <a name="personalize-Type-IntegerHyperParameterRange-maxValue"></a>
El valor máximo permitido para el hiperparámetro.  
Tipo: número entero  
Rango válido: valor máximo de 1000000.  
Obligatorio: no

 ** minValue **   <a name="personalize-Type-IntegerHyperParameterRange-minValue"></a>
El valor mínimo permitido para el hiperparámetro.  
Tipo: número entero  
Rango válido: valor mínimo de -1000000.  
Obligatorio: no

 ** name **   <a name="personalize-Type-IntegerHyperParameterRange-name"></a>
El nombre del hiperparámetro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_IntegerHyperParameterRange_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/IntegerHyperParameterRange) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/IntegerHyperParameterRange) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/IntegerHyperParameterRange) 

# MetricAttribute
<a name="API_MetricAttribute"></a>

Contiene información sobre una métrica de la que informa una atribución de métricas. Para obtener más información, consulte [Medición del impacto de las recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).

## Contenido
<a name="API_MetricAttribute_Contents"></a>

 ** eventType **   <a name="personalize-Type-MetricAttribute-eventType"></a>
El tipo de evento de la métrica.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256 caracteres.  
Obligatorio: sí

 ** expression **   <a name="personalize-Type-MetricAttribute-expression"></a>
La expresión del atributo. Las funciones disponibles son `SUM()` o `SAMPLECOUNT()`. Para las funciones SUM(), proporcione el tipo de conjunto de datos (interacciones o elementos) y la columna que se va a sumar como parámetro. Por ejemplo, SUM(Items.PRICE).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256 caracteres.  
Obligatorio: sí

 ** metricName **   <a name="personalize-Type-MetricAttribute-metricName"></a>
El nombre de la métrica. El nombre le ayuda a identificar la métrica en Amazon CloudWatch o Amazon S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256 caracteres.  
Obligatorio: sí

## Véase también
<a name="API_MetricAttribute_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribute) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribute) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribute) 

# MetricAttribution
<a name="API_MetricAttribution"></a>

Contiene información sobre una atribución de métricas. La atribución de métricas crea informes sobre los datos que importa en Amazon Personalize. En función de cómo haya importado los datos, los informes se pueden ver en Amazon CloudWatch o Amazon S3. Para obtener más información, consulte [Medición del impacto de las recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).

## Contenido
<a name="API_MetricAttribution_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-MetricAttribution-creationDateTime"></a>
Fecha y hora de creación de la atribución de métricas.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-MetricAttribution-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos de las atribuciones de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-MetricAttribution-failureReason"></a>
El motivo del error de la atribución de métricas.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-MetricAttribution-lastUpdatedDateTime"></a>
Fecha y hora de la última actualización de la atribución de métricas.  
Tipo: marca temporal  
Obligatorio: no

 ** metricAttributionArn **   <a name="personalize-Type-MetricAttribution-metricAttributionArn"></a>
El nombre de recurso de Amazon (ARN) de la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** metricsOutputConfig **   <a name="personalize-Type-MetricAttribution-metricsOutputConfig"></a>
La configuración de salida de la atribución de métricas.  
Tipo: objeto [MetricAttributionOutput](API_MetricAttributionOutput.md)  
Obligatorio: no

 ** name **   <a name="personalize-Type-MetricAttribution-name"></a>
El nombre de la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-MetricAttribution-status"></a>
El estado de la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_MetricAttribution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttribution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttribution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttribution) 

# MetricAttributionOutput
<a name="API_MetricAttributionOutput"></a>

Los detalles de configuración de salida para la atribución de métricas.

## Contenido
<a name="API_MetricAttributionOutput_Contents"></a>

 ** roleArn **   <a name="personalize-Type-MetricAttributionOutput-roleArn"></a>
El nombre de recurso de Amazon (ARN) del rol de servicio de IAM que tiene permisos para añadir datos al bucket de Amazon S3 de salida y añadir métricas a Amazon CloudWatch. Para obtener más información, consulte [Medición del impacto de las recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: sí

 ** s3DataDestination **   <a name="personalize-Type-MetricAttributionOutput-s3DataDestination"></a>
Los detalles de configuración de un bucket de entrada o salida de Amazon S3.  
Tipo: objeto [S3DataConfig](API_S3DataConfig.md)  
Obligatorio: no

## Véase también
<a name="API_MetricAttributionOutput_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionOutput) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionOutput) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionOutput) 

# MetricAttributionSummary
<a name="API_MetricAttributionSummary"></a>

Proporciona un resumen de las propiedades de una atribución de métricas. Para obtener una lista completa, llame a [DescribeMetricAttribution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeMetricAttribution.html).

## Contenido
<a name="API_MetricAttributionSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-MetricAttributionSummary-creationDateTime"></a>
Fecha y hora de creación de la atribución de métricas.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-MetricAttributionSummary-failureReason"></a>
El motivo del error de la atribución de métricas.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-MetricAttributionSummary-lastUpdatedDateTime"></a>
Fecha y hora de la última actualización de la atribución de métricas.  
Tipo: marca temporal  
Obligatorio: no

 ** metricAttributionArn **   <a name="personalize-Type-MetricAttributionSummary-metricAttributionArn"></a>
El nombre de recurso de Amazon (ARN) de la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** name **   <a name="personalize-Type-MetricAttributionSummary-name"></a>
El nombre de la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** status **   <a name="personalize-Type-MetricAttributionSummary-status"></a>
El estado de la atribución de métricas.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_MetricAttributionSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/MetricAttributionSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/MetricAttributionSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/MetricAttributionSummary) 

# OptimizationObjective
<a name="API_OptimizationObjective"></a>

Describe el objetivo adicional de la solución, como maximizar los minutos de streaming o aumentar los ingresos. Para obtener más información, consulte [Optimización de una solución](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html).

## Contenido
<a name="API_OptimizationObjective_Contents"></a>

 ** itemAttribute **   <a name="personalize-Type-OptimizationObjective-itemAttribute"></a>
La columna de metadatos numéricos de un conjunto de datos de elementos relacionada con el objetivo de optimización. Por ejemplo, VIDEO\$1LENGTH (para maximizar los minutos de streaming) o PRICE (para maximizar los ingresos).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 150 caracteres.  
Obligatorio: no

 ** objectiveSensitivity **   <a name="personalize-Type-OptimizationObjective-objectiveSensitivity"></a>
Especifica cómo Amazon Personalize equilibra la importancia de su objetivo de optimización con la relevancia.  
Tipo: cadena  
Valores válidos: `LOW | MEDIUM | HIGH | OFF`   
Obligatorio: no

## Véase también
<a name="API_OptimizationObjective_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/OptimizationObjective) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/OptimizationObjective) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/OptimizationObjective) 

# Recipe
<a name="API_Recipe"></a>

Proporciona información sobre una receta. Cada receta proporciona un algoritmo que Amazon Personalize utiliza en el entrenamiento de modelos cuando se utiliza la operación [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html). 

## Contenido
<a name="API_Recipe_Contents"></a>

 ** algorithmArn **   <a name="personalize-Type-Recipe-algorithmArn"></a>
El nombre de recurso de Amazon (ARN) del algoritmo que Amazon Personalize utiliza para entrenar el modelo.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-Recipe-creationDateTime"></a>
La fecha y la hora (en formato Unix) en que se creó la receta.  
Tipo: marca temporal  
Obligatorio: no

 ** description **   <a name="personalize-Type-Recipe-description"></a>
La descripción de la receta.  
Tipo: cadena  
Requerido: no

 ** featureTransformationArn **   <a name="personalize-Type-Recipe-featureTransformationArn"></a>
El ARN del objeto FeatureTransformation.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-Recipe-lastUpdatedDateTime"></a>
La fecha y hora (en formato Unix) en que se actualizó por última vez la receta.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-Recipe-name"></a>
El nombre de la receta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** recipeArn **   <a name="personalize-Type-Recipe-recipeArn"></a>
El nombre de recurso de Amazon (ARN) de la receta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** recipeType **   <a name="personalize-Type-Recipe-recipeType"></a>
Uno de los valores siguientes:  
+ PERSONALIZED\$1RANKING
+ RELATED\$1ITEMS
+ USER\$1PERSONALIZATION
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** status **   <a name="personalize-Type-Recipe-status"></a>
El estado de la receta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_Recipe_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recipe) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recipe) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recipe) 

# RecipeSummary
<a name="API_RecipeSummary"></a>

Proporciona un resumen de las propiedades de una receta. Para obtener una lista completa, llame a la API [DescribeRecipe](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecipe.html).

## Contenido
<a name="API_RecipeSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-RecipeSummary-creationDateTime"></a>
La fecha y la hora (en hora Unix) en que se creó la receta.  
Tipo: marca temporal  
Obligatorio: no

 ** domain **   <a name="personalize-Type-RecipeSummary-domain"></a>
El dominio de la receta (si la receta es un caso de uso de un grupo de conjuntos de datos de dominio).  
Tipo: cadena  
Valores válidos: `ECOMMERCE | VIDEO_ON_DEMAND`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-RecipeSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez la receta.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-RecipeSummary-name"></a>
El nombre de la receta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** recipeArn **   <a name="personalize-Type-RecipeSummary-recipeArn"></a>
El nombre de recurso de Amazon (ARN) de la receta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-RecipeSummary-status"></a>
El estado de la receta.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_RecipeSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecipeSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecipeSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecipeSummary) 

# Recommender
<a name="API_Recommender"></a>

Describe un generador de recomendaciones para un grupo de conjuntos de datos de dominio. Crea un recomendador en un grupo de conjuntos de datos de dominio para un caso de uso de dominio específico (receta de dominio) y especifica el recomendador en una solicitud de [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html).

## Contenido
<a name="API_Recommender_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-Recommender-creationDateTime"></a>
La fecha y la hora (en tiempo Unix) en que se creó el recomendador.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-Recommender-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos de dominio que contiene el recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-Recommender-failureReason"></a>
Si se produce un error en el recomendador, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-Recommender-lastUpdatedDateTime"></a>
La fecha y hora (en formato Unix) en que se actualizó por última vez el recomendador.  
Tipo: marca temporal  
Obligatorio: no

 ** latestRecommenderUpdate **   <a name="personalize-Type-Recommender-latestRecommenderUpdate"></a>
Proporciona un resumen de las últimas actualizaciones del recomendador.   
Tipo: objeto [RecommenderUpdateSummary](API_RecommenderUpdateSummary.md)  
Obligatorio: no

 ** modelMetrics **   <a name="personalize-Type-Recommender-modelMetrics"></a>
Proporciona métricas de evaluación que ayudan a determinar el rendimiento de un recomendador. Para obtener más información, consulte [Evaluación de un recomendador.](https://docs.aws.amazon.com/personalize/latest/dg/evaluating-recommenders.html)  
Tipo: cadena al mapa doble  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Obligatorio: no

 ** name **   <a name="personalize-Type-Recommender-name"></a>
El nombre del recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** recipeArn **   <a name="personalize-Type-Recommender-recipeArn"></a>
El nombre de recurso de Amazon (ARN) de la receta (caso de uso del grupo de conjuntos de datos de dominio) para el que se creó el recomendador.   
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** recommenderArn **   <a name="personalize-Type-Recommender-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** recommenderConfig **   <a name="personalize-Type-Recommender-recommenderConfig"></a>
Los detalles de configuración del recomendador.  
Tipo: objeto [RecommenderConfig](API_RecommenderConfig.md)  
Obligatorio: no

 ** status **   <a name="personalize-Type-Recommender-status"></a>
El estado del recomendador.  
Un recomendador puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_Recommender_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Recommender) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Recommender) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Recommender) 

# RecommenderConfig
<a name="API_RecommenderConfig"></a>

Los detalles de configuración del recomendador.

## Contenido
<a name="API_RecommenderConfig_Contents"></a>

 ** enableMetadataWithRecommendations **   <a name="personalize-Type-RecommenderConfig-enableMetadataWithRecommendations"></a>
Indica si los metadatos con recomendaciones están habilitados para el recomendador. Si está habilitada, puede especificar las columnas del conjunto de datos de elementos en su solicitud de recomendaciones. Amazon Personalize devuelve estos datos para cada elemento en la respuesta a la recomendación. Para obtener información sobre cómo habilitar los metadatos para un recomendador, consulte [Habilitación de los metadatos en las recomendaciones para un recomendador](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata).  
 Si habilita los metadatos en las recomendaciones, incurrirá en costos adicionales. Para obtener más información, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).   
Tipo: Booleano  
Obligatorio: no

 ** itemExplorationConfig **   <a name="personalize-Type-RecommenderConfig-itemExplorationConfig"></a>
Especifica los hiperparámetros de configuración de la exploración, incluidos `explorationWeight` y `explorationItemAgeCutOff`, que desea utilizar para configurar la cantidad de exploración de elementos que Amazon Personalize utiliza al recomendar artículos. Proporciona datos `itemExplorationConfig` solo si sus recomendadores generan recomendaciones personalizadas para un usuario (no elementos populares ni elementos similares).  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** minRecommendationRequestsPerSecond **   <a name="personalize-Type-RecommenderConfig-minRecommendationRequestsPerSecond"></a>
Especifica el número mínimo de solicitudes de recomendación aprovisionadas solicitadas por segundo que Amazon Personalize admitirá. Un valor `minRecommendationRequestsPerSecond` elevado incrementará su factura. Le recomendamos empezar con 1 para `minRecommendationRequestsPerSecond` (el valor predeterminado). Realice un seguimiento de su uso mediante las métricas de Amazon CloudWatch y aumente `minRecommendationRequestsPerSecond` según sea necesario.  
Tipo: número entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** trainingDataConfig **   <a name="personalize-Type-RecommenderConfig-trainingDataConfig"></a>
 Especifica la configuración de los datos de entrenamiento que se utilizará al crear un recomendador de dominios.   
Tipo: objeto [TrainingDataConfig](API_TrainingDataConfig.md)  
Obligatorio: no

## Véase también
<a name="API_RecommenderConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderConfig) 

# RecommenderSummary
<a name="API_RecommenderSummary"></a>

Proporciona un resumen de las propiedades del recomendador.

## Contenido
<a name="API_RecommenderSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-RecommenderSummary-creationDateTime"></a>
La fecha y la hora (en tiempo Unix) en que se creó el recomendador.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-RecommenderSummary-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos de dominio que contiene el recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-RecommenderSummary-lastUpdatedDateTime"></a>
La fecha y hora (en formato Unix) en que se actualizó por última vez el recomendador.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-RecommenderSummary-name"></a>
El nombre del recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** recipeArn **   <a name="personalize-Type-RecommenderSummary-recipeArn"></a>
El nombre de recurso de Amazon (ARN) de la receta (caso de uso del grupo de conjuntos de datos de dominio) para el que se creó el recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** recommenderArn **   <a name="personalize-Type-RecommenderSummary-recommenderArn"></a>
El nombre de recurso de Amazon (ARN) del recomendador.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** recommenderConfig **   <a name="personalize-Type-RecommenderSummary-recommenderConfig"></a>
Los detalles de configuración del recomendador.  
Tipo: objeto [RecommenderConfig](API_RecommenderConfig.md)  
Obligatorio: no

 ** status **   <a name="personalize-Type-RecommenderSummary-status"></a>
El estado del recomendador. Un recomendador puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_RecommenderSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderSummary) 

# RecommenderUpdateSummary
<a name="API_RecommenderUpdateSummary"></a>

Proporciona un resumen de las propiedades de una actualización de recomendador. Para obtener una lista completa, llame a la API [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html).

## Contenido
<a name="API_RecommenderUpdateSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-RecommenderUpdateSummary-creationDateTime"></a>
La fecha y la hora (en formato Unix) en que se creó la actualización del recomendador.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-RecommenderUpdateSummary-failureReason"></a>
Si se produce un error en la actualización del recomendador, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-RecommenderUpdateSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez la actualización del recomendador.  
Tipo: marca temporal  
Obligatorio: no

 ** recommenderConfig **   <a name="personalize-Type-RecommenderUpdateSummary-recommenderConfig"></a>
Los detalles de configuración de la actualización del recomendador.  
Tipo: objeto [RecommenderConfig](API_RecommenderConfig.md)  
Obligatorio: no

 ** status **   <a name="personalize-Type-RecommenderUpdateSummary-status"></a>
El estado de la actualización del recomendador. Una actualización de recomendador puede tener uno de los siguientes estados:  
CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_RecommenderUpdateSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/RecommenderUpdateSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/RecommenderUpdateSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/RecommenderUpdateSummary) 

# S3DataConfig
<a name="API_S3DataConfig"></a>

Los detalles de configuración de un bucket de entrada o salida de Amazon S3.

## Contenido
<a name="API_S3DataConfig_Contents"></a>

 ** path **   <a name="personalize-Type-S3DataConfig-path"></a>
La ruta de archivo del bucket de Amazon S3.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `(s3|http|https)://.+`   
Obligatorio: sí

 ** kmsKeyArn **   <a name="personalize-Type-S3DataConfig-kmsKeyArn"></a>
El nombre de recurso de Amazon (ARN) de la clave AWS Key Management Service (KMS) que Amazon Personalize utiliza para cifrar o descifrar los archivos de entrada y salida.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 2048 caracteres.  
Patrón: `arn:aws.*:kms:.*:[0-9]{12}:key/.*`   
Obligatorio: no

## Véase también
<a name="API_S3DataConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/S3DataConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/S3DataConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/S3DataConfig) 

# Solution
<a name="API_Solution"></a>

**importante**  
De forma predeterminada, todas las soluciones nuevas utilizan el entrenamiento automático. Con el entrenamiento automático, incurrirá en costos de entrenamiento mientras la solución esté activa. Para evitar costos innecesarios, cuando haya terminado, puede [actualizar la solución](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) para desactivar el entrenamiento automático. Para obtener información sobre los costos de entrenamiento, consulte [Precios de Amazon Personalize](https://aws.amazon.com/personalize/pricing/).

Un objeto que proporciona información sobre una solución. Una solución incluye la receta personalizada, los parámetros personalizados y los modelos entrenados (versiones de solución) que Amazon Personalize utiliza para generar recomendaciones. 

Después de crear una solución, no puede cambiar la configuración. Si necesita realizar cambios, puede [clonar la solución](https://docs.aws.amazon.com/personalize/latest/dg/cloning-solution.html) con la consola de Amazon Personalize o crear una nueva.

## Contenido
<a name="API_Solution_Contents"></a>

 ** autoMLResult **   <a name="personalize-Type-Solution-autoMLResult"></a>
Cuando `performAutoML` es verdadero, especifica la mejor receta encontrada.  
Tipo: objeto [AutoMLResult](API_AutoMLResult.md)  
Obligatorio: no

 ** creationDateTime **   <a name="personalize-Type-Solution-creationDateTime"></a>
La fecha y hora de creación (en tiempo Unix) de la solución.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-Solution-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que proporciona los datos de entrenamiento.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** eventType **   <a name="personalize-Type-Solution-eventType"></a>
El tipo de evento (por ejemplo, “clic” o “me gusta”) que se utiliza para entrenar el modelo. Si no se proporciona `eventType`, Amazon Personalize utiliza todas las interacciones para el entrenamiento con la misma ponderación, independientemente del tipo.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-Solution-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez la solución.  
Tipo: marca temporal  
Obligatorio: no

 ** latestSolutionUpdate **   <a name="personalize-Type-Solution-latestSolutionUpdate"></a>
Proporciona un resumen de las últimas actualizaciones de la solución.  
Tipo: objeto [SolutionUpdateSummary](API_SolutionUpdateSummary.md)  
Obligatorio: no

 ** latestSolutionVersion **   <a name="personalize-Type-Solution-latestSolutionVersion"></a>
Describe la versión más reciente de la solución, incluidos el estado y el ARN.  
Tipo: objeto [SolutionVersionSummary](API_SolutionVersionSummary.md)  
Obligatorio: no

 ** name **   <a name="personalize-Type-Solution-name"></a>
El nombre de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** performAutoML **   <a name="personalize-Type-Solution-performAutoML"></a>
No le recomendamos habilitar el machine learning automático. En lugar de eso, puede emparejar su caso de uso con las recetas de Amazon Personalize disponibles. Para obtener más información, consulte [Determining your use case.](https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html) (Determinación de su caso de uso). 
Si se cumple, Amazon Personalize realizará una búsqueda de la mejor receta USER\$1PERSONALIZATION de la lista especificada en la configuración de la solución (`recipeArn` no debe especificarse). Si no se cumple, Amazon Personalize utilizará `recipeArn` para el entrenamiento.  
Tipo: Booleano  
Obligatorio: no

 ** performAutoTraining **   <a name="personalize-Type-Solution-performAutoTraining"></a>
Especifica si la solución crea versiones de solución de forma automática. El valor predeterminado es `True` y la solución crea automáticamente nuevas versiones de solución cada siete días.  
Para obtener más información sobre el entrenamiento automático, consulte [Creación y configuración de una solución](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html).  
Tipo: Booleano  
Obligatorio: no

 ** performHPO **   <a name="personalize-Type-Solution-performHPO"></a>
Si se debe realizar la optimización de hiperparámetros (HPO) en la receta que se ha elegido. El valor predeterminado es `false`.  
Tipo: Booleano  
Obligatorio: no

 ** performIncrementalUpdate **   <a name="personalize-Type-Solution-performIncrementalUpdate"></a>
Un valor booleano que indica si se realizan actualizaciones de entrenamiento incrementales en el modelo. Cuando está activado, permite que el modelo aprenda de los nuevos datos con mayor frecuencia sin necesidad de volver a capacitarse por completo, lo que permite una personalización prácticamente en tiempo real. Este parámetro solo es compatible con las soluciones que utilizan la receta de similitud semántica  
Tipo: Booleano  
Obligatorio: no

 ** recipeArn **   <a name="personalize-Type-Solution-recipeArn"></a>
El ARN de la receta que se ha utilizado para crear la solución. Esto es obligatorio cuando `performAutoML` es falso.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** solutionArn **   <a name="personalize-Type-Solution-solutionArn"></a>
El ARN de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** solutionConfig **   <a name="personalize-Type-Solution-solutionConfig"></a>
Describe las propiedades de configuración de la solución.  
Tipo: objeto [SolutionConfig](API_SolutionConfig.md)  
Obligatorio: no

 ** status **   <a name="personalize-Type-Solution-status"></a>
El estado de la acción.  
Una solución puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_Solution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWSSDKs, consulte lo siguiente:
+  [AWSSDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Solution) 
+  [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Solution) 
+  [AWSSDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Solution) 

# SolutionConfig
<a name="API_SolutionConfig"></a>

Describe las propiedades de configuración de la solución.

## Contenido
<a name="API_SolutionConfig_Contents"></a>

 ** algorithmHyperParameters **   <a name="personalize-Type-SolutionConfig-algorithmHyperParameters"></a>
Muestra los hiperparámetros del algoritmo y sus valores.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** autoMLConfig **   <a name="personalize-Type-SolutionConfig-autoMLConfig"></a>
El objeto [AutoMLConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_AutoMLConfig.html) que contiene una lista de recetas para buscar cuando se ejecuta AutoML.  
Tipo: objeto [AutoMLConfig](API_AutoMLConfig.md)  
Obligatorio: no

 ** autoTrainingConfig **   <a name="personalize-Type-SolutionConfig-autoTrainingConfig"></a>
Especifica la configuración de entrenamiento automático que se utilizará.  
Tipo: objeto [AutoTrainingConfig](API_AutoTrainingConfig.md)  
Obligatorio: no

 ** eventsConfig **   <a name="personalize-Type-SolutionConfig-eventsConfig"></a>
Describe la configuración de un evento, que incluye una lista de parámetros de evento. Puede especificar hasta 10 parámetros de evento. Los eventos se utilizan en la creación de soluciones.  
Tipo: objeto [EventsConfig](API_EventsConfig.md)  
Obligatorio: no

 ** eventValueThreshold **   <a name="personalize-Type-SolutionConfig-eventValueThreshold"></a>
Para entrenar un modelo, solo se utilizan eventos cuyo valor sea mayor o igual que el umbral.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** featureTransformationParameters **   <a name="personalize-Type-SolutionConfig-featureTransformationParameters"></a>
Muestra los parámetros de transformación de características.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** hpoConfig **   <a name="personalize-Type-SolutionConfig-hpoConfig"></a>
Describe las propiedades de la optimización de hiperparámetros (HPO).  
Tipo: objeto [HPOConfig](API_HPOConfig.md)  
Obligatorio: no

 ** optimizationObjective **   <a name="personalize-Type-SolutionConfig-optimizationObjective"></a>
Describe el objetivo adicional de la solución, como maximizar los minutos de streaming o aumentar los ingresos. Para obtener más información, consulte [Optimización de una solución](https://docs.aws.amazon.com/personalize/latest/dg/optimizing-solution-for-objective.html).  
Tipo: objeto [OptimizationObjective](API_OptimizationObjective.md)  
Obligatorio: no

 ** trainingDataConfig **   <a name="personalize-Type-SolutionConfig-trainingDataConfig"></a>
 La configuración de los datos de entrenamiento que se utilizará al crear una versión de solución personalizada (modelo entrenado).   
Tipo: objeto [TrainingDataConfig](API_TrainingDataConfig.md)  
Obligatorio: no

## Véase también
<a name="API_SolutionConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionConfig) 

# SolutionSummary
<a name="API_SolutionSummary"></a>

Proporciona un resumen de las propiedades de una solución. Para obtener una lista completa, llame a la API [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html).

## Contenido
<a name="API_SolutionSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-SolutionSummary-creationDateTime"></a>
La fecha y hora (en tiempo Unix) en que creó la solución.  
Tipo: marca temporal  
Obligatorio: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-SolutionSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez la solución.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-SolutionSummary-name"></a>
El nombre de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** recipeArn **   <a name="personalize-Type-SolutionSummary-recipeArn"></a>
El nombre de recurso de Amazon (ARN) de la receta que utiliza la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** solutionArn **   <a name="personalize-Type-SolutionSummary-solutionArn"></a>
El nombre de recurso de Amazon (ARN) de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-SolutionSummary-status"></a>
El estado de la acción.  
Una solución puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_SolutionSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionSummary) 

# SolutionUpdateConfig
<a name="API_SolutionUpdateConfig"></a>

Los detalles de configuración de la actualización de la solución.

## Contenido
<a name="API_SolutionUpdateConfig_Contents"></a>

 ** autoTrainingConfig **   <a name="personalize-Type-SolutionUpdateConfig-autoTrainingConfig"></a>
La configuración de entrenamiento automático que se debe usar cuando el valor de `performAutoTraining` es true.  
Tipo: objeto [AutoTrainingConfig](API_AutoTrainingConfig.md)  
Obligatorio: no

 ** eventsConfig **   <a name="personalize-Type-SolutionUpdateConfig-eventsConfig"></a>
Describe la configuración de un evento, que incluye una lista de parámetros de evento. Puede especificar hasta 10 parámetros de evento. Los eventos se utilizan en la creación de soluciones.  
Tipo: objeto [EventsConfig](API_EventsConfig.md)  
Obligatorio: no

## Véase también
<a name="API_SolutionUpdateConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateConfig) 

# SolutionUpdateSummary
<a name="API_SolutionUpdateSummary"></a>

Proporciona un resumen de las propiedades de una actualización de solución. Para obtener una lista completa, llama a la [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html)API.

## Contenido
<a name="API_SolutionUpdateSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-SolutionUpdateSummary-creationDateTime"></a>
La fecha y la hora (en formato Unix) en que se creó la actualización de solución.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-SolutionUpdateSummary-failureReason"></a>
Si se produce un error en una actualización de solución, se indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-SolutionUpdateSummary-lastUpdatedDateTime"></a>
Fecha y hora (en tiempo Unix) en que se actualizó por última vez la actualización de solución.  
Tipo: marca temporal  
Obligatorio: no

 ** performAutoTraining **   <a name="personalize-Type-SolutionUpdateSummary-performAutoTraining"></a>
Especifica si la solución crea automáticamente versiones de solución.  
Tipo: Booleano  
Obligatorio: no

 ** performIncrementalUpdate **   <a name="personalize-Type-SolutionUpdateSummary-performIncrementalUpdate"></a>
Un valor booleano que indica si se realizan actualizaciones de entrenamiento incrementales en el modelo. Cuando está activado, el entrenamiento incremental se realiza para las versiones de la solución con campañas activas y permite que el modelo aprenda de los nuevos datos con mayor frecuencia sin necesidad de volver a capacitarse por completo, lo que permite una personalización casi en tiempo real. Este parámetro solo es compatible con las soluciones que utilizan la receta de similitud semántica. El valor predeterminado es `true`.  
Ten en cuenta que es posible que determinadas puntuaciones y atributos (como las actualizaciones de popularidad y frescura de los artículos utilizadas para influir en la clasificación en la aws-semantic-similarity receta) no se actualicen hasta que se realice el siguiente entrenamiento completo.   
Tipo: Booleano  
Obligatorio: no

 ** solutionUpdateConfig **   <a name="personalize-Type-SolutionUpdateSummary-solutionUpdateConfig"></a>
Detalles de configuración de la solución.  
Tipo: objeto [SolutionUpdateConfig](API_SolutionUpdateConfig.md)  
Obligatorio: no

 ** status **   <a name="personalize-Type-SolutionUpdateSummary-status"></a>
Estado de la actualización de solución. Una actualización de solución puede tener uno de los siguientes estados:  
CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

## Véase también
<a name="API_SolutionUpdateSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWSSDKs, consulta lo siguiente:
+  [AWSSDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionUpdateSummary) 
+  [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionUpdateSummary) 
+  [AWSSDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionUpdateSummary) 

# SolutionVersion
<a name="API_SolutionVersion"></a>

Objeto que proporciona información sobre una versión específica de una [solución](https://docs.aws.amazon.com/personalize/latest/dg/API_Solution.html) en un grupo de conjuntos de datos personalizado.

## Contenido
<a name="API_SolutionVersion_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-SolutionVersion-creationDateTime"></a>
La fecha y hora (en tiempo Unix) en que creó la versión de la solución.  
Tipo: marca temporal  
Obligatorio: no

 ** datasetGroupArn **   <a name="personalize-Type-SolutionVersion-datasetGroupArn"></a>
El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos que proporciona los datos de entrenamiento.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** eventType **   <a name="personalize-Type-SolutionVersion-eventType"></a>
El tipo de evento (por ejemplo, “clic” o “me gusta”) que se utiliza para entrenar el modelo.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-SolutionVersion-failureReason"></a>
Si se produce un error en el entrenamiento de una versión de solución, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-SolutionVersion-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez la solución.  
Tipo: marca temporal  
Obligatorio: no

 ** name **   <a name="personalize-Type-SolutionVersion-name"></a>
El nombre de la versión de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** performAutoML **   <a name="personalize-Type-SolutionVersion-performAutoML"></a>
Si es cierto, Amazon Personalize busca la receta más óptima según la configuración de la solución. Cuando es false (valor predeterminado), Amazon Personalize utiliza `recipeArn`.  
Tipo: Booleano  
Obligatorio: no

 ** performHPO **   <a name="personalize-Type-SolutionVersion-performHPO"></a>
Si se debe realizar la optimización de hiperparámetros (HPO) en la receta que se ha elegido. El valor predeterminado es `false`.  
Tipo: Booleano  
Obligatorio: no

 ** performIncrementalUpdate **   <a name="personalize-Type-SolutionVersion-performIncrementalUpdate"></a>
Si la versión de la solución debe realizar una actualización incremental. Si se establece en true, el entrenamiento procesará solo los datos que hayan cambiado desde el último entrenamiento, de forma similar a cuando TrainingMode está configurado en UPDATE. Esto solo se puede usar con las versiones de la solución que utilizan la receta de personalización del usuario.  
Tipo: Booleano  
Obligatorio: no

 ** recipeArn **   <a name="personalize-Type-SolutionVersion-recipeArn"></a>
El ARN de la receta que se ha utilizado en la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** solutionArn **   <a name="personalize-Type-SolutionVersion-solutionArn"></a>
El ARN de la solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** solutionConfig **   <a name="personalize-Type-SolutionVersion-solutionConfig"></a>
Describe las propiedades de configuración de la solución.  
Tipo: objeto [SolutionConfig](API_SolutionConfig.md)  
Obligatorio: no

 ** solutionVersionArn **   <a name="personalize-Type-SolutionVersion-solutionVersionArn"></a>
El ARN de la versión de solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-SolutionVersion-status"></a>
El estado de la versión de solución.  
Una versión de la solución puede tener uno de los siguientes estados:  
+ CREATE PENDING
+ CREATE IN\$1PROGRESS
+ ACTIVE
+ CREATE FAILED
+ CREATE STOPPING
+ CREATE STOPPED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** trainingHours **   <a name="personalize-Type-SolutionVersion-trainingHours"></a>
El tiempo utilizado para entrenar el modelo. Se le facturará por el tiempo que se tarda en entrenar un modelo. Este campo solo está visible después de que Amazon Personalize entrene correctamente un modelo.  
Tipo: Doble  
Rango válido: valor mínimo de 0.  
Obligatorio: no

 ** trainingMode **   <a name="personalize-Type-SolutionVersion-trainingMode"></a>
El alcance del entrenamiento que se realizará al crear la versión de la solución. Un entrenamiento `FULL` tiene en cuenta todos los datos del grupo de conjuntos de datos. Con `UPDATE` se procesan solo los datos que han cambiado desde el último entrenamiento. Solo las versiones de solución creadas con la receta User-Personalization pueden usar `UPDATE`.   
Tipo: cadena  
Valores válidos: `FULL | UPDATE | AUTOTRAIN`   
Obligatorio: no

 ** trainingType **   <a name="personalize-Type-SolutionVersion-trainingType"></a>
Indica si la versión de solución se creó de forma automática o manual.  
Tipo: cadena  
Valores válidos: `AUTOMATIC | MANUAL`   
Obligatorio: no

 ** tunedHPOParams **   <a name="personalize-Type-SolutionVersion-tunedHPOParams"></a>
Si se realizó la optimización de hiperparámetros, contiene los valores de hiperparámetros del modelo con mejor rendimiento.  
Tipo: objeto [TunedHPOParams](API_TunedHPOParams.md)  
Obligatorio: no

## Véase también
<a name="API_SolutionVersion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWSSDKs, consulte lo siguiente:
+  [AWSSDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersion) 
+  [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersion) 
+  [AWSSDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersion) 

# SolutionVersionSummary
<a name="API_SolutionVersionSummary"></a>

Proporciona un resumen de las propiedades de una versión de solución. Para obtener una lista completa, llame a la API [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html).

## Contenido
<a name="API_SolutionVersionSummary_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-SolutionVersionSummary-creationDateTime"></a>
La fecha y hora (en tiempo Unix) en que creó esta versión de una solución.  
Tipo: marca temporal  
Obligatorio: no

 ** failureReason **   <a name="personalize-Type-SolutionVersionSummary-failureReason"></a>
Si se produce un error en una versión de solución, indica el motivo.  
Tipo: cadena  
Requerido: no

 ** lastUpdatedDateTime **   <a name="personalize-Type-SolutionVersionSummary-lastUpdatedDateTime"></a>
La fecha y hora (en tiempo Unix) en que se actualizó por última vez la versión de solución.  
Tipo: marca temporal  
Obligatorio: no

 ** solutionVersionArn **   <a name="personalize-Type-SolutionVersionSummary-solutionVersionArn"></a>
El nombre de recurso de Amazon (ARN) de la versión de solución.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** status **   <a name="personalize-Type-SolutionVersionSummary-status"></a>
El estado de la versión de solución.  
Una versión de la solución puede tener uno de los siguientes estados:  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** trainingMode **   <a name="personalize-Type-SolutionVersionSummary-trainingMode"></a>
El alcance del entrenamiento que se realizará al crear la versión de la solución. Un entrenamiento `FULL` tiene en cuenta todos los datos del grupo de conjuntos de datos. Con `UPDATE` se procesan solo los datos que han cambiado desde el último entrenamiento. Solo las versiones de solución creadas con la receta User-Personalization pueden usar `UPDATE`.   
Tipo: cadena  
Valores válidos: `FULL | UPDATE | AUTOTRAIN`   
Obligatorio: no

 ** trainingType **   <a name="personalize-Type-SolutionVersionSummary-trainingType"></a>
Indica si la versión de solución se creó de forma automática o manual.  
Tipo: cadena  
Valores válidos: `AUTOMATIC | MANUAL`   
Obligatorio: no

## Véase también
<a name="API_SolutionVersionSummary_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/SolutionVersionSummary) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/SolutionVersionSummary) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/SolutionVersionSummary) 

# Tag
<a name="API_Tag"></a>

Los metadatos opcionales que se aplican a los recursos para ayudarle a categorizarlos y organizarlos. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Para obtener más información, consulte [Etiquetado de recursos de Amazon Personalize](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html). 

## Contenido
<a name="API_Tag_Contents"></a>

 ** tagKey **   <a name="personalize-Type-Tag-tagKey"></a>
Una parte de un par clave-valor que compone una etiqueta. Un clave es una etiqueta general que actúa como una categoría para valores de etiqueta más específicos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.  
Patrón: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
Obligatorio: sí

 ** tagValue **   <a name="personalize-Type-Tag-tagValue"></a>
La parte opcional de un par clave-valor que compone una etiqueta. Un valor actúa como un descriptor en una categoría de etiquetas (clave).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
Obligatorio: sí

## Véase también
<a name="API_Tag_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/Tag) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/Tag) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/Tag) 

# ThemeGenerationConfig
<a name="API_ThemeGenerationConfig"></a>

Detalles de la configuración para generar temas con un trabajo de inferencia por lotes.

## Contenido
<a name="API_ThemeGenerationConfig_Contents"></a>

 ** fieldsForThemeGeneration **   <a name="personalize-Type-ThemeGenerationConfig-fieldsForThemeGeneration"></a>
Campos utilizados para generar temas descriptivos para un trabajo de inferencia por lotes.  
Tipo: objeto [FieldsForThemeGeneration](API_FieldsForThemeGeneration.md)  
Obligatorio: sí

## Véase también
<a name="API_ThemeGenerationConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ThemeGenerationConfig) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ThemeGenerationConfig) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ThemeGenerationConfig) 

# TrainingDataConfig
<a name="API_TrainingDataConfig"></a>

La configuración de los datos de entrenamiento que se utilizará al crear un recomendador de dominios o una versión de solución personalizada (modelo entrenado).

## Contenido
<a name="API_TrainingDataConfig_Contents"></a>

 ** excludedDatasetColumns **   <a name="personalize-Type-TrainingDataConfig-excludedDatasetColumns"></a>
Especifica las columnas que se van a excluir del entrenamiento. Cada clave es un tipo de conjunto de datos y cada valor es una lista de columnas. Excluya columnas para controlar qué datos utiliza Amazon Personalize para generar recomendaciones.  
 Por ejemplo, puede tener una columna que desee utilizar únicamente para filtrar recomendaciones. Puede excluir esta columna del entrenamiento y Amazon Personalize solo la tendrá en cuenta al filtrar.   
Tipo: mapa de cadena a matriz de cadenas  
Entradas de mapa: número máximo de 3 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256.  
Patrón de clave: `^[A-Za-z_]+$`   
Miembros de la matriz: número máximo de 50 elementos.  
Limitaciones de longitud: longitud máxima de 150 caracteres.  
Patrón: `[A-Za-z_][A-Za-z\d_]*`   
Obligatorio: no

 ** includedDatasetColumns **   <a name="personalize-Type-TrainingDataConfig-includedDatasetColumns"></a>
Especifica las columnas que se van a incluir de la formación. Cada clave es un tipo de conjunto de datos y cada valor es una lista de columnas. Incluye columnas para controlar qué datos utiliza Amazon Personalize para generar recomendaciones.  
Por ejemplo, es posible que tengas varias columnas en el conjunto de datos de tus artículos, pero solo quieras usar el título y la descripción para el entrenamiento. Puede incluir solo estas dos columnas para la formación y Amazon Personalize solo considerará las columnas incluidas para la formación.  
Tipo: mapa de cadena a matriz de cadenas  
Entradas de mapa: número máximo de 3 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256.  
Patrón de clave: `^[A-Za-z_]+$`   
Miembros de la matriz: número máximo de 50 elementos.  
Limitaciones de longitud: longitud máxima de 150 caracteres.  
Patrón: `[A-Za-z_][A-Za-z\d_]*`   
Obligatorio: no

## Véase también
<a name="API_TrainingDataConfig_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWSSDKs, consulte lo siguiente:
+  [AWSSDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TrainingDataConfig) 
+  [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TrainingDataConfig) 
+  [AWSSDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TrainingDataConfig) 

# TunedHPOParams
<a name="API_TunedHPOParams"></a>

Si se realizó la optimización de hiperparámetros (HPO), contiene los valores de hiperparámetros del modelo con mejor rendimiento.

## Contenido
<a name="API_TunedHPOParams_Contents"></a>

 ** algorithmHyperParameters **   <a name="personalize-Type-TunedHPOParams-algorithmHyperParameters"></a>
Una lista de los valores de hiperparámetros del modelo con mejor rendimiento.  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 100 elementos.  
Limitaciones de longitud de clave: longitud máxima de 256 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

## Véase también
<a name="API_TunedHPOParams_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TunedHPOParams) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TunedHPOParams) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TunedHPOParams) 

# Eventos de Amazon Personalize
<a name="API_Types_Amazon_Personalize_Events"></a>

Eventos de Amazon Personalize admite los siguientes tipos de datos:
+  [Action](API_UBS_Action.md) 
+  [ActionInteraction](API_UBS_ActionInteraction.md) 
+  [Event](API_UBS_Event.md) 
+  [Item](API_UBS_Item.md) 
+  [MetricAttribution](API_UBS_MetricAttribution.md) 
+  [User](API_UBS_User.md) 

# Action
<a name="API_UBS_Action"></a>

Representa los metadatos de las acciones agregadas a un conjunto de datos de acciones mediante la API `PutActions`. Para obtener más información, consulte [Importación de acciones de forma individual](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html). 

## Contenido
<a name="API_UBS_Action_Contents"></a>

 ** actionId **   <a name="personalize-Type-UBS_Action-actionId"></a>
ID asociado con la acción.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** properties **   <a name="personalize-Type-UBS_Action-properties"></a>
Mapa de cadenas de metadatos específicos de la acción. Los elementos del mapa se componen de un par clave-valor. Por ejemplo, `{"value": "100"}`.  
Las claves utilizan nombres con mayúsculas y minúsculas que coinciden con los campos del esquema del conjunto de datos de acciones. En el ejemplo anterior, `value` coincide con el campo “VALUE” definido en el esquema de acciones. En el caso de los datos de cadena categóricos, para incluir varias categorías para una sola acción, separe cada categoría con un separador vertical (`|`). Por ejemplo, `\"Deluxe|Premium\"`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 32 000.  
Obligatorio: no

## Véase también
<a name="API_UBS_Action_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Action) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Action) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Action) 

# ActionInteraction
<a name="API_UBS_ActionInteraction"></a>

Representa un evento de interacción de acciones enviado mediante la API `PutActionInteractions`.

## Contenido
<a name="API_UBS_ActionInteraction_Contents"></a>

 ** actionId **   <a name="personalize-Type-UBS_ActionInteraction-actionId"></a>
ID de la acción con la que el usuario ha interactuado. Corresponde al campo `ACTION_ID` del esquema de interacción de acciones.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** eventType **   <a name="personalize-Type-UBS_ActionInteraction-eventType"></a>
Tipo de evento de interacción de acciones. Puede especificar los tipos de evento `Viewed`, `Taken` y `Not Taken`. Para obtener más información sobre los datos de los tipos de eventos de interacción de acciones, consulte [Datos de tipo de eventos](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-event-type-data.html).   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** sessionId **   <a name="personalize-Type-UBS_ActionInteraction-sessionId"></a>
ID asociado a la visita del usuario. La aplicación genera un `sessionId` único cuando un usuario visita por primera vez su sitio web o utiliza su aplicación.   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** timestamp **   <a name="personalize-Type-UBS_ActionInteraction-timestamp"></a>
Marca temporal de cuándo se produjo el evento de interacción de acciones. Las marcas temporales deben estar en formato de tiempo Unix expresado en segundos.  
Tipo: marca temporal  
Obligatorio: sí

 ** eventId **   <a name="personalize-Type-UBS_ActionInteraction-eventId"></a>
ID asociado al evento. Si no se proporciona un ID de evento, Amazon Personalize genera un ID único para el evento. El ID de evento no se utiliza como entrada en el modelo. Amazon Personalize usa el ID del evento para distinguir eventos únicos. Los eventos posteriores al primero con el mismo ID de evento no se utilizan en el entrenamiento con modelos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** impression **   <a name="personalize-Type-UBS_ActionInteraction-impression"></a>
Lista de ID de acciones que representa la secuencia de acciones que ha mostrado al usuario. Por ejemplo, `["actionId1", "actionId2", "actionId3"]`. Amazon Personalize no usa datos de impresiones de los eventos de interacción de acciones. En su lugar, registre varios eventos para cada acción y use el tipo de evento `Viewed`.   
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 25 elementos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** properties **   <a name="personalize-Type-UBS_ActionInteraction-properties"></a>
Un mapa de cadenas de datos específicos de un evento que puede decidir registrar. Por ejemplo, si un usuario realiza una acción, aparte del ID de la acción, también puede enviar el número de acciones realizadas por el usuario.  
Los elementos del mapa se componen de un par clave-valor. Por ejemplo:  
 `{"numberOfActions": "12"}`   
Las claves utilizan nombres con mayúsculas y minúsculas que coinciden con los campos del esquema de interacciones de acción. En el ejemplo anterior, `numberOfActions` coincidiría con el campo “NUMBER\$1OF\$1ACTIONS” definido en el esquema de interacciones de acción.  
 No se puede incluir lo siguiente como palabra clave para las propiedades (no distingue entre mayúsculas y minúsculas).   
+  userId 
+  sessionId 
+ eventType
+ marca de tiempo
+ recommendationId
+ impression
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Obligatorio: no

 ** recommendationId **   <a name="personalize-Type-UBS_ActionInteraction-recommendationId"></a>
ID de la lista de recomendaciones que contiene la acción con la que ha interactuado el usuario.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 40 caracteres.  
Obligatorio: no

 ** userId **   <a name="personalize-Type-UBS_ActionInteraction-userId"></a>
ID del usuario que ha interactuado con la acción. Corresponde al campo `USER_ID` del esquema de interacciones de acción.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

## Véase también
<a name="API_UBS_ActionInteraction_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/ActionInteraction) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/ActionInteraction) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/ActionInteraction) 

# Event
<a name="API_UBS_Event"></a>

Representa la información de eventos de interacción de elementos enviada mediante la API `PutEvents`.

## Contenido
<a name="API_UBS_Event_Contents"></a>

 ** eventType **   <a name="personalize-Type-UBS_Event-eventType"></a>
El tipo de evento, como hacer clic o descargar. Esta propiedad corresponde al campo `EVENT_TYPE` de su esquema del conjunto de datos de interacciones de elementos y depende de los tipos de eventos que esté rastreando.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** sentAt **   <a name="personalize-Type-UBS_Event-sentAt"></a>
La marca de tiempo (en tiempo Unix) del lado del cliente cuando ocurrió el evento.  
Tipo: marca temporal  
Obligatorio: sí

 ** eventId **   <a name="personalize-Type-UBS_Event-eventId"></a>
ID asociado al evento. Si no se proporciona un ID de evento, Amazon Personalize genera un ID único para el evento. El ID de evento no se utiliza como entrada en el modelo. Amazon Personalize usa el ID del evento para distinguir eventos únicos. Los eventos posteriores al primero con el mismo ID de evento no se utilizan en el entrenamiento con modelos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** eventValue **   <a name="personalize-Type-UBS_Event-eventValue"></a>
Valor del evento que corresponde al campo `EVENT_VALUE` del esquema de interacciones de elementos.  
Tipo: flotante  
Obligatorio: no

 ** impression **   <a name="personalize-Type-UBS_Event-impression"></a>
Una lista de ID de elementos que representa la secuencia de elementos que ha mostrado al usuario. Por ejemplo, `["itemId1", "itemId2", "itemId3"]`. Proporcione una lista de elementos para registrar manualmente los datos de las impresiones de un evento. Para obtener más información sobre el registro de los datos de impresiones, consulte [Registro de los datos de impresiones](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data).   
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 25 elementos.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** itemId **   <a name="personalize-Type-UBS_Event-itemId"></a>
Clave del ID de elemento que corresponde al campo `ITEM_ID` del esquema del conjunto de datos de interacciones de elementos.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** metricAttribution **   <a name="personalize-Type-UBS_Event-metricAttribution"></a>
Contiene información sobre la atribución de métricas asociada a un evento. Para obtener más información sobre la atribución de métricas, consulte [Medición del impacto de las recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).  
Tipo: objeto [MetricAttribution](API_UBS_MetricAttribution.md)  
Obligatorio: no

 ** properties **   <a name="personalize-Type-UBS_Event-properties"></a>
Un mapa de cadenas de datos específicos de un evento que puede decidir registrar. Por ejemplo, si un usuario valora una película en su sitio, aparte del ID de película (`itemId`) y la valoración (`eventValue`), también puede enviar el número de valoraciones de películas realizadas por el usuario.  
Los elementos del mapa se componen de un par clave-valor. Por ejemplo:  
 `{"numberOfRatings": "12"}`   
Las claves utilizan nombres con mayúsculas y minúsculas que coinciden con los campos del esquema del conjunto de datos de interacciones de elementos. En el ejemplo anterior, `numberOfRatings` coincidiría con el campo “NUMBER\$1OF\$1RATINGS” definido en el esquema del conjunto de datos de interacciones de elementos.  
 No se puede incluir lo siguiente como palabra clave para las propiedades (no distingue entre mayúsculas y minúsculas).   
+  userId 
+  sessionId 
+ eventType
+ marca de tiempo
+ recommendationId
+ impression
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Obligatorio: no

 ** recommendationId **   <a name="personalize-Type-UBS_Event-recommendationId"></a>
El ID de la lista de recomendaciones que contiene el elemento con el que interactuó el usuario. Proporcione un `recommendationId` para que Amazon Personalize registre implícitamente las recomendaciones que muestra a su usuario como datos de impresiones. O proporcione `recommendationId` si utiliza una atribución de métricas para medir el impacto de las recomendaciones.   
 Para obtener más información sobre el registro de los datos de impresiones, consulte [Registro de los datos de impresiones](https://docs.aws.amazon.com/personalize/latest/dg/recording-events.html#putevents-including-impressions-data). Para obtener más información sobre la creación de una atribución de métricas, consulte [Medición del impacto de las recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).   
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 40 caracteres.  
Obligatorio: no

## Véase también
<a name="API_UBS_Event_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Event) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Event) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Event) 

# Item
<a name="API_UBS_Item"></a>

Representa los metadatos de los elementos agregados a un conjunto de datos de elementos mediante la API `PutItems`. Para obtener más información, consulte [Importación de elementos de forma individual](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html). 

## Contenido
<a name="API_UBS_Item_Contents"></a>

 ** itemId **   <a name="personalize-Type-UBS_Item-itemId"></a>
El ID asociado al elemento.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** properties **   <a name="personalize-Type-UBS_Item-properties"></a>
Un mapa de cadenas de metadatos específicos de un elemento. Los elementos del mapa se componen de un par clave-valor. Por ejemplo, `{"numberOfRatings": "12"}`.  
Las claves utilizan nombres con mayúsculas y minúsculas que coinciden con los campos del esquema del conjunto de datos de elementos. En el ejemplo anterior, `numberOfRatings` coincide con el campo “NUMBER\$1OF\$1RATINGS” definido en el esquema de elementos. En el caso de los datos de cadena categóricos, para incluir varias categorías para un solo elemento, separe cada categoría con un separador vertical (`|`). Por ejemplo, `\"Horror|Action\"`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 32 000.  
Obligatorio: no

## Véase también
<a name="API_UBS_Item_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/Item) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/Item) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/Item) 

# MetricAttribution
<a name="API_UBS_MetricAttribution"></a>

Contiene información sobre una atribución de métricas asociada a un evento. Para obtener más información sobre la atribución de métricas, consulte [Medición del impacto de las recomendaciones](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).

## Contenido
<a name="API_UBS_MetricAttribution_Contents"></a>

 ** eventAttributionSource **   <a name="personalize-Type-UBS_MetricAttribution-eventAttributionSource"></a>
El origen del evento, por ejemplo, un tercero.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 1024 caracteres.  
Patrón: `^[\x20-\x7E]*[\x21-\x7E]+[\x20-\x7E]*$`   
Obligatorio: sí

## Véase también
<a name="API_UBS_MetricAttribution_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/MetricAttribution) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/MetricAttribution) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/MetricAttribution) 

# User
<a name="API_UBS_User"></a>

Representa los metadatos de usuario agregados a un conjunto de datos de usuarios mediante la API `PutUsers`. Para obtener más información, consulte [Importación de usuarios de forma individual](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html).

## Contenido
<a name="API_UBS_User_Contents"></a>

 ** userId **   <a name="personalize-Type-UBS_User-userId"></a>
El ID asociado al usuario.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Obligatorio: sí

 ** properties **   <a name="personalize-Type-UBS_User-properties"></a>
Un mapa de cadenas de metadatos específicos del usuario. Los elementos del mapa se componen de un par clave-valor. Por ejemplo, `{"numberOfVideosWatched": "45"}`.  
Las claves utilizan nombres con mayúsculas y minúsculas que coinciden con los campos del esquema del conjunto de datos de usuarios. En el ejemplo anterior, `numberOfVideosWatched` coincidiría con el campo “NUMBER\$1OF\$1VIDEOS\$1WATCHED” definido en el esquema de usuarios. En el caso de los datos de cadena categóricos, para incluir varias categorías para un solo usuario, separe cada categoría con un separador vertical (`|`). Por ejemplo, `\"Member|Frequent shopper\"`.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 24 000.  
Obligatorio: no

## Véase también
<a name="API_UBS_User_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/User) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/User) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/User) 

# Versión ejecutable de Amazon Personalize
<a name="API_Types_Amazon_Personalize_Runtime"></a>

Versión ejecutable de Amazon Personalize admite los siguientes tipos de datos:
+  [PredictedAction](API_RS_PredictedAction.md) 
+  [PredictedItem](API_RS_PredictedItem.md) 
+  [Promotion](API_RS_Promotion.md) 

# PredictedAction
<a name="API_RS_PredictedAction"></a>

Objeto que identifica una acción.

La API [GetActionRecommendations](API_RS_GetActionRecommendations.md) devuelve una lista de instancias de `PredictedAction`.

## Contenido
<a name="API_RS_PredictedAction_Contents"></a>

 ** actionId **   <a name="personalize-Type-RS_PredictedAction-actionId"></a>
ID de la acción recomendada.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** score **   <a name="personalize-Type-RS_PredictedAction-score"></a>
Puntuación de la acción recomendada. Para obtener información sobre las puntuaciones de las acciones, consulte [Cómo funciona la puntuación de recomendaciones de acciones](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html).  
Tipo: Doble  
Obligatorio: no

## Véase también
<a name="API_RS_PredictedAction_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedAction) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedAction) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedAction) 

# PredictedItem
<a name="API_RS_PredictedItem"></a>

Objeto que identifica un elemento.

Las API [GetRecommendations](API_RS_GetRecommendations.md) y [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) y devuelven una lista de `PredictedItem`.

## Contenido
<a name="API_RS_PredictedItem_Contents"></a>

 ** itemId **   <a name="personalize-Type-RS_PredictedItem-itemId"></a>
El ID del elemento recomendado.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Obligatorio: no

 ** metadata **   <a name="personalize-Type-RS_PredictedItem-metadata"></a>
Metadatos sobre el elemento del conjunto de datos de elementos.  
Tipo: mapa de cadena a cadena  
Limitaciones de longitud de clave: longitud máxima de 150 caracteres.  
Limitaciones de longitud de valor: longitud máxima de 20 000.  
Obligatorio: no

 ** promotionName **   <a name="personalize-Type-RS_PredictedItem-promotionName"></a>
El nombre de la promoción que incluía el elemento previsto.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** reason **   <a name="personalize-Type-RS_PredictedItem-reason"></a>
Si utiliza User-Personalization-v2, una lista de los motivos por los que se ha incluido el elemento en las recomendaciones. Algunos motivos posibles son los siguientes:  
+ Elemento promocionado: indica que el elemento se ha incluido como parte de una promoción que ha aplicado en la solicitud de recomendación.
+ Exploración: indica que el elemento se ha incluido con la exploración. Con la exploración, las recomendaciones incluyen elementos con menos datos de interacciones o relevancia para el usuario. Para obtener más información sobre la exploración, consulte [Exploración](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#about-exploration).
+  Elemento popular: indica que el elemento se ha incluido como marcador de posición de elemento popular. Si utiliza un filtro, en función del número de recomendaciones que elimina el filtro, Amazon Personalize podría agregar marcadores de posición de elemento para `numResults` correspondiente a la solicitud de recomendación. Estos elementos son populares, según los datos de interacciones, que cumplen los criterios de filtro. No tienen una puntuación de relevancia para el usuario. 
Tipo: matriz de cadenas  
Limitaciones de longitud: longitud máxima de 256 caracteres.  
Obligatorio: no

 ** score **   <a name="personalize-Type-RS_PredictedItem-score"></a>
Representación numérica de la certeza del modelo de que el elemento será la siguiente selección del usuario. Para obtener más información sobre la lógica de puntuación, consulte [Puntuaciones de recomendaciones](getting-recommendations.md#how-scores-work).  
Tipo: Doble  
Obligatorio: no

## Véase también
<a name="API_RS_PredictedItem_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/PredictedItem) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/PredictedItem) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/PredictedItem) 

# Promotion
<a name="API_RS_Promotion"></a>

Contiene información sobre una promoción. Una promoción define reglas empresariales adicionales que se aplican a un subconjunto configurable de elementos recomendados.

## Contenido
<a name="API_RS_Promotion_Contents"></a>

 ** filterArn **   <a name="personalize-Type-RS_Promotion-filterArn"></a>
El nombre de recurso de Amazon (ARN) del filtro que utiliza la promoción. Este filtro define los criterios de los artículos promocionados. Para obtener más información, consulte [Filtros de promoción](https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatorio: no

 ** filterValues **   <a name="personalize-Type-RS_Promotion-filterValues"></a>
Los valores que se deben utilizar al promocionar elementos. Para cada parámetro de marcador de posición de la expresión de filtro de la promoción, proporcione el nombre del parámetro (respetando mayúsculas y minúsculas) como clave y los valores del filtro como valor correspondiente. Separe los valores múltiples de un parámetro con una coma.   
En el caso de las expresiones de filtro que utilizan un elemento `INCLUDE` para incluir elementos, debe proporcionar valores para todos los parámetros definidos en la expresión. En el caso de los filtros con expresiones que utilizan un elemento `EXCLUDE` para excluir elementos, puede omitir `filter-values`. En este caso, Amazon Personalize no utiliza esa parte de la expresión para filtrar recomendaciones.  
Para obtener más información sobre la creación de filtros, consulte [Filtrado de recomendaciones y segmentos de usuario](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mapa de cadena a cadena  
Entradas de mapa: número máximo de 25 elementos.  
Limitaciones de longitud de clave: longitud máxima de 50 caracteres.  
Patrón de clave: `[A-Za-z0-9_]+`   
Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.  
Obligatorio: no

 ** name **   <a name="personalize-Type-RS_Promotion-name"></a>
El nombre de la promoción.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatorio: no

 ** percentPromotedItems **   <a name="personalize-Type-RS_Promotion-percentPromotedItems"></a>
El porcentaje de elementos recomendados a los que se debe aplicar la promoción.  
Tipo: número entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

## Véase también
<a name="API_RS_Promotion_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/Promotion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/Promotion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/Promotion) 

# Errores comunes
<a name="CommonErrors"></a>

En esta sección, se enumeran los errores comunes a las acciones de la API de todos los servicios de AWS. En el caso de los errores específicos de una acción de la API de este servicio, consulte el tema de dicha acción de la API.

 **AccessDeniedException**   
No tiene acceso suficiente para realizar esta acción.  
Código de estado HTTP: 400

 **IncompleteSignature**   
La firma de solicitud no se ajusta a los estándares de AWS.  
Código de estado HTTP: 400

 **InternalFailure**   <a name="CommonErrors-InternalFailure"></a>
El procesamiento de la solicitud ha devuelto un error debido a un error o una excepción desconocidos.  
Código de estado HTTP: 500

 **InvalidAction**   <a name="CommonErrors-InvalidAction"></a>
La acción u operación solicitada no es válida. Compruebe que la acción se ha escrito correctamente.  
Código de estado HTTP: 400

 **InvalidClientTokenId**   <a name="CommonErrors-InvalidClientTokenId"></a>
El certificado X.509 o el ID de clave de acceso de AWS proporcionado no existen en nuestros registros.  
Código de estado HTTP: 403

 **NotAuthorized**   <a name="CommonErrors-NotAuthorized"></a>
No tiene permiso para realizar esta acción.  
Código de estado HTTP: 400

 **OptInRequired**   <a name="CommonErrors-OptInRequired"></a>
El ID de clave de acceso de AWS necesita una suscripción al servicio.  
Código de estado HTTP: 403

 **RequestExpired**   <a name="CommonErrors-RequestExpired"></a>
La solicitud llegó al servicio más de 15 minutos después de la marca de fecha en la solicitud o más de 15 minutos después de la fecha de vencimiento de la solicitud (por ejemplo, para las URL prefirmadas) o la marca de fecha de la solicitud corresponde a una hora futura en más de 15 minutos.  
Código de estado HTTP: 400

 **ServiceUnavailable**   <a name="CommonErrors-ServiceUnavailable"></a>
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.  
Código de estado HTTP: 503

 **ThrottlingException**   <a name="CommonErrors-ThrottlingException"></a>
La solicitud fue denegada debido a una limitación de la solicitud.  
Código de estado HTTP: 400

 **ValidationError**   <a name="CommonErrors-ValidationError"></a>
La entrada no satisface las limitaciones que especifica un servicio de AWS.  
Código de estado HTTP: 400

# Parámetros comunes
<a name="CommonParameters"></a>

La siguiente lista contiene los parámetros que utilizan todas las acciones para firmar solicitudes de Signature Version 4 con una cadena de consulta. Los parámetros específicos de acción se enumeran en el tema correspondiente a la acción. Para obtener más información sobre la versión 4 de Signature, consulte [Firmar solicitudes de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) en la *Guía del usuario de IAM*.

 **X-Amz-Algorithm**   <a name="CommonParameters-X-Amz-Algorithm"></a>
El algoritmo de hash que utilizó para crear la solicitud de firma.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Valores válidos: `AWS4-HMAC-SHA256`   
Obligatorio: condicional

 **X-Amz-Credential**   <a name="CommonParameters-X-Amz-Credential"></a>
El valor del ámbito de la credencial, que es una cadena que incluye la clave de acceso, la fecha, la región a la que se dirige, el servicio que solicita y una cadena de terminación (“aws4\$1request”). El valor se expresa en el siguiente formato: *access\$1key*/*AAAAMMDD*/*region*/*service*/aws4\$1request.  
Para obtener más información, consulte [Crear una solicitud de AWS API firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la Guía del *usuario de IAM*.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Date**   <a name="CommonParameters-X-Amz-Date"></a>
La fecha utilizada para crear la firma. El formato debe ser ISO 8601 formato básico (AAAAMMDD‘T’HHMMSS‘Z’). Por ejemplo, la siguiente fecha y hora es un X-Amz-Date valor válido:`20120325T120000Z`.  
Condición: X-Amz-Date es opcional en todas las solicitudes; puede utilizarse para anular la fecha empleada para firmar solicitudes. Si el encabezado de fecha se especifica en el formato básico ISO 8601, no X-Amz-Date es obligatorio. Cuando X-Amz-Date se usa, siempre anula el valor del encabezado de fecha. Para obtener más información, consulte [Elementos de la firma de una solicitud de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) en la Guía del *usuario de IAM*.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Security-Token**   <a name="CommonParameters-X-Amz-Security-Token"></a>
El token de seguridad temporal que se obtuvo mediante una llamada a AWS Security Token Service (AWS STS). Para obtener una lista de servicios compatibles con las credenciales de seguridad temporales de AWS STS, consulte [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) en la *Guía del usuario de IAM*.  
Condición: si utilizas credenciales de seguridad temporales de AWS STS, debes incluir el token de seguridad.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-Signature**   <a name="CommonParameters-X-Amz-Signature"></a>
Especifica la firma codificada hexadecimal que se calculó a partir de la cadena que se va a firmar y la clave de firma derivada.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional

 **X-Amz-SignedHeaders**   <a name="CommonParameters-X-Amz-SignedHeaders"></a>
Especifica todos los encabezados HTTP que se incluyeron como parte de la solicitud canónica. Para obtener más información sobre cómo especificar encabezados firmados, consulte [Crear una solicitud de AWS API firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la Guía del *usuario de IAM*.  
Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP.  
Tipo: cadena  
Obligatorio: condicional