Hosts - Put

服務:

BizTalk Server 2020

API 版本:

v1

更新主機實例設定

PUT http://localhost/BizTalkManagementService/Hosts/Settings/{hostName}

URI 參數

名稱	位於	必要	類型	Description
hostName	path	True	string	主機的名稱

要求本文

Media Types: "application/json", "text/json", "application/xml", "text/xml", "application/x-www-form-urlencoded"

名稱	類型	Description
GeneralSettings	GeneralSettings	一般設定
MessageProcessThrottlingSettings	MessageProcessThrottlingSettings	訊息進程節流設定
OrchestrationThrottlingSettings	OrchestrationThrottlingSettings	協調流程節流設定
ResourceBasedThrottlingSettings	ResourceBasedThrottlingSettings	以資源為基礎的節流設定

回應

名稱	類型	Description
204 No Content		無內容

定義

名稱	Description
GeneralSettings	一般取得
HostSettings	主機設定
MessageProcessThrottlingSettings	訊息進程節流設定
OrchestrationThrottlingSettings	協調流程節流設定
ResourceBasedThrottlingSettings	以資源為基礎的節流設定

GeneralSettings

一般取得

名稱	類型	Description
AllowMultipleResponses	boolean	此屬性允許將多個回應傳送回 2 向 RL（僅隔離主機）。
AuthTrusted	boolean	這個屬性指出是否信任 BizTalk 主機來收集驗證資訊。
DecryptCertComment	string	這是一個批注欄位，可讓某些易記名稱與解密憑證產生關聯。
DecryptCertThumbprint	string	解密憑證的指紋。
HostTracking	boolean	這個 BizTalk 主機的實例是否會裝載追蹤子服務
IsHost32BitOnly	boolean	這個屬性指出主機實例進程是否應該在32位和64位伺服器上建立為32位。
LegacyWhitespace	boolean	此屬性會開啟或關閉對應來保留空格符。
MessagingMaxReceiveInterval	integer	以毫秒為單位的傳訊輪詢間隔
MessagingReqRespTTL	integer	要求回應消息的預設逾時。
MsgAgentPerfCounterServiceClassID	string	顯示性能計數器的服務。
ThreadPoolSize	integer	每個 CPU 的訊息引擎線程數目上限。
UseDefaultAppDomainForIsolatedAdapter	boolean	這個屬性會控制隔離配接器是在預設應用程式域還是呼叫端的網域中執行。
XlangMaxReceiveInterval	integer	輪詢間隔 i 毫秒的協調流程在此主機中執行。

HostSettings

主機設定

名稱	類型	Description
GeneralSettings	GeneralSettings	一般設定
MessageProcessThrottlingSettings	MessageProcessThrottlingSettings	訊息進程節流設定
OrchestrationThrottlingSettings	OrchestrationThrottlingSettings	協調流程節流設定
ResourceBasedThrottlingSettings	ResourceBasedThrottlingSettings	以資源為基礎的節流設定

MessageProcessThrottlingSettings

訊息進程節流設定

名稱	類型	Description
MessageDeliveryMaximumDelay	integer	郵件傳遞節流所加的延遲上限（以毫秒為單位）。 零表示停用訊息傳遞節流。
MessageDeliveryOverdriveFactor	integer	系統將過度驅動訊息傳遞節流輸入速率的百分比因素。
MessageDeliverySampleSpaceSize	integer
MessageDeliverySampleSpaceWindow	integer	逾時範圍（以毫秒為單位），在此時間範圍以外，樣本將被視為無效的考慮。
MessagePublishMaximumDelay	integer	訊息發佈節流施加的最大延遲（以毫秒為單位）。 零表示停用訊息發佈節流。
MessagePublishOverdriveFactor	integer	系統將過度驅動輸入速率的百分比因素。
MessagePublishSampleSpaceSize	integer	用來判斷服務類別所發佈訊息速率的範例數目。
MessagePublishSampleSpaceWindow	integer	逾時範圍（以毫秒為單位），在此時間範圍以外，樣本將被視為無效的考慮。
ThrottlingDeliveryOverride	integer	這個屬性會增加/減少輸出節流條件的嚴重性。
ThrottlingDeliveryOverrideSeverity	integer	這個屬性會增加/減少輸出節流條件的嚴重性。
ThrottlingPublishOverride	integer	這個屬性會增加/減少輸入節流條件的嚴重性。
ThrottlingPublishOverrideSeverity	integer	這個屬性會增加/減少輸出節流條件的嚴重性。

OrchestrationThrottlingSettings

協調流程節流設定

名稱	類型	Description
DehydrationBehavior	integer	Orhestration（XLANG） 引擎的脫水行為。 只有在選取 [自定義] 時，其他 xlang 設定才應該可編輯。 ValueMap {“0”， “1”， “2”}， 值 {“Always”， “Never”， “Custom”}]
SubscriptionPauseAt	integer	如果有任何訂用帳戶 >= PauseAt 訊息等候取用，則停止將訊息傳遞至訂用帳戶實例。
SubscriptionResumeAt	integer	如果因 PauseAt 設定而暫停任何訂用帳戶，且沒有未完成的訊息已關閉至 ResumeAt 值，則消息框將會繼續將訊息提供給訂用帳戶。
TimeBasedMaxThreshold	integer	協調流程實例的等候時間上限 （秒） 可以在脫水之前封鎖。
TimeBasedMinThreshold	integer	協調流程實例的Min waittime（sec） 可以在脫水之前封鎖。

ResourceBasedThrottlingSettings

以資源為基礎的節流設定

名稱	類型	Description
DBQueueSizeThreshold	integer	Database 中的項目數目上限。
DBSessionThreshold	integer	節流開始前允許的資料庫會話數目上限（每個CPU）。
DeliveryQueueSize	integer	主機維護的記憶體內部佇列大小，做為傳遞訊息的暫存佔位元。
GlobalMemoryThreshold	integer	在節流開始之前，允許的全系統虛擬記憶體使用量上限（以百分比為單位）。
InflightMessageThreshold	integer	節流訊息傳遞開始前允許的記憶體內部訊息數目上限。
ProcessMemoryThreshold	integer	節流開始之前允許的最大進程記憶體（以百分比為單位）。
ThreadThreshold	integer	在節流開始之前，進程中允許的線程數目上限（每個 CPU）。
ThrottlingBatchMemoryThresholdPercent	integer	這個屬性會控制記憶體閾值，以節流發佈一批訊息。 批次記憶體閾值的計算方式是將這個百分比因素乘以進程記憶體使用量閾值。 如果估計執行發行批次的記憶體超過批次記憶體閾值，批次將受限於處理以記憶體為基礎的節流。 否則，即使進程記憶體總計超過進程記憶體使用量閾值，批次仍會豁免進程記憶體型節流。 值為零表示，即使估計執行批次的記憶體最少，所有發佈批次都可能受限於處理記憶體型節流。
ThrottlingLimitToTriggerGC	integer	當進程記憶體耗用量增加並接近閾值時，這個屬性會控制何時觸發 .NET 垃圾收集 （GC）。 當記憶體耗用量超過記憶體閾值的這個百分比值時，就會觸發 GC。
ThrottlingSeverityDatabaseSize	integer	此屬性會控制資料庫大小觸發節流條件的嚴重性。 這會以百分比值指定，此參數會設定超過資料庫臨界值中訊息計數時所造成節流條件的嚴重性。
ThrottlingSeverityInflightMessage	integer	當進程內大小超過臨界值時，這個屬性會控制節流的反應時間。 這會以百分比值指定，此參數會設定超過每個CPU閾值時所造成節流條件的嚴重性。
ThrottlingSeverityProcessMemory	integer	此屬性會控制進程記憶體觸發節流條件的嚴重性。 這會以百分比值指定，而且此參數會設定超過進程記憶體使用量閾值時所造成節流條件的嚴重性。
ThrottlingSpoolMultiplier	integer	這個屬性會指定資料庫臨界值中訊息計數會相乘的因數，然後與多任務緩衝處理數據表中的目前記錄計數進行比較，以判斷系統是否應該在多任務緩衝處理數據表大小上進行節流。 如果設定為 0，多任務緩衝處理數據表大小不會作為判斷節流條件的考慮。 最大值 1000
ThrottlingTrackingDataMultiplier	integer	這個屬性會指定資料庫臨界值中訊息計數會相乘的因數，然後與追蹤數據表中的目前記錄計數進行比較，以判斷系統是否應該對追蹤數據表大小進行節流。 如果設定為 0，則不會將追蹤資料表大小作為判斷節流條件的考慮。