HTTP 端點 (httpEndpoint)
HTTP 端點的配置內容。
屬性名稱 | 資料類型 | 預設值 | 說明 |
---|---|---|---|
accessLoggingRef | 最上層 httpAccessLogging 元素的參照(字串)。 | 端點的 HTTP 存取記載配置。 | |
enabled | boolean | true | 切換此端點的可用性。如果是 true,分派器便會啟動這個端點來處理 HTTP 要求。 |
host | string | localhost | 用戶端用來要求資源的 IP 位址、含網域名稱字尾的網域名稱伺服器 (DNS) 主機名稱,或只是 DNS 主機名稱。使用 '*' 來代表所有可用網路介面。 |
httpOptionsRef | 最上層 httpOptions 元素的參照(字串)。 | defaultHttpOptions | 端點的 HTTP 通訊協定選項。 |
httpPort | int
下限:-1 上限:65535 |
用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 | |
httpsPort | int
下限:-1 上限:65535 |
受到 SSL (https) 保護的用戶端 HTTP 要求所用的埠。使用 -1 可停用此埠。 | |
id | string | 唯一的配置 ID。 | |
onError |
|
WARN | 無法啟動端點之後要採取的動作。
|
sslOptionsRef | 最上層 sslOptions 元素的參照(字串)。 | 端點的 SSL 通訊協定選項。 | |
tcpOptionsRef | 最上層 tcpOptions 元素的參照(字串)。 | defaultTCPOptions | 端點的 TCP 通訊協定選項。 |
- accessLogging
說明: 端點的 HTTP 存取記載配置。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 enabled boolean true 啟用存取記載。 filePath 檔案的路徑 ${server.output.dir}/logs/http_access.log 存取日誌檔的目錄路徑和名稱。指定目錄路徑時,可以使用標準變數替代項目,例如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定記載用戶端存取資訊時要使用的日誌格式。 maxFileSize int 下限:0
20 日誌檔在輪替之前的大小上限 (MB);0 值表示無限制。 maxFiles int 下限:0
2 在移除最舊檔案之前,將保留的日誌檔數目上限;0 值表示無限制。
- httpOptions
說明: 端點的 HTTP 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 keepAliveEnabled boolean true 啟用持續性連線(HTTP 保持作用中)。如果是 true,連線會保持作用中,供多個循序要求和回應重複使用。如果是 false,則會送出回應之後關閉連線。 maxKeepAliveRequests int 下限:-1
100 啟用持續性連線時,單一 HTTP 連線所允許的持續性要求數目上限。值 -1 表示無限制。 persistTimeout 精準度是秒鐘的時間量 30s 允許 Socket 在要求之間保持閒置的時間量。只有在啟用持續性連線時,這項設定才適用。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 readTimeout 精準度是秒鐘的時間量 60s 在進行第一次讀取之後,在 Socket 上等待讀取要求完成的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 removeServerHeader boolean false 將伺服器實作資訊從 HTTP 標頭移除,同時停用預設的 Liberty 設定檔歡迎使用頁面。 writeTimeout 精準度是秒鐘的時間量 60s 在 Socket 上等待傳輸每部分回應資料的時間量。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。
- sslOptions
說明: 端點的 SSL 通訊協定選項。必要: false資料類型: 屬性名稱 資料類型 預設值 說明 sessionTimeout 精準度是秒鐘的時間量 1d 在 Socket 上等待讀取或寫入要求完成的時間量。特定通訊協定專用的逾時值會置換此值。. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m) 或秒 (s)。例如,指定 30 秒為 30s。您可以在單一項目中包括多個值。例如,1m30s 相等於 90 秒。 sslRef 最上層 ssl 元素的參照(字串)。 預設 SSL 配置儲存庫。預設值是 defaultSSLSettings。 sslSessionTimeout 精準度是毫秒的時間量 8640ms %ssl.sslSessionTimeout.desc. 指定正整數加上時間單位,時間單位可以是小時 (h)、分鐘 (m)、秒 (s) 或毫秒 (ms)。例如,指定 500 毫秒為 500ms。您可以在單一項目中包括多個值。例如,1s500ms 相等於 1.5 秒。 suppressHandshakeErrors boolean false 停用 SSL 信號交換記載錯誤。在正常作業期間可能會發生 SSL 信號交換錯誤,不過當 SSL 的行為並非所預期時,這些訊息可能會非常有用。