ProtocolDetails - AWS Transfer Family
目錄另請參閱

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

ProtocolDetails

為伺服器設定的通訊協定設定。

目錄

As2Transports

指出 AS2 訊息的傳輸方法。目前僅支援 HTTP。

類型：字串陣列

陣列成員：固定項目數為 1。

有效值:HTTP

必要：否

PassiveIp

指示用於 FTP 和 FTPS 通訊協定的被動模式。輸入單一 IPv4 地址，例如防火牆、路由器或負載平衡器的公有 IP 地址。例如：

aws transfer update-server --protocol-details PassiveIp=0.0.0.0

將上述範例中的 0.0.0.0 取代為您要使用的實際 IP 地址。

注意

如果變更 PassiveIp 值，為了讓變更生效，您必須停止 Transfer Family 伺服器，然後重新啟動該伺服器。如需在 NAT 環境中使用被動模式 (PASV) 的詳細資訊，請參閱在防火牆或 NAT 後方設定 FTPS 伺服器。 AWS Transfer Family

特殊值

AUTO 和 0.0.0.0 是 PassiveIp 參數的特殊值。在預設情況下，值 PassiveIp=AUTO 會被指派至 FTP 和 FTPS 類型的伺服器。在此情況下，伺服器會自動在 PASV 回應中回應一個端點 IP。PassiveIp=0.0.0.0 對於其使用情況具有更加獨特的應用程式。例如，如果您具有高可用性 (HA) Network Load Balancer (NLB) 環境，且您在該環境中有 3 個子網路，則只能使用 PassiveIp 參數指定一個 IP 地址。這會降低高可用性的有效性。在此情況下，您可以指定 PassiveIp=0.0.0.0。這會讓用戶端使用與控制連線相同的 IP 地址，並將所有可用區域用於其連線。但請注意，並非所有 FTP 用戶端都支援PassiveIp=0.0.0.0回應。 FileZilla 和 WinSCP 確實支持它。如果您使用的是其他用戶端，請檢查您的用戶端是否支援 PassiveIp=0.0.0.0 回應。

類型：字串

長度限制：長度下限為 0。長度上限為 15。

必要：否

SetStatOption

使用 SetStatOption 來忽略在用戶端嘗試對您上傳至 S3 儲存貯體的檔案使用 SETSTAT 時所產生的錯誤。

某些 SFTP 檔案傳輸用戶端可以在上傳檔案時，使用 SETSTAT 等命令來嘗試變更遠端檔案的屬性 (包括時間戳記和許可)。不過，這些命令與 Amazon S3 等物件儲存系統並不相容。由於這種不相容性，即使已成功上傳檔案，從這些用戶端上傳檔案也可能導致錯誤。

將值設為 ENABLE_NO_OP，讓 Transfer Family 伺服器忽略 SETSTAT 命令，然後在不需要對 SFTP 用戶端進行任何變更的情況下上傳檔案。雖然SetStatOptionENABLE_NO_OP設定會忽略錯誤，但會在 Amazon CloudWatch Logs 中產生日誌項目，因此您可以判斷用戶端何時SETSTAT撥打電話。

注意

如果要保留檔案的原始時間戳記，並使用 SETSTAT 修改其他檔案屬性，您可以將 Amazon EFS 用作採用 Transfer Family 的後端儲存。

類型：字串

有效值:DEFAULT | ENABLE_NO_OP

必要：否

TlsSessionResumptionMode

與使用 FTPS 通訊協定的 Transfer Family 伺服器搭配使用的屬性。TLS 工作階段恢復提供了一種機制，可在 FTPS 工作階段的控制和資料連線之間恢復或共用交涉的私密金鑰。TlsSessionResumptionMode 決定伺服器是否透過唯一的工作階段 ID 恢復最近交涉的工作階段。此屬性可在 CreateServer 和 UpdateServer 呼叫期間使用。如果未在 CreateServer 期間指定 TlsSessionResumptionMode 值，則預設會設定為 ENFORCED。

  • DISABLED：伺服器不會處理 TLS 工作階段恢復用戶端請求，但會為每個請求建立新的 TLS 工作階段。

  • ENABLED：伺服器處理並接受正在執行 TLS 工作階段恢復的用戶端。伺服器不會拒絕未執行 TLS 工作階段恢復用戶端處理的用戶端資料連線。

  • ENFORCED：伺服器處理並接受正在執行 TLS 工作階段恢復的用戶端。伺服器拒絕未執行 TLS 工作階段恢復用戶端處理的用戶端資料連線。先測試用戶端，再將值設定為 ENFORCED。

    注意

    並非所有 FTPS 用戶端都會執行 TLS 工作階段恢復。因此，如果選擇強制執行 TLS 工作階段恢復，您可以防止任何來自不執行通訊協定交涉之 FTPS 用戶端的連線。為了判斷是否可以使用 ENFORCED 值，您需要測試用戶端。

類型：字串

有效值:DISABLED | ENABLED | ENFORCED

必要：否

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：