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

# Transfer Family riferimento ai dettagli degli eventi
<a name="events-detail-reference"></a>

Tutti gli eventi dei AWS servizi hanno un set comune di campi contenenti metadati relativi all'evento. Questi metadati possono includere il AWS servizio che è l'origine dell'evento, l'ora in cui l'evento è stato generato, l'account e la regione in cui si è verificato l'evento e altri. Per le definizioni di questi campi generali, consultate il [riferimento alla struttura degli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) nella *Guida per l'Amazon EventBridge utente*. 

Inoltre, ogni evento ha un campo `detail` che contiene dati specifici per quel particolare evento. Il riferimento seguente definisce i campi di dettaglio per i vari Transfer Family eventi.

Quando utilizzate EventBridge per selezionare e gestire Transfer Family gli eventi, tenete presente quanto segue:
+ Il `source` campo per tutti gli eventi da Transfer Family è impostato su`aws.transfer`.
+ Il campo `detail-type` specifica il tipo di evento. 

  Ad esempio, `FTP Server File Download Completed`.
+ Il campo `detail` contiene i dati specifici di quel particolare evento. 

Per informazioni sulla creazione di modelli di eventi che consentono alle regole di abbinare Transfer Family gli eventi, consulta [Modelli di eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) nella *Guida per l'Amazon EventBridge utente*.

Per ulteriori informazioni sugli eventi e su come li EventBridge elabora, consulta [Amazon EventBridge gli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) nella *Guida per l'Amazon EventBridge utente*.

**Topics**
+ [Eventi dei server SFTP, FTPS e FTP](#event-detail-server-events)
+ [Eventi del connettore SFTP](#event-detail-sftp-connector-events)
+ [AS2 eventi](#event-detail-as2-server-events)

## Eventi dei server SFTP, FTPS e FTP
<a name="event-detail-server-events"></a>

Di seguito sono riportati i campi di dettaglio per gli eventi dei server SFTP, FTPS e FTP:
+ Creazione della directory del server FTP completata
+ Creazione della directory del server FTP non riuscita
+ Eliminazione della directory del server FTP completata
+ Eliminazione della directory del server FTP non riuscita
+ Eliminazione del file dal server FTP completata
+ Eliminazione del file dal server FTP non riuscita
+ Scaricamento del file dal server FTP completato
+ Scaricamento del file dal server FTP non riuscito
+ Rinomina file del server FTP completata
+ Rinomina file del server FTP non riuscita
+ Caricamento del file sul server FTP completato
+ Caricamento del file sul server FTP non riuscito
+ Creazione della directory del server FTPS completata
+ Creazione della directory del server FTPS non riuscita
+ Eliminazione della directory del server FTPS completata
+ Eliminazione della directory del server FTPS non riuscita
+ Eliminazione del file dal server FTPS completata
+ Eliminazione del file dal server FTPS non riuscita
+ Scaricamento del file dal server FTPS completato
+ Scaricamento del file dal server FTPS non riuscito
+ Rinomina file del server FTPS completata
+ Rinomina file del server FTPS non riuscita
+ Caricamento del file sul server FTPS completato
+ Caricamento del file sul server FTPS non riuscito
+ Creazione della directory del server SFTP completata
+ Creazione della directory del server SFTP non riuscita
+ Eliminazione della directory del server SFTP completata
+ Eliminazione della directory del server SFTP non riuscita
+ Eliminazione dei file dal server SFTP completata
+ Eliminazione del file del server SFTP non riuscita
+ Scaricamento del file dal server SFTP completato
+ Scaricamento del file dal server SFTP non riuscito
+ Rinomina dei file del server SFTP completata
+ Rinomina file del server SFTP non riuscita
+ Caricamento dei file del server SFTP completato
+ Caricamento del file sul server SFTP non riuscito

I `detail-type` campi `source` e sono inclusi di seguito perché contengono valori specifici per Transfer Family gli eventi. Per le definizioni degli altri campi di metadati inclusi in tutti gli eventi, consulta il [riferimento alla struttura degli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) nella *Guida per l'Amazon EventBridge utente*.

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "failure-code" : "string",
    "status-code" : "string",
    "protocol" : "string",
    "bytes" : "number",
    "client-ip" : "string",
    "failure-message" : "string",
    "end-timestamp" : "string",
    "etag" : "string",
    "file-path" : "string",
    "original-file-path" : "string",
    "renamed-file-path" : "string",
    "directory-path" : "string",
    "server-id" : "string",
    "username" : "string",
    "session-id" : "string",
    "start-timestamp" : "string"
  }
}
```

`detail-type`  <a name="event-detail-server-events-detail-type"></a>
Identifica il tipo di evento.  
Per questo evento, il valore è uno dei nomi di evento del server SFTP, FTPS o FTP elencati in precedenza.

`source`  <a name="event-detail-server-events-source"></a>
Identifica il servizio che ha generato l’evento. Per gli eventi Transfer Family, questo valore è`aws.transfer`.

`detail`  <a name="sftp-server-detail"></a>
Un oggetto JSON contenente informazioni sull’evento. Il servizio che genera l’evento determina il contenuto di questo campo.  
Per questo evento, i dati includono quanto segue:    
`failure-code`  <a name="sftp-server-failure-code"></a>
Categoria relativa al motivo per cui il trasferimento non è riuscito. Valori: `PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR`  
`status-code`  <a name="sftp-server-status-code"></a>
Se il trasferimento è andato a buon fine. Valori:`COMPLETED | FAILED`.  
`protocol`  <a name="sftp-server-protocol"></a>
Il protocollo utilizzato per il trasferimento. Valori: `SFTP | FTPS | FTP`  
`bytes`  <a name="sftp-server-bytes"></a>
Il numero di byte trasferiti.  
`client-ip`  <a name="sftp-server-client-ip"></a>
L'indirizzo IP del client coinvolto nel trasferimento  
`failure-message`  <a name="sftp-server-failure-message"></a>
Per i trasferimenti non riusciti, i dettagli del motivo per cui il trasferimento non è riuscito.  
`end-timestamp`  <a name="sftp-server-end-timestamp"></a>
Per i trasferimenti riusciti, il timestamp del termine dell'elaborazione del file.  
`etag`  <a name="sftp-server-etag"></a>
Il tag di entità (utilizzato solo per i file Amazon S3).  
`file-path`  <a name="sftp-server-file-path"></a>
Il percorso del file trasferito, eliminato o utilizzato in altro modo.  
`original-file-path`  <a name="sftp-server-original-file-path"></a>
Per gli eventi di ridenominazione dei file, il percorso originale del file prima della ridenominazione.  
`renamed-file-path`  <a name="sftp-server-renamed-file-path"></a>
Per gli eventi di ridenominazione dei file, il nuovo percorso del file dopo la ridenominazione.  
`directory-path`  <a name="sftp-server-directory-path"></a>
Per gli eventi di creazione ed eliminazione della directory, il percorso della directory.  
`server-id`  <a name="sftp-server-server-id"></a>
L'ID univoco per il server Transfer Family.  
`username`  <a name="sftp-server-username"></a>
L'utente che sta eseguendo il trasferimento.  
`session-id`  <a name="sftp-server-session-id"></a>
L'identificatore univoco per la sessione di trasferimento.  
`start-timestamp`  <a name="sftp-server-start-timestamp"></a>
Per trasferimenti riusciti, il timestamp di inizio dell'elaborazione dei file.

**Example Esempio di evento SFTP Server File Download Failed**  <a name="event-detail-server-events.example"></a>
L'esempio seguente mostra un evento in cui un download non è riuscito su un server SFTP (Amazon EFS è lo storage utilizzato).  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Download Failed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T17:20:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "failure-code": "PARTIAL_DOWNLOAD",
        "status-code": "FAILED",
        "protocol": "SFTP",
        "bytes": 4100,
        "client-ip": "IP-address",
        "failure-message": "File was partially downloaded.",
        "end-timestamp": "2024-01-29T17:20:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2024-01-29T17:20:16.706282454Z"
    }
}
```

**Example Esempio di evento FTP Server File Upload Completed**  <a name="event-detail-server-events.example"></a>
L'esempio seguente mostra un evento in cui un caricamento è stato completato correttamente su un server FTP (Amazon S3 è lo storage utilizzato).  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "FTP Server File Upload Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T16:31:43Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1111aaaa2222bbbb3"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "FTP",
        "bytes": 1048576,
        "client-ip": "10.0.0.141",
        "end-timestamp": "2024-01-29T16:31:43.311866408Z",
        "etag": "b6d81b360a5672d80c27430f39153e2c",
        "file-path": "/amzn-s3-demo-bucket/test/1mb_file",
        "server-id": "s-1111aaaa2222bbbb3",
        "username": "test",
        "session-id": "event-ID",
        "start-timestamp": "2024-01-29T16:31:42.462088327Z"
    }
}
```

**Example Evento di esempio SFTP Server File Delete Completed**  <a name="event-detail-server-events.example"></a>
L'esempio seguente mostra un evento in cui un file è stato eliminato con successo su un server SFTP.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Delete Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T14:30:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T14:30:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file-to-delete.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T14:30:26.706282454Z"
    }
}
```

**Example Evento di esempio SFTP Server File Rename Completed**  <a name="event-detail-server-events.example"></a>
L'esempio seguente mostra un evento in cui un file è stato rinominato correttamente su un server SFTP.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Rename Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T15:45:12Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T15:45:12.749749117Z",
        "original-file-path": "/fs-1234abcd5678efghi/user0/old-filename.txt",
        "renamed-file-path": "/fs-1234abcd5678efghi/user0/new-filename.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T15:45:11.706282454Z"
    }
}
```

**Example Evento di esempio SFTP Server Directory Create Completed**  <a name="event-detail-server-events.example"></a>
L'esempio seguente mostra un evento in cui una directory è stata creata correttamente su un server SFTP.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server Directory Create Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T16:20:05Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T16:20:05.749749117Z",
        "directory-path": "/fs-1234abcd5678efghi/user0/new-directory",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T16:20:04.706282454Z"
    }
}
```

## Eventi del connettore SFTP
<a name="event-detail-sftp-connector-events"></a>

**Nota**  
Questi eventi vengono erogati a un EventBridge livello durevole, come descritto nella sezione [Livello di consegna per gli eventi AWS di servizio](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) in *Amazon EventBridge Events Reference*.

Di seguito sono riportati i campi di dettaglio per gli eventi del connettore SFTP:
+ Invio del file del connettore SFTP completato
+ Invio del file del connettore SFTP non riuscito
+ Recupero del file del connettore SFTP completato
+ Recupero del file del connettore SFTP non riuscito
+ Elenco delle directory dei connettori SFTP completato
+ Elenco delle directory dei connettori SFTP non riuscito
+ Spostamento remoto del connettore SFTP completato
+ Spostamento remoto del connettore SFTP non riuscito
+ Eliminazione remota del connettore SFTP completata
+ Eliminazione remota del connettore SFTP non riuscita

I `detail-type` campi `source` e sono inclusi di seguito perché contengono valori specifici per Transfer Family gli eventi. Per le definizioni degli altri campi di metadati inclusi in tutti gli eventi, consulta il [riferimento alla struttura degli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) nella *Guida per l'Amazon EventBridge utente*.

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "operation" : "string",
    "max-items" : "number",
    "connector-id" : "string",
    "output-directory-path" : "string",
    "listing-id" : "string",
    "transfer-id" : "string",
    "file-transfer-id" : "string",
    "url" : "string",
    "file-path" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "local-directory-path" : "string",
    "remote-directory-path" : "string"
    "item-count" : "number"
    "truncated" : "boolean"
    "bytes" : "number",
    "egress-type" : "string",
    "vpc-lattice-resource-configuration-arn" : "string",
    "vpc-lattice-port-number" : "number",
    "local-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    },
    "output-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    }
  }
}
```

`detail-type`  <a name="event-detail-sftp-connector-events-detail-type"></a>
Identifica il tipo di evento.  
Per questo evento, il valore è uno dei nomi di eventi del connettore SFTP elencati in precedenza.

`source`  <a name="event-detail-sftp-connector-events-source"></a>
Identifica il servizio che ha generato l’evento. Per Transfer Family gli eventi, questo valore è`aws.transfer`.

`detail`  <a name="sftp-connector-detail"></a>
Un oggetto JSON contenente informazioni sull’evento. Il servizio che genera l'evento determina il contenuto di questo campo.  
Per questo evento, i dati includono quanto segue:    
`max-items`  <a name="sftp-connector-max-items"></a>
Il numero massimo di directory/file nomi da restituire.  
`operation`  <a name="sftp-connector-operation"></a>
Se la `StartFileTransfer` richiesta consiste nell'invio o nel recupero di un file. Valori:. `SEND|RETRIEVE`  
`connector-id`  <a name="sftp-connector-connector-id"></a>
L'identificatore univoco per il connettore SFTP utilizzato.  
`output-directory-path`  <a name="sftp-connector-output-directory-path"></a>
Il percorso (bucket e prefisso) in Amazon S3 per archiviare i risultati dell'elenco. file/directory   
`listing-id`  <a name="sftp-connector-listing-id"></a>
Un identificatore univoco per il funzionamento dell'API. `StartDirectoryListing` Questo identificatore può essere utilizzato per controllare CloudWatch i log e vedere lo stato della richiesta di inserzione.  
`transfer-id`  <a name="sftp-connector-transfer-id"></a>
L'identificatore univoco per l'evento di trasferimento (una `StartFileTransfer` richiesta).  
`file-transfer-id`  <a name="sftp-connector-file-transfer-id"></a>
L'identificatore univoco del file da trasferire.  
`url`  <a name="sftp-connector-url"></a>
L'URL dell'endpoint SFTP AS2 o del partner.  
`file-path`  <a name="sftp-connector-file-path"></a>
La posizione e il file che vengono inviati o recuperati.  
`status-code`  <a name="sftp-connector-status-code"></a>
Se il trasferimento ha esito positivo. Valori:`FAILED | COMPLETED`.   
`failure-code`  <a name="sftp-connector-failure-code"></a>
Per i trasferimenti non riusciti, il codice del motivo per cui il trasferimento non è riuscito.  
`failure-message`  <a name="sftp-connector-failure-message"></a>
Per i trasferimenti non riusciti, i dettagli del motivo per cui il trasferimento non è riuscito.  
`start-timestamp`  <a name="sftp-connector-start-timestamp"></a>
Per trasferimenti riusciti, il timestamp di inizio dell'elaborazione dei file.  
`end-timestamp`  <a name="sftp-connector-end-timestamp"></a>
Per trasferimenti riusciti, il timestamp del completamento dell'elaborazione del file.  
`local-directory-path`  <a name="sftp-connector-local-directory-path"></a>
Per `RETRIEVE` le richieste, la posizione in cui inserire il file recuperato.  
`remote-directory-path`  <a name="sftp-connector-remote-directory-path"></a>
Per `SEND` le richieste, la directory dei file in cui inserire il file sul server SFTP del partner. Questo è il valore `RemoteDirectoryPath` che l'utente ha passato alla `StartFileTransfer` richiesta. È possibile specificare una directory predefinita sul server SFTP del partner. In tal caso, questo campo è vuoto.  
`item-count`  <a name="sftp-connector-item-count"></a>
Il numero di elementi (directory e file) restituiti per la richiesta di inserzione.  
`truncated`  <a name="sftp-connector-truncated"></a>
Se l'output dell'elenco contiene o meno tutti gli elementi contenuti nella directory remota.  
`bytes`  <a name="sftp-connector-bytes"></a>
Il numero di byte trasferiti. Il valore è 0 per i trasferimenti non riusciti.  
`egress-type`  <a name="sftp-connector-egress-type"></a>
Tipo di configurazione di uscita per il connettore. Valori: `SERVICE_MANAGED` o. `VPC_LATTICE`  
`vpc-lattice-resource-configuration-arn`  <a name="sftp-connector-vpc-lattice-resource-configuration-arn"></a>
ARN della configurazione delle risorse VPC\$1LATTICE che definisce la posizione del server SFTP di destinazione. Questo campo è nullo per i connettori gestiti dai servizi.  
`vpc-lattice-port-number`  <a name="sftp-connector-vpc-lattice-port-number"></a>
Numero di porta per la connessione al server SFTP tramite VPC\$1LATTICE.  
`local-file-location`  <a name="sftp-connector-local-file-location"></a>
Questo parametro contiene i dettagli della posizione del file di archiviazione. AWS     
`domain`  <a name="sftp-connector-domain"></a>
Lo spazio di archiviazione utilizzato. Attualmente, l'unico valore è`S3`.  
`bucket`  <a name="sftp-connector-bucket"></a>
Il contenitore per l'oggetto in Amazon S3.  
`key`  <a name="sftp-connector-key"></a>
Il nome assegnato all'oggetto in Amazon S3.  
`output-file-location`  <a name="sftp-connector-output-file-location"></a>
Questo parametro contiene i dettagli della posizione in cui archiviare i risultati dell'elenco delle directory in AWS archiviazione.    
`domain`  <a name="sftp-connector-output-domain"></a>
Lo spazio di archiviazione utilizzato. Attualmente, l'unico valore è`S3`.  
`bucket`  <a name="sftp-connector-output-bucket"></a>
Il contenitore per l'oggetto in Amazon S3.  
`key`  <a name="sftp-connector-output-key"></a>
Il nome assegnato all'oggetto in Amazon S3.

**Example Esempio di evento SFTP Connector File Send Failed**  <a name="event-detail-sftp-connector-events.example"></a>
L'esempio seguente mostra un evento in cui un connettore SFTP si è guastato durante il tentativo di inviare un file a un server SFTP remoto.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Send Failed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T19:30:45Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "SEND",
        "connector-id": "c-f1111aaaa2222bbbb3",
        "transfer-id": "transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "/amzn-s3-demo-bucket/testfile.txt",
        "status-code": "FAILED",
        "failure-code": "CONNECTION_ERROR",
        "failure-message": "Unknown Host",
        "remote-directory-path": "",
        "bytes": 0,
        "start-timestamp": "2024-01-24T18:29:33.658729Z",
        "end-timestamp": "2024-01-24T18:29:33.993196Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example Evento di esempio SFTP Connector File Retrieve Completed**  <a name="event-detail-sftp-connector-events.example"></a>
L'esempio seguente mostra un evento in cui un connettore SFTP ha recuperato con successo un file inviato da un server SFTP remoto.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Retrieve Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "RETRIEVE",
        "connector-id": "c-fc68000012345aa18",
        "transfer-id": "file-transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "testfile.txt",
        "status-code": "COMPLETED",
        "local-directory-path": "/amzn-s3-demo-bucket",
        "bytes": 63533,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example Evento di esempio SFTP Connector Directory Listing Completed**  <a name="event-detail-sftp-connector-events.example"></a>
L'esempio seguente mostra un evento in cui una chiamata Start Directory Listing ha recuperato un file di elenco da un server SFTP remoto.  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector Directory Listing Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "max-items": 10000,
        "connector-id": "c-fc68000012345aa18",
        "output-directory-path": "/amzn-s3-demo-bucket/example/file-listing-output",
        "listing-id": "123456-23aa-7980-abc1-1a2b3c4d5e",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",        
        "status-code": "COMPLETED",
        "remote-directory-path": "/home",
        "item-count": 10000,
        "truncated": true,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "output-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "c-fc1ab90fd0d047e7a-70987273-49nn-4006-bab1-1a7290cc412ba.json"
        }
    }
}
```

## AS2 eventi
<a name="event-detail-as2-server-events"></a>

**Nota**  
Questi eventi vengono erogati a un EventBridge livello durevole, come descritto nella sezione [Livello di consegna per gli eventi AWS di servizio](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) in *Amazon EventBridge Events Reference*.

Di seguito sono riportati i campi di dettaglio per AS2 gli eventi:
+ AS2 Payload (ricezione completata)
+ AS2 Ricezione del payload non riuscita
+ AS2 Invio del payload completato
+ AS2 Invio del payload non riuscito
+ AS2 Ricezione MDN completata
+ AS2 Ricezione MDN non riuscita
+ AS2 Invio MDN completato
+ AS2 Invio MDN non riuscito

I `detail-type` campi `source` e sono inclusi di seguito perché contengono valori specifici per Transfer Family gli eventi. Per le definizioni degli altri campi di metadati inclusi in tutti gli eventi, consulta il [riferimento alla struttura degli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) nella *Guida per l'Amazon EventBridge utente*.

```
{
   . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {    
    "s3-attributes" : {
      "file-bucket" : "string",
      "file-key" : "string",
      "json-bucket" : "string",
      "json-key" : "string", 
      "mdn-bucket" : "string",
      "mdn-key" : "string"
      }
    "mdn-subject" : "string",
    "mdn-message-id" : "string",
    "disposition" : "string",
    "bytes" : "number",
    "as2-from" : "string",
    "as2-message-id" : "string",
    "as2-to" : "string",
    "connector-id" : "string",
    "client-ip" : "string",
    "agreement-id" : "string",
    "server-id" : "string",
    "requester-file-name" : "string",
    "message-subject" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "transfer-id" : "string"
  }
}
```

`detail-type`  <a name="event-detail-as2-server-events-detail-type"></a>
Identifica il tipo di evento.  
Per questo evento, il valore è uno degli AS2 eventi elencati in precedenza.

`source`  <a name="event-detail-as2-server-events-source"></a>
Identifica il servizio che ha generato l’evento. Per Transfer Family gli eventi, questo valore è`aws.transfer`.

`detail`  <a name="as2-server-detail"></a>
Un oggetto JSON contenente informazioni sull’evento. Il servizio che genera l’evento determina il contenuto di questo campo.    
`s3-attributes`  <a name="as2-server-s3-attributes"></a>
Identifica il bucket e la chiave Amazon S3 per il file da trasferire. Per gli eventi MDN, identifica anche il bucket e la chiave per il file MDN.    
`file-bucket`  <a name="as2-server-s3-file-bucket"></a>
Il contenitore per l'oggetto in Amazon S3.  
`file-key`  <a name="as2-server-s3-file-key"></a>
Il nome assegnato all'oggetto in Amazon S3.  
`json-bucket`  <a name="as2-server-s3-json-bucket"></a>
Per i trasferimenti COMPLETATI o NON RIUSCITI, il contenitore per il file JSON.  
`json-key`  <a name="as2-server-s3-json-key"></a>
Per i trasferimenti COMPLETATI o NON RIUSCITI, il nome assegnato al file JSON in Amazon S3.  
`mdn-bucket`  <a name="as2-server-s3-mdn-bucket"></a>
Per gli eventi MDN, il contenitore per il file MDN.  
`mdn-key`  <a name="as2-server-s3-mdn-key"></a>
Per gli eventi MDN, il nome assegnato al file MDN in Amazon S3.   
`mdn-subject`  <a name="as2-server-mdn-subject"></a>
Per gli eventi MDN, una descrizione testuale della disposizione dei messaggi.  
`mdn-message-id`  <a name="as2-server-mdn-message-id"></a>
Per gli eventi MDN, un ID univoco per il messaggio MDN.  
`disposition`  <a name="as2-server-disposition"></a>
Per gli eventi MDN, la categoria per la disposizione.  
`bytes`  <a name="as2-server-bytes"></a>
Il numero di byte nel messaggio.  
`as2-from`  <a name="as2-server-as2-from"></a>
Il partner AS2 commerciale che invia il messaggio.  
`as2-message-id`  <a name="as2-server-as2-message-id"></a>
Un identificatore univoco per il AS2 messaggio da trasferire.  
`as2-to`  <a name="as2-server-as2-to"></a>
Il partner AS2 commerciale che riceve il messaggio.  
`connector-id`  <a name="as2-server-connector-id"></a>
Per AS2 i messaggi inviati da un server Transfer Family a un partner commerciale, viene utilizzato l'identificatore univoco del AS2 connettore.  
`client-ip`  <a name="as2-server-client-ip"></a>
Per gli eventi del server (trasferimenti da un partner commerciale a un server Transfer Family), l'indirizzo IP del client coinvolto nel trasferimento.   
`agreement-id`  <a name="as2-server-agreement-id"></a>
Per gli eventi del server, l'identificatore univoco dell' AS2accordo.  
`server-id`  <a name="as2-server-server-id"></a>
Per gli eventi del server, un ID univoco solo per il server Transfer Family.  
`requester-file-name`  <a name="as2-server-requester-file-name"></a>
Per gli eventi di payload, il nome originale del file ricevuto durante il trasferimento.  
`message-subject`  <a name="as2-server-message-subject"></a>
Una descrizione testuale dell'oggetto del messaggio.  
`start-timestamp`  <a name="as2-server-start-timestamp"></a>
Per trasferimenti riusciti, il timestamp di inizio dell'elaborazione dei file.  
`end-timestamp`  <a name="as2-server-end-timestamp"></a>
Per trasferimenti riusciti, il timestamp del completamento dell'elaborazione del file.  
`status-code`  <a name="as2-server-status-code"></a>
Il codice che corrisponde allo stato del processo di trasferimento dei AS2 messaggi. Valori validi: `COMPLETED | FAILED | PROCESSING`.  
`failure-code`  <a name="as2-server-failure-code"></a>
Per i trasferimenti non riusciti, la categoria relativa al motivo per cui il trasferimento non è riuscito.  
`failure-message`  <a name="as2-server-failure-message"></a>
Per i trasferimenti non riusciti, i dettagli del motivo per cui il trasferimento non è riuscito.  
`transfer-id`  <a name="as2-server-transfer-id"></a>
L'identificatore univoco dell'evento di trasferimento.

**Example AS2 Esempio di evento Payload Receive Completed**  <a name="event-detail-as2-server-events.example"></a>

```
{
    "version": "0",
     "id": "event-ID",
    "detail-type": "AS2 Payload Receive Completed",
    "source": "aws.transfer",
    "account": "076722215406",
    "time": "2024-02-07T06:47:05Z",
    "region": "us-east-1",
    "resources": ["arn:aws:transfer:us-east-1:076722215406:connector/c-1111aaaa2222bbbb3"],
    "detail": {
        "s3-attributes": {
            "file-key": "/inbound/processed/testAs2Message.dat",
            "file-bucket": "amzn-s3-demo-bucket"
        },
        "client-ip": "client-IP-address",
        "requester-file-name": "testAs2MessageVerifyFile.dat",
        "end-timestamp": "2024-02-07T06:47:06.040031Z",
        "as2-from": "as2-from-ID",
        "as2-message-id": "as2-message-ID",
        "message-subject": "Message from AS2 tests",
        "start-timestamp": "2024-02-07T06:47:05.410Z",
        "status-code": "PROCESSING",
        "bytes": 63,
        "as2-to": "as2-to-ID",
        "agreement-id": "a-1111aaaa2222bbbb3",
        "server-id": "s-1234abcd5678efghi"
    }
}
```

**Example AS2 Esempio di evento MDN Receive Failed**  <a name="event-detail-as2-server-events.example"></a>

```
{
  "version": "0",
  "id": "event-ID",
  "detail-type": "AS2 MDN Receive Failed",
  "source": "aws.transfer",
  "account": "889901007463",
  "time": "2024-02-06T22:05:09Z",
  "region": "us-east-1",
  "resources": ["arn:aws:transfer:us-east-1:076722215406:server/s-1111aaaa2222bbbb3"],
  "detail": {      
      "mdn-subject": "Your Requested MDN Response re: Test run from Id 123456789abcde to partner ijklmnop987654",
      "s3-attributes": {
          "json-bucket": "amzn-s3-demo-bucket1",
          "file-key": "/as2Integ/TestOutboundWrongCert.dat",
          "file-bucket": "amzn-s3-demo-bucket2",
          "json-key": "/as2Integ/failed/TestOutboundWrongCert.dat.json"
      },
      "mdn-message-id": "MDN-message-ID",
      "end-timestamp": "2024-02-06T22:05:09.479878Z",
      "as2-from": "PartnerA",
      "as2-message-id": "as2-message-ID",
      "connector-id": "c-1234abcd5678efghj",
      "message-subject": "Test run from Id 123456789abcde to partner ijklmnop987654",
      "start-timestamp": "2024-02-06T22:05:03Z",
      "failure-code": "VERIFICATION_FAILED_NO_MATCHING_KEY_FOUND",
      "status-code": "FAILED",
      "as2-to": "MyCompany",
      "failure-message": "No public certificate matching message signature could be found in profile: p-1234abcd5678efghj",
      "transfer-id": "transfer-ID"
  }
}
```