

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á.

# CreateSolutionVersion
<a name="API_CreateSolutionVersion"></a>

Treina ou treina novamente uma solução ativa em um grupo de conjuntos de dados personalizados. Uma solução é criada usando a [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)operação e deve estar no estado ATIVO antes da chamada`CreateSolutionVersion`. Uma nova versão da solução é criada sempre que você chama essa operação.

 **Status** 

Uma versão da solução pode estar em um dos seguintes estados:
+ CREATE PENDING
+ CREATE IN\$1PROGRESS
+ ACTIVE
+ CREATE FAILED
+ CREATE STOPPING
+ CREATE STOPPED

Para obter o status da versão, ligue [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). Espere até que o status apareça como ATIVO antes de chamar `CreateCampaign`.

Se o status for exibido como CREATE FAILED, a resposta incluirá uma chave `failureReason` que descreve por que o trabalho falhou.

**Relacionado APIs**
+  [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) 
+  [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) 
+  [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) 
+  [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 
+  [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) 
+  [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) 

## Sintaxe da solicitação
<a name="API_CreateSolutionVersion_RequestSyntax"></a>

```
{
   "name": "string",
   "solutionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ],
   "trainingMode": "string"
}
```

## Parâmetros da solicitação
<a name="API_CreateSolutionVersion_RequestParameters"></a>

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

 ** [name](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-name"></a>
O nome da versão da solução.  
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: não

 ** [solutionArn](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-solutionArn"></a>
O nome do recurso da Amazon (ARN) da solução que contém as informações de configuração do treinamento.  
Tipo: string  
Restrições de tamanho: o tamanho máximo é 256.  
Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obrigatório: Sim

 ** [tags](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-tags"></a>
Uma lista de [tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) para aplicar à versão da solução.  
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

 ** [trainingMode](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-trainingMode"></a>
O escopo do treinamento a ser realizado ao criar uma versão da solução. O padrão é `FULL`. Isso cria um modelo completamente novo com base na totalidade dos dados de treinamento dos conjuntos de dados em seu grupo de conjuntos de dados.   
Se você usar [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html), poderá especificar um modo de treinamento de `UPDATE`. Isso atualiza o modelo para considerar novos itens para recomendações. Não é uma reciclagem completa. Você ainda deve concluir uma reciclagem completa semanalmente. Se você especificar `UPDATE`, o Amazon Personalize interromperá as atualizações automáticas da versão da solução. Para retomar as atualizações, crie uma nova solução com o modo de treinamento definido como `FULL` e implante-a em uma campanha. Para obter informações sobre as atualizações automáticas, consulte [Atualizações automáticas](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#maintaining-with-automatic-updates).   
A opção `UPDATE` só pode ser usada quando você já tem uma versão ativa da solução criada a partir da solução de entrada usando a opção `FULL`, e a solução de entrada foi treinada com a fórmula [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html) ou a fórmula [HRNN-Coldstart](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html).  
Tipo: string  
Valores válidos: `FULL | UPDATE | AUTOTRAIN`   
Obrigatório: não

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

```
{
   "solutionVersionArn": "string"
}
```

## Elementos de resposta
<a name="API_CreateSolutionVersion_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.

 ** [solutionVersionArn](#API_CreateSolutionVersion_ResponseSyntax) **   <a name="personalize-CreateSolutionVersion-response-solutionVersionArn"></a>
O ARN da nova versão da solução.  
Tipo: string  
Restrições de tamanho: o tamanho máximo é 256.  
Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Erros
<a name="API_CreateSolutionVersion_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_CreateSolutionVersion_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/CreateSolutionVersion) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolutionVersion) 