`. Sie können auf diese Variablen beim Erstellen Ihrer *Eingabevorlage* verweisen.
**Anmerkung**
Amazon CloudWatch Logs und SSM-Ziele unterstützen die Verwendung von `Input` und `InputPath` in ihren Eingangstransformatoren nicht.
### Eingabevorlage
Die *Eingabevorlage* ist eine Vorlage für die Informationen, die Sie an Ihr Ziel übergeben möchten. Sie können eine Vorlage erstellen, die entweder eine Zeichenfolge oder JSON an das Ziel übergibt. Unter Verwendung des vorherigen Ereignisses und *Eingabepfads* wird das Ereignis in den folgenden Beispielen für *Eingabevorlagen* in die Beispielausgabe transformiert, bevor es an ein Ziel weitergeleitet wird.
| Description | Vorlage | Ausgabe |
| --- | --- | --- |
| Einfache Zeichenfolge | "instance is in "
| "instance i-0123456789 is in RUNNING"
|
| **Zeichenfolge mit Anführungszeichen, die durch Escape-Zeichen geschützt sind** | "instance \"\" is in "
| "instance \"i-0123456789\" is in RUNNING"
Beachten Sie, dass dies das Verhalten in der EventBridge Konsole ist. In der AWS CLI werden die Schrägstriche durch Escape-Zeichen geschützt. Das Ergebnis lautet `"instance "i-0123456789" is in RUNNING"`. |
| **Einfache JSON** | {
"instance" : ,
"state":
} | {
"instance" : "i-0123456789",
"state": "RUNNING"
} |
| **JSON mit Zeichenfolgen und Variablen** | {
"instance" : ,
"state": "",
"instanceStatus": "instance \"\" is in "
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"instanceStatus": "instance \"i-0123456789\" is in RUNNING"
} |
| **JSON mit einer Mischung aus Variablen und statischen Informationen** | {
"instance" : ,
"state": [ 9, , true ],
"Transformed" : "Yes"
}
| {
"instance" : "i-0123456789",
"state": [
9,
"RUNNING",
true
],
"Transformed" : "Yes"
} |
| **Einbeziehen von reservierten Variablen in JSON** | {
"instance" : ,
"state": ,
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
} |
| **Einbeziehen von reservierten Variablen in eine Zeichenfolge** | " triggered"
| "example triggered"
|
| ** CloudWatch Amazon-Protokollgruppe** | {
"timestamp" : ,
"message": "instance \"\" is in "
} | {
"timestamp" : 2015-11-11T21:29:54Z,
"message": "instance "i-0123456789" is in RUNNING
} |
## Transformieren von Eingaben mithilfe der EventBridge API
Informationen zur Verwendung der EventBridge API zur Transformation von Eingaben finden Sie unter [Verwenden von Input Transformer, um Daten aus einem Ereignis zu extrahieren und diese Daten in das Ziel einzugeben](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html#API_PutTargets_Example_2).
## Transformieren von Eingaben mithilfe von AWS CloudFormation
Hinweise zur Verwendung AWS CloudFormation zum Transformieren von Eingaben finden Sie unter [AWS::Events::Rule InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html).
## Häufige Probleme beim Transformieren von Eingaben
Dies sind einige häufig auftretende Probleme bei der Transformation von Eingaben in EventBridge:
+ Für Zeichenfolgen sind Anführungszeichen erforderlich.
+ Beim Erstellen des JSON-Pfads für Ihre Vorlage erfolgt keine Validierung.
+ Wenn Sie eine Variable angeben, die einem JSON-Pfad entspricht, der im Ereignis nicht vorhanden ist, wird diese Variable nicht erstellt und nicht in der Ausgabe angezeigt.
+ JSON-Eigenschaften wie `aws.events.event.json` können nur als Wert eines JSON-Felds verwendet werden, nicht inline in anderen Zeichenfolgen.
+ EventBridge maskiert Werte, die vom *Eingabepfad* extrahiert wurden, nicht, wenn die *Eingabevorlage* für ein Ziel gefüllt wird.
+ Wenn ein JSON-Pfad auf ein JSON-Objekt oder ein JSON-Array verweist, die Variable jedoch in einer Zeichenfolge referenziert wird, werden alle internen Anführungszeichen EventBridge entfernt, um sicherzustellen, dass eine gültige Zeichenfolge vorliegt. Bei einer Variablen, auf die `` verwiesen wird`$.detail`, würde „Detail is“ beispielsweise dazu führen, dass Anführungszeichen aus dem Objekt EventBridge entfernt werden.
Wenn Sie also ein JSON-Objekt ausgeben möchten, das auf einer einzelnen JSON-Pfadvariablen basiert, müssen Sie es als Schlüssel platzieren. In diesem Beispiel `{"detail": }`.
+ Für Variablen, die Zeichenfolgen darstellen, sind keine Anführungszeichen erforderlich. Sie sind zulässig, fügen aber während der Transformation EventBridge automatisch Anführungszeichen zu Zeichenkettenvariablenwerten hinzu, um sicherzustellen, dass es sich bei der Transformationsausgabe um ein gültiges JSON-Format handelt. EventBridge fügt Variablen, die JSON-Objekte oder -Arrays darstellen, keine Anführungszeichen hinzu. Fügen Sie für Variablen, die JSON-Objekte oder -Arrays darstellen, keine Anführungszeichen hinzu.
Die folgende Eingabevorlage enthält beispielsweise Variablen, die sowohl Zeichenfolgen als auch JSON-Objekte darstellen:
```
{
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
}
```
Das Ergebnis ist gültiges JSON mit den richtigen Anführungszeichen:
```
{
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
}
```
+ Bei (Nicht-JSON-) Textausgabe als mehrzeilige Zeichenfolgen setzen Sie jede einzelne Zeile in Ihrer Eingabevorlage in doppelte Anführungszeichen.
Wenn Sie beispielsweise [Amazon Inspector Finding-Ereignisse](https://docs.aws.amazon.com/inspector/latest/user/eventbridge-integration.html#event-finding) mit dem folgenden Ereignismuster abgleichen würden:
```
{
"detail": {
"severity": ["HIGH"],
"status": ["ACTIVE"]
},
"detail-type": ["Inspector2 Finding"],
"source": ["inspector2"]
}
```
Und mit dem folgenden Eingabepfad:
```
{
"account": "$.detail.awsAccountId",
"ami": "$.detail.resources[0].details.awsEc2Instance.imageId",
"arn": "$.detail.findingArn",
"description": "$.detail.description",
"instance": "$.detail.resources[0].id",
"platform": "$.detail.resources[0].details.awsEc2Instance.platform",
"region": "$.detail.resources[0].region",
"severity": "$.detail.severity",
"time": "$.time",
"title": "$.detail.title",
"type": "$.detail.type"
}
```
Sie könnten die folgende Eingabevorlage verwenden, um eine mehrzeilige Zeichenkettenausgabe zu generieren:
```
" severity finding "
"Description: <description>"
"ARN: \"<arn>\""
"Type: <type>"
"AWS Account: <account>"
"Region: <region>"
"EC2 Instance: <instance>"
"Platform: <platform>"
"AMI: <ami>"
```
# Konfiguration eines Eingangstransformators beim Erstellen einer Regel in EventBridge
<a name="eb-transform-input-rule"></a>
Im Rahmen der Erstellung einer Regel können Sie einen Eingangstransformator angeben, der verwendet werden EventBridge soll, um übereinstimmende Ereignisse zu verarbeiten, bevor diese Ereignisse an das angegebene Ziel gesendet werden. Sie können Eingangstransformatoren für Ziele konfigurieren, bei denen es sich um AWS Dienste oder API-Ziele handelt.
**So erstellen Sie einen Zieleingabe-Transformator als Teil einer Regel**
1. Befolgen Sie die Schritte zum Erstellen einer Regel, wie unter [Regeln in Amazon erstellen EventBridge](eb-create-rule-visual.md) beschrieben.
1. Erweitern Sie in **Schritt 3 – Ziel(e) auswählen** die Option **Zusätzliche Einstellungen**.
1. Wählen Sie für **Zieleingabe konfigurieren** die Option **Eingabe-Transformator** im Dropdown-Menü aus.
Klicken Sie auf **Eingabe-Transformator konfigurieren**.
EventBridge zeigt das Dialogfeld **Eingangstransformator konfigurieren** an.
1. Wählen Sie im Abschnitt **Beispielereignis** einen **Beispiel-Ereignistyp** aus, anhand dessen Sie das Ereignismuster testen möchten. Sie können ein AWS Ereignis oder ein Partnerereignis auswählen oder ein eigenes benutzerdefiniertes Ereignis eingeben.
------
#### [ AWS events ]
Wählen Sie aus Ereignissen aus, die von unterstützten AWS-Services ausgegeben wurden.
1. Wählen Sie **AWS -Ereignisse** aus.
1. Wählen Sie unter **Beispielereignisse** die gewünschte AWS Veranstaltung aus. Die Veranstaltungen werden nach AWS Service organisiert.
Wenn Sie ein Ereignis auswählen, wird das Beispielereignis EventBridge aufgefüllt.
Wenn Sie beispielsweise **S3 Object** Created wählen, EventBridge wird ein Beispielereignis vom Typ S3 Object Created angezeigt.
1. (Optional) Sie können auch **Kopieren** auswählen, um das Beispielereignis in die Zwischenablage Ihres Geräts zu kopieren.
------
#### [ Partner events ]
Wählen Sie Ereignisse aus, die von EventBridge unterstützenden Drittanbieterdiensten wie Salesforce ausgelöst werden.
1. Wählen Sie **EventBridge Partnerereignisse** aus.
1. Wählen Sie unter **Beispielereignisse** das gewünschte Partnerereignis aus. Die Ereignisse sind nach Partner organisiert.
Wenn Sie ein Ereignis auswählen, wird das Beispielereignis EventBridge aufgefüllt.
1. (Optional) Sie können auch **Kopieren** auswählen, um das Beispielereignis in die Zwischenablage Ihres Geräts zu kopieren.
------
#### [ Enter your own ]
Geben Sie Ihr eigenes Ereignis als JSON-Text ein.
1. Wählen **Mein eigenes eingeben** aus.
1. EventBridge füllt das Beispielereignis mit einer Vorlage mit den erforderlichen Ereignisattributen auf.
1. Bearbeiten Sie das Beispielereignis nach Bedarf und fügen Sie es hinzu. Das Beispielereignis muss gültiges JSON sein.
1. (Optional) Sie können auch eine der folgenden Optionen wählen:
+ **Kopieren** – Kopiert das Beispielereignis in die Zwischenablage Ihres Geräts.
+ **Verschönern** – Erleichtert das Lesen des JSON-Texts durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen.
------
1. (Optional) Erweitern Sie den Abschnitt **Beispiel für Eingabepfade, Vorlagen und Ausgaben**, um Beispiele für Folgendes zu sehen:
+ So werden JSON-Pfade verwendet, um Variablen zu definieren, die Ereignisdaten darstellen
+ So können diese Variablen in einer Eingabe-Transformator-Vorlage verwendet werden
+ Die resultierende Ausgabe, die EventBridge an das Ziel gesendet wird
Ausführlichere Beispiele für Eingabetransformationen finden Sie unter [Beispiele für die Eingabetransformation](eb-transform-target-input.md#eb-transform-input-examples).
1. Definieren Sie im Abschnitt **Zieleingabe-Transformator** alle Variablen, die Sie in der Eingabevorlage verwenden möchten.
Variablen verwenden einen JSON-Pfad, um auf Werte in der ursprünglichen Ereignisquelle zu verweisen. Sie können dann in der Eingabevorlage auf diese Variablen verweisen, um Daten aus dem ursprünglichen Quellereignis in das transformierte Ereignis einzubeziehen, das EventBridge an das Ziel weitergegeben wird. Sie können bis zu 100 Variablen definieren. Der Eingabe-Transformator muss gültiges JSON sein.
Nehmen wir beispielsweise an, Sie hätten das AWS Ereignis **S3 Object Created** als Beispielereignis für diesen Eingangstransformator ausgewählt. Sie könnten dann die folgenden Variablen zur Verwendung in Ihrer Vorlage definieren:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Optional) Sie können auch **Kopieren** auswählen, um den Eingabe-Transformator in die Zwischenablage Ihres Geräts zu kopieren.
1. Verfassen Sie im Abschnitt **Vorlage** die Vorlage, anhand derer Sie bestimmen möchten, was EventBridge an das Ziel übergeben wird.
Sie können JSON, Zeichenfolgen, statische Informationen, von Ihnen definierte Variablen sowie reservierte Variablen verwenden. Ausführlichere Beispiele für Eingabetransformationen finden Sie unter [Beispiele für die Eingabetransformation](eb-transform-target-input.md#eb-transform-input-examples).
Angenommen, Sie haben die Variablen im vorherigen Beispiel definiert. Sie könnten dann die folgende Vorlage erstellen, die auf diese Variablen sowie auf reservierte Variablen und statische Informationen verweist.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Optional) Sie können auch **Kopieren** auswählen, um die Vorlage in die Zwischenablage Ihres Geräts zu kopieren.
1. Wenn Sie Ihre Vorlage testen möchten, wählen Sie **Ausgabe erzeugen** aus.
EventBridge verarbeitet das Beispielereignis auf der Grundlage der Eingabevorlage und zeigt die transformierte Ausgabe an, die unter **Ausgabe** generiert wurde. Dies sind die Informationen, EventBridge die anstelle des ursprünglichen Quellereignisses an das Ziel weitergegeben werden.
Die erzeugte Ausgabe für die oben beschriebene Beispiel-Eingabevorlage wäre die folgende:
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
(Optional) Sie können auch **Kopieren** auswählen, um die erzeugte Ausgabe in die Zwischenablage Ihres Geräts zu kopieren.
1. Wählen Sie **Bestätigen** aus.
1. Befolgen Sie die restlichen Schritte zum Erstellen einer Regel, wie unter [Regeln in Amazon erstellen EventBridge](eb-create-rule-visual.md) beschrieben.
# Testen eines Zieleingangstransformators mit der EventBridge Sandbox
<a name="eb-sandbox-input-trans"></a>
Sie können Eingangstransformatoren verwenden, um den Text eines [Ereignisses](eb-events.md) anzupassen EventBridge, bevor die Informationen an das [Ziel](eb-targets.md) einer [Regel](eb-rules.md) weitergegeben werden.
Die Konfiguration eines Eingabe-Transformators ist in der Regel Teil eines größeren Prozesses, bei dem während [der Erstellung einer neuen Regel](eb-create-rule-visual.md) oder der Bearbeitung einer vorhandenen ein Ziel angegeben wird. Mithilfe der Sandbox in können Sie EventBridge jedoch schnell einen Eingangstransformator konfigurieren und anhand eines Beispielereignisses bestätigen, dass Sie die gewünschte Ausgabe erhalten, ohne eine Regel erstellen oder bearbeiten zu müssen.
Weitere Informationen zu Eingabetransformationen finden Sie unter [Transformation Amazon EventBridge Amazon-Eingaben](eb-transform-target-input.md).
**So testen Sie einen Zieleingabe-Transformator**
1. Öffnen Sie die EventBridge Amazon-Konsole unter [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Wählen Sie unter **Entwicklerressourcen** die Option **Sandbox** und auf der **Sandbox**-Seite die Registerkarte **Zieleingabe-Transformator** aus.
1. Wählen Sie im Abschnitt **Beispielereignis** einen **Beispiel-Ereignistyp** aus, anhand dessen Sie das Ereignismuster testen möchten. Sie können eine AWS Veranstaltung oder eine Partnerveranstaltung auswählen oder Ihre eigene benutzerdefinierte Veranstaltung eingeben.
------
#### [ AWS events ]
Wählen Sie aus Ereignissen aus, die von unterstützten AWS-Services ausgegeben wurden.
1. Wählen Sie **AWS -Ereignisse** aus.
1. Wählen Sie unter **Beispielereignisse** die gewünschte AWS Veranstaltung aus. Die Veranstaltungen werden nach AWS Service organisiert.
Wenn Sie ein Ereignis auswählen, wird das Beispielereignis EventBridge aufgefüllt.
Wenn Sie beispielsweise **S3 Object** Created wählen, EventBridge wird ein Beispielereignis vom Typ S3 Object Created angezeigt.
1. (Optional) Sie können auch **Kopieren** auswählen, um das Beispielereignis in die Zwischenablage Ihres Geräts zu kopieren.
------
#### [ Partner events ]
Wählen Sie Ereignisse aus, die von EventBridge unterstützenden Drittanbieterdiensten wie Salesforce ausgelöst werden.
1. Wählen Sie **EventBridge Partnerereignisse** aus.
1. Wählen Sie unter **Beispielereignisse** das gewünschte Partnerereignis aus. Die Ereignisse sind nach Partner organisiert.
Wenn Sie ein Ereignis auswählen, wird das Beispielereignis EventBridge aufgefüllt.
1. (Optional) Sie können auch **Kopieren** auswählen, um das Beispielereignis in die Zwischenablage Ihres Geräts zu kopieren.
------
#### [ Enter your own ]
Geben Sie Ihr eigenes Ereignis als JSON-Text ein.
1. Wählen **Mein eigenes eingeben** aus.
1. EventBridge füllt das Beispielereignis mit einer Vorlage mit den erforderlichen Ereignisattributen auf.
1. Bearbeiten Sie das Beispielereignis nach Bedarf und fügen Sie es hinzu. Das Beispielereignis muss gültiges JSON sein.
1. (Optional) Sie können auch eine der folgenden Optionen wählen:
+ **Kopieren** – Kopiert das Beispielereignis in die Zwischenablage Ihres Geräts.
+ **Verschönern** – Erleichtert das Lesen des JSON-Texts durch Hinzufügen von Zeilenumbrüchen, Tabulatoren und Leerzeichen.
------
1. (Optional) Erweitern Sie den Abschnitt **Beispiel für Eingabepfade, Vorlagen und Ausgaben**, um Beispiele für Folgendes zu sehen:
+ So werden JSON-Pfade verwendet, um Variablen zu definieren, die Ereignisdaten darstellen
+ So können diese Variablen in einer Eingabe-Transformator-Vorlage verwendet werden
+ Die resultierende Ausgabe, die EventBridge an das Ziel gesendet wird
Ausführlichere Beispiele für Eingabetransformationen finden Sie unter [Beispiele für die Eingabetransformation](eb-transform-target-input.md#eb-transform-input-examples).
1. Definieren Sie im Abschnitt **Zieleingabe-Transformator** alle Variablen, die Sie in der Eingabevorlage verwenden möchten.
Variablen verwenden einen JSON-Pfad, um auf Werte in der ursprünglichen Ereignisquelle zu verweisen. Sie können dann in der Eingabevorlage auf diese Variablen verweisen, um Daten aus dem ursprünglichen Quellereignis in das transformierte Ereignis einzubeziehen, das EventBridge an das Ziel weitergegeben wird. Sie können bis zu 100 Variablen definieren. Der Eingabe-Transformator muss gültiges JSON sein.
Nehmen wir beispielsweise an, Sie hätten das AWS Ereignis **S3 Object Created** als Beispielereignis für diesen Eingangstransformator ausgewählt. Sie könnten dann die folgenden Variablen zur Verwendung in Ihrer Vorlage definieren:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Optional) Sie können auch **Kopieren** auswählen, um den Eingabe-Transformator in die Zwischenablage Ihres Geräts zu kopieren.
1. Verfassen Sie im Abschnitt **Vorlage** die Vorlage, anhand derer Sie bestimmen möchten, was EventBridge an das Ziel übergeben wird.
Sie können JSON, Zeichenfolgen, statische Informationen, von Ihnen definierte Variablen sowie reservierte Variablen verwenden. Ausführlichere Beispiele für Eingabetransformationen finden Sie unter [Beispiele für die Eingabetransformation](eb-transform-target-input.md#eb-transform-input-examples).
Angenommen, Sie haben die Variablen im vorherigen Beispiel definiert. Sie könnten dann die folgende Vorlage erstellen, die auf diese Variablen sowie auf reservierte Variablen und statische Informationen verweist.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Optional) Sie können auch **Kopieren** auswählen, um die Vorlage in die Zwischenablage Ihres Geräts zu kopieren.
1. Wenn Sie Ihre Vorlage testen möchten, wählen Sie **Ausgabe erzeugen** aus.
EventBridge verarbeitet das Beispielereignis auf der Grundlage der Eingabevorlage und zeigt die transformierte Ausgabe an, die unter **Ausgabe** generiert wurde. Dies sind die Informationen, EventBridge die anstelle des ursprünglichen Quellereignisses an das Ziel weitergegeben werden.
Die erzeugte Ausgabe für die oben beschriebene Beispiel-Eingabevorlage wäre die folgende:
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
(Optional) Sie können auch **Kopieren** auswählen, um die erzeugte Ausgabe in die Zwischenablage Ihres Geräts zu kopieren.