ServiceBusClient class
Een client die afzenderexemplaren kan maken voor het verzenden van berichten naar wachtrijen en onderwerpen, evenals ontvangersexemplaren om berichten van wachtrijen en abonnementen te ontvangen.
Constructors
Service |
Hiermee maakt u een exemplaar van de klasse ServiceBusClient die kan worden gebruikt om afzenders en ontvangers te maken voor de Azure Service Bus naamruimte die is opgegeven in de connection string. Er wordt geen verbinding met de service gemaakt totdat de afzenders/ontvangers die met de client zijn gemaakt, worden gebruikt om berichten te verzenden/ontvangen. |
Service |
Hiermee maakt u een exemplaar van de ServiceBusClient-klasse die kan worden gebruikt om afzenders en ontvangers te maken voor de Azure Service Bus opgegeven naamruimte. Er wordt geen verbinding met de service gemaakt totdat de afzenders/ontvangers die met de client zijn gemaakt, worden gebruikt om berichten te verzenden/ontvangen. |
Eigenschappen
fully |
De volledig gekwalificeerde naamruimte van het Service Bus-exemplaar waarvoor deze client is gemaakt. Dit is waarschijnlijk vergelijkbaar met .servicebus.windows.net. |
identifier | De naam die wordt gebruikt om deze ServiceBusClient te identificeren. Als dit niet is opgegeven of leeg is, wordt er een willekeurige unieke gegenereerd. |
Methoden
accept |
Hiermee maakt u een ontvanger voor de volgende beschikbare sessie in een Azure Service Bus wachtrij met sessiemogelijkheden. U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger. Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock |
accept |
Hiermee maakt u een ontvanger voor de volgende beschikbare sessie in een Azure Service Bus-abonnement waarvoor een sessie is ingeschakeld. U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger. Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock |
accept |
Hiermee maakt u een ontvanger voor een sessie die is ingeschakeld Azure Service Bus wachtrij. U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger. Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock |
accept |
Hiermee maakt u een ontvanger voor een sessie die is ingeschakeld Azure Service Bus abonnement. U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger. Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock |
close() | Hiermee wordt de onderliggende AMQP-verbinding gesloten. OPMERKING: hiermee wordt ook de verbinding verbroken van alle instanties van de ontvanger of afzender die op basis van dit exemplaar zijn gemaakt. |
create |
Hiermee maakt u een ontvanger voor een Azure Service Bus wachtrij. Er wordt geen verbinding gemaakt met de service totdat een van de methoden op de ontvanger wordt aangeroepen. Als u subwachtrijen wilt targeten, zoals de wachtrij met onbestelbare berichten of de wachtrij voor overdracht van onbestelbare berichten, geeft u de U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
Berichten die niet binnen de vergrendelingsduur zijn vereffend, worden net zo vaak opnieuw bezorgd als het maximale aantal bezorgingen dat is ingesteld voor de wachtrij, waarna ze naar een afzonderlijke wachtrij met onbestelbare berichten worden verzonden. U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger. Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock |
create |
Hiermee maakt u een ontvanger voor een Azure Service Bus-abonnement. Er wordt geen verbinding gemaakt met de service totdat een van de methoden op de ontvanger wordt aangeroepen. Als u subwachtrijen wilt targeten, zoals de wachtrij met onbestelbare berichten of de wachtrij voor overdracht van onbestelbare berichten, geeft u de U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
Berichten die niet binnen de vergrendelingsduur zijn vereffend, worden net zo vaak opnieuw bezorgd als het maximale aantal bezorgingen dat is ingesteld voor het abonnement, waarna ze naar een afzonderlijke wachtrij met onbestelbare berichten worden verzonden. U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger. Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock |
create |
Hiermee maakt u een exemplaar van ServiceBusRuleManager dat wordt gebruikt voor het beheren van de regels voor een abonnement. |
create |
Hiermee maakt u een afzender die kan worden gebruikt om berichten te verzenden, te plannen dat berichten op een later tijdstip worden verzonden en dergelijke geplande berichten te annuleren. Er wordt geen verbinding gemaakt met de service totdat een van de methoden op de afzender wordt aangeroepen. |
Constructordetails
ServiceBusClient(string, ServiceBusClientOptions)
Hiermee maakt u een exemplaar van de klasse ServiceBusClient die kan worden gebruikt om afzenders en ontvangers te maken voor de Azure Service Bus naamruimte die is opgegeven in de connection string. Er wordt geen verbinding met de service gemaakt totdat de afzenders/ontvangers die met de client zijn gemaakt, worden gebruikt om berichten te verzenden/ontvangen.
new ServiceBusClient(connectionString: string, options?: ServiceBusClientOptions)
Parameters
- connectionString
-
string
Een connection string voor Azure Service Bus naamruimte. OPMERKING: deze connection string kan een EntityPath bevatten, dat wordt genegeerd.
- options
- ServiceBusClientOptions
Opties voor de Service Bus-client.
ServiceBusClient(string, TokenCredential | NamedKeyCredential | SASCredential, ServiceBusClientOptions)
Hiermee maakt u een exemplaar van de ServiceBusClient-klasse die kan worden gebruikt om afzenders en ontvangers te maken voor de Azure Service Bus opgegeven naamruimte. Er wordt geen verbinding met de service gemaakt totdat de afzenders/ontvangers die met de client zijn gemaakt, worden gebruikt om berichten te verzenden/ontvangen.
new ServiceBusClient(fullyQualifiedNamespace: string, credential: TokenCredential | NamedKeyCredential | SASCredential, options?: ServiceBusClientOptions)
Parameters
- fullyQualifiedNamespace
-
string
De volledige naamruimte van uw Service Bus-exemplaar die waarschijnlijk vergelijkbaar is met .servicebus.windows.net.
- credential
Een referentieobject dat door de client wordt gebruikt om het token op te halen om de verbinding met de Azure Service Bus te verifiëren. Zie @azure/identity voor het maken van de referenties.
Als u een eigen implementatie van de TokenCredential
interface tegen AAD gebruikt, stelt u de 'bereiken' voor Service Bus in op ["https://servicebus.azure.net//user_impersonation"]
om het juiste token op te halen.
Gebruik de AzureNamedKeyCredential
from @azure/core-auth als u een SharedAccessKeyName
en SharedAccessKey
wilt doorgeven zonder een connection string te gebruiken. Deze velden worden respectievelijk toegewezen aan het name
veld en key
in AzureNamedKeyCredential
.
Gebruik de AzureSASCredential
van @azure/core-auth als u een SharedAccessSignature
wilt doorgeven zonder een connection string te gebruiken. Dit veld wordt toegewezen aan signature
in AzureSASCredential
.
- options
- ServiceBusClientOptions
Een reeks opties die moeten worden toegepast bij het configureren van de client.
retryOptions
: hiermee configureert u het beleid voor opnieuw proberen voor alle bewerkingen op de client. Bijvoorbeeld{ "maxRetries": 4 }
of{ "maxRetries": 4, "retryDelayInMs": 30000 }
.webSocketOptions
: hiermee configureert u de channeling van de AMQP-verbinding via Web Sockets.
Eigenschapdetails
fullyQualifiedNamespace
De volledig gekwalificeerde naamruimte van het Service Bus-exemplaar waarvoor deze client is gemaakt. Dit is waarschijnlijk vergelijkbaar met .servicebus.windows.net.
fullyQualifiedNamespace: string
Waarde van eigenschap
string
identifier
De naam die wordt gebruikt om deze ServiceBusClient te identificeren. Als dit niet is opgegeven of leeg is, wordt er een willekeurige unieke gegenereerd.
identifier: string
Waarde van eigenschap
string
Methodedetails
acceptNextSession(string, ServiceBusSessionReceiverOptions)
Hiermee maakt u een ontvanger voor de volgende beschikbare sessie in een Azure Service Bus wachtrij met sessiemogelijkheden.
U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
- In de peekLock-modus heeft de ontvanger een vergrendeling op het bericht voor de duur die is opgegeven in de wachtrij.
- In de receiveAndDelete-modus worden berichten verwijderd uit Service Bus zodra ze worden ontvangen.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger.
Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
function acceptNextSession(queueName: string, options?: ServiceBusSessionReceiverOptions): Promise<ServiceBusSessionReceiver>
Parameters
- queueName
-
string
De naam van de wachtrij waarvan u wilt ontvangen.
- options
- ServiceBusSessionReceiverOptions
Opties zijn onder andere receiveMode (standaard ingesteld op peekLock), opties om sessieontvanger te maken.
Retouren
Promise<ServiceBusSessionReceiver>
Een ontvanger die kan worden gebruikt om berichten te ontvangen, te bekijken en te vereffenen.
acceptNextSession(string, string, ServiceBusSessionReceiverOptions)
Hiermee maakt u een ontvanger voor de volgende beschikbare sessie in een Azure Service Bus-abonnement waarvoor een sessie is ingeschakeld.
U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
- In de peekLock-modus heeft de ontvanger een vergrendeling op het bericht voor de duur die is opgegeven in de wachtrij.
- In de receiveAndDelete-modus worden berichten verwijderd uit Service Bus zodra ze worden ontvangen.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger.
Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
function acceptNextSession(topicName: string, subscriptionName: string, options?: ServiceBusSessionReceiverOptions): Promise<ServiceBusSessionReceiver>
Parameters
- topicName
-
string
Naam van het onderwerp voor het abonnement waarvan we willen ontvangen.
- subscriptionName
-
string
Naam van het abonnement (onder de topic
) waarvan we willen ontvangen.
- options
- ServiceBusSessionReceiverOptions
Opties zijn onder andere receiveMode (standaard ingesteld op peekLock), opties om sessieontvanger te maken.
Retouren
Promise<ServiceBusSessionReceiver>
Een ontvanger die kan worden gebruikt om berichten te ontvangen, te bekijken en te vereffenen.
acceptSession(string, string, ServiceBusSessionReceiverOptions)
Hiermee maakt u een ontvanger voor een sessie die is ingeschakeld Azure Service Bus wachtrij.
U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
- In de peekLock-modus heeft de ontvanger een vergrendeling op het bericht voor de duur die is opgegeven in de wachtrij.
- In de receiveAndDelete-modus worden berichten verwijderd uit Service Bus zodra ze worden ontvangen.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger.
Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
function acceptSession(queueName: string, sessionId: string, options?: ServiceBusSessionReceiverOptions): Promise<ServiceBusSessionReceiver>
Parameters
- queueName
-
string
De naam van de wachtrij waarvan u wilt ontvangen.
- sessionId
-
string
De id van de sessie van waaruit berichten moeten worden ontvangen
- options
- ServiceBusSessionReceiverOptions
Opties zijn onder andere receiveMode (standaard ingesteld op peekLock), opties om sessieontvanger te maken.
Retouren
Promise<ServiceBusSessionReceiver>
Een ontvanger die kan worden gebruikt om berichten te ontvangen, te bekijken en te vereffenen.
acceptSession(string, string, string, ServiceBusSessionReceiverOptions)
Hiermee maakt u een ontvanger voor een sessie die is ingeschakeld Azure Service Bus abonnement.
U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
- In de peekLock-modus heeft de ontvanger een vergrendeling op het bericht voor de duur die is opgegeven in de wachtrij.
- In de receiveAndDelete-modus worden berichten verwijderd uit Service Bus zodra ze worden ontvangen.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger.
Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
function acceptSession(topicName: string, subscriptionName: string, sessionId: string, options?: ServiceBusSessionReceiverOptions): Promise<ServiceBusSessionReceiver>
Parameters
- topicName
-
string
Naam van het onderwerp voor het abonnement waarvan we willen ontvangen.
- subscriptionName
-
string
Naam van het abonnement (onder de topic
) waarvan we willen ontvangen.
- sessionId
-
string
De id van de sessie van waaruit berichten moeten worden ontvangen
- options
- ServiceBusSessionReceiverOptions
Opties zijn onder andere receiveMode (standaard ingesteld op peekLock), opties om sessieontvanger te maken.
Retouren
Promise<ServiceBusSessionReceiver>
Een ontvanger die kan worden gebruikt om berichten te ontvangen, te bekijken en te vereffenen.
close()
Hiermee wordt de onderliggende AMQP-verbinding gesloten. OPMERKING: hiermee wordt ook de verbinding verbroken van alle instanties van de ontvanger of afzender die op basis van dit exemplaar zijn gemaakt.
function close(): Promise<void>
Retouren
Promise<void>
createReceiver(string, ServiceBusReceiverOptions)
Hiermee maakt u een ontvanger voor een Azure Service Bus wachtrij. Er wordt geen verbinding gemaakt met de service totdat een van de methoden op de ontvanger wordt aangeroepen.
Als u subwachtrijen wilt targeten, zoals de wachtrij met onbestelbare berichten of de wachtrij voor overdracht van onbestelbare berichten, geeft u de subQueue
op in de opties. Zie voor meer informatie over wachtrijen voor onbestelbare berichten https://docs.microsoft.com/azure/service-bus-messaging/service-bus-dead-letter-queues
U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
- In de peekLock-modus heeft de ontvanger een vergrendeling op het bericht voor de duur die is opgegeven in de wachtrij.
- In de receiveAndDelete-modus worden berichten verwijderd uit Service Bus zodra ze worden ontvangen.
Berichten die niet binnen de vergrendelingsduur zijn vereffend, worden net zo vaak opnieuw bezorgd als het maximale aantal bezorgingen dat is ingesteld voor de wachtrij, waarna ze naar een afzonderlijke wachtrij met onbestelbare berichten worden verzonden.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger.
Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
function createReceiver(queueName: string, options?: ServiceBusReceiverOptions): ServiceBusReceiver
Parameters
- queueName
-
string
De naam van de wachtrij waarvan u wilt ontvangen.
- options
- ServiceBusReceiverOptions
Opties voor het doorgeven van de receiveMode, standaard ingesteld op peekLock.
Retouren
Een ontvanger die kan worden gebruikt om berichten te ontvangen, te bekijken en te vereffenen.
createReceiver(string, string, ServiceBusReceiverOptions)
Hiermee maakt u een ontvanger voor een Azure Service Bus-abonnement. Er wordt geen verbinding gemaakt met de service totdat een van de methoden op de ontvanger wordt aangeroepen.
Als u subwachtrijen wilt targeten, zoals de wachtrij met onbestelbare berichten of de wachtrij voor overdracht van onbestelbare berichten, geeft u de subQueue
op in de opties. Zie voor meer informatie over wachtrijen voor onbestelbare berichten https://docs.microsoft.com/azure/service-bus-messaging/service-bus-dead-letter-queues
U kunt kiezen tussen twee ontvangstmodi: 'peekLock' (standaard) en 'receiveAndDelete'.
- In de peekLock-modus heeft de ontvanger een vergrendeling op het bericht voor de duur die is opgegeven in de wachtrij.
- In de receiveAndDelete-modus worden berichten verwijderd uit Service Bus zodra ze worden ontvangen.
Berichten die niet binnen de vergrendelingsduur zijn vereffend, worden net zo vaak opnieuw bezorgd als het maximale aantal bezorgingen dat is ingesteld voor het abonnement, waarna ze naar een afzonderlijke wachtrij met onbestelbare berichten worden verzonden.
U kunt een bericht vereffenen door de methoden completeMessage(), abandonMessage(), deferMessage() of deadletterMessage() aan te roepen op de ontvanger.
Meer informatie over de werking van peekLock en berichtafhandeling vindt u hier: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
function createReceiver(topicName: string, subscriptionName: string, options?: ServiceBusReceiverOptions): ServiceBusReceiver
Parameters
- topicName
-
string
Naam van het onderwerp voor het abonnement waarvan we willen ontvangen.
- subscriptionName
-
string
Naam van het abonnement (onder de topic
) waarvan we willen ontvangen.
- options
- ServiceBusReceiverOptions
Opties voor het doorgeven van de receiveMode, standaard ingesteld op peekLock.
Retouren
Een ontvanger die kan worden gebruikt om berichten te ontvangen, te bekijken en te vereffenen.
createRuleManager(string, string)
Hiermee maakt u een exemplaar van ServiceBusRuleManager dat wordt gebruikt voor het beheren van de regels voor een abonnement.
function createRuleManager(topicName: string, subscriptionName: string): ServiceBusRuleManager
Parameters
- topicName
-
string
het onderwerp voor het maken van ServiceBusRuleManager
- subscriptionName
-
string
het abonnement dat specifiek is voor het opgegeven onderwerp waarvoor u een ServiceBusRuleManager wilt maken.
Retouren
een ServiceBusRuleManager die is afgestemd op het opgegeven abonnement en onderwerp.
createSender(string, ServiceBusSenderOptions)
Hiermee maakt u een afzender die kan worden gebruikt om berichten te verzenden, te plannen dat berichten op een later tijdstip worden verzonden en dergelijke geplande berichten te annuleren. Er wordt geen verbinding gemaakt met de service totdat een van de methoden op de afzender wordt aangeroepen.
function createSender(queueOrTopicName: string, options?: ServiceBusSenderOptions): ServiceBusSender
Parameters
- queueOrTopicName
-
string
De naam van een wachtrij of onderwerp waar berichten naartoe moeten worden verzonden.
- options
- ServiceBusSenderOptions