ServiceBusSessionReceiverOptions interface

參考

套件:: @azure/service-bus

描述使用已啟用會話的佇列/訂用帳戶時，傳遞給 acceptSession 和 acceptNextSession 方法的選項。

Extends: OperationOptionsBase

屬性

identifier	設定名稱以識別會話接收者。這可用來將記錄和例外狀況相互關聯。如果未指定或空白，則會使用隨機唯一的。
maxAutoLockRenewalDurationInMs	用戶端會自動更新會話鎖定的持續時間上限，以毫秒為單位。預設值： `300000` (5 分鐘) 毫秒。若要停用自動鎖定更新，請將此設定為 `0` 。範例︰如果鎖定在 2 分鐘內到期，且您的處理時間為 8 分鐘... 將 maxAutoLockRenewalDurationInMs 設定為 10 分鐘，鎖定會自動更新大約 4 次， (相當於利用鎖定更新) ，讓會話鎖定 4 倍。
receiveMode	表示接收者的接收模式。在 receiveAndDelete 模式中，訊息會在收到時從服務匯流排中刪除。在 peekLock 模式中，接收者在佇列/訂用帳戶上指定的持續時間內，對訊息有鎖定。未在鎖定期間內結算的訊息會重新傳遞佇列/訂用帳戶上設定的最大傳遞計數多次，之後就會傳送至個別的寄不出的信件佇列。您可以在訊息上呼叫 complete () 、abandon () 、defer () 或 deadletter () 方法來解決訊息。如需 peekLock 和訊息結算如何運作的詳細資訊，請參閱： https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
skipConvertingDate	接收訊息時，是否要略過將訊息批註屬性或應用程式屬性的 Date 類型轉換成數位。根據預設，Date 類型的屬性會轉換成 UNIX epoch 編號，以取得相容性。
skipParsingBodyAsJson	在接收訊息時，停用用戶端在訊息本文上執行 JSON.parse () 的選項。如果訊息是以 AMQP 本文類型值或序列傳送，則不適用。當您偏好直接處理訊息本文中存在的位元組，而不是用戶端嘗試剖析它時，請使用此選項。

繼承的屬性

abortSignal	可用來中止要求的訊號。
tracingOptions	啟用追蹤時所使用的選項。

屬性詳細資料

identifier

設定名稱以識別會話接收者。這可用來將記錄和例外狀況相互關聯。如果未指定或空白，則會使用隨機唯一的。

identifier?: string

屬性值

string

maxAutoLockRenewalDurationInMs

用戶端會自動更新會話鎖定的持續時間上限，以毫秒為單位。

預設值： 300000 (5 分鐘) 毫秒。
若要停用自動鎖定更新，請將此設定為 0 。

範例︰

如果鎖定在 2 分鐘內到期，且您的處理時間為 8 分鐘...

將 maxAutoLockRenewalDurationInMs 設定為 10 分鐘，鎖定會自動更新大約 4 次， (相當於利用鎖定更新) ，讓會話鎖定 4 倍。

maxAutoLockRenewalDurationInMs?: number

屬性值

number

receiveMode

表示接收者的接收模式。

在 receiveAndDelete 模式中，訊息會在收到時從服務匯流排中刪除。

在 peekLock 模式中，接收者在佇列/訂用帳戶上指定的持續時間內，對訊息有鎖定。

未在鎖定期間內結算的訊息會重新傳遞佇列/訂用帳戶上設定的最大傳遞計數多次，之後就會傳送至個別的寄不出的信件佇列。

您可以在訊息上呼叫 complete () 、abandon () 、defer () 或 deadletter () 方法來解決訊息。

如需 peekLock 和訊息結算如何運作的詳細資訊，請參閱： https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

receiveMode?: "peekLock" | "receiveAndDelete"

屬性值

"peekLock" | "receiveAndDelete"

skipConvertingDate

接收訊息時，是否要略過將訊息批註屬性或應用程式屬性的 Date 類型轉換成數位。根據預設，Date 類型的屬性會轉換成 UNIX epoch 編號，以取得相容性。

skipConvertingDate?: boolean

屬性值

boolean

skipParsingBodyAsJson

在接收訊息時，停用用戶端在訊息本文上執行 JSON.parse () 的選項。如果訊息是以 AMQP 本文類型值或序列傳送，則不適用。當您偏好直接處理訊息本文中存在的位元組，而不是用戶端嘗試剖析它時，請使用此選項。

skipParsingBodyAsJson?: boolean

屬性值

boolean

繼承的屬性詳細資料

abortSignal

可用來中止要求的訊號。

abortSignal?: AbortSignalLike

屬性值

AbortSignalLike

繼承自 OperationOptionsBase.abortSignal

tracingOptions

啟用追蹤時所使用的選項。

tracingOptions?: OperationTracingOptions

屬性值

OperationTracingOptions

繼承自 OperationOptionsBase.tracingOptions

共用方式為