本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
SFTP连接器事件
以下是SFTP连接器事件的详细信息字段：
SFTP连接器文件发送已完成
SFTP连接器文件发送失败
SFTP连接器文件检索已完成
SFTP连接器文件检索失败
下面包含source和detail-type字段，因为它们包含 Transfer Family 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅Amazon EventBridge 用户指南中的事件结构参考。
{ . . ., "detail-type": "string", "source": "aws.transfer", . . ., "detail": { "operation" : "string", "connector-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" "bytes" : "number", "local-file-location" : { "domain" : "string", "bucket" : "string", "key" : "string" }, } }
detail-type-
标识事件的类型。
对于此事件，该值是先前列出的SFTP连接器事件名称之一。
source-
标识生成事件的服务。对于 Transfer Family 事件，此值为
aws.transfer。 detail-
一个包含有关事件的信息的JSON对象。生成事件的服务决定了该字段的内容。
此事件的数据包括以下内容：
operation-
StartFileTransfer请求是发送文件还是检索文件。价值观：SEND|RETRIEVE。 connector-id-
正在使用的SFTP连接器的唯一标识符。
transfer-id-
传输事件（
StartFileTransfer请求）的唯一标识符。 file-transfer-id-
正在传输的文件的唯一标识符。
url-
合作伙伴AS2或SFTP终端节点的。URL
file-path-
正在发送或检索的位置和文件。
status-code-
传输是否成功。价值观：
FAILED | COMPLETED。 failure-code-
对于失败的传输，则为转移失败的原因代码。
failure-message-
对于失败的传输，提供传输失败原因的详细信息。
start-timestamp-
对于成功传输，指文件处理开始时间的时间戳。
end-timestamp-
对于成功传输，指文件处理完成的时间戳。
local-directory-path-
对于
RETRIEVE请求，指存放检索到文件的位置。 remote-directory-path-
对于
SEND请求，指将文件放在合作伙伴SFTP服务器上的文件目录。这是用户传递给StartFileTransfer请求RemoteDirectoryPath的的值。您可以在合作伙伴的SFTP服务器上指定默认目录。如果是，则此字段为空。 bytes-
正在传输的字节数。对于失败的传输，该值为 0。
local-file-location-
此参数包含 Amazon 存储文件位置的详细信息。
domain-
正在使用的存储空间。目前，唯一的值是
S3。 bucket-
Amazon S3 中对象的容器。
key-
在 Amazon S3 中为对象分配的名称。
例 SFTP连接器文件发送失败示例事件
以下示例显示了SFTP连接器在尝试向远程SFTP服务器发送文件时出现故障的事件。
{ "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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET", "key": "testfile.txt" } } }
例 SFTP连接器文件检索已完成示例事件
以下示例显示了一个事件，在该事件中，SFTP连接器成功检索了从远程SFTP服务器发送的文件。
{ "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": "/DOC-EXAMPLE-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": "DOC-EXAMPLE-BUCKET", "key": "testfile.txt" } } }