Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# CreateFilter
<a name="API_CreateFilter"></a>

Crée un filtre de recommandation. Pour plus d'informations, consultez la section [Recommandations de filtrage et segments d'utilisateurs](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).

## Syntaxe de la requête
<a name="API_CreateFilter_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_CreateFilter_RequestParameters"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [datasetGroupArn](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-datasetGroupArn"></a>
L'ARN du groupe de jeux de données auquel le filtre appartiendra.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obligatoire : oui

 ** [filterExpression](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-filterExpression"></a>
L'expression du filtre définit les éléments inclus ou exclus des recommandations. L'expression du filtre doit respecter des règles de format spécifiques. Pour plus d'informations sur la structure et la syntaxe des expressions de filtre, consultez la section [Expressions de filtre](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html).  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2500.  
Obligatoire : oui

 ** [name](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-name"></a>
Nom du filtre à créer.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.  
Modèle : `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obligatoire : oui

 ** [tags](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-tags"></a>
Liste des [balises](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) à appliquer au filtre.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateFilter_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_CreateFilter_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [filterArn](#API_CreateFilter_ResponseSyntax) **   <a name="personalize-CreateFilter-response-filterArn"></a>
L'ARN du nouveau filtre.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Entrez une valeur valide pour le champ ou le paramètre.  
Code d’état HTTP : 400

 ** LimitExceededException **   
La limite du nombre de demandes par seconde a été dépassée.  
Code d’état HTTP : 400

 ** ResourceAlreadyExistsException **   
La ressource spécifiée existe déjà.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Impossible de trouver la ressource spécifiée.  
Code d’état HTTP : 400

 ** TooManyTagsException **   
Vous avez dépassé le nombre maximum de balises que vous pouvez appliquer à cette ressource.   
Code d’état HTTP : 400

## Voir aussi
<a name="API_CreateFilter_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateFilter)