`. Puoi fare riferimento a queste variabili durante la creazione di *Input Path (Percorso di input)*.
**Nota**
I target Amazon CloudWatch Logs e SSM non supportano l'uso di `Input` e `InputPath` nei rispettivi trasformatori di input.
### Modello di input
*Input Template (Modello di input)* è un modello per le informazioni che desideri passare alla destinazione. Puoi creare un modello che passa una stringa o un codice JSON alla destinazione. Utilizzando l'evento precedente e *Input Path (Percorso di input)*, i seguenti esempi di *Input Template (Modello di input)* trasformeranno l'evento nell'output di esempio prima di indirizzarlo a una destinazione.
| Description | Modello | Output |
| --- | --- | --- |
| Stringa semplice | "instance is in "
| "instance i-0123456789 is in RUNNING"
|
| **Stringa con virgolette di escape** | "instance \"\" is in "
| "instance \"i-0123456789\" is in RUNNING"
Nota che questo è il comportamento della EventBridge console. AWS CLI esegue l'escape dei caratteri di barra e il risultato è `"instance "i-0123456789" is in RUNNING"`. |
| **JSON semplice** | {
"instance" : ,
"state":
} | {
"instance" : "i-0123456789",
"state": "RUNNING"
} |
| **JSON con stringhe e variabili** | {
"instance" : ,
"state": "",
"instanceStatus": "instance \"\" is in "
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"instanceStatus": "instance \"i-0123456789\" is in RUNNING"
} |
| **JSON con un mix di variabili e informazioni statiche** | {
"instance" : ,
"state": [ 9, , true ],
"Transformed" : "Yes"
}
| {
"instance" : "i-0123456789",
"state": [
9,
"RUNNING",
true
],
"Transformed" : "Yes"
} |
| **Inclusione di variabili riservate 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
}
} |
| **Inclusione di variabili riservate in una stringa** | " triggered"
| "example triggered"
|
| **Gruppo di CloudWatch log Amazon** | {
"timestamp" : ,
"message": "instance \"\" is in "
} | {
"timestamp" : 2015-11-11T21:29:54Z,
"message": "instance "i-0123456789" is in RUNNING
} |
## Trasformazione dell'input utilizzando l'API EventBridge
Per informazioni sull'utilizzo dell' EventBridge API per trasformare l'input, consulta [Utilizzare Input Transformer per estrarre dati da un evento e immettere tali dati nella destinazione](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html#API_PutTargets_Example_2).
## Trasformazione dell'input utilizzando AWS CloudFormation
Per informazioni sull'utilizzo AWS CloudFormation per trasformare l'input, vedere [AWS::Events::Rule InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html).
## Problemi comuni con la trasformazione di input
Questi sono alcuni problemi comuni che si verificano quando si trasforma l'input in EventBridge:
+ Per le stringhe, le virgolette sono obbligatorie.
+ Non vi è alcuna convalida durante la creazione del percorso JSON per il modello.
+ Se specifichi una variabile per la corrispondenza con un percorso JSON che non esiste nell'evento, quella variabile non viene creata e non appare nell'output.
+ Le proprietà JSON come `aws.events.event.json` possono essere utilizzate solo come valore di un campo JSON, non in linea in altre stringhe.
+ EventBridge non sfugge ai valori estratti da *Input Path*, quando compila il *modello di input per un target*.
+ Se un percorso JSON fa riferimento a un oggetto o a un array JSON, ma la variabile è referenziata in una stringa, EventBridge rimuove tutte le virgolette interne per garantire una stringa valida. Ad esempio, per una variabile a cui si `` punta`$.detail`, «Detail is" comporterebbe la EventBridge rimozione delle virgolette dall'oggetto.
Pertanto, se come output vuoi un oggetto JSON basato su una singola variabile di percorso JSON, devi posizionarlo come chiave. In questo esempio, `{"detail": }`.
+ Le virgolette non sono necessarie per le variabili che rappresentano stringhe. Sono consentite, ma aggiungono EventBridge automaticamente le virgolette ai valori delle variabili di stringa durante la trasformazione, per garantire che l'output della trasformazione sia JSON valido. EventBridge non aggiunge virgolette alle variabili che rappresentano oggetti o array JSON. Non aggiungere virgolette alle variabili che rappresentano oggetti o array JSON.
Ad esempio, il seguente modello di input include variabili che rappresentano sia stringhe che oggetti JSON:
```
{
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
}
```
Il risultato è JSON valido con un uso corretto delle virgolette:
```
{
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
}
```
+ Per l'output di testo (non JSON) come stringhe multilinea, raccogli ogni riga separata del modello di input tra virgolette doppie.
Ad esempio, se stavi [Amazon Inspector confrontando gli eventi di Finding](https://docs.aws.amazon.com/inspector/latest/user/eventbridge-integration.html#event-finding) con il seguente schema di eventi:
```
{
"detail": {
"severity": ["HIGH"],
"status": ["ACTIVE"]
},
"detail-type": ["Inspector2 Finding"],
"source": ["inspector2"]
}
```
E utilizzando il seguente percorso di input:
```
{
"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"
}
```
È possibile utilizzare il modello di input seguente per generare un output di stringhe multilinea:
```
" severity finding "
"Description: <description>"
"ARN: \"<arn>\""
"Type: <type>"
"AWS Account: <account>"
"Region: <region>"
"EC2 Instance: <instance>"
"Platform: <platform>"
"AMI: <ami>"
```
# Configurazione di un trasformatore di ingresso durante la creazione di una regola in EventBridge
<a name="eb-transform-input-rule"></a>
Come parte della creazione di una regola, è possibile specificare un trasformatore di input EventBridge da utilizzare per elaborare gli eventi corrispondenti prima di inviarli alla destinazione specificata. È possibile configurare trasformatori di input per destinazioni che sono AWS servizi o destinazioni API.
**Per creare un trasformatore di input di destinazione come parte di una regola**
1. Segui i passaggi per creare una regola come descritto in [Creazione di regole in Amazon EventBridge](eb-create-rule-visual.md).
1. In **Passaggio 3: selezionare le destinazioni**, espandi **Impostazioni aggiuntive**.
1. In **Configura l'input di destinazione**, scegli **Trasformatore di input** dall'elenco a discesa.
Fai clic su **Configura il trasformatore di input**.
EventBridge visualizza la finestra di **dialogo Configura trasformatore di ingresso**.
1. Nella sezione **Evento di esempio**, scegli un **Tipo evento di esempio** in base al quale desideri testare il modello di eventi. Puoi scegliere un AWS evento, un evento partner o inserire il tuo evento personalizzato.
------
#### [ AWS events ]
Seleziona uno degli eventi emessi dai Servizi AWS supportati.
1. Seleziona **Eventi AWS **.
1. In **Eventi di esempio**, scegli l' AWS evento desiderato. Gli eventi sono organizzati per AWS servizio.
Quando si seleziona un evento, EventBridge compila l'evento di esempio.
Ad esempio, se scegliete **S3 Object Created**, EventBridge visualizza un esempio di evento S3 Object Created.
1. (Facoltativo) Puoi anche selezionare **Copia** per copiare l'evento di esempio negli appunti del dispositivo.
------
#### [ Partner events ]
Seleziona tra gli eventi emessi da servizi di terze parti che supportano EventBridge, come Salesforce.
1. **Seleziona EventBridge gli eventi dei partner.**
1. In **Eventi di esempio**, scegli l'evento partner desiderato. Gli eventi sono organizzati per partner.
Quando si seleziona un evento, EventBridge compila l'evento di esempio.
1. (Facoltativo) Puoi anche selezionare **Copia** per copiare l'evento di esempio negli appunti del dispositivo.
------
#### [ Enter your own ]
Immetti il tuo evento in formato JSON.
1. Seleziona **Inserisci il mio**.
1. EventBridge compila l'evento di esempio con un modello di attributi di evento obbligatori.
1. Modifica e aggiungi all'evento di esempio come desiderato. L'evento di esempio deve essere JSON valido.
1. (Facoltativo) È anche possibile scegliere una delle seguenti opzioni:
+ **Copia**: copia il modello di eventi negli appunti del dispositivo.
+ **Abbellisci (Prettify)**: semplifica la lettura del testo JSON aggiungendo interruzioni di riga, tabulazioni e spazi.
------
1. (Facoltativo) Espandi la sezione **Esempi di percorsi di input, modelli e output** per visualizzare esempi di:
+ Come vengono utilizzati i percorsi JSON per definire variabili che rappresentano i dati degli eventi
+ Come possono essere utilizzate queste variabili in un modello di trasformatore di input
+ L'output risultante che EventBridge viene inviato alla destinazione
Per esempi più dettagliati di trasformazioni di input, consulta [Esempi di trasformazione di input](eb-transform-target-input.md#eb-transform-input-examples).
1. Nella sezione **Transformatore di input di destinazione**, definisci le variabili che desideri utilizzare nel modello di input.
Le variabili utilizzano il percorso JSON per fare riferimento ai valori nell'origine dell'evento originale. È quindi possibile fare riferimento a tali variabili nel modello di input per includere i dati dell'evento di origine originale nell'evento trasformato che EventBridge passa alla destinazione. Puoi definire fino a 100 variabili. Il trasformatore di input deve essere in formato JSON valido.
Ad esempio, supponete di aver scelto l' AWS evento **S3 Object Created** come evento di esempio per questo trasformatore di input. Puoi quindi definire le seguenti variabili da utilizzare nel modello:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Facoltativo) Puoi anche scegliere **Copia** per copiare il trasformatore di input negli appunti del tuo dispositivo.
1. Nella sezione **Modello**, componi il modello che desideri utilizzare per determinare cosa EventBridge passare al bersaglio.
Puoi usare JSON, stringhe, informazioni statiche, variabili che hai definito e variabili riservate. Per esempi più dettagliati di trasformazioni di input, consulta [Esempi di trasformazione di input](eb-transform-target-input.md#eb-transform-input-examples).
Ad esempio, supponiamo che hai definito le variabili nell'esempio precedente. È quindi possibile comporre il seguente modello, che fa riferimento a tali variabili, nonché a variabili riservate e ad informazioni statiche.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Facoltativo) Puoi anche scegliere **Copia** per copiare il modello negli appunti del tuo dispositivo.
1. Per testare il modello, seleziona **Genera output**.
EventBridge elabora l'evento di esempio in base al modello di input e visualizza l'output trasformato generato in **Output**. Queste sono le informazioni che EventBridge verranno passate alla destinazione al posto dell'evento di origine originale.
L'output generato per il modello di input di esempio descritto sopra sarebbe il come segue:
```
{
"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"
}
```
(Facoltativo) Puoi anche scegliere **Copia** per copiare l'output generato negli appunti del tuo dispositivo.
1. Seleziona **Conferma**.
1. Segui gli altri passaggi per creare una regola come descritto in [Creazione di regole in Amazon EventBridge](eb-create-rule-visual.md).
# Test di un trasformatore di ingresso target utilizzando la Sandbox EventBridge
<a name="eb-sandbox-input-trans"></a>
[È possibile utilizzare i trasformatori di input per personalizzare il testo di un [evento](eb-events.md) prima di EventBridge passare le informazioni alla [destinazione](eb-targets.md) di una regola.](eb-rules.md)
La configurazione di un trasformatore di input fa in genere parte del processo più ampio di specificazione di una destinazione durante la [creazione di una nuova regola](eb-create-rule-visual.md) o la modifica di una regola esistente. Utilizzando Sandbox in EventBridge, tuttavia, è possibile configurare rapidamente un trasformatore di input e utilizzare un evento di esempio per confermare che si sta ottenendo l'output desiderato, senza dover creare o modificare una regola.
Per ulteriori informazioni sulle trasformazioni di input, consulta [Trasformazione degli EventBridge input di Amazon](eb-transform-target-input.md).
**Per testare un trasformatore di input di destinazione**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. In **Risorse per gli sviluppatori**, scegli **Sandbox** e nella pagina **Sandbox** scegli la scheda **Trasformatore di input di destinazione**.
1. Nella sezione **Evento di esempio**, scegli un **Tipo evento di esempio** in base al quale desideri testare il modello di eventi. Puoi scegliere un AWS evento, un evento per i partner o partecipare al tuo evento personalizzato.
------
#### [ AWS events ]
Seleziona uno degli eventi emessi dai Servizi AWS supportati.
1. Seleziona **Eventi AWS **.
1. In **Eventi di esempio**, scegli l' AWS evento desiderato. Gli eventi sono organizzati per AWS servizio.
Quando si seleziona un evento, EventBridge compila l'evento di esempio.
Ad esempio, se scegliete **S3 Object Created**, EventBridge visualizza un esempio di evento S3 Object Created.
1. (Facoltativo) Puoi anche selezionare **Copia** per copiare l'evento di esempio negli appunti del dispositivo.
------
#### [ Partner events ]
Seleziona tra gli eventi emessi da servizi di terze parti che supportano EventBridge, come Salesforce.
1. **Seleziona EventBridge gli eventi dei partner.**
1. In **Eventi di esempio**, scegli l'evento partner desiderato. Gli eventi sono organizzati per partner.
Quando si seleziona un evento, EventBridge compila l'evento di esempio.
1. (Facoltativo) Puoi anche selezionare **Copia** per copiare l'evento di esempio negli appunti del dispositivo.
------
#### [ Enter your own ]
Immetti il tuo evento in formato JSON.
1. Seleziona **Inserisci il mio**.
1. EventBridge compila l'evento di esempio con un modello di attributi di evento obbligatori.
1. Modifica e aggiungi all'evento di esempio come desiderato. L'evento di esempio deve essere JSON valido.
1. (Facoltativo) È anche possibile scegliere una delle seguenti opzioni:
+ **Copia**: copia il modello di eventi negli appunti del dispositivo.
+ **Abbellisci (Prettify)**: semplifica la lettura del testo JSON aggiungendo interruzioni di riga, tabulazioni e spazi.
------
1. (Facoltativo) Espandi la sezione **Esempi di percorsi di input, modelli e output** per visualizzare esempi di:
+ Come vengono utilizzati i percorsi JSON per definire variabili che rappresentano i dati degli eventi
+ Come possono essere utilizzate queste variabili in un modello di trasformatore di input
+ L'output risultante che EventBridge viene inviato alla destinazione
Per esempi più dettagliati di trasformazioni di input, consulta [Esempi di trasformazione di input](eb-transform-target-input.md#eb-transform-input-examples).
1. Nella sezione **Transformatore di input di destinazione**, definisci le variabili che desideri utilizzare nel modello di input.
Le variabili utilizzano il percorso JSON per fare riferimento ai valori nell'origine dell'evento originale. È quindi possibile fare riferimento a tali variabili nel modello di input per includere i dati dell'evento di origine originale nell'evento trasformato che EventBridge passa alla destinazione. Puoi definire fino a 100 variabili. Il trasformatore di input deve essere in formato JSON valido.
Ad esempio, supponete di aver scelto l' AWS evento **S3 Object Created** come evento di esempio per questo trasformatore di input. Puoi quindi definire le seguenti variabili da utilizzare nel modello:
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
(Facoltativo) Puoi anche scegliere **Copia** per copiare il trasformatore di input negli appunti del tuo dispositivo.
1. Nella sezione **Modello**, componi il modello che desideri utilizzare per determinare cosa EventBridge passare al bersaglio.
Puoi usare JSON, stringhe, informazioni statiche, variabili che hai definito e variabili riservate. Per esempi più dettagliati di trasformazioni di input, consulta [Esempi di trasformazione di input](eb-transform-target-input.md#eb-transform-input-examples).
Ad esempio, supponiamo che hai definito le variabili nell'esempio precedente. È quindi possibile comporre il seguente modello, che fa riferimento a tali variabili, nonché a variabili riservate e ad informazioni statiche.
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
(Facoltativo) Puoi anche scegliere **Copia** per copiare il modello negli appunti del tuo dispositivo.
1. Per testare il modello, seleziona **Genera output**.
EventBridge elabora l'evento di esempio in base al modello di input e visualizza l'output trasformato generato in **Output**. Queste sono le informazioni che EventBridge verranno passate alla destinazione al posto dell'evento di origine originale.
L'output generato per il modello di input di esempio descritto sopra sarebbe il come segue:
```
{
"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"
}
```
(Facoltativo) Puoi anche scegliere **Copia** per copiare l'output generato negli appunti del tuo dispositivo.