SFTP 커넥터 이벤트 - AWS Transfer Family

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

이 파라미터에는 AWS 스토리지 파일의 위치에 대한 세부 정보가 포함되어 있습니다.

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