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.

# 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)