SFTPFTPS, et événements FTP du serveur - AWS Transfer Family

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

SFTPFTPS, et événements FTP du serveur

Voici les champs détaillés pour SFTPFTPS, et les événements FTP du serveur :

  • FTPTéléchargement du serveur de fichiers terminé

  • FTPÉchec du téléchargement du serveur de fichiers

  • FTPChargement du serveur de fichiers terminé

  • FTPEchec du téléchargement du serveur de fichiers

  • FTPSTéléchargement du serveur de fichiers terminé

  • FTPSÉchec du téléchargement du serveur de fichiers

  • FTPSChargement du serveur de fichiers terminé

  • FTPSEchec du téléchargement du serveur de fichiers

  • SFTPTéléchargement du fichier du serveur terminé

  • SFTPÉchec du téléchargement du fichier du serveur

  • SFTPTéléchargement du fichier du serveur terminé

  • SFTPÉchec du téléchargement du fichier sur le serveur

Les detail-type champs source et sont inclus ci-dessous car ils contiennent des valeurs spécifiques pour les Transfer Family événements. Pour les définitions des autres champs de métadonnées inclus dans tous les événements, consultez la section Référence de la structure des événements dans le guide de Amazon EventBridge l'utilisateur.

{
  . . .,
  "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",
    "server-id" : "string",
    "username" : "string",
    "session-id" : "string",
    "start-timestamp" : "string"
  }
}
detail-type

Identifie le type d'événement.

Pour cet événement, la valeur est l'un des noms FTPS d'événements FTP du serveur répertoriés précédemment. SFTP

source

Identifie le service qui a généré l'événement. Pour les événements Transfer Family, cette valeur estaws.transfer.

detail

JSONObjet contenant des informations sur l'événement. Le service qui génère l'événement détermine le contenu de ce champ.

Pour cet événement, les données incluent les éléments suivants :

failure-code

Catégorie expliquant pourquoi le transfert a échoué. Valeurs: PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR

status-code

Si le transfert est réussi. Valeurs :COMPLETED | FAILED.

protocol

Protocole utilisé pour le transfert. Valeurs: SFTP | FTPS | FTP

bytes

Nombre d’octets transférés.

client-ip

Adresse IP du client impliqué dans le transfert

failure-message

Pour les transferts ayant échoué, les détails expliquant pourquoi le transfert a échoué.

end-timestamp

Pour les transferts réussis, horodatage indiquant la fin du traitement du fichier.

etag

La balise d'entité (uniquement utilisée pour les fichiers Amazon S3).

file-path

Le chemin d'accès au fichier transféré.

server-id

L'identifiant unique du serveur Transfer Family.

username

L'utilisateur qui effectue le transfert.

session-id

Identifiant unique de la session de transfert.

start-timestamp

Pour les transferts réussis, l'horodatage du début du traitement des fichiers.

Exemple SFTPExemple d'événement d'échec du téléchargement du fichier du serveur

L'exemple suivant montre un événement au cours duquel un téléchargement a échoué sur un SFTP serveur (Amazon EFS le stockage est-il utilisé).

{
    "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"
    }
}
Exemple FTPExemple d'événement « Téléchargement du serveur de fichiers terminé »

L'exemple suivant montre un événement au cours duquel un téléchargement s'Amazon S3 est terminé avec succès sur un FTP serveur (le stockage est-il utilisé).

{
    "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": "/DOC-EXAMPLE-BUCKET/test/1mb_file",
        "server-id": "s-1111aaaa2222bbbb3",
        "username": "test",
        "session-id": "event-ID",
        "start-timestamp": "2024-01-29T16:31:42.462088327Z"
    }
}