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 você usar a Similar-Items receita, o Amazon Personalize pode 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 lotes com as Next-Best-Action receitas Trending-Now ou.
Sintaxe da solicitação
{
"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 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\-_]*Obrigatório: 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: 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+=,.@\-_/]+Obrigatório: 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:.*:.*:.+Obrigatório: 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 um dos AWS SDKs específicos do idioma, consulte o seguinte:
