

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 자습서: 매치메이킹 규칙 세트 생성
<a name="match-create-ruleset"></a>

Amazon GameLift Servers FlexMatch 매치메이커용 매치메이킹 규칙 세트를 생성하기 전에, [규칙 세트 구문](match-rules-reference.md)을 확인하는 것이 좋습니다. Amazon GameLift Servers 콘솔 또는 AWS Command Line Interface(AWS CLI)를 사용하여 규칙 세트를 생성한 후에는 변경할 수 없습니다.

AWS 리전에서 보유할 수 있는 최대 규칙 세트 수에 대한 [Service Quotas](https://console.aws.amazon.com/servicequotas/home/services/gamelift/quotas/)가 있으므로 사용하지 않는 규칙 세트를 삭제하는 것이 좋습니다.

**Topics**

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

**규칙 세트 생성**

1. [https://console.aws.amazon.com/gamelift/](https://console.aws.amazon.com/gamelift/)에서 Amazon GameLift Servers 콘솔을 엽니다.

1. 규칙 세트를 생성하고자 하는 AWS 리전으로 전환합니다. 규칙 세트는 함께 사용하고자 하는 매치메이킹 구성과 동일한 리전에서 정의합니다.

1. 탐색 창에서 **FlexMatch**, **매치메이킹 규칙 세트**를 선택합니다.

1. **매치메이킹 규칙 세트** 페이지에서 **규칙 세트 생성**을 선택합니다.

1. **매치메이킹 규칙 세트 생성** 페이지에서 다음을 실행합니다.

   1. **규칙 세트 설정**에서 **이름**에 목록이나 이벤트 및 지표 테이블에서 식별하는 데 사용할 수 있는 고유한 설명 이름을 입력합니다.

   1. **규칙 세트**에는 규칙 세트를 JSON으로 입력합니다. 규칙 세트 설계에 대한 자세한 내용은 [FlexMatch 규칙 세트 설계](match-design-ruleset.md) 섹션을 참조하세요. [FlexMatch 규칙 세트 예제](match-examples.md)의 예제 규칙 세트 중 하나를 사용할 수도 있습니다.

   1. **검증**을 선택하여 규칙 세트 구문이 정확한지 검증합니다. 규칙 세트를 만든 후에는 편집할 수 없으므로 먼저 검증하는 것이 좋습니다.

   1. (선택 사항) **태그**에는 AWS 리소스를 관리하고 추적하는 데 도움이 되는 태그를 추가합니다.

1. **생성(Create)**을 선택합니다. 생성을 성공적으로 마쳤으면 매치메이커가 규칙 세트를 사용할 수 있습니다.

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

**규칙 세트 생성**

명령줄 창을 열고 [create-matchmaking-rule-set](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-matchmaking-rule-set.html) 명령을 사용합니다.

이 예제 명령에서는 단일 팀을 설정하는 간단한 매치메이킹 규칙 세트를 생성합니다. 사용할 매치메이킹 구성과 동일한 AWS 리전에 규칙 세트를 생성해야 합니다.

```
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}]}'
```

생성 요청이 성공하면 Amazon GameLift Servers가 여러분이 지정한 설정과 함께 [MatchmakingRuleSet](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_MatchmakingRuleSet.html) 객체를 반환합니다. 이제 매치메이커가 새 규칙 세트를 사용할 수 있습니다.

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

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

**규칙 세트 삭제**

1. [https://console.aws.amazon.com/gamelift/](https://console.aws.amazon.com/gamelift/)에서 Amazon GameLift Servers 콘솔을 엽니다.

1. 규칙 세트를 생성한 리전으로 전환합니다.

1. 탐색 창에서 **FlexMatch**, **매치메이킹 규칙 세트**를 선택합니다.

1. **매치메이킹 규칙 세트** 페이지에서 삭제하려는 규칙 세트를 선택한 다음 **삭제**를 선택합니다.

1. **규칙 세트 삭제** 대화 상자에서 **삭제**를 선택하여 삭제를 확인합니다.
**참고**  
매치메이킹 구성이 규칙 세트를 사용하는 경우 Amazon GameLift Servers는 오류 메시지(**규칙 세트를 삭제할 수 없음**)를 표시합니다. 이 경우 매치메이킹 구성을 다른 규칙 세트를 사용하도록 변경한 다음 다시 시도합니다. 규칙 세트를 사용 중인 매치메이킹 구성을 확인하려면 규칙 세트 이름을 선택하여 해당 세부 정보 페이지를 봅니다.

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

**규칙 세트 삭제**

명령줄 창을 열고 [delete-matchmaking-rule-set](https://docs.aws.amazon.com/cli/latest/reference/gamelift/delete-matchmaking-rule-set.html) 명령을 사용하여 매치메이킹 규칙 세트를 삭제합니다.

매치메이킹 구성이 규칙 세트를 사용하는 경우 Amazon GameLift Servers는 오류 메시지를 반환합니다. 이 경우 매치메이킹 구성을 다른 규칙 세트를 사용하도록 변경한 다음 다시 시도합니다. 규칙 세트를 사용 중인 매치메이킹 구성 목록을 가져오려면 [describe-matchmaking-configurations](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-matchmaking-configurations.html) 명령을 사용하고 규칙 세트 이름을 지정합니다.

이 예제 명령에서는 매치메이킹 규칙 세트의 사용 여부를 확인한 후 규칙 세트를 삭제합니다.

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

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

------