Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# FlexMatchEvent-Benachrichtigungen einrichten
Sie können Ereignisbenachrichtigungen verwenden, um den Status einzelner Matchmaking-Anfragen zu verfolgen. Alle Spiele, die sich in der Produktion befinden oder sich in der Vorproduktion befinden und umfangreiche Matchmaking-Aktivitäten beinhalten, sollten Event-Benachrichtigungen verwenden.
Es gibt zwei Optionen für die Einrichtung von Ereignisbenachrichtigungen.
+ Lassen Sie Ihren Matchmaker Event-Benachrichtigungen zu einem Amazon Simple Notification Service (Amazon SNS) -Thema veröffentlichen.
+ Verwenden Sie automatisch veröffentlichte EventBridge Amazon-Ereignisse und die zugehörigen Tools für die Verwaltung von Veranstaltungen.
Eine Liste der FlexMatch Ereignisse, die ausgelöst werdenAmazon GameLift Servers, finden Sie unter[FlexMatchMatchmaking-Ereignisse](match-events.md).
**Wichtig**
Für Matchmaking-Systeme mit hohem Volumen empfehlen wir die Verwendung von Amazon SNS SNS-Standardthemen (ohne FIFO) anstelle von FIFO-Themen. Für FIFO-Themen gelten niedrigere Veröffentlichungslimits als für Standardthemen, was bei hoher Auslastung zu eingeschränkten Ausnahmen führen kann. Wenn Sie bei FIFO-Themen eine Drosselung feststellen, können Sie Benachrichtigungen verlieren. FlexMatch
**Anmerkung**
Amazon GameLift Serversverarbeitet automatisch Amazon SNS SNS-Zustellungsfehler und Drosselungen mit integrierter Wiederholungslogik. Wenn Amazon SNS Drosselungsfehler oder vorübergehende Ausfälle zurückgibt, Amazon GameLift Servers versucht Amazon SNS erneut, die Benachrichtigung mit fortschreitenden Verzögerungen zwischen den Versuchen zuzustellen. Auf diese Weise wird sichergestellt, dass Ereignisbenachrichtigungen zuverlässig zugestellt werden. Benachrichtigungen können jedoch verloren gehen, wenn nach allen Wiederholungsversuchen weiterhin Fehler auftreten, oder wenn es sich um Fehler handelt, die nicht wiederholt werden können, wie z. B. Autorisierungsfehler oder fehlende Themen.
**Topics**
+ [Richten Sie Ereignisse ein EventBridge](#match-notification-cwe)
+ [Tutorial: Ein Amazon SNS SNS-Thema einrichten](match-notification-sns.md)
+ [Richten Sie ein SNS-Thema mit serverseitiger Verschlüsselung ein](queue-notification-sns-sse.md)
+ [Konfigurieren Sie ein Themenabonnement, um eine Lambda-Funktion aufzurufen](match-notification-lambda.md)
## Richten Sie Ereignisse ein EventBridge
Amazon GameLift Serversveröffentlicht automatisch alle Matchmaking-Events auf Amazon EventBridge. Mit können Sie Regeln einrichten EventBridge, nach denen Matchmaking-Ereignisse zur Verarbeitung an Ziele weitergeleitet werden. Sie können beispielsweise eine Regel festlegen, um das Ereignis "PotentialMatchCreated" an eine AWS Lambda Funktion weiterzuleiten, die Spielerakzeptanz verarbeitet. Weitere Informationen finden Sie unter [Was ist Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
**Anmerkung**
Wenn Sie Ihre Matchmaker konfigurieren, lassen Sie das Feld für das Benachrichtigungsziel leer oder verweisen Sie auf ein SNS-Thema, wenn Sie EventBridge sowohl Amazon SNS als auch Amazon SNS verwenden möchten.
# Tutorial: Ein Amazon SNS SNS-Thema einrichten
Sie können alle Ereignisse, die ein FlexMatch Matchmaker generiert, zu einem Amazon SNS SNS-Thema Amazon GameLift Servers veröffentlichen lassen.
**Um ein SNS-Thema für Ereignisbenachrichtigungen zu erstellen Amazon GameLift Servers**
1. Öffnen Sie die [Amazon-SNS-Konsole](https://console.aws.amazon.com/sns).
1. Wählen Sie im Navigationsbereich **Themen** aus.
1. Klicken Sie auf der Seite **Themen** auf **Thema erstellen**.
1. Erstellen Sie ein Thema in der -Konsole. Weitere Informationen finden Sie unter [So erstellen Sie ein Thema mit dem AWS-Managementkonsole](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html#create-topic-aws-console) im *Amazon Simple Notification Service Developer Guide*.
1. Wählen Sie auf der **Detailseite** für Ihr Thema die Option **Bearbeiten** aus.
1. (Optional) Erweitern Sie auf der Seite **Bearbeiten** für Ihr Thema die Option **Zugriffsrichtlinie** und fügen Sie dann die fett gedruckte Syntax aus der folgenden AWS Identity and Access Management (IAM-) Richtlinienanweisung am Ende Ihrer vorhandenen Richtlinie hinzu. (Aus Gründen der Übersichtlichkeit wird hier die gesamte Richtlinie angezeigt.) Achten Sie darauf, die Amazon Resource Name (ARN) -Details für Ihr eigenes SNS-Thema und Ihre Amazon GameLift Servers Matchmaking-Konfiguration zu verwenden.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "__default_policy_ID",
"Statement": [
{
"Sid": "__default_statement_ID",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"SNS:GetTopicAttributes",
"SNS:SetTopicAttributes",
"SNS:AddPermission",
"SNS:RemovePermission",
"SNS:DeleteTopic",
"SNS:Subscribe",
"SNS:ListSubscriptionsByTopic",
"SNS:Publish"
],
"Resource": "arn:aws:sns:us-east-1:111122223333:your_topic_name",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333"
}
}
},
{
"Sid": "__console_pub_0",
"Effect": "Allow",
"Principal": {
"Service": "gamelift.amazonaws.com"
},
"Action": "SNS:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:your_topic_name",
"Condition": {
"ArnLike": {
"aws:SourceArn": "arn:aws:gamelift:us-east-1:111122223333:matchmakingconfiguration/your_configuration_name"
}
}
}
]
}
```
------
1. Wählen Sie **Änderungen speichern ** aus.
# Richten Sie ein SNS-Thema mit serverseitiger Verschlüsselung ein
Sie können serverseitige Verschlüsselung (SSE) verwenden, um vertrauliche Daten in verschlüsselten Themen zu speichern. SSE schützt den Inhalt von Nachrichten in Amazon SNS SNS-Themen mithilfe von Schlüsseln, die in AWS Key Management Service (AWS KMS) verwaltet werden. Weitere Informationen zur serverseitigen Verschlüsselung mit Amazon SNS finden Sie unter [Verschlüsselung im Ruhezustand im](https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html) *Amazon Simple Notification Service Developer Guide*.
Um ein SNS-Thema mit serverseitiger Verschlüsselung einzurichten, lesen Sie sich die folgenden Themen durch:
+ [Schlüssel erstellen](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html) *im Entwicklerhandbuch AWS Key Management Service *
+ [SSE für ein Thema im *Amazon Simple Notification Service Developer Guide* aktivieren](https://docs.aws.amazon.com/sns/latest/dg/sns-enable-encryption-for-topic.html)
Verwenden Sie beim Erstellen Ihres KMS-Schlüssels die folgende KMS-Schlüsselrichtlinie:
```
{
"Effect": "Allow",
"Principal": {
"Service": "gamelift.amazonaws.com"
},
"Action": [
"kms:Decrypt",
"kms:GenerateDataKey"
],
"Resource": "*",
"Condition": {
"ArnLike": {
"aws:SourceArn": "arn:aws:gamelift:your_region:your_account:matchmakingconfiguration/your_configuration_name"
},
"StringEquals": {
"kms:EncryptionContext:aws:sns:topicArn": "arn:aws:sns:your_region:your_account:your_sns_topic_name"
}
}
}
```
# Konfigurieren Sie ein Themenabonnement, um eine Lambda-Funktion aufzurufen
Sie können eine Lambda-Funktion mithilfe von Ereignisbenachrichtigungen aufrufen, die in Ihrem Amazon SNS SNS-Thema veröffentlicht wurden. Achten Sie bei der Konfiguration des Matchmakers darauf, das Benachrichtigungsziel auf den ARN Ihres SNS-Themas festzulegen.
Die folgende AWS CloudFormation Vorlage konfiguriert ein Abonnement für ein SNS-Thema mit dem Namen, um eine `MyFlexMatchEventTopic` Lambda-Funktion mit dem Namen aufzurufen. `FlexMatchEventHandlerLambdaFunction` Die Vorlage erstellt eine IAM-Berechtigungsrichtlinie, die das Schreiben in das Amazon GameLift Servers SNS-Thema ermöglicht. Die Vorlage fügt dann Berechtigungen für das SNS-Thema hinzu, um die Lambda-Funktion aufzurufen.
```
FlexMatchEventTopic:
Type: "AWS::SNS::Topic"
Properties:
KmsMasterKeyId: alias/aws/sns #Enables server-side encryption on the topic using an AWS managed key
Subscription:
- Endpoint: !GetAtt FlexMatchEventHandlerLambdaFunction.Arn
Protocol: lambda
TopicName: MyFlexMatchEventTopic
FlexMatchEventTopicPolicy:
Type: "AWS::SNS::TopicPolicy"
DependsOn: FlexMatchEventTopic
Properties:
PolicyDocument:
Version: "2012-10-17"
Statement:
- Effect: Allow
Principal:
Service: gamelift.amazonaws.com
Action:
- "sns:Publish"
Resource: !Ref FlexMatchEventTopic
Topics:
- Ref: FlexMatchEventTopic
FlexMatchEventHandlerLambdaPermission:
Type: "AWS::Lambda::Permission"
Properties:
Action: "lambda:InvokeFunction"
FunctionName: !Ref FlexMatchEventHandlerLambdaFunction
Principal: sns.amazonaws.com
SourceArn: !Ref FlexMatchEventTopic
```