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

Crea un filtro de recomendaciones. Para obtener más información, consulte [Filtrado de recomendaciones por lotes y segmentos de usuario](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).

## Sintaxis de la solicitud
<a name="API_CreateFilter_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_CreateFilter_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [datasetGroupArn](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-datasetGroupArn"></a>
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](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-filterExpression"></a>
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](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2500.  
Obligatorio: sí

 ** [name](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-name"></a>
Nombre del filtro que se va a crear.  
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: sí

 ** [tags](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al filtro.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
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
<a name="API_CreateFilter_ResponseSyntax"></a>

```
{
   "filterArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateFilter_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [filterArn](#API_CreateFilter_ResponseSyntax) **   <a name="personalize-CreateFilter-response-filterArn"></a>
El ARN del nuevo filtro.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errores
<a name="API_CreateFilter_Errors"></a>

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

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateFilter)