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） 的詳細資訊，請參閱設定防火牆後方的FTPS伺服器或NAT搭配 AWS Transfer Family。

特殊值

AUTO 和 0.0.0.0 是 PassiveIp 參數的特殊值。根據預設，該值PassiveIp=AUTO會指派給 FTP並FTPS輸入伺服器。在此情況下，伺服器會自動回應回應回應IPs中的其中一個端點PASV。 PassiveIp=0.0.0.0 具有更唯一的應用程式來使用它。例如，如果您有高可用性 （HA） Network Load Balancer （NLB） 環境，其中有 3 個子網路，您只能使用 PassiveIp 參數指定單一 IP 地址。這會降低高可用性的有效性。在此情況下，您可以指定 PassiveIp=0.0.0.0。這會告訴用戶端使用與 Control 連線相同的 IP 地址，並將所有 AZs 用於其連線。不過請注意，並非所有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

必要：否

另請參閱

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