Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Crea una EventBridge regola per una fonte Amazon S3 (console)
<a name="create-cloudtrail-S3-source-console"></a>

Prima di configurare una regola in EventBridge, devi creare un AWS CloudTrail percorso. Per ulteriori informazioni, consulta [Creazione di un trail nella console](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-a-trail-using-the-console-first-time.html).

**Importante**  
Se usi la console per creare o modificare la pipeline, la EventBridge regola e il AWS CloudTrail percorso vengono creati automaticamente.

**Come creare un trail**

1. Apri la AWS CloudTrail console.

1. Nel riquadro di navigazione selezionare **Trails** (Percorso).

1. Scegliere **Create trail (Creare trail)**. In **Trail name (Nome trail)**, immetti un nome per il trail.

1. In **Storage location (Percorso di storage)**, creare o specificare il bucket da utilizzare per archiviare i file di log. Per impostazione predefinita, i bucket e gli oggetti Amazon S3 sono privati. Solo il proprietario della risorsa (l' AWS account che ha creato il bucket) può accedere al bucket e ai suoi oggetti. Il bucket deve disporre di una politica delle risorse che consenta AWS CloudTrail le autorizzazioni di accesso agli oggetti nel bucket.

1. In **Trail log bucket and folder**, specifica un bucket Amazon S3 e il prefisso dell'oggetto (nome della cartella) per registrare gli eventi relativi ai dati per tutti gli oggetti nella cartella. Per ogni trail puoi aggiungere fino a 250 oggetti Amazon S3. **Completa le informazioni sulla chiave di crittografia richieste e scegli Avanti.**

1. Per **Tipo di evento**, scegli **Eventi di gestione**.

1. Per **gli eventi di gestione**, scegli **Scrivi**. Il percorso registra l'attività dell'API a livello di oggetto di Amazon S3 (ad esempio `GetObject` e`PutObject`) sul bucket e sul prefisso specificati.

1. Scegliere **Write (Scrivi)**. 

1. **Se sei soddisfatto del percorso, scegli Crea percorso.**

**Per creare una EventBridge regola che abbia come target la tua pipeline con una fonte Amazon S3**

1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Nel riquadro di navigazione, scegli **Regole**. Lascia selezionato il bus predefinito o scegli un bus per eventi. Scegli **Crea regola**.

1. In **Nome**, inserisci un nome per la regola.

1. In **Tipo di regola**, scegli **Regola con un modello di evento**. Scegli **Next (Successivo)**.

1. In **Origine evento**, scegli **AWS eventi o eventi EventBridge partner**.

1. In **Tipo di evento di esempio**, scegli **AWS eventi**.

1. In **Eventi di esempio**, digita S3 come parola chiave su cui filtrare. Scegli la **chiamata AWS API tramite CloudTrail**.

1. In **Metodo di creazione**, scegli **Customer pattern (editor JSON).**

   Incolla lo schema di eventi fornito di seguito. Assicurati di aggiungere il nome del bucket e la chiave dell'oggetto S3 (o nome chiave) che identifica in modo univoco l'oggetto nel bucket come. `requestParameters` In questo esempio, viene creata una regola per un bucket denominato `amzn-s3-demo-source-bucket` e una chiave oggetto di. `my-files.zip` Quando utilizzi la finestra **Edit (Modifica)** per specificare le risorse, la regola viene aggiornata per l'utilizzo di un modello eventi personalizzato.

   Di seguito è riportato un esempio di modello di eventi da copiare e incollare:

   ```
   {
       "source": [
           "aws.s3"
       ],
       "detail-type": [
           "AWS API Call via CloudTrail"
       ],
       "detail": {
           "eventSource": [
               "s3.amazonaws.com"
           ],
           "eventName": [
               "CopyObject",
               "CompleteMultipartUpload",
               "PutObject"
           ],
           "requestParameters": {
               "bucketName": [
                   "amzn-s3-demo-source-bucket"
               ],
               "key": [
                   "my-files.zip"
               ]
           }
       }
   }
   ```

1. Scegli **Next (Successivo)**.

1. In **Tipi di Target**, scegli **AWS service**.

1. In **Seleziona un obiettivo**, scegli **CodePipeline**. In **Pipeline ARN**, immettete l'ARN della pipeline per la pipeline da avviare in base a questa regola.
**Nota**  
Per ottenere l'ARN della pipeline, esegui il comando **get-pipeline**. L'ARN della pipeline viene visualizzato nell'output. Il formato è il seguente:   
*region**account*arn:aws:codepipeline::: *pipeline-name*  
ARN della pipeline di esempio:  
arn:aws:codepipeline:us-east- 2:80398 ESEMPIO: MyFirstPipeline 

1. Per creare o specificare un ruolo di servizio IAM che conceda le EventBridge autorizzazioni per richiamare il target associato alla regola (in questo caso, l'obiettivo è): EventBridge CodePipeline 
   + Scegli **Crea un nuovo ruolo per questa risorsa specifica per** creare un ruolo di servizio che ti dia EventBridge le autorizzazioni per avviare le esecuzioni della pipeline.
   + Scegli **Usa il ruolo esistente** per inserire un ruolo di servizio che ti dia EventBridge le autorizzazioni per avviare le esecuzioni della pipeline.

1. (Facoltativo) Per specificare le sostituzioni di origine con un ID di immagine specifico, utilizzate il trasformatore di input per passare i dati come parametri JSON. Puoi anche usare il trasformatore di input per passare le variabili della pipeline.
   + Espandere **Additional settings** (Impostazioni aggiuntive).

     In **Configura l'input di destinazione**, scegli **Configura trasformatore di ingresso**.

     Nella finestra di dialogo, scegli **Inserisci il mio.** Nella casella **Percorso di input**, digitate le seguenti coppie chiave-valore.

     ```
     {"revisionValue": "$.detail.object.version-id"}
     ```
   + Nella casella **Modello**, digitate le seguenti coppie chiave-valore.

     ```
                                     
                                     {
         "sourceRevisions": [
             {
                 "actionName": "Source",
                 "revisionType": "S3_OBJECT_VERSION_ID",
                 "revisionValue": "<revisionValue>"
             }
         ],
          "variables": [
             {
                 "name": "Variable_Name",
                 "value": "Variable_Value"
             }
         ]
     }
     ```
   + Scegli **Conferma**.

1. Scegli **Next (Successivo)**.

1. **Nella pagina **Tag**, scegli Avanti.**

1. Nella pagina **Rivedi e crea**, esamina la configurazione della regola. Se la regola ti soddisfa, scegli **Create rule** (Crea regola).