CreateSolutionVersion - Amazon Personalize

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

Treina ou treina novamente uma solução ativa em um grupo de conjuntos de dados personalizados. Uma solução é criada usando a CreateSolutionoperação e deve estar no estado ATIVO antes da chamadaCreateSolutionVersion. 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_PROGRESS

  • ACTIVE

  • CREATE FAILED

  • CREATE STOPPING

  • CREATE STOPPED

Para obter o status da versão, ligue DescribeSolutionVersion. 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.

Sintaxe da Solicitação

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

Parâmetros da solicitação

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

name

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

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:.*:.*:.+

Exigido: Sim

tags

Uma lista de tags para aplicar à versão da solução.

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

trainingMode

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

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 ou a fórmula HRNN-Coldstart.

Tipo: String

Valores Válidos: FULL | UPDATE | AUTOTRAIN

Obrigatório: Não

Sintaxe da Resposta

{ "solutionVersionArn": "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.

solutionVersionArn

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

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: