Kolejki Azure

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
Logic Apps	Standard	Wszystkie regiony usługi Logic Apps
Power Apps	Premium	Wszystkie regiony usługi Power Apps
Power Automate	Premium	Wszystkie regiony usługi Power Automate

Metadane łącznika
Publisher	Microsoft
Witryna internetowa	https://azure.microsoft.com/services/storage/queues/

Aby korzystać z tej integracji, musisz mieć dostęp do konta usługi Azure Storage. Więcej informacji można znaleźć tutaj. Podczas próby nawiązania połączenia zostanie wyświetlony monit o podanie nazwy konta magazynu i klucza magazynu. Nazwę konta magazynu można znaleźć w adresie URL, na przykład jeśli adres URL to https://myaccount.queue.core.windows.net nazwa konta to "myaccount". Jeśli masz wiele kont, podaj te, których chcesz użyć, i wybierz pozycję Utwórz. Jeśli podczas tworzenia zostanie wyświetlony błąd, sprawdź nazwę konta i klucz i spróbuj ponownie. Teraz możesz rozpocząć korzystanie z tej integracji.

Znane problemy i ograniczenia

1. Aplikacje logiki nie mogą bezpośrednio uzyskiwać dostępu do kont magazynu, które znajdują się za zaporami, jeśli znajdują się w tym samym regionie. Aby obejść ten problem, możesz mieć swoje aplikacje logiki i konto magazynu w różnych regionach. Aby uzyskać więcej informacji na temat włączania dostępu z usługi Azure Logic Apps do kont magazynu za zaporami, zobacz Access storage accounts behind firewalls (Uzyskiwanie dostępu do kont magazynu za zaporami)

Uwierzytelnianie identyfikatora entra firmy Microsoft i łącznik usługi Azure Queues

Aby można było używać uwierzytelniania identyfikatora Entra firmy Microsoft, używane konto musi mieć przypisane określone przypisanie roli, aby uzyskać więcej informacji, odwiedź stronę Przypisywanie roli platformy Azure w celu uzyskania dostępu do danych obiektów blob — Azure Storage:

> Only roles explicitly defined for data access permit a security principal to access blob or queue data. Built-in roles such as Owner, Contributor, and Storage Account Contributor permit a security principal to manage a storage account, but do not provide access to the blob or queue data within that account via Microsoft Entra ID.

Oto szybki test umożliwiający sprawdzenie, czy konto ma wymaganą rolę do wykonywania operacji w kontenerze: 1. Zaloguj się przy użyciu tego konta w witrynie Azure Portal. 2. Przejdź do kolejki na koncie magazynu i zostanie użyty, a następnie kliknij Switch to Microsoft Entra ID User Account metodę uwierzytelniania. Ta opcja jest wyświetlana tylko w górnej części pola wyszukiwania.

Jeśli zostanie wyświetlony komunikat bez autoryzacji, użytkownik musi mieć przypisane uprawnienia specyficzne dla konta magazynu. W tym celu menedżer kont magazynu powinien: 1. Przejdź do karty kolejki Access Control (IAM) . 2. Add Kliknij pozycję 3. Kliknij pozycję Add role assignment 4. Przypisywanie określonej Storage Queue roli do użytkownika (na przykład Storage Queue Data Contributor)

Znane ograniczenia dotyczące uwierzytelniania identyfikatora Entra firmy Microsoft

Ze względu na bieżące ograniczenia potoku uwierzytelniania użytkownicy-goście identyfikatora Entra firmy Microsoft nie są obsługiwani w przypadku połączeń microsoft Entra ID z kolejkami platformy Azure. W przypadku korzystania z uwierzytelniania identyfikatora Entra firmy Microsoft obsługiwane są tylko akcje v2. Przestarzałe akcje będą nadal działać z Access Key uwierzytelnianiem, ale w przypadku użycia z połączeniem Microsoft Entra ID zakończy się niepowodzeniem.

Nawiązywanie połączenia z łącznikiem usługi Azure Queues przy użyciu punktu końcowego kolejki

Wprowadź pełny punkt końcowy kolejki usługi Azure Storage podczas tworzenia połączenia "Klucz dostępu" lub przy użyciu operacji w wersji 2.

• W przypadku uwierzytelniania "Klucz dostępu" wprowadź pełny punkt końcowy kolejki usługi Azure Storage w parametrze Azure Storage account name or queue endpoint .

  • W przypadku korzystania z operacji "V2" z uwierzytelnianiem "Klucz dostępu" punkt końcowy kolejki musi być również podany w parametrze storageAccountName .

• W przypadku operacji "V2" wprowadź pełny punkt końcowy kolejki usługi Azure Storage w parametrze storageAccountName .

• Musisz podać pełny punkt końcowy, w tym schemat, na przykład:

  • https://account.queue.core.windows.net/
  • https://account-secondary.queue.core.windows.net/ (w przypadku nawiązywania połączenia z pomocniczym punktem końcowym)
  • Ścieżki względne (na przykład account.queue.core.windows.net) zostaną odrzucone.

Pobieranie punktu końcowego kolejki usługi Azure Storage dla danego konta magazynu

Istnieje wiele sposobów uzyskiwania tego punktu końcowego kolejki:

• Przy użyciu witryny Azure Portal

  1. Na platformie Microsoft Azure przejdź do konta usługi Azure Storage, z którym chcesz nawiązać połączenie
  2. W Settings sekcji (blok po lewej stronie) kliknij pozycję Endpoints
  3. Punkt końcowy kolejki będzie znajdować się w obszarze Usługa kolejki w polu tekstowym queue service .

• Korzystanie z kont magazynu — uzyskiwanie wywołania interfejsu API REST właściwości

  1. Pobierz konto subscription Id usługi Azure Storage i resource group name.
  2. Przejdź do pozycji Konta magazynu — pobierz właściwości
  3. Kliknij przycisk w Try it prawym górnym rogu wywołania HTTP
  4. Zaloguj się (użytkownik powinien mieć dostęp do konta magazynu)
  5. Wybieranie dzierżawy platformy Azure, w ramach których znajduje się konto usługi Azure Storage
  6. Wprowadź nazwę konta usługi Azure Storage, nazwę grupy zasobów i wybierz subskrypcję, w ramach których znajduje się konto magazynu.
  7. Klikać Run
  8. Punkt końcowy kolejki będzie znajdować się we queue właściwości w primaryEndpoints obiekcie w odpowiedzi

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Klucz dostępu	Podaj nazwę konta usługi Azure Storage (lub punkt końcowy kolejki) i klucz dostępu, aby uzyskać dostęp do usługi Azure Queue Storage.	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)	Udostępnialne
Klucz dostępu (Azure Government)	Podaj nazwę konta usługi Azure Storage (lub punkt końcowy kolejki) i klucz dostępu, aby uzyskać dostęp do usługi Azure Queue Storage.	Platforma Azure Government i Departament Obrony (DoD) tylko w usługach Azure Government i US Government (GCC-High)	Udostępnialne
Klucz dostępu (Azure Government)	Podaj nazwę konta usługi Azure Storage (lub punkt końcowy kolejki) i klucz dostępu, aby uzyskać dostęp do usługi Azure Queue Storage w usłudze Azure Government.	Tylko instytucje rządowe USA (GCC)	Udostępnialne
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 Queue Storage.	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 Queue Storage.	Platforma Azure Government i Departament Obrony (DoD) tylko w usługach Azure Government 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 Queue Storage w usłudze Azure Government.	Tylko instytucje rządowe USA (GCC)	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: keyBasedAuth

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 nazwę konta usługi Azure Storage (lub punkt końcowy kolejki) i klucz dostępu, aby uzyskać dostęp do usługi Azure Queue Storage.

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
Nazwa konta usługi Azure Storage lub punkt końcowy kolejki	ciąg	Nazwa lub punkt końcowy kolejki konta usługi Azure Storage, który powinien być używany przez łącznik.	Prawda
Klucz dostępu do konta usługi Azure Storage	securestring	Określ prawidłowy klucz dostępu do podstawowego/pomocniczego konta magazynu.

Klucz dostępu (Azure Government)

Identyfikator uwierzytelniania: keyBasedAuth

Dotyczy: tylko platforma Azure Government i Departament Obrony (DoD) w usługach Azure Government i US Government (GCC-High)

Podaj nazwę konta usługi Azure Storage (lub punkt końcowy kolejki) i klucz dostępu, aby uzyskać dostęp do usługi Azure Queue Storage.

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
Nazwa konta usługi Azure Storage lub punkt końcowy kolejki	ciąg	Nazwa lub punkt końcowy kolejki konta usługi Azure Storage, który powinien być używany przez łącznik.	Prawda
Klucz dostępu do konta usługi Azure Storage	securestring	Określ prawidłowy klucz dostępu do podstawowego/pomocniczego konta magazynu.

Klucz dostępu (Azure Government)

Identyfikator uwierzytelniania: keyBasedAuth

Dotyczy: tylko rząd USA (GCC)

Podaj nazwę konta usługi Azure Storage (lub punkt końcowy kolejki) i klucz dostępu, aby uzyskać dostęp do usługi Azure Queue Storage w usłudze Azure Government.

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
Nazwa konta usługi Azure Storage lub punkt końcowy kolejki	ciąg	Nazwa lub punkt końcowy kolejki konta usługi Azure Storage, który powinien być używany przez łącznik.	Prawda
Klucz dostępu do konta usługi Azure Storage	securestring	Określ prawidłowy klucz dostępu do podstawowego/pomocniczego konta magazynu.

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
Nazwa konta usługi Azure Storage lub punkt końcowy kolejki	ciąg	Nazwa lub punkt końcowy kolejki konta usługi Azure Storage	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

Microsoft Entra ID Zintegrowany

Identyfikator uwierzytelniania: tokenBasedAuth

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 Queue Storage.

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.

Microsoft Entra ID Integrated (Azure Government)

Identyfikator uwierzytelniania: tokenBasedAuth

Dotyczy: tylko platforma Azure Government i Departament Obrony (DoD) w usługach Azure Government i US Government (GCC-High)

Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do usługi Azure Queue Storage.

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.

Microsoft Entra ID Integrated (Azure Government)

Identyfikator uwierzytelniania: tokenBasedAuth

Dotyczy: tylko rząd USA (GCC)

Użyj identyfikatora Entra firmy Microsoft, aby uzyskać dostęp do usługi Azure Queue Storage w usłudze Azure Government.

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.

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
Nazwa konta usługi Azure Storage lub punkt końcowy kolejki	ciąg	Nazwa lub punkt końcowy kolejki konta usługi Azure Storage	Prawda
Klucz magazynu współużytkowanego	securestring	Klucz magazynu współużytkowanego konta magazynu	Prawda

Limity ograniczania

Nazwa	Wywołania	Okres odnowienia
Wywołania interfejsu API na połączenie	1200	60 sekund
Częstotliwość sond wyzwalacza	1	60 sekund

Akcje

Pobieranie komunikatów (wersja 2)	Pobieranie określonego zestawu komunikatów z kolejki. Komunikaty będą ukryte, ale pozostaną w kolejce do momentu użycia akcji usuwania.
Pobieranie komunikatów [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz komunikaty (V2). Pobieranie określonego zestawu komunikatów z kolejki. Komunikaty będą ukryte, ale pozostaną w kolejce do momentu użycia akcji usuwania.
Tworzenie nowej kolejki (wersja 2)	Dodaje kolejkę do konta.
Tworzenie nowej kolejki [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz nową kolejkę (wersja 2). Dodaje kolejkę do konta.
Umieszczanie komunikatu w kolejce (wersja 2)	Dodaje komunikat do danej kolejki.
Umieszczanie komunikatu w kolejce [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Put a message on a queue (V2). Dodaje komunikat do danej kolejki.
Usuń komunikat (wersja 2)	Usuń określony komunikat z kolejki.
Usuń komunikat [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Usuń komunikat (V2). Usuń określony komunikat z kolejki.
Wyświetlanie listy kolejek (wersja 2)	Wyświetl listę wszystkich kolejek dla konta magazynu.
Wyświetlanie listy kolejek [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj kolejek listy (V2). Wyświetl listę wszystkich kolejek dla konta magazynu.

Pobieranie komunikatów (wersja 2)

Pobieranie komunikatów [PRZESTARZAŁE]

Tworzenie nowej kolejki (wersja 2)

Tworzenie nowej kolejki [PRZESTARZAŁE]

Umieszczanie komunikatu w kolejce (wersja 2)

Umieszczanie komunikatu w kolejce [PRZESTARZAŁE]

Usuń komunikat (wersja 2)

Usuń komunikat [PRZESTARZAŁE]

Wyświetlanie listy kolejek (wersja 2)

Wyświetlanie listy kolejek [PRZESTARZAŁE]

Wyzwalacze

Gdy określona liczba komunikatów jest w danej kolejce (wersja 2)	Wyzwalacze, gdy określona liczba komunikatów znajdują się w danej kolejce.
Gdy określona liczba komunikatów jest w danej kolejce [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Gdy określona liczba komunikatów jest w danej kolejce (wersja 2). Wyzwalacze, gdy określona liczba komunikatów znajdują się w danej kolejce.
W przypadku komunikatów w kolejce (wersja 2)	Wyzwalacze za każdym razem, gdy w kolejce znajdują się komunikaty, zwracając do 32 komunikatów. Komunikaty będą ukryte, ale pozostaną w kolejce do momentu użycia akcji usuwania.
W przypadku komunikatów w kolejce [PRZESTARZAŁE]	Ta akcja została przestarzała. Zamiast tego użyj polecenia Jeśli w kolejce (wersja 2) znajdują się komunikaty . Wyzwalacze za każdym razem, gdy w kolejce znajdują się komunikaty, zwracając do 32 komunikatów. Komunikaty będą ukryte, ale pozostaną w kolejce do momentu użycia akcji usuwania.

Gdy określona liczba komunikatów jest w danej kolejce (wersja 2)

Gdy określona liczba komunikatów jest w danej kolejce [PRZESTARZAŁE]

W przypadku komunikatów w kolejce (wersja 2)

W przypadku komunikatów w kolejce [PRZESTARZAŁE]

Definicje

Kolejka

QueueArray

Messages

ciąg