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

CreateFilter

Crea un filtro de recomendaciones. Para obtener más información, consulte Filtrado de recomendaciones por lotes y segmentos de usuario.

Sintaxis de la solicitud

{ "datasetGroupArn": "string", "filterExpression": "string", "name": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

datasetGroupArn

El ARN del grupo de conjuntos de datos al que pertenecerá el filtro.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

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

Obligatorio: sí

filterExpression

La expresión del filtro define qué elementos se incluyen en las recomendaciones o se excluyen de estas. La expresión de filtro debe seguir reglas de formato específicas. Para obtener información sobre la estructura y la sintaxis de la expresión de filtro, consulte Expresiones de filtro.

Tipo: cadena

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

Obligatorio: sí

name

Nombre del filtro que se va a crear.

Tipo: string

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: sí

tags

Lista de etiquetas que se aplican al filtro.

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

Sintaxis de la respuesta

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

filterArn

El ARN del nuevo filtro.

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

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 uno de los AWS SDK específicos del idioma, consulta lo siguiente: