ServiceBusReceiverOptions interface

パッケージ:

@azure/service-bus

レシーバーの作成時に使用するオプション。

プロパティ

identifier	受信者を識別する名前を設定します。 これを使用して、ログと例外を関連付けることができます。 指定しない場合、または空の場合は、ランダムに一意のものが使用されます。
maxAutoLockRenewalDurationInMs	メッセージのロックがクライアントによって自動的に更新される最大期間 (ミリ秒単位)。 この自動更新は、メッセージが解決されると停止します。 既定の: 300 * 1000 ミリ秒 (5 分)。 自動更新を無効にするには、これを [0] に設定します。 例: メッセージ ロックの有効期限が 2 分で、メッセージの処理時間が 8 分の場合... maxAutoLockRenewalDurationInMs を 10 分に設定すると、メッセージ ロックは 4 回自動的に更新されます (ロックの更新を利用して、メッセージをロック期間の 4 倍に制限することと同じです)。
receiveMode	受信側の受信モードを表します。 receiveAndDelete モードでは、メッセージは受信時に Service Bus から削除されます。 peekLock モードでは、受信者はキュー/サブスクリプションで指定された期間、メッセージをロックします。 ロック期間内に解決されないメッセージは、キュー/サブスクリプションに設定された最大配信数の数と同じ回数再配信され、その後、別の配信不能キューに送信されます。 メッセージに対して complete()、abandon()、defer()、または deadletter() メソッドを呼び出すことで、メッセージを解決できます。 peekLock とメッセージ決済のしくみの詳細については、こちらを参照してください:https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
skipConvertingDate	メッセージの受信時に、メッセージ注釈またはアプリケーション プロパティのプロパティの Date 型を数値に変換することをスキップするかどうか。 既定では、Date 型のプロパティは互換性のために UNIX エポック番号に変換されます。
skipParsingBodyAsJson	メッセージを受信するときに、クライアントがメッセージ本文で JSON.parse() を実行できないようにするオプション。 メッセージが AMQP 本文の種類の値またはシーケンスで送信された場合は適用されません。 このオプションは、クライアントが解析を試みるよりも、メッセージ本文に存在するバイトを直接操作する場合に使用します。
subQueueType	任意のキューまたはサブスクリプションに適用できるサブ キューを表します。 有効な値は "deadLetter" と "transferDeadLetter" です。 配信不能キューの詳細については、https://docs.microsoft.com/azure/service-bus-messaging/service-bus-dead-letter-queues を参照してください。

プロパティの詳細

identifier

受信者を識別する名前を設定します。 これを使用して、ログと例外を関連付けることができます。 指定しない場合、または空の場合は、ランダムに一意のものが使用されます。

identifier?: string

プロパティ値

string

maxAutoLockRenewalDurationInMs

メッセージのロックがクライアントによって自動的に更新される最大期間 (ミリ秒単位)。 この自動更新は、メッセージが解決されると停止します。

• 既定の: 300 * 1000 ミリ秒 (5 分)。
• 自動更新を無効にするには、これを [0] に設定します。

例:

メッセージ ロックの有効期限が 2 分で、メッセージの処理時間が 8 分の場合...

maxAutoLockRenewalDurationInMs を 10 分に設定すると、メッセージ ロックは 4 回自動的に更新されます (ロックの更新を利用して、メッセージをロック期間の 4 倍に制限することと同じです)。

maxAutoLockRenewalDurationInMs?: number

プロパティ値

number

receiveMode

受信側の受信モードを表します。

receiveAndDelete モードでは、メッセージは受信時に Service Bus から削除されます。

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 エポック番号に変換されます。

skipConvertingDate?: boolean

プロパティ値

boolean

skipParsingBodyAsJson

メッセージを受信するときに、クライアントがメッセージ本文で JSON.parse() を実行できないようにするオプション。 メッセージが AMQP 本文の種類の値またはシーケンスで送信された場合は適用されません。 このオプションは、クライアントが解析を試みるよりも、メッセージ本文に存在するバイトを直接操作する場合に使用します。

skipParsingBodyAsJson?: boolean

プロパティ値

boolean

subQueueType

任意のキューまたはサブスクリプションに適用できるサブ キューを表します。 有効な値は "deadLetter" と "transferDeadLetter" です。 配信不能キューの詳細については、https://docs.microsoft.com/azure/service-bus-messaging/service-bus-dead-letter-queues を参照してください。

subQueueType?: "deadLetter" | "transferDeadLetter"

プロパティ値

"deadLetter" | "transferDeadLetter"