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
<a name="API_CreateBatchInferenceJob"></a>

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](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html).

 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](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html). 

Você não pode obter recomendações de lote com o Trending-Now ou com as receitas. Next-Best-Action

## Sintaxe da solicitação
<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 da solicitação
<a name="API_CreateBatchInferenceJob_RequestParameters"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobConfig"></a>
Os detalhes da configuração de um trabalho de inferência em lote.  
Tipo: objeto [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)  
Obrigatório: não

 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobMode"></a>
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 a `BATCH_INFERENCE` padrã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](https://aws.amazon.com/personalize/pricing/).   
Tipo: string  
Valores válidos: `BATCH_INFERENCE | THEME_GENERATION`   
Obrigatório: não

 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-filterArn"></a>
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](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html).  
Tipo: string  
Restrições de tamanho: o tamanho máximo é 256.  
Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obrigatório: não

 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobInput"></a>
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](API_BatchInferenceJobInput.md)  
Obrigatório: Sim

 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobName"></a>
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](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobOutput"></a>
O caminho para o bucket do Amazon S3 no qual a saída do trabalho é armazenada.  
Tipo: objeto [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)  
Obrigatório: Sim

 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-numResults"></a>
O número de recomendações a serem recuperadas.  
Tipo: inteiro  
Obrigatório: não

 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-roleArn"></a>
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](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-solutionVersionArn"></a>
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

 ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-tags"></a>
Uma lista de [tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) a serem aplicadas ao trabalho de inferência em lote.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-themeGenerationConfig"></a>
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](API_ThemeGenerationConfig.md)  
Obrigatório: não

## Sintaxe da resposta
<a name="API_CreateBatchInferenceJob_ResponseSyntax"></a>

```
{
   "batchInferenceJobArn": "string"
}
```

## Elementos de resposta
<a name="API_CreateBatchInferenceJob_ResponseElements"></a>

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](#API_CreateBatchInferenceJob_ResponseSyntax) **   <a name="personalize-CreateBatchInferenceJob-response-batchInferenceJobArn"></a>
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
<a name="API_CreateBatchInferenceJob_Errors"></a>

 ** 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
<a name="API_CreateBatchInferenceJob_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando 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)