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à.

# Configurazione di sorgenti bucket S3 personalizzate
<a name="configuring-custom-s3-bucket-sources"></a>

Con le CloudWatch pipeline, puoi elaborare log arbitrari archiviati nei bucket S3.

## Prerequisiti
<a name="s3-prerequisites"></a>

Per utilizzare Amazon S3 come sorgente per una pipeline, crea prima un bucket S3. Per istruzioni, consulta [ Creazione di un bucket generico ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) nella Amazon S3 User Guide. * *

**Nota**  
Se il bucket S3 utilizzato come sorgente nella pipeline si trova in un AWS account diverso, devi anche abilitare le autorizzazioni di lettura tra account sul bucket. Ciò consente alla pipeline di leggere ed elaborare i dati. Per abilitare le autorizzazioni per più account, consulta la sezione [ Bucket owner granting cross-account bucket ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) permissions nella Amazon S3 User Guide. * *  
Se i tuoi bucket S3 sono in più account, usa una mappa. `bucket_owners` Per un esempio, vedi [ Cross-account S3 access ](https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/sources/s3/#cross-account-s3-access) nella documentazione. * OpenSearch *

Per configurare S3-SQS l'elaborazione, è inoltre necessario eseguire i seguenti passaggi:
+ [Crea una coda ](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/creating-sqs-standard-queues.html) Amazon SQS.
+ [Abilita le notifiche degli eventi sul bucket S3 con la coda SQS come destinazione. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-event-notifications.html)

## Configurare il ruolo della pipeline
<a name="configure-pipeline-role"></a>

A differenza di altri plug-in di origine che inviano dati a una pipeline, il plug-in di origine S3 ha un'architettura basata sulla lettura in cui la pipeline estrae i dati dall'origine. Pertanto, affinché una pipeline possa leggere da S3, è necessario specificare un ruolo all'interno della configurazione di origine S3 della pipeline che abbia accesso sia al bucket S3 che alla coda Amazon SQS. La pipeline assumerà questo ruolo per leggere i dati dalla coda.

Puoi trovare esempi di autorizzazioni di ruolo nelle politiche IAM. [ Source-specific ](pipeline-iam-reference.md#source-specific-iam-policies) Nota che questo ruolo deve avere una relazione di fiducia con il principio del servizio CloudWatch pipelines. Puoi trovare un esempio di configurazione della politica di fiducia per il tuo ruolo nella pipeline in Relazioni di [ fiducia. ](pipeline-iam-reference.md#trust-relationships)

## Crea la pipeline
<a name="create-s3-pipeline"></a>

Dopo aver impostato le autorizzazioni, puoi configurare una pipeline in base al tuo caso d'uso di Amazon S3.

Seleziona ** Create pipeline ** nella ** scheda ** Pipelines sotto ** Ingestion nella console. ** CloudWatch Segui i passaggi della procedura guidata della pipeline e fornisci l'ARN della coda SQS e il ruolo IAM della pipeline richiesto quando richiesto. Facoltativamente, fornisci un nome e un tipo di origine dati da allegare alla destinazione del gruppo di log in Logs. CloudWatch 

Assicurati di configurare una policy relativa alle risorse di [ CloudWatch Logs, ](https://docs.aws.amazon.com/resource-policies.html) se non l'hai già configurata per il gruppo di log di destinazione, quindi seleziona ** Crea pipeline ** nella fase di ** revisione e creazione**. In caso di successo, la pipeline verrà creata e i dati inizieranno a fluire entro 5 minuti.

## Amazon S3 cross account come fonte
<a name="cross-account-s3-access"></a>

Puoi concedere l'accesso a più account con Amazon S3 in modo che CloudWatch le pipeline possano accedere ai bucket S3 in un altro account come fonte. Per abilitare l'accesso tra account, consulta la sezione Proprietario del [ bucket che concede autorizzazioni a bucket su più account nella Amazon S3 User Guide. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) * * Dopo aver concesso l'accesso, assicurati che il ruolo della pipeline disponga delle autorizzazioni richieste.

Quindi, puoi creare una pipeline utilizzando `bucket_owners` per abilitare l'accesso tra più account a un bucket Amazon S3 come fonte.

**Configurazione di origine personalizzata **

Quando si crea una pipeline per sorgenti personalizzate:
+ Un parser deve essere il primo processore della pipeline
+ È possibile specificare qualsiasi processore supportato per le pipeline di log personalizzate