As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CreateBatchInferenceJob
Gera recomendações em lote com base em uma lista de itens ou usuários armazenados no Amazon S3 e exporta as recomendações para um bucket do Amazon S3.
Para gerar recomendações em lote, especifique o ARN de uma versão da solução e um URI do Amazon S3 para os dados de entrada e saída. Para personalização do usuário, itens populares e soluções de classificação personalizada, o trabalho de inferência em lote gera uma lista de itens recomendados para cada ID de usuário no arquivo de entrada. Para soluções de itens relacionados, o trabalho gera uma lista de itens recomendados para cada ID de item no arquivo de entrada.
Para obter mais informações, consulte Criar um trabalho de inferência em lote.
Se a fórmula Similar-Items for utilizada, o Amazon Personalize poderá adicionar temas descritivos às recomendações em lote. Para gerar temas, defina o modo do trabalho como THEME_GENERATION e especifique o nome do campo que contém os nomes dos itens nos dados de entrada.
Para obter mais informações sobre a geração de temas, consulte Recomendações em lote com temas do Content Generator.
Você não pode obter recomendações de lote com o Trending-Now ou com as receitas. Next-Best-Action
Sintaxe da Solicitação
{
"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 da solicitação
A solicitação aceita os dados a seguir no formato JSON.
- batchInferenceJobConfig
-
Os detalhes da configuração de um trabalho de inferência em lote.
Tipo: objeto BatchInferenceJobConfig
Obrigatório: não
- batchInferenceJobMode
-
O modo do trabalho de inferência em lote. Para gerar temas descritivos para grupos de itens semelhantes, defina o modo de trabalho como
THEME_GENERATION. Se não quiser gerar temas, use aBATCH_INFERENCEpadrão.Ao receber recomendações em lote com temas, são gerados custos adicionais. Para obter mais informações, consulte Preços do Amazon Personalize
. Tipo: string
Valores Válidos:
BATCH_INFERENCE | THEME_GENERATIONObrigatório: não
- filterArn
-
O ARN do filtro a ser aplicado ao trabalho de inferência em lote. Para obter mais informações sobre como usar filtros, consulte Filtrar recomendações em lote.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+Obrigatório: não
- jobInput
-
O caminho do Amazon S3 que leva ao arquivo de entrada no qual basear suas recomendações. O material de entrada deve estar em formato JSON.
Tipo: objeto BatchInferenceJobInput
Obrigatório: sim
- jobName
-
O nome do trabalho de inferência em lote a ser criado.
Tipo: string
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.
Padrão:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*Exigido: Sim
- jobOutput
-
O caminho para o bucket do Amazon S3 no qual a saída do trabalho é armazenada.
Tipo: objeto BatchInferenceJobOutput
Obrigatório: sim
- numResults
-
O número de recomendações a serem recuperadas.
Tipo: número inteiro
Obrigatório: não
- roleArn
-
O ARN da função Amazon Identity and Access Management que tem permissões para ler e gravar em seus buckets de entrada e saída do Amazon S3, respectivamente.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Exigido: Sim
- solutionVersionArn
-
O nome do recurso da Amazon (ARN) da versão da solução que será usado para gerar as recomendações de inferência em lote.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+Exigido: Sim
-
Uma lista de tags a serem aplicadas ao trabalho de inferência em lote.
Tipo: matriz de objetos Tag
Membros da Matriz: número mínimo de 0 itens. Número máximo de 200 itens.
Obrigatório: não
- themeGenerationConfig
-
Para trabalhos de geração de temas, especifique o nome da coluna no conjunto de dados de itens que contém o nome de cada item.
Tipo: objeto ThemeGenerationConfig
Obrigatório: Não
Sintaxe da Resposta
{
"batchInferenceJobArn": "string"
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- batchInferenceJobArn
-
O ARN do trabalho de inferência em lote.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão:
arn:([a-z\d-]+):personalize:.*:.*:.+
Erros
- InvalidInputException
-
Forneça um valor válido para o campo ou parâmetro.
Código de status HTTP: 400
- LimitExceededException
-
O limite de número de solicitações por segundo foi excedido.
Código de status HTTP: 400
- ResourceAlreadyExistsException
-
O recurso especificado já existe.
Código de status HTTP: 400
- ResourceInUseException
-
O recurso especificado está em uso.
Código de status HTTP: 400
- ResourceNotFoundException
-
Não foi possível encontrar o recurso especificado.
Código de status HTTP: 400
- TooManyTagsException
-
Você excedeu o número máximo de tags que pode aplicar a esse recurso.
Código de Status HTTP: 400
Consulte Também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
