CreateSolutionVersion - Amazon Personalize

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CreateSolutionVersion

Entrena o reentrena una solución activa en un grupo de conjuntos de datos personalizados. Una solución se crea mediante la operación CreateSolution y debe estar en el estado ACTIVE antes de realizar la llamada a CreateSolutionVersion. Se crea una nueva versión de la solución cada vez que llama a esta operación.

Status

Una versión de la solución puede tener uno de los siguientes estados:

  • CREATE PENDING

  • CREATE IN_PROGRESS

  • ACTIVE

  • CREATE FAILED

  • CREATE STOPPING

  • CREATE STOPPED

Para obtener el estado de la versión, llame a DescribeSolutionVersion. Espere a que el estado se muestre como ACTIVE antes de llamar a CreateCampaign.

Si el estado muestra CREATE FAILED, la respuesta incluye una clave failureReason que describe el motivo del error en el trabajo.

Sintaxis de la solicitud

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

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

name

El nombre de la versión de la solución.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.

Patrón: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Obligatorio: no

solutionArn

El nombre de recurso de Amazon (ARN) de la solución que contiene la información de configuración de entrenamiento.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatorio: sí

tags

Lista de etiquetas que se aplican a la versión de solución.

Tipo: matriz de objetos Tag

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.

Obligatorio: no

trainingMode

El alcance del entrenamiento que se realizará al crear la versión de la solución. El valor predeterminado es FULL. Esto crea un modelo completamente nuevo basado en la totalidad de los datos de entrenamiento de los conjuntos de datos de su grupo de conjuntos de datos.

Si usa User-Personalization, puede especificar un modo de entrenamiento de UPDATE. Esto actualiza el modelo para tener en cuenta nuevos elementos a modo de recomendaciones. No se trata de un reentrenamiento completo. Aún así, debe completar un reentrenamiento completo semanalmente. Si especifica UPDATE, Amazon Personalize detendrá las actualizaciones automáticas de la versión de la solución. Para reanudar las actualizaciones, cree una nueva solución con el modo de entrenamiento configurado en FULL e impleméntela en una campaña. Para obtener más información acerca de las actualizaciones automáticas, consulte Actualizaciones automáticas.

La opción UPDATE solo se puede usar si ya se ha creado una versión de la solución activa a partir de la solución de entrada mediante la opción FULL y la solución de entrada se entrenó con la receta User-Personalization o con la receta HRNN-Coldstart heredada.

Tipo: cadena

Valores válidos: FULL | UPDATE

Obligatorio: no

Sintaxis de la respuesta

{ "solutionVersionArn": "string" }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

solutionVersionArn

El ARN de la nueva versión de la solución.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):personalize:.*:.*:.+

Errores

InvalidInputException

Proporcione un valor válido para el campo o el parámetro.

Código de estado HTTP: 400

LimitExceededException

Se ha excedido el límite en el número de solicitudes por segundo.

Código de estado HTTP: 400

ResourceAlreadyExistsException

El recurso especificado ya existe.

Código de estado HTTP: 400

ResourceInUseException

El recurso especificado está en uso.

Código de estado HTTP: 400

ResourceNotFoundException

No se ha encontrado el recurso especificado.

Código de estado HTTP: 400

TooManyTagsException

Ha superado el número máximo de etiquetas que puede aplicar a este recurso.

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: