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