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
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.
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.
No puede obtener recomendaciones por lotes con las recetas Trending-Now o Next-Best-Action.
Sintaxis de la solicitud
{
"batchInferenceJobConfig": {
"itemExplorationConfig": {
"string" : "string"
}
},
"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
La solicitud acepta los siguientes datos en formato JSON.
- batchInferenceJobConfig
-
Los detalles de configuración de un trabajo de inferencia por lotes.
Tipo: objeto BatchInferenceJobConfig
Requerido: no
- batchInferenceJobMode
-
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 predeterminadoBATCH_INFERENCE.Al recibir recomendaciones por lotes con temas, incurrirá en costos adicionales. Para obtener más información, consulte Precios de Amazon Personalize
. Tipo: cadena
Valores válidos:
BATCH_INFERENCE | THEME_GENERATIONRequerido: no
- filterArn
-
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.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+Requerido: no
- jobInput
-
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
Obligatorio: sí
- jobName
-
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
-
La ruta al bucket de Amazon S3 donde se almacenará el resultado del trabajo.
Tipo: objeto BatchInferenceJobOutput
Obligatorio: sí
- numResults
-
El número de recomendaciones que se van a recuperar.
Tipo: entero
Requerido: no
- roleArn
-
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
-
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í
-
Una lista de etiquetas para aplicar al trabajo de inferencia por lotes.
Tipo: matriz de objetos Tag
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.
Requerido: no
- themeGenerationConfig
-
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
Requerido: no
Sintaxis de la respuesta
{
"batchInferenceJobArn": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- batchInferenceJobArn
-
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
- 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
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
