Очереди Azure

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Премия	Все регионы Power Automate
Логические приложения	Стандарт	Все регионы Logic Apps
Power Apps	Премия	Все регионы Power Apps
Power Automate	Премия	Все регионы Power Automate

Метаданные соединителя
Publisher	Microsoft
Веб-сайт	https://azure.microsoft.com/services/storage/queues/

Чтобы использовать эту интеграцию, вам потребуется доступ к учетной записи хранения Azure. Дополнительные сведения см. здесь. При попытке подключиться вам будет предложено указать имя учетной записи хранения и ключ хранилища. Имя учетной записи хранения можно найти в URL-адресе, например, если URL-адрес будет https://myaccount.queue.core.windows.net иметь имя учетной записи myaccount. Если у вас несколько учетных записей, укажите нужный и нажмите кнопку "Создать". Если во время создания возникает ошибка, проверьте имя учетной записи и ключ и повторите попытку. Теперь вы готовы начать использовать эту интеграцию.

Известные проблемы и ограничения

1. Приложения логики не могут напрямую получать доступ к учетным записям хранения, которые находятся за брандмауэрами, если они находятся в одном регионе. В качестве обходного решения вы можете использовать приложения логики и учетную запись хранения в разных регионах. Дополнительные сведения о включении доступа из Azure Logic Apps к учетным записям хранения за брандмауэрами см. в статье " Учетные записи хранения Access" за брандмауэрами.

Проверка подлинности идентификатора Microsoft Entra и соединитель очередей Azure

Чтобы использовать проверку подлинности идентификатора Microsoft Entra, учетная запись, используемая должна быть назначена определенному назначению ролей. Дополнительные сведения см. в статье "Назначение роли Azure для доступа к данным BLOB-объектов в службе хранилища Azure".

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

Ниже приведен краткий тест для проверки наличия учетной записи необходимой роли для выполнения операций в контейнере: 1. Вход с помощью этой учетной записи на портале Azure. 2. Перейдите в очередь в учетной записи хранения и выберите Switch to Microsoft Entra ID User Account метод проверки подлинности. Этот параметр отображается только в верхней части поля поиска.

Если появится неавторизованное сообщение, пользователю необходимо назначить определенные разрешения учетной записи хранения. Для этого диспетчер учетных записей хранения должен: 1. Перейдите на вкладку очереди Access Control (IAM) . 2. Add Щелкните 3. Add role assignment Щелкните 4. Назначение определенной Storage Queue роли пользователю (например, Storage Queue Data Contributor)

Известные ограничения с проверкой подлинности Идентификатора Microsoft Entra

Из-за текущих ограничений конвейера проверки подлинности гостевые пользователи Идентификатора Microsoft Entra не поддерживаются для подключений идентификатора Microsoft Entra к очередям Azure. При использовании проверки подлинности идентификатора Microsoft Entra id поддерживаются только действия версии 2. Устаревшие действия будут продолжать работать с Access Key проверкой подлинности, но при использовании с подключением идентификатора Microsoft Entra ID завершится ошибкой.

Подключение к соединителю очередей Azure с помощью конечной точки очереди

Введите полную конечную точку очереди службы хранилища Azure при создании подключения "Ключ доступа" или использовании операций версии 2.

• Для проверки подлинности "Ключ доступа" введите полную конечную точку очереди службы хранилища Azure в Azure Storage account name or queue endpoint параметре.

  • При использовании операций "V2" с проверкой подлинности "Ключ доступа" конечная точка очереди также должна быть предоставлена в параметре storageAccountName .

• Для операций "V2" введите полную конечную точку очереди службы хранилища Azure в storageAccountName параметре.

• Необходимо указать полную конечную точку, включая схему, например:

  • https://account.queue.core.windows.net/
  • https://account-secondary.queue.core.windows.net/ (при подключении к вторичной конечной точке)
  • Относительные пути (например, account.queue.core.windows.net) будут отклонены.

Получение конечной точки очереди службы хранилища Azure для заданной учетной записи хранения

Существует несколько способов получения этой конечной точки очереди:

• Использование портала Azure

  1. В Microsoft Azure перейдите к учетной записи хранения Azure, которую вы хотите подключить.
  2. В разделе Settings (левая колонка) щелкните Endpoints
  3. Конечная точка очереди будет находиться в службе очередей в текстовом queue service поле.

• Использование учетных записей хранения — вызов REST API свойств

  1. Получение учетной записи subscription Id хранения Azure и resource group name.
  2. Переход к учетным записям хранения — получение свойств
  3. Try it Нажмите кнопку в правом верхнем углу вызова HTTP
  4. Вход (у пользователя должен быть доступ к учетной записи хранения)
  5. Выберите клиент Azure, на который находится учетная запись хранения Azure.
  6. Введите имя учетной записи службы хранилища Azure, имя группы ресурсов и выберите подписку, в которую находится учетная запись хранения.
  7. Щелчок Run
  8. Конечная точка очереди будет находиться в queue свойстве объекта primaryEndpoints в ответе

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:

ключа доступа	Укажите имя учетной записи хранения Azure (или конечную точку очереди) и ключ доступа для доступа к хранилищу очередей Azure.	Все регионы, кроме Azure для государственных организаций и министерства обороны (DoD) в Azure для государственных организаций и государственных организаций США (GCC) и государственных организаций США (GCC-High)	Доступный для общего пользования
Ключ доступа (Azure для государственных организаций)	Укажите имя учетной записи хранения Azure (или конечную точку очереди) и ключ доступа для доступа к хранилищу очередей Azure.	Azure для государственных организаций и Министерства обороны (DoD) в Azure для государственных организаций и государственных организаций США (GCC-High) только	Доступный для общего пользования
Ключ доступа (Azure для государственных организаций)	Укажите имя учетной записи хранения Azure (или конечную точку очереди) и ключ доступа для доступа к хранилищу очередей Azure в Azure для государственных организаций.	Только правительство США (GCC)	Доступный для общего пользования
Проверка подлинности сертификата клиента	Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX	Все регионы	Доступный для общего пользования
Управляемое удостоверение Logic Apps	Создание подключения с помощью управляемого удостоверения LogicApps	Только LOGICAPPS	Доступный для общего пользования
Интегрированный идентификатор Microsoft Entra	Используйте идентификатор Microsoft Entra для доступа к хранилищу очередей Azure.	Все регионы, кроме Azure для государственных организаций и министерства обороны (DoD) в Azure для государственных организаций и государственных организаций США (GCC) и государственных организаций США (GCC-High)	Недоступен для совместного использования
Интегрированная идентификатора Microsoft Entra (Azure для государственных организаций)	Используйте идентификатор Microsoft Entra для доступа к хранилищу очередей Azure.	Azure для государственных организаций и Министерства обороны (DoD) в Azure для государственных организаций и государственных организаций США (GCC-High) только	Недоступен для совместного использования
Интегрированная идентификатора Microsoft Entra (Azure для государственных организаций)	Используйте идентификатор Microsoft Entra для доступа к хранилищу очередей Azure в Azure для государственных организаций.	Только правительство США (GCC)	Недоступен для совместного использования
По умолчанию [не рекомендуется]	Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.	Все регионы	Недоступен для совместного использования

Ключ доступа

Идентификатор проверки подлинности: keyBasedAuth

Применимо: все регионы, кроме Azure для государственных организаций и министерства обороны (DoD) в Azure для государственных организаций и государственных организаций США (GCC) и сша (GCC-High)

Укажите имя учетной записи хранения Azure (или конечную точку очереди) и ключ доступа для доступа к хранилищу очередей Azure.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Имя учетной записи хранения Azure или конечная точка очереди	струна	Имя или конечная точка очереди учетной записи хранения Azure, используемая соединителем.	True
Ключ доступа к учетной записи хранения Azure	securestring	Укажите допустимый ключ доступа к первичной или вторичной учетной записи хранения.

Ключ доступа (Azure для государственных организаций)

Идентификатор проверки подлинности: keyBasedAuth

Применимо: Только Для государственных организаций Azure и Министерства обороны (DoD) в Azure для государственных организаций и государственных организаций США (GCC-High)

Укажите имя учетной записи хранения Azure (или конечную точку очереди) и ключ доступа для доступа к хранилищу очередей Azure.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Имя учетной записи хранения Azure или конечная точка очереди	струна	Имя или конечная точка очереди учетной записи хранения Azure, используемая соединителем.	True
Ключ доступа к учетной записи хранения Azure	securestring	Укажите допустимый ключ доступа к первичной или вторичной учетной записи хранения.

Ключ доступа (Azure для государственных организаций)

Идентификатор проверки подлинности: keyBasedAuth

Применимо: только правительство США (GCC)

Укажите имя учетной записи хранения Azure (или конечную точку очереди) и ключ доступа для доступа к хранилищу очередей Azure в Azure для государственных организаций.

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Имя учетной записи хранения Azure или конечная точка очереди	струна	Имя или конечная точка очереди учетной записи хранения Azure, используемая соединителем.	True
Ключ доступа к учетной записи хранения Azure	securestring	Укажите допустимый ключ доступа к первичной или вторичной учетной записи хранения.

Проверка подлинности сертификата клиента

Идентификатор проверки подлинности: certOauth

Применимо: все регионы

Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Tenant	струна		True
Идентификатор клиента	струна	Идентификатор клиента для приложения Идентификатора Microsoft Entra	True
Секрет сертификата клиента	клиентский сертификат	Секрет сертификата клиента, разрешенный этим приложением	True
Имя учетной записи хранения Azure или конечная точка очереди	струна	Имя или конечная точка очереди учетной записи хранения Azure	True

Управляемое удостоверение Logic Apps

Идентификатор проверки подлинности: managedIdentityAuth

Применимо: только LOGICAPPS

Создание подключения с помощью управляемого удостоверения LogicApps

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя	Тип	Description	Обязательно
Управляемое удостоверение LogicApps	управляемая идентичность	Вход с помощью управляемого удостоверения Logic Apps	True

Встроенная интеграция идентификатора Microsoft Entra

Идентификатор проверки подлинности: tokenBasedAuth

Применимо: все регионы, кроме Azure для государственных организаций и министерства обороны (DoD) в Azure для государственных организаций и государственных организаций США (GCC) и сша (GCC-High)

Используйте идентификатор Microsoft Entra для доступа к хранилищу очередей Azure.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Интегрированная идентификатора Microsoft Entra (Azure для государственных организаций)

Идентификатор проверки подлинности: tokenBasedAuth

Применимо: Только Для государственных организаций Azure и Министерства обороны (DoD) в Azure для государственных организаций и государственных организаций США (GCC-High)

Используйте идентификатор Microsoft Entra для доступа к хранилищу очередей Azure.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Интегрированная идентификатора Microsoft Entra (Azure для государственных организаций)

Идентификатор проверки подлинности: tokenBasedAuth

Применимо: только правительство США (GCC)

Используйте идентификатор Microsoft Entra для доступа к хранилищу очередей Azure в Azure для государственных организаций.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

По умолчанию [не рекомендуется]

Применимо: все регионы

Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя	Тип	Description	Обязательно
Имя учетной записи хранения Azure или конечная точка очереди	струна	Имя или конечная точка очереди учетной записи хранения Azure	True
Общий ключ хранилища	securestring	Общий ключ хранилища учетной записи хранения	True

Ограничения регулирования

Имя	Вызовы	Период обновления
Вызовы API для каждого подключения	1200	60 секунд
Частота опросов триггеров	1	60 секунд

Действия

Вывод списка очередей [DEPRECATED]	Это действие устарело. Вместо этого используйте очереди списка (V2). Список всех очередей для учетной записи хранения.
Перечисление очередей (версия 2)	Список всех очередей для учетной записи хранения.
Получение сообщений (версия 2)	Получение определенного набора сообщений из очереди. Сообщения будут скрыты, но остаются в очереди до тех пор, пока действие удаления не будет использовано.
Получение сообщений [DEPRECATED]	Это действие устарело. Вместо этого используйте get messages (V2). Получение определенного набора сообщений из очереди. Сообщения будут скрыты, но остаются в очереди до тех пор, пока действие удаления не будет использовано.
Поместите сообщение в очередь (версия 2)	Добавляет сообщение в указанную очередь.
Поместите сообщение в очередь [НЕ РЕКОМЕНДУЕТСЯ]	Это действие устарело. Вместо этого используйте сообщение "Поместить" в очередь (версия 2). Добавляет сообщение в указанную очередь.
Создание новой очереди (версия 2)	Добавляет очередь в учетную запись.
Создание новой очереди [не рекомендуется]	Это действие устарело. Вместо этого используйте новую очередь (V2 ). Добавляет очередь в учетную запись.
Удаление сообщения (версия 2)	Удалите определенное сообщение из очереди.
Удаление сообщения [DEPRECATED]	Это действие устарело. Вместо этого используйте сообщение Delete (V2 ). Удалите определенное сообщение из очереди.

Вывод списка очередей [DEPRECATED]

Перечисление очередей (версия 2)

Получение сообщений (версия 2)

Получение сообщений [DEPRECATED]

Поместите сообщение в очередь (версия 2)

Поместите сообщение в очередь [НЕ РЕКОМЕНДУЕТСЯ]

Создание новой очереди (версия 2)

Создание новой очереди [не рекомендуется]

Удаление сообщения (версия 2)

Удаление сообщения [DEPRECATED]

Триггеры

Если указанное количество сообщений находится в заданной очереди (версия 2)	Триггеры, когда указанное число сообщений находится в заданной очереди.
Если указанное число сообщений находится в заданной очереди [DEPRECATED]	Это действие устарело. Используйте, если указанное число сообщений находится в заданной очереди (V2). Триггеры, когда указанное число сообщений находится в заданной очереди.
При наличии сообщений в очереди (версия 2)	Триггеры в любой момент, когда в очереди есть сообщения, возвращающие до 32 сообщений. Сообщения будут скрыты, но остаются в очереди до тех пор, пока действие удаления не будет использовано.
При наличии сообщений в очереди [НЕ РЕКОМЕНДУЕТСЯ]	Это действие устарело. Используйте, если вместо этого есть сообщения в очереди (версия 2 ). Триггеры в любой момент, когда в очереди есть сообщения, возвращающие до 32 сообщений. Сообщения будут скрыты, но остаются в очереди до тех пор, пока действие удаления не будет использовано.

Если указанное количество сообщений находится в заданной очереди (версия 2)

Если указанное число сообщений находится в заданной очереди [DEPRECATED]

При наличии сообщений в очереди (версия 2)

При наличии сообщений в очереди [НЕ РЕКОМЕНДУЕТСЯ]

Определения

Очередь

QueueArray

Messages

струна