

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.

# Tutoriel : Créer un ensemble de règles de matchmaking
Tutoriel : Création d'un ensemble de règles

Avant de créer un ensemble de règles de matchmaking pour votre Amazon GameLift Servers FlexMatch entremetteur, nous vous recommandons de vérifier la [syntaxe du jeu de règles](match-rules-reference.md). Une fois que vous avez créé un ensemble de règles à l'aide de la Amazon GameLift Servers console ou du AWS Command Line Interface (AWS CLI), vous ne pouvez pas le modifier.

Notez qu'il existe un [quota de service](https://console.aws.amazon.com/servicequotas/home/services/gamelift/quotas/) pour le nombre maximum d'ensembles de règles que vous pouvez avoir dans une AWS région. Il est donc conseillé de supprimer les ensembles de règles non utilisés.

**Topics**

------
#### [ Console ]

**Création d'un ensemble de règles**

1. Ouvrez la console Amazon GameLift Servers à l’adresse [https://console.aws.amazon.com/gamelift/](https://console.aws.amazon.com/gamelift/).

1. Passez à la AWS région dans laquelle vous souhaitez créer votre ensemble de règles. Définissez des ensembles de règles dans la même région que la configuration de matchmaking qui les utilise.

1. Dans le volet de navigation, choisissez **FlexMatch**, **Ensembles de règles de matchmaking**.

1. Sur la page **Ensembles de règles de matchmaking**, choisissez **Créer un ensemble de règles**.

1. Sur la page **Créer un ensemble de règles de matchmaking**, procédez comme suit :

   1. Dans **Paramètres de l'ensemble de règles**, pour **Nom**, entrez un nom descriptif unique que vous pouvez utiliser pour l'identifier dans une liste ou dans des tableaux d'événements et de statistiques.

   1. Pour **Ensemble de règles**, entrez votre ensemble de règles en JSON. Pour plus d'informations sur la conception d'un ensemble de règles, consultez[Concevoir un ensemble de FlexMatch règles](match-design-ruleset.md). Vous pouvez également utiliser l'un des exemples d'ensembles de règles de[FlexMatchexemples d'ensembles de règles](match-examples.md).

   1. Choisissez **Valider** pour vérifier que la syntaxe de votre ensemble de règles est correcte. Vous ne pouvez pas modifier les ensembles de règles une fois qu'ils ont été créés. Il est donc conseillé de les valider au préalable.

   1. (Facultatif) Sous **Balises**, ajoutez des balises pour vous aider à gérer et à suivre vos AWS ressources.

1. Choisissez **Créer**. Si la création est réussie, vous pouvez utiliser l'ensemble de règles avec un entremetteur.

------
#### [ AWS CLI ]

**Création d'un ensemble de règles**

Ouvrez une fenêtre de ligne de commande et utilisez la commande [create-matchmaking-rule-set](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-matchmaking-rule-set.html).

Cet exemple de commande crée un ensemble de règles de matchmaking simple qui permet de configurer une seule équipe. Assurez-vous de créer l'ensemble de règles dans la même AWS région que les configurations de matchmaking qui l'utilisent.

```
aws gamelift create-matchmaking-rule-set \
    --name "SampleRuleSet123" \
    --rule-set-body '{"name": "aliens_vs_cowboys", "ruleLanguageVersion": "1.0", "teams": [{"name": "cowboys", "maxPlayers": 8, "minPlayers":  4}]}'
```

Si la demande de création aboutit, Amazon GameLift Servers renvoie un [MatchmakingRuleSet](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_MatchmakingRuleSet.html)objet qui inclut les paramètres que vous avez spécifiés. Un entremetteur peut désormais utiliser le nouvel ensemble de règles.

------<a name="match-delete-ruleset"></a><a name="match-delete-ruleset-cli"></a>

------
#### [ Console ]

**Supprimer un jeu de règles**

1. Ouvrez la console Amazon GameLift Servers à l’adresse [https://console.aws.amazon.com/gamelift/](https://console.aws.amazon.com/gamelift/).

1. Basculez vers la région dans laquelle vous avez créé l'ensemble de règles.

1. Dans le volet de navigation, choisissez **FlexMatch**, **Ensembles de règles de matchmaking**.

1. Sur la page **Ensembles de règles de matchmaking**, sélectionnez l'ensemble de règles que vous souhaitez supprimer, puis choisissez **Supprimer**.

1. Dans la boîte de dialogue **Supprimer l'ensemble de règles**, choisissez **Supprimer** pour confirmer la suppression.
**Note**  
Si une configuration de matchmaking utilise l'ensemble de règles, Amazon GameLift Servers affiche un message d'erreur (**Impossible de supprimer l'ensemble de règles**). Si cela se produit, modifiez la configuration de matchmaking pour utiliser un ensemble de règles différent, puis réessayez. Pour savoir quelles configurations de matchmaking utilisent un ensemble de règles, choisissez le nom d'un ensemble de règles pour afficher sa page de détails.

------
#### [ AWS CLI ]

**Supprimer un ensemble de règles**

Ouvrez une fenêtre de ligne de commande et utilisez la commande [delete-matchmaking-rule-set](https://docs.aws.amazon.com/cli/latest/reference/gamelift/delete-matchmaking-rule-set.html)pour supprimer un ensemble de règles de matchmaking.

Si une configuration de matchmaking utilise l'ensemble de règles, Amazon GameLift Servers renvoie un message d'erreur. Si cela se produit, modifiez la configuration de matchmaking pour utiliser un ensemble de règles différent, puis réessayez. Pour obtenir une liste des configurations de matchmaking utilisant un ensemble de règles, utilisez la commande [describe-matchmaking-configurations](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-matchmaking-configurations.html)et spécifiez le nom de l'ensemble de règles.

Cet exemple de commande vérifie l'utilisation de l'ensemble de règles de matchmaking, puis le supprime.

```
aws gamelift describe-matchmaking-rule-sets \
    --rule-set-name "SampleRuleSet123" \
    --limit 10

aws gamelift delete-matchmaking-rule-set \
    --name  "SampleRuleSet123"
```

------