AS2 事件 - AWS Transfer Family

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

AS2 事件

以下是AS2事件的詳細資訊欄位：

  • AS2 承載接收已完成

  • AS2 承載接收失敗

  • AS2 承載傳送已完成

  • AS2 承載傳送失敗

  • AS2 MDN 接收已完成

  • AS2 MDN 接收失敗

  • AS2 MDN 傳送已完成

  • AS2 MDN 傳送失敗

source 和 detail-type 欄位包含如下，因為其中包含 Transfer Family 事件的特定值。如需所有事件中包含的其他中繼資料欄位的定義，請參閱 Amazon EventBridge 使用者指南 中的事件結構參考。

{
   . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {    
    "s3-attributes" : {
      "file-bucket" : "string",
      "file-key" : "string",
      "json-bucket" : "string",
      "json-key" : "string", 
      "mdn-bucket" : "string",
      "mdn-key" : "string"
      }
    "mdn-subject" : "string",
    "mdn-message-id" : "string",
    "disposition" : "string",
    "bytes" : "number",
    "as2-from" : "string",
    "as2-message-id" : "string",
    "as2-to" : "string",
    "connector-id" : "string",
    "client-ip" : "string",
    "agreement-id" : "string",
    "server-id" : "string",
    "requester-file-name" : "string",
    "message-subject" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "transfer-id" : "string"
  }
}
detail-type

識別事件的類型。

對於此事件，該值是先前列出的AS2事件之一。

source

識別產生事件的服務。對於 Transfer Family 事件，此值為 aws.transfer。

detail

包含事件相關資訊的JSON物件。產生事件的服務會決定此欄位的內容。

s3-attributes

識別要傳輸之檔案的 Amazon S3 儲存貯體和金鑰。對於MDN事件，它也會識別MDN檔案的儲存貯體和金鑰。

file-bucket

Amazon S3 中物件的容器。

file-key

指派給 Amazon S3 中物件的名稱。

json-bucket

對於 COMPLETED或 FAILED傳輸，JSON檔案的容器。

json-key

對於 COMPLETED或 FAILED傳輸，指派給 Amazon S3 中JSON檔案的名稱。

mdn-bucket

對於MDN事件，MDN檔案的容器。

mdn-key

對於MDN事件，指派給 Amazon S3 中MDN檔案的名稱。

mdn-subject

對於MDN事件，訊息處置的文字描述。

mdn-message-id

對於MDN事件，MDN訊息的唯一 ID。

disposition

對於MDN事件，處置的類別。

bytes

訊息中的位元組數。

as2-from

傳送訊息的交易AS2合作夥伴。

as2-message-id

要傳輸之AS2訊息的唯一識別碼。

as2-to

接收訊息的交易AS2合作夥伴。

connector-id

對於從 Transfer Family 伺服器傳送至交易合作夥伴AS2的訊息，使用AS2連接器的唯一識別符。

client-ip

對於伺服器事件 （從交易合作夥伴傳輸到 Transfer Family 伺服器），涉及傳輸之用戶端的 IP 地址。

agreement-id

對於伺服器事件，則為AS2協議的唯一識別符。

server-id

對於伺服器事件，只有 Transfer Family 伺服器的唯一 ID。

requester-file-name

對於承載事件，傳輸期間所接收檔案的原始名稱。

message-subject

訊息主旨的文字描述。

start-timestamp

若要成功傳輸，檔案處理開始時的時間戳記。

end-timestamp

若要成功傳輸，檔案處理完成時的時間戳記。

status-code

對應AS2訊息傳輸程序狀態的程式碼。有效值：COMPLETED | FAILED | PROCESSING。

failure-code

對於失敗的傳輸，傳輸失敗原因的類別。

failure-message

對於失敗的傳輸，傳輸失敗的原因詳細資訊。

transfer-id

傳輸事件的唯一識別符。

範例 AS2 承載接收已完成範例事件
{
    "version": "0",
     "id": "event-ID",
    "detail-type": "AS2 Payload Receive Completed",
    "source": "aws.transfer",
    "account": "076722215406",
    "time": "2024-02-07T06:47:05Z",
    "region": "us-east-1",
    "resources": ["arn:aws:transfer:us-east-1:076722215406:connector/c-1111aaaa2222bbbb3"],
    "detail": {
        "s3-attributes": {
            "file-key": "/inbound/processed/testAs2Message.dat",
            "file-bucket": "DOC-EXAMPLE-BUCKET"
        },
        "client-ip": "client-IP-address",
        "requester-file-name": "testAs2MessageVerifyFile.dat",
        "end-timestamp": "2024-02-07T06:47:06.040031Z",
        "as2-from": "as2-from-ID",
        "as2-message-id": "as2-message-ID",
        "message-subject": "Message from AS2 tests",
        "start-timestamp": "2024-02-07T06:47:05.410Z",
        "status-code": "PROCESSING",
        "bytes": 63,
        "as2-to": "as2-to-ID",
        "agreement-id": "a-1111aaaa2222bbbb3",
        "server-id": "s-1234abcd5678efghi"
    }
}
範例 AS2 MDN 接收失敗的範例事件
{
  "version": "0",
  "id": "event-ID",
  "detail-type": "AS2 MDN Receive Failed",
  "source": "aws.transfer",
  "account": "889901007463",
  "time": "2024-02-06T22:05:09Z",
  "region": "us-east-1",
  "resources": ["arn:aws:transfer:us-east-1:076722215406:server/s-1111aaaa2222bbbb3"],
  "detail": {      
      "mdn-subject": "Your Requested MDN Response re: Test run from Id 123456789abcde to partner ijklmnop987654",
      "s3-attributes": {
          "json-bucket": "DOC-EXAMPLE-BUCKET1",
          "file-key": "/as2Integ/TestOutboundWrongCert.dat",
          "file-bucket": "DOC-EXAMPLE-BUCKET2",
          "json-key": "/as2Integ/failed/TestOutboundWrongCert.dat.json"
      },
      "mdn-message-id": "MDN-message-ID",
      "end-timestamp": "2024-02-06T22:05:09.479878Z",
      "as2-from": "PartnerA",
      "as2-message-id": "as2-message-ID",
      "connector-id": "c-1234abcd5678efghj",
      "message-subject": "Test run from Id 123456789abcde to partner ijklmnop987654",
      "start-timestamp": "2024-02-06T22:05:03Z",
      "failure-code": "VERIFICATION_FAILED_NO_MATCHING_KEY_FOUND",
      "status-code": "FAILED",
      "as2-to": "MyCompany",
      "failure-message": "No public certificate matching message signature could be found in profile: p-1234abcd5678efghj",
      "transfer-id": "transfer-ID"
  }
}