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.
Não é possível obter recomendações em lote com as fórmulas Trending-Now e 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: 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 tiver êxito, o serviço enviará de volta 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 da linguagem, consulte o seguinte:
