`. Vous pouvez référencer ces variables lors de la création de votre *modèle d’entrée*.
**Note**
Amazon CloudWatch Logs et les cibles SSM ne prennent pas en charge l'utilisation de `Input` et `InputPath` dans leurs transformateurs d'entrée.
### Modèle de saisie
Le *modèle d’entrée* est un modèle pour les informations que vous souhaitez transmettre à votre cible. Vous pouvez créer un modèle qui transmet une chaîne ou un fichier JSON à la cible. À l'aide de l'événement précédent et du *chemin d'entrée*, les exemples de *modèle d’entrée* suivants transformeront l'événement en l’exemple de sortie suivant avant de l’acheminer vers une cible.
| Description | Modèle | Output |
| --- | --- | --- |
| Chaîne simple | "instance is in "
| "instance i-0123456789 is in RUNNING"
|
| **Chaîne avec guillemets échappés** | "instance \"\" is in "
| "instance \"i-0123456789\" is in RUNNING"
Notez qu'il s'agit du comportement de la EventBridge console. L’ AWS CLI échappe les caractères de barre oblique et le résultat est `"instance "i-0123456789" is in RUNNING"`. |
| **Fichier JSON simple** | {
"instance" : ,
"state":
} | {
"instance" : "i-0123456789",
"state": "RUNNING"
} |
| **Fichier JSON avec chaînes et variables** | {
"instance" : ,
"state": "",
"instanceStatus": "instance \"\" is in "
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"instanceStatus": "instance \"i-0123456789\" is in RUNNING"
} |
| **Fichier JSON avec un mélange de variables et d'informations statiques** | {
"instance" : ,
"state": [ 9, , true ],
"Transformed" : "Yes"
}
| {
"instance" : "i-0123456789",
"state": [
9,
"RUNNING",
true
],
"Transformed" : "Yes"
} |
| **Inclut des variables réservées dans 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
}
} |
| **Inclut des variables réservées dans une chaîne** | " triggered"
| "example triggered"
|
| **Groupe de CloudWatch journaux Amazon** | {
"timestamp" : ,
"message": "instance \"\" is in "
} | {
"timestamp" : 2015-11-11T21:29:54Z,
"message": "instance "i-0123456789" is in RUNNING
} |
## Transformation des entrées à l'aide de l' EventBridge API
Pour plus d'informations sur l'utilisation de l' EventBridge API pour transformer les entrées, voir [Utiliser le transformateur d'entrée pour extraire les données d'un événement et les saisir dans la cible](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html#API_PutTargets_Example_2).
## Transformation des données en utilisant AWS CloudFormation
Pour plus d'informations sur l'utilisation AWS CloudFormation pour transformer les entrées, consultez [AWS::Events::Rule InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html).
## Problèmes courants liés à la transformation d’entrée
Voici quelques problèmes courants lors de la transformation des entrées en EventBridge :
+ Pour les chaînes, des guillemets sont requis.
+ Il n'y a pas de validation lors de la création du chemin JSON pour votre modèle.
+ Si vous spécifiez une variable à mettre en correspondance avec un chemin JSON qui n’existe pas dans l’événement, cette variable n’est pas créée et n’apparaîtra pas dans la sortie.
+ Les propriétés JSON telles que `aws.events.event.json` ne peuvent être utilisées que comme valeur d’un champ JSON, et non en ligne dans d’autres chaînes.
+ EventBridge n'échappe pas aux valeurs extraites par *Input Path*, lors du remplissage du *modèle d'entrée* pour une cible.
+ Si un chemin JSON fait référence à un objet ou à un tableau JSON, mais que la variable est référencée dans une chaîne, EventBridge supprime tous les guillemets internes pour garantir la validité de la chaîne. Par exemple, pour une variable `` pointée`$.detail`, « Detail is » entraînerait la EventBridge suppression des guillemets de l'objet.
Par conséquent, si vous souhaitez générer un objet JSON basé sur une seule variable de chemin JSON, vous devez le placer sous forme de clé. Dans cet exemple, `{"detail": }`.
+ Les guillemets ne sont pas obligatoires pour les variables qui représentent des chaînes. Ils sont autorisés, mais ajoutent EventBridge automatiquement des guillemets aux valeurs des variables de chaîne lors de la transformation, afin de garantir que le résultat de la transformation est un JSON valide. EventBridge n'ajoute pas de guillemets aux variables qui représentent des objets ou des tableaux JSON. N’ajoutez pas de guillemets pour les variables qui représentent des objets ou des tableaux JSON.
Par exemple, le modèle d’entrée suivant inclut des variables qui représentent à la fois des chaînes et des objets JSON :
```
{
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
}
```
Le résultat est un code JSON valide avec des guillemets appropriés :
```
{
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
}
```
+ Pour une sortie de texte (non JSON) sous forme de chaînes multilignes, placez chaque ligne distincte de votre modèle de saisie entre guillemets doubles.
Par exemple, si vous faisiez correspondre les événements de [Amazon Inspector recherche](https://docs.aws.amazon.com/inspector/latest/user/eventbridge-integration.html#event-finding) au modèle d'événements suivant :
```
{
"detail": {
"severity": ["HIGH"],
"status": ["ACTIVE"]
},
"detail-type": ["Inspector2 Finding"],
"source": ["inspector2"]
}
```
Et en utilisant le chemin d'entrée suivant :
```
{
"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"
}
```
Vous pouvez utiliser le modèle de saisie ci-dessous pour générer une sortie de chaîne multiligne :
```
" severity finding "
"Description: <description>"
"ARN: \"<arn>\""
"Type: <type>"
"AWS Account: <account>"
"Region: <region>"
"EC2 Instance: <instance>"
"Platform: <platform>"
"AMI: <ami>"
```