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

イベントのタイプを示します。

このイベントの場合、値は、前述の SFTP、FTPS、または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"
    }
}