SFTPFTPS、和FTP服务器事件 - AWS Transfer Family

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

SFTPFTPS、和FTP服务器事件

以下是SFTPFTPS、和FTP服务器事件的详细信息字段：

  • FTP文件服务器下载已完成

  • FTP文件服务器下载失败

  • FTP文件服务器上传已完成

  • FTP文件服务器上传失败

  • FTPS文件服务器下载已完成

  • FTPS文件服务器下载失败

  • FTPS文件服务器上传已完成

  • FTPS文件服务器上传失败

  • SFTP服务器文件下载已完成

  • SFTP服务器文件下载失败

  • SFTP服务器文件上传已完成

  • SFTP服务器文件上传失败

下面包含source和detail-type字段，因为它们包含 Transfer Family 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅Amazon EventBridge 用户指南中的事件结构参考。

{
  . . .,
  "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

标识事件的类型。

对于此事件，该值是先前列出的SFTPFTPS、或FTP服务器事件名称之一。

source

标识生成事件的服务。对于 Transfer Family 事件，此值为aws.transfer。

detail

一个包含有关事件的信息的JSON对象。生成事件的服务决定该字段的内容。

此事件的数据包括以下内容：

failure-code

传输失败原因的类别。值：PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR

status-code

传输是否成功。价值观：COMPLETED | FAILED。

protocol

用于传输的协议。值：SFTP | FTPS | FTP

bytes

传输的字节数。

client-ip

参与传输的客户端 IP 地址

failure-message

对于失败的传输，提供传输失败原因的详细信息。

end-timestamp

对于成功传输，指文件处理完毕的时间戳。

etag

实体标签（仅用于 Amazon S3 文件）。

file-path

正在传输的文件的路径。

server-id

Transfer Family 服务器的唯一 ID。

username

正在执行转移的用户。

session-id

传输会话的唯一标识符。

start-timestamp

对于成功传输，指文件处理开始时间的时间戳。

例 SFTP服务器文件下载失败示例事件

以下示例显示了SFTP服务器上下载失败的事件（Amazon EFS 是否正在使用存储空间）。

{
    "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"
    }
}
例 FTP文件服务器上传已完成示例事件

以下示例显示了在FTP服务器上成功完成上传的事件（Amazon S3 是否正在使用存储空间）。

{
    "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"
    }
}