Magistrala usług
Połącz się z usługą Azure Service Bus, aby wysyłać i odbierać komunikaty. Możesz wykonywać czynności, takie jak wysyłanie do kolejki, wysyłanie do wątku, odbieranie z kolejki, odbieranie z subskrypcji itp.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC High) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC High) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC High) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL |
Obsługa usługi Microsoft LogicApps Pomoc techniczna usługi Microsoft Power Automate Obsługa usługi Microsoft Power Apps |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
| Witryna internetowa | https://azure.microsoft.com/services/service-bus/ |
Ogólne znane problemy i ograniczenia
Pętle nieskończone
Należy zachować ostrożność, wybierając zarówno wyzwalacz, jak i akcję, która ma ten sam typ łącznika, i używać ich do pracy z tą samą jednostką, taką jak kolejka lub subskrypcja tematu. Ta kombinacja może utworzyć nieskończoną pętlę, co skutkuje przepływem pracy, który nigdy się nie kończy.
Załóżmy na przykład, że przepływ pracy używa wyzwalacza usługi Service Bus, który zwraca nowo odebrany komunikat w kolejce i następuje po tym wyzwalaczu z akcją usługi Service Bus, która wysyła komunikat z powrotem do tej samej kolejki. Ten wzorzec może utworzyć pętlę nieskończoną, powodując niekończący się przepływ pracy.
Limit zapisanych sesji w pamięci podręcznej łącznika
Na jednostkę obsługi komunikatów usługi Service Bus, taką jak subskrypcja lub temat, łącznik usługi Service Bus może zaoszczędzić maksymalnie 1500 unikatowych sesji jednocześnie w pamięci podręcznej łącznika. Jeśli liczba sesji przekroczy ten limit, stare sesje zostaną usunięte z pamięci podręcznej. Aby uzyskać więcej informacji, zobacz Sesje komunikatów.
Wyzwalacze długiego sondowania
W przypadku łącznika zarządzanego usługi Azure Service Bus wszystkie wyzwalacze są długotrwałe sondowanie. Ten typ wyzwalacza przetwarza wszystkie komunikaty, a następnie czeka 30 sekund, aż więcej komunikatów pojawi się w subskrypcji kolejki lub tematu. Jeśli w ciągu 30 sekund nie pojawią się żadne komunikaty, przebieg wyzwalacza jest pomijany. W przeciwnym razie wyzwalacz kontynuuje odczytywanie komunikatów, dopóki kolejka lub subskrypcja tematu nie będzie pusta. Następny sonda wyzwalacza jest oparta na interwale cyklu określonym we właściwościach wyzwalacza.
Uwierzytelnianie za pomocą Microsoft Entra ID
Aby korzystać z uwierzytelniania identyfikatora Entra firmy Microsoft, konto użytkownika wymaga określonego przypisania roli. Aby uzyskać więcej informacji, zobacz Przypisywanie roli platformy Azure w celu uzyskania praw dostępu — Azure Service Bus.
Uwierzytelnianie tożsamości zarządzanej
Obecnie uwierzytelnianie tożsamości zarządzanej jest obsługiwane tylko w przypadku usługi Azure Logic Apps.
Aby użyć tożsamości zarządzanej, która uwierzytelnia dostęp z przepływu pracy aplikacji logiki do przestrzeni nazw i jednostki obsługi komunikatów usługi Service Bus, upewnij się, że przypisano uprawnienia roli na odpowiednich poziomach. Na przykład aby uzyskać dostęp do kolejki, tożsamość zarządzana wymaga roli, która ma niezbędne uprawnienia dla tej kolejki.
Każda tożsamość zarządzana, która uzyskuje dostęp do innej jednostki obsługi komunikatów, powinna mieć oddzielne połączenie z jednostką. Jeśli używasz różnych akcji usługi Azure Service Bus do wysyłania i odbierania komunikatów, a te akcje wymagają różnych uprawnień, upewnij się, że używasz różnych połączeń.
Aby włączyć tożsamość zarządzaną do użycia z usługą Azure Service Bus, wykonaj następujące ogólne kroki:
Włącz lub utwórz tożsamość zarządzaną dla zasobu aplikacji logiki. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie dostępu do zasobów platformy Azure za pomocą tożsamości zarządzanych w usłudze Azure Logic Apps.
Nadaj tożsamości dostęp do zasobów usługi Azure Service Bus. Aby uzyskać więcej informacji, zobacz Przypisywanie roli platformy Azure w celu uzyskania praw dostępu — Azure Service Bus
W przypadku tożsamości przypisanej przez użytkownika dodaj tożsamość do zasobu aplikacji logiki. Aby uzyskać więcej informacji na temat tożsamości zarządzanych w usłudze Azure Logic Apps, zobacz Uwierzytelnianie dostępu do zasobów platformy Azure przy użyciu tożsamości zarządzanych w usłudze Azure Logic Apps
Szczegółowe informacje o konektorze
W tym artykule opisano operacje łącznika zarządzanego usługi Azure Service Bus, który jest dostępny dla usług Azure Logic Apps, Power Automate i Power Apps. Wbudowany łącznik usługi Azure Service Bus jest dostępny tylko dla standardowych przepływów pracy aplikacji logiki w usłudze Azure Logic Apps.
Aby uzyskać więcej informacji na temat wbudowanego łącznika usługi Azure Service Bus i łącznika zarządzanego w usłudze Azure Logic Apps, zobacz Connect to Azure Service Bus from workflows in Azure Logic Apps (Nawiązywanie połączenia z usługą Azure Service Bus z przepływów pracy w usłudze Azure Logic Apps).
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Klucz dostępu | Podaj parametry połączenia, aby uzyskać dostęp do usługi Azure Service Bus. | Wszystkie regiony z wyjątkiem platformy Azure Government i Departamentu Obrony (DoD) w usługach Azure Government i US Government (GCC) i US Government (GCC-High) | Nie można udostępniać |
| Klucz dostępu (Azure Government) | Podaj parametry połączenia, aby uzyskać dostęp do usługi Azure Service Bus. | Platforma Azure Government i Departament Obrony (DoD) w usługach Azure Government i US Government (GCC) i US Government (GCC-High) | Nie można udostępniać |
| Uwierzytelnianie certyfikatu klienta | Podaj poświadczenia identyfikatora entra firmy Microsoft przy użyciu certyfikatu PFX i hasła | Wszystkie regiony | Udostępnialne |
| Tożsamość zarządzana usługi Logic Apps | Tworzenie połączenia przy użyciu tożsamości zarządzanej usługi LogicApps | Tylko USŁUGA LOGICAPPS | Udostępnialne |
| Microsoft Entra ID Integrated | Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do usługi Azure Service Bus. | Wszystkie regiony z wyjątkiem platformy Azure Government i Departamentu Obrony (DoD) w usługach Azure Government i US Government (GCC) i US Government (GCC-High) | Nie można udostępniać |
| Microsoft Entra ID Integrated (Azure Government) | Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do usługi Azure Service Bus. | Platforma Azure Government i Departament Obrony (DoD) w usługach Azure Government i US Government (GCC) i US Government (GCC-High) | Nie można udostępniać |
| Domyślne [PRZESTARZAŁE] | Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami. | Wszystkie regiony | Nie można udostępniać |
Klawisz dostępu
Identyfikator uwierzytelniania: connectionstringauth
Dotyczy: wszystkie regiony z wyjątkiem platformy Azure Government i Departamentu Obrony (DoD) w usługach Azure Government i US Government (GCC) i US Government (GCC-High)
Podaj parametry połączenia, aby uzyskać dostęp do usługi Azure Service Bus.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Ciąg połączenia | securestring | Ciąg połączenia z Azure Service Bus | Prawda |
Klucz dostępu (Azure Government)
Identyfikator uwierzytelniania: connectionstringauth
Dotyczy: Platforma Azure Government i Departament Obrony (DoD) w usługach Azure Government i US Government (GCC) i US Government (GCC-High)
Podaj parametry połączenia, aby uzyskać dostęp do usługi Azure Service Bus.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Ciąg połączenia | securestring | Ciąg połączenia z Azure Service Bus | Prawda |
Uwierzytelnianie certyfikatu klienta
Identyfikator uwierzytelniania: CertOauth
Dotyczy: wszystkie regiony
Podaj poświadczenia identyfikatora entra firmy Microsoft przy użyciu certyfikatu PFX i hasła
Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Tenant | ciąg | Prawda | |
| ID klienta | ciąg | Identyfikator klienta aplikacji Microsoft Entra ID | Prawda |
| Klucz tajny certyfikatu klienta | certyfikat klienta | Klucz tajny certyfikatu klienta dozwolony przez tę aplikację | Prawda |
| Punkt końcowy przestrzeni nazw | ciąg | Podaj punkt końcowy przestrzeni nazw usługi Service Bus (np. sb://testsb.servicebus.windows.net/) | Prawda |
Tożsamość zarządzana usługi Logic Apps
Identyfikator uwierzytelniania: managedIdentityAuth
Dotyczy: tylko USŁUGA LOGICAPPS
Tworzenie połączenia przy użyciu tożsamości zarządzanej usługi LogicApps
Jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power jest udostępniana innemu użytkownikowi, połączenie jest również udostępniane. Aby uzyskać więcej informacji, zobacz Omówienie łączników dla aplikacji kanwy — Power Apps | Microsoft Docs
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Tożsamość zarządzana usługi LogicApps | managedIdentity | Logowanie się przy użyciu tożsamości zarządzanej usługi Logic Apps | Prawda |
| Punkt końcowy przestrzeni nazw | ciąg | Podaj punkt końcowy przestrzeni nazw usługi Service Bus (np. sb://testsb.servicebus.windows.net/) | Prawda |
Microsoft Entra ID Zintegrowany
Identyfikator uwierzytelniania: aadAuth
Dotyczy: wszystkie regiony z wyjątkiem platformy Azure Government i Departamentu Obrony (DoD) w usługach Azure Government i US Government (GCC) i US Government (GCC-High)
Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do usługi Azure Service Bus.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Punkt końcowy przestrzeni nazw | ciąg | Podaj punkt końcowy przestrzeni nazw usługi Service Bus (np. sb://testsb.servicebus.windows.net/) | Prawda |
Microsoft Entra ID Integrated (Azure Government)
Identyfikator uwierzytelniania: aadAuth
Dotyczy: Platforma Azure Government i Departament Obrony (DoD) w usługach Azure Government i US Government (GCC) i US Government (GCC-High)
Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do usługi Azure Service Bus.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Punkt końcowy przestrzeni nazw | ciąg | Podaj punkt końcowy przestrzeni nazw usługi Service Bus (np. sb://testsb.servicebus.windows.net/) | Prawda |
Domyślne [PRZESTARZAŁE]
Dotyczy: wszystkie regiony
Ta opcja dotyczy tylko starszych połączeń bez jawnego typu uwierzytelniania i jest dostępna tylko w celu zapewnienia zgodności z poprzednimi wersjami.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Ciąg połączenia | securestring | Ciąg połączenia z Azure Service Bus | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 6000 | 60 sekund |
Akcje
| Odnawianie blokady komunikatu w kolejce |
Operacja odnawia blokadę komunikatu w kolejce. |
| Odnawianie blokady komunikatu w subskrypcji tematu |
Operacja odnawia blokadę komunikatu w subskrypcji tematu. |
| Odnawianie blokady sesji w subskrypcji tematu |
Operacja odnawia sesję w subskrypcji tematu. |
| Odnawianie blokady w sesji w kolejce |
Operacja odnawia sesję w kolejce. |
| Odroczenie komunikatu w kolejce |
Operacja odchyli komunikat w kolejce. |
| Odroczenie komunikatu w subskrypcji tematu |
Operacja odchyli komunikat w subskrypcji tematu. |
| Pobieranie komunikatu odroczonego z kolejki |
Operacja pobiera odroczony komunikat z kolejki. |
| Pobieranie komunikatu odroczonego z subskrypcji tematu |
Operacja pobiera odroczony komunikat z subskrypcji tematu. |
| Pobieranie komunikatów z kolejki (zobacz blokadę) |
Operacja odbiera komunikaty z kolejki z podglądem blokady. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów. |
| Pobieranie komunikatów z subskrypcji tematu (zobacz blokadę) |
Operacja odbiera komunikaty z subskrypcji tematu z podglądem blokady. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów. |
| Porzucanie komunikatu w kolejce |
Operacja porzuca komunikat w kolejce. |
| Porzucanie komunikatu w subskrypcji tematu |
Operacja porzuca komunikat w subskrypcji tematu. |
| Tworzenie subskrypcji tematu |
Operacja tworzy subskrypcję tematu. |
| Ukończ komunikat w subskrypcji tematu |
Operacja kończy komunikat w subskrypcji tematu. |
| Usuwanie subskrypcji tematu |
Operacja usuwa subskrypcję tematu. |
| Utracony komunikat w kolejce |
Operacja przenosi komunikat do kolejki Dead-Letter. |
| Utracony komunikat w subskrypcji tematu |
Operacja przenosi komunikat do tematu Dead-Letter Kolejka. |
| Uzupełnianie komunikatu w kolejce |
Operacja kończy komunikat w kolejce. |
| Wysyłanie co najmniej jednej wiadomości |
Ta operacja wysyła jeden lub więcej komunikatów do kolejki lub tematu. |
| Wyślij wiadomość |
Ta operacja wysyła komunikat do kolejki lub tematu. |
| Zamykanie sesji w kolejce |
Operacja zamyka sesję w kolejce. |
| Zamykanie sesji w temacie |
Operacja zamyka sesję w temacie. |
Odnawianie blokady komunikatu w kolejce
Operacja odnawia blokadę komunikatu w kolejce.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu komunikatu w celu odnowienia blokady |
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
Odnawianie blokady komunikatu w subskrypcji tematu
Operacja odnawia blokadę komunikatu w subskrypcji tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu komunikatu w celu odnowienia blokady |
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
Odnawianie blokady sesji w subskrypcji tematu
Operacja odnawia sesję w subskrypcji tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Identyfikator sesji
|
sessionId | True | string |
Identyfikator sesji |
Odnawianie blokady w sesji w kolejce
Operacja odnawia sesję w kolejce.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Identyfikator sesji
|
sessionId | True | string |
Identyfikator sesji |
Odroczenie komunikatu w kolejce
Operacja odchyli komunikat w kolejce.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu komunikatu w celu odroczenia |
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Odroczenie komunikatu w subskrypcji tematu
Operacja odchyli komunikat w subskrypcji tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu komunikatu w celu odroczenia |
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Pobieranie komunikatu odroczonego z kolejki
Operacja pobiera odroczony komunikat z kolejki.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Numer sekwencji komunikatu
|
sequenceNumber | True | integer |
Numer sekwencji komunikatu |
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Pobieranie komunikatu odroczonego z subskrypcji tematu
Operacja pobiera odroczony komunikat z subskrypcji tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Numer sekwencji komunikatu
|
sequenceNumber | True | integer |
Numer sekwencji komunikatu |
|
Typ subskrypcji
|
subscriptionType | string |
Typ kolejki — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Pobieranie komunikatów z kolejki (zobacz blokadę)
Operacja odbiera komunikaty z kolejki z podglądem blokady. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Maksymalna liczba komunikatów
|
maxMessageCount | integer |
Maksymalna liczba komunikatów zwracanych w partii |
|
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Zwraca
- response
- array of ServiceBusMessage
Pobieranie komunikatów z subskrypcji tematu (zobacz blokadę)
Operacja odbiera komunikaty z subskrypcji tematu z podglądem blokady. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Maksymalna liczba komunikatów
|
maxMessageCount | integer |
Maksymalna liczba komunikatów zwracanych w partii |
|
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Zwraca
- response
- array of ServiceBusMessage
Porzucanie komunikatu w kolejce
Operacja porzuca komunikat w kolejce.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu komunikatu w celu porzucenia |
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Porzucanie komunikatu w subskrypcji tematu
Operacja porzuca komunikat w subskrypcji tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu komunikatu w celu porzucenia |
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Tworzenie subskrypcji tematu
Operacja tworzy subskrypcję tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Filter
|
subscriptionFilter | True | dynamic |
Filtr subskrypcji |
|
Typ filtru
|
subscriptionFilterType | string |
Typ filtru |
Zwraca
Subskrypcja tematu.
- Body
- Subscription
Ukończ komunikat w subskrypcji tematu
Operacja kończy komunikat w subskrypcji tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu komunikatu do ukończenia |
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Usuwanie subskrypcji tematu
Operacja usuwa subskrypcję tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
Utracony komunikat w kolejce
Operacja przenosi komunikat do kolejki Dead-Letter.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu wiadomości w przypadku utraconych komunikatów |
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
|
|
Przyczyna utraconych listów
|
deadLetterReason | string |
Przyczyna utraconych listów |
|
|
Opis błędu utraconych komunikatów
|
deadLetterErrorDescription | string |
Opis błędu utraconych komunikatów |
Utracony komunikat w subskrypcji tematu
Operacja przenosi komunikat do tematu Dead-Letter Kolejka.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu wiadomości w przypadku utraconych komunikatów |
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
|
|
Przyczyna utraconych listów
|
deadLetterReason | string |
Przyczyna utraconych listów |
|
|
Opis błędu utraconych komunikatów
|
deadLetterErrorDescription | string |
Opis błędu utraconych komunikatów |
Uzupełnianie komunikatu w kolejce
Operacja kończy komunikat w kolejce.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Blokowanie tokenu komunikatu
|
lockToken | True | string |
Blokowanie tokenu komunikatu do ukończenia |
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji |
Wysyłanie co najmniej jednej wiadomości
Ta operacja wysyła jeden lub więcej komunikatów do kolejki lub tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki/tematu
|
entityName | True | string |
Nazwa kolejki lub tematu |
|
Content
|
ContentData | byte |
Zawartość wiadomości |
|
|
Typ zawartości
|
ContentType | string |
Typ zawartości wiadomości |
|
|
Właściwości
|
Properties | object |
Pary klucz-wartość dla każdej właściwości obsługiwanej przez brokera |
|
|
Identyfikator wiadomości
|
MessageId | string |
Jest to wartość zdefiniowana przez użytkownika, która usługa Service Bus może używać do identyfikowania zduplikowanych komunikatów, jeśli jest włączona. |
|
|
Do
|
To | string |
Wyślij na adres |
|
|
Odpowiedz na
|
ReplyTo | string |
Adres kolejki, na który ma odpowiadać |
|
|
Odpowiedz na identyfikator sesji
|
ReplyToSessionId | string |
Identyfikator sesji do odpowiadania na |
|
|
Etykieta
|
Label | string |
Etykieta specyficzna dla aplikacji |
|
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
Data i godzina w formacie UTC, kiedy komunikat zostanie dodany do kolejki |
|
|
Identyfikator sesji
|
SessionId | string |
Identyfikator sesji |
|
|
Identyfikator korelacji
|
CorrelationId | string |
Identyfikator korelacji |
|
|
Numer sekwencji
|
SequenceNumber | integer |
Identyfikator numeru sekwencji |
|
|
Blokowanie tokenu
|
LockToken | string |
Token blokady komunikatu jako ciąg. |
|
|
Czas wygaśnięcia
|
TimeToLive | integer |
Jest to czas trwania, w znacznikach, że komunikat jest prawidłowy. Czas trwania rozpoczyna się od momentu wysłania komunikatu do usługi Service Bus. |
|
|
Właściwości systemu
|
systemProperties | string |
Właściwości systemu — brak lub szczegóły uruchomienia. Szczegóły przebiegu doda szczegóły właściwości metadanych przebiegu jako właściwości niestandardowe w komunikacie. |
Wyślij wiadomość
Ta operacja wysyła komunikat do kolejki lub tematu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki/tematu
|
entityName | True | string |
Nazwa kolejki lub tematu |
|
Content
|
ContentData | byte |
Zawartość wiadomości |
|
|
Typ zawartości
|
ContentType | string |
Typ zawartości wiadomości |
|
|
Właściwości
|
Properties | object |
Pary klucz-wartość dla każdej właściwości obsługiwanej przez brokera |
|
|
Identyfikator wiadomości
|
MessageId | string |
Jest to wartość zdefiniowana przez użytkownika, która usługa Service Bus może używać do identyfikowania zduplikowanych komunikatów, jeśli jest włączona. |
|
|
Do
|
To | string |
Wyślij na adres |
|
|
Odpowiedz na
|
ReplyTo | string |
Adres kolejki, na który ma odpowiadać |
|
|
Odpowiedz na identyfikator sesji
|
ReplyToSessionId | string |
Identyfikator sesji do odpowiadania na |
|
|
Etykieta
|
Label | string |
Etykieta specyficzna dla aplikacji |
|
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
Data i godzina w formacie UTC, kiedy komunikat zostanie dodany do kolejki |
|
|
Identyfikator sesji
|
SessionId | string |
Identyfikator sesji |
|
|
Identyfikator korelacji
|
CorrelationId | string |
Identyfikator korelacji |
|
|
Numer sekwencji
|
SequenceNumber | integer |
Identyfikator numeru sekwencji |
|
|
Blokowanie tokenu
|
LockToken | string |
Token blokady komunikatu jako ciąg. |
|
|
Czas wygaśnięcia
|
TimeToLive | integer |
Jest to czas trwania, w znacznikach, że komunikat jest prawidłowy. Czas trwania rozpoczyna się od momentu wysłania komunikatu do usługi Service Bus. |
|
|
Właściwości systemu
|
systemProperties | string |
Właściwości systemu — brak lub szczegóły uruchomienia. Szczegóły przebiegu doda szczegóły właściwości metadanych przebiegu jako właściwości niestandardowe w komunikacie. |
Zamykanie sesji w kolejce
Operacja zamyka sesję w kolejce.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Identyfikator sesji
|
sessionId | True | string |
Identyfikator sesji |
Zamykanie sesji w temacie
Operacja zamyka sesję w temacie.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Identyfikator sesji
|
sessionId | True | string |
Identyfikator sesji |
Wyzwalacze
| Gdy co najmniej jeden komunikat dociera do kolejki (zobacz blokadę) |
Operacja odbiera jeden lub więcej komunikatów z kolejki z podglądem blokady. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów. |
| Gdy co najmniej jeden komunikat pojawi się w kolejce (autouzupełnij) |
Operacja odbiera jeden lub więcej komunikatów z kolejki. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów. |
| Gdy co najmniej jeden komunikat pojawi się w temacie (autouzupełnij) |
Operacja odbiera jeden lub więcej komunikatów z tematu. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów. |
| Gdy co najmniej jeden komunikat pojawi się w temacie (zobacz blokadę) |
Operacja odbiera jeden lub więcej komunikatów z tematu z podglądem blokady. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów. |
| Po odebraniu komunikatu w kolejce (autouzupełnieniu) |
Ta operacja wyzwala przepływ po odebraniu komunikatu w kolejce i automatycznym zakończeniu komunikatu. |
| Po odebraniu komunikatu w kolejce (zobacz blokadę) |
Operacja wyzwala przepływ, gdy komunikat odebrany w kolejce z trybem podglądu blokady. |
| Po odebraniu komunikatu w subskrypcji tematu (autouzupełnieniu) |
Ta operacja wyzwala przepływ po odebraniu komunikatu w subskrypcji tematu i automatycznie kończy komunikat. |
| Po odebraniu komunikatu w subskrypcji tematu (zobacz blokadę) |
Operacja wyzwala przepływ, gdy komunikat otrzymany w subskrypcji tematu z trybem podglądu blokady. |
Gdy co najmniej jeden komunikat dociera do kolejki (zobacz blokadę)
Operacja odbiera jeden lub więcej komunikatów z kolejki z podglądem blokady. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Maksymalna liczba komunikatów
|
maxMessageCount | integer |
Maksymalna liczba komunikatów zwracanych w partii |
|
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji — brak lub następny dostępny lub podaj identyfikator sesji |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Gdy co najmniej jeden komunikat pojawi się w kolejce (autouzupełnij)
Operacja odbiera jeden lub więcej komunikatów z kolejki. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Maksymalna liczba komunikatów
|
maxMessageCount | integer |
Maksymalna liczba komunikatów zwracanych w partii |
|
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Gdy co najmniej jeden komunikat pojawi się w temacie (autouzupełnij)
Operacja odbiera jeden lub więcej komunikatów z tematu. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Maksymalna liczba komunikatów
|
maxMessageCount | integer |
Maksymalna liczba komunikatów zwracanych w partii |
|
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Gdy co najmniej jeden komunikat pojawi się w temacie (zobacz blokadę)
Operacja odbiera jeden lub więcej komunikatów z tematu z podglądem blokady. Jeśli nie podano maksymalnej liczby komunikatów, odczytuje 20 komunikatów.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Maksymalna liczba komunikatów
|
maxMessageCount | integer |
Maksymalna liczba komunikatów zwracanych w partii |
|
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji — brak lub następny dostępny lub podaj identyfikator sesji |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Po odebraniu komunikatu w kolejce (autouzupełnieniu)
Ta operacja wyzwala przepływ po odebraniu komunikatu w kolejce i automatycznym zakończeniu komunikatu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Po odebraniu komunikatu w kolejce (zobacz blokadę)
Operacja wyzwala przepływ, gdy komunikat odebrany w kolejce z trybem podglądu blokady.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa kolejki
|
queueName | True | string |
Nazwa kolejki |
|
Typ kolejki
|
queueType | string |
Typ kolejki — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji — brak lub następny dostępny lub podaj identyfikator sesji |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Po odebraniu komunikatu w subskrypcji tematu (autouzupełnieniu)
Ta operacja wyzwala przepływ po odebraniu komunikatu w subskrypcji tematu i automatycznie kończy komunikat.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Po odebraniu komunikatu w subskrypcji tematu (zobacz blokadę)
Operacja wyzwala przepływ, gdy komunikat otrzymany w subskrypcji tematu z trybem podglądu blokady.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Nazwa tematu
|
topicName | True | string |
Nazwa tematu |
|
Nazwa subskrypcji tematu
|
subscriptionName | True | string |
Nazwa subskrypcji tematu |
|
Typ subskrypcji
|
subscriptionType | string |
Typ subskrypcji — Main lub DeadLetter |
|
|
Identyfikator sesji
|
sessionId | string |
Identyfikator sesji — brak lub następny dostępny lub podaj identyfikator sesji |
Zwraca
Komunikat usługi Service Bus
- Body
- ServiceBusMessage
Definicje
ServiceBusMessage
Komunikat usługi Service Bus
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Content
|
ContentData | byte |
Zawartość wiadomości |
|
Typ zawartości
|
ContentType | string |
Typ zawartości wiadomości |
|
Właściwości
|
Properties | object |
Pary klucz-wartość dla każdej właściwości obsługiwanej przez brokera |
|
Identyfikator wiadomości
|
MessageId | string |
Jest to wartość zdefiniowana przez użytkownika, która usługa Service Bus może używać do identyfikowania zduplikowanych komunikatów, jeśli jest włączona. |
|
Do
|
To | string |
Wyślij na adres |
|
Odpowiedz na
|
ReplyTo | string |
Adres kolejki, na który ma odpowiadać |
|
Odpowiedz na identyfikator sesji
|
ReplyToSessionId | string |
Identyfikator sesji do odpowiadania na |
|
Etykieta
|
Label | string |
Etykieta specyficzna dla aplikacji |
|
ScheduledEnqueueTimeUtc
|
ScheduledEnqueueTimeUtc | date-time |
Data i godzina w formacie UTC, kiedy komunikat zostanie dodany do kolejki |
|
Identyfikator sesji
|
SessionId | string |
Identyfikator sesji |
|
Identyfikator korelacji
|
CorrelationId | string |
Identyfikator korelacji |
|
Numer sekwencji
|
SequenceNumber | integer |
Identyfikator numeru sekwencji |
|
Blokowanie tokenu
|
LockToken | string |
Token blokady komunikatu jako ciąg. |
|
Czas wygaśnięcia
|
TimeToLive | integer |
Jest to czas trwania, w znacznikach, że komunikat jest prawidłowy. Czas trwania rozpoczyna się od momentu wysłania komunikatu do usługi Service Bus. |
Subscription
Subskrypcja tematu.
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Nazwa subskrypcji
|
SubscriptionName | string |
Nazwa subskrypcji. |