SFTP、 FTPS和 FTP 伺服器事件 - AWS Transfer Family

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

SFTP、 FTPS和 FTP 伺服器事件

以下是 SFTP、 FTPS和 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

識別事件的類型。

對於此事件，該值是先前列出的其中一個 FTPS、 SFTP或 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"
    }
}