Azure Queues
Azure Storage キュー ストレージはアプリケーション コンポーネント間のクラウド メッセージングを提供します。 キュー ストレージは、非同期タスクの管理とプロセス ワーク フローの構築もサポートします。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | すべての Logic Apps 地域および統合サービス環境 (ISE) |
| Power Automate | プレミアム | すべての Power Automate 地域 |
| Power Apps | Premium | すべての Power Apps 地域 |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://azure.microsoft.com/services/storage/queues/ |
この統合を使用するには、Azure ストレージ アカウントへのアクセスが必要です。 詳細については、こちらを参照してください。 接続しようとすると、ストレージ アカウント名とストレージ キーを入力するよう求められます。 ストレージ アカウントの名前は URL に含まれており、たとえば URL が https://myaccount.queue.core.windows.net の場合、アカウント名は「myaccount」になります。 複数のアカウントをお持ちの場合は、使用するアカウントを指定して作成を選択します。 作成中にエラーが発生した場合、アカウント名とキーを確認して、もう一度お試しください。 これで、この統合の使用を開始する準備が整いました。
既知の問題と制限事項
- Logic Apps は、両方が同じ地域にある場合、ファイアウォールの背後にあるストレージ アカウントに直接アクセスすることはできません。 回避策として、Logic Apps とストレージ アカウントを異なる地域にします。 Azure Logic Apps からファイアウォールの背後にあるストレージ アカウントへのアクセスを有効にする方法の詳細については、ファイアウォールの背後にあるストレージ アカウントにアクセスするを参照してください
Microsoft Entra ID 認証と Azure Queues コネクタ
Microsoft Entra ID 認証を使用するには、使用するアカウントに特定のロールの割り当てを割り当てる必要があり、詳細については、BLOB データへのアクセスに Azure ロールを割り当てる - 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.
アカウントがコンテナー内で操作を実行するために必要なロールを持っているかどうかを確認するための簡単なテストを次に示します。
1. Azure Portal でそのアカウントでサインインします。
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 ID 認証に関する既知の制限事項
現在の認証パイプラインの制限により、Microsoft Entra ID のゲスト ユーザーは Azure Queues への Microsoft Entra ID の接続に対応していません。 Microsoft Entra ID 認証を使用する場合、V2 アクションのみがサポートされています。 非推奨アクションは引き続き Access Key 認証で機能しますが、Microsoft Entra AAD 接続で使用すると失敗します。
キュー エンドポイント を使用して、Azure キュー コネクタに接続する
「アクセス キー」接続を作成または V2 操作を使用するさい、完全な Azure Storage キュー エンドポイント を入力します。
「アクセス キー」認証の場合は、
Azure Storage account name or queue endpointパラメータに完全な Azure Storage キュー エンドポイントを入力します。- 「アクセス キー」認証で「V2」操作を使用する場合、同様にキュー エンドポイントは
storageAccountNameパラメータを指定する必要があります。
- 「アクセス キー」認証で「V2」操作を使用する場合、同様にキュー エンドポイントは
「V2」接続の場合、
storageAccountNameパラメータに完全な Azure Storage キュー エンドポイントを入力します。スキーマを含め、完全なエンドポイントを指定する必要があります。例えば:
https://account.queue.core.windows.net/https://account-secondary.queue.core.windows.net/(セカンダリ エンドポイントに接続する場合)- 相対パス (例えば、
account.queue.core.windows.net) は拒否されます。
特定のストレージ アカウントの Azure Storage キュー エンドポイントを取得
キュー エンドポイントを取得するには、複数の方法があります:
Azure portal を使用
- Microsoft Azure 上で、接続したい Azure Storage アカウントに移動
Settingsセクションで (左のブレード) で、Endpointsをクリックqueue serviceテキスト ボックスで、キュー エンドポイントはキュー サービスの下になります。
Storage アカウント - プロパティの取得 REST API 呼び出し
- Azure Storage アカウント
subscription Idとresource group nameを取得します。 - Storage アカウント - プロパティの取得 へ移動
- HTTP 呼び出しの右上隅で
Try itボタンをクリック - サイン イン (ユーザーはストレージ アカウントにアクセスできる必要があります)
- Azure Storage アカウントが配置されている Azure テナントを選択
- Azure Storage アカウント名、リソース グループ名を入力し、ストレージ アカウントが配置されているサブスクリプションを選択します。
Runをクリック- キュー エンドポイントは応答の
primaryEndpointsオブジェクトの下のqueueプロパティに表示される
- Azure Storage アカウント
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| アクセス キー | Azure Storage アカウント名 (またはキュー エンドポイント) と Azure Queue ストレージにアクセスするアクセス キーを指定します。 | Azure Government、米国政府 (GCC)、米国政府 (GCC-High) における Azure Government と国防総省 (DoD) を除くすべての地域 | 共有可能 |
| アクセス キー (Azure Government) | Azure Storage アカウント名 (またはキュー エンドポイント) と Azure Queue ストレージにアクセスするアクセス キーを指定します。 | Azure Government と米国政府 (GCC-High) のみに含まれる Azure Government と国防総省 (DOD) | 共有可能 |
| アクセス キー (Azure Government) | Azure Storage アカウント名 (またはキュー エンドポイント) と Azure Government の Azure Queue ストレージにアクセスするアクセス キーを指定します。 | 米国政府 (GCC) のみ | 共有可能 |
| Azure AD 統合 | Azure Active Directory を使用して、Azure Queue ストレージにアクセスします。 | MOONCAKE のみ | 共有不可 |
| Azure AD 統合 (Azure Government) | Azure Active Directory を使用して、Azure Queue ストレージにアクセスします。 | Azure Government と米国政府 (GCC-High) のみに含まれる Azure Government と国防総省 (DOD) | 共有不可 |
| Azure AD 統合 (Azure Government) | Azure Active Directory を使用して、Azure Government の Azure Queue ストレージにアクセスします。 | 米国政府 (GCC) のみ | 共有不可 |
| Logic Apps マネージド ID | LogicApps Managed Identity を使用して接続を作成する | LOGICAPPS のみ | 共有可能 |
| Microsoft Entra ID 統合 | Microsoft Entra ID を使用して、Azure Queue Storage にアクセスします。 | Azure Government、MOONCAKE、米国政府 (GCC)、米国政府 (GCC-High) における Azure Government と国防総省 (DoD) を除くすべての地域 | 共有不可 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 | すべての地域 | 共有不可 |
アクセス キー
認証 ID: keyBasedAuth
適用可能: Azure Government、米国政府 (GCC)、米国政府 (GCC-High) における Azure Government と国防総省 (DoD) を除くすべての地域
Azure Storage アカウント名 (またはキュー エンドポイント) と Azure Queue ストレージにアクセスするアクセス キーを指定します。
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| Azure Storage アカウント名またはキュー エンドポイント | string | コネクタで使用される Azure Storage アカウントの名前または キュー エンドポイントです。 | True |
| Azure Storage アカウントのアクセス キー | securestring | プライマリ/セカンダリ ストレージ アカウントの有効なアクセス キーを指定します。 |
アクセス キー (Azure Government)
認証 ID: keyBasedAuth
適用可能: Azure Government と米国政府 (GCC-High) のみに含まれる Azure Government と国防総省 (DOD)
Azure Storage アカウント名 (またはキュー エンドポイント) と Azure Queue ストレージにアクセスするアクセス キーを指定します。
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| Azure Storage アカウント名またはキュー エンドポイント | string | コネクタで使用される Azure Storage アカウントの名前または キュー エンドポイントです。 | True |
| Azure Storage アカウントのアクセス キー | securestring | プライマリ/セカンダリ ストレージ アカウントの有効なアクセス キーを指定します。 |
アクセス キー (Azure Government)
認証 ID: keyBasedAuth
該当するもの: 米国政府 (GCC) のみ
Azure Storage アカウント名 (またはキュー エンドポイント) と Azure Government の Azure Queue ストレージにアクセスするアクセス キーを指定します。
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| Azure Storage アカウント名またはキュー エンドポイント | string | コネクタで使用される Azure Storage アカウントの名前または キュー エンドポイントです。 | True |
| Azure Storage アカウントのアクセス キー | securestring | プライマリ/セカンダリ ストレージ アカウントの有効なアクセス キーを指定します。 |
Azure AD 統合
Auth ID: tokenBasedAuth
適用: MOONCAKE のみ
Azure Active Directory を使用して、Azure Queue ストレージにアクセスします。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
Azure AD 統合 (Azure Government)
認証 ID: tokenBasedAuth
適用可能: Azure Government と米国政府 (GCC-High) のみに含まれる Azure Government と国防総省 (DOD)
Azure Active Directory を使用して、Azure Queue ストレージにアクセスします。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
Azure AD 統合 (Azure Government)
認証 ID: tokenBasedAuth
該当するもの: 米国政府 (GCC) のみ
Azure Active Directory を使用して、Azure Government の Azure Queue ストレージにアクセスします。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
Logic Apps マネージド ID
認証 ID: managedIdentityAuth
適用対象: LOGICAPPS のみ
LogicApps Managed Identity を使用して接続を作成する
これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください
| 名前 | 種類 | 説明 | 必須 |
|---|---|---|---|
| LogicApps Managed Identity | managedIdentity | Logic Apps Managed Identity でサインインする | True |
Microsoft Entra ID 統合
Auth ID: tokenBasedAuth
適用可能: Azure Government、MOONCAKE、米国政府 (GCC)、米国政府 (GCC-High) における Azure Government と国防総省 (DoD) を除くすべての地域
Microsoft Entra ID を使用して、Azure Queue Storage にアクセスします。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
既定 [非推奨]
適用できるもの: すべての領域
このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 説明設定 | Required |
|---|---|---|---|
| Azure Storage アカウント名またはキュー エンドポイント | string | Azure Storage アカウントの名前またはキュー エンドポイント | True |
| 共有ストレージ キー | securestring | ストレージ アカウントの共有ストレージ キー | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1200 | 60 秒 |
| トリガー ポーリングの頻度 | 1 | 60 秒 |
アクション
| キューにメッセージを入れる (V2) |
指定のキューにメッセージを追加します。 |
| キューにメッセージを入れる [非推奨] |
このアクションは非推奨になりました。 代わりに キューにメッセージを入れる (V2) を使用してください。
|
| キューを一覧表示する (V2) |
ご利用のストレージ アカウントのすべてのキューを一覧表示します。 |
| キューを一覧表示する [非推奨] |
このアクションは非推奨になりました。 代わりに、キューを一覧表示する (V2) を使用してください。
|
| メッセージの削除 (V2) |
特定のメッセージをキューから削除します。 |
| メッセージを削除する [非推奨] |
このアクションは非推奨になりました。 代わりに、メッセージを削除する (V2) を使用してください。
|
| メッセージを取得する (V2) |
キューから特定のメッセージのセットを取得します。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。 |
| メッセージを取得する [非推奨] |
このアクションは非推奨になりました。 代わりに メッセージを取得する (V2) を使用してください。
|
| 新しいキューを作成する (V2) |
ご利用のアカウントにキューを追加します。 |
| 新しいキューを作成する [非推奨] |
このアクションは非推奨になりました。 代わりに 新しいキューを作成する (V2) を使用してください。
|
キューにメッセージを入れる (V2)
指定のキューにメッセージを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ストレージ アカウント名またはキュー エンドポイント
|
storageAccountName | True | string |
Azure Storage アカウント名またはキュー エンドポイントです。 |
|
キュー名
|
queueName | True | string |
メッセージを入れるキュー。 |
|
Message
|
message | True | string |
キューに投稿するメッセージ コンテンツ。 |
キューにメッセージを入れる [非推奨]
このアクションは非推奨になりました。 代わりに キューにメッセージを入れる (V2) を使用してください。
指定のキューにメッセージを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
キュー名
|
queueName | True | string |
メッセージを入れるキュー。 |
|
メッセージ
|
message | True | string |
キューに投稿するメッセージ コンテンツ。 |
キューを一覧表示する (V2)
ご利用のストレージ アカウントのすべてのキューを一覧表示します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ストレージ アカウント名またはキュー エンドポイント
|
storageAccountName | True | string |
Azure Storage アカウント名またはキュー エンドポイントです。 |
戻り値
- アイテム
- QueueArray
キューを一覧表示する [非推奨]
このアクションは非推奨になりました。 代わりに、キューを一覧表示する (V2) を使用してください。
ご利用のストレージ アカウントのすべてのキューを一覧表示します。
戻り値
- 品目
- QueueArray
メッセージの削除 (V2)
特定のメッセージをキューから削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ストレージ アカウント名またはキュー エンドポイント
|
storageAccountName | True | string |
Azure Storage アカウント名またはキュー エンドポイントです。 |
|
キュー名
|
queueName | True | string |
メッセージの削除元となるキュー。 |
|
メッセージ ID
|
messageId | True | string |
削除するメッセージの ID。 |
|
ポップの受信
|
popreceipt | True | string |
Get Messages に対する以前の呼び出しから返された有効なポップ受信値。 |
メッセージを削除する [非推奨]
このアクションは非推奨になりました。 代わりに、メッセージを削除する (V2) を使用してください。
特定のメッセージをキューから削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
キュー名
|
queueName | True | string |
メッセージの削除元となるキュー。 |
|
メッセージ ID
|
messageId | True | string |
削除するメッセージの ID。 |
|
ポップの受信
|
popreceipt | True | string |
Get Messages に対する以前の呼び出しから返された有効なポップ受信値。 |
メッセージを取得する (V2)
キューから特定のメッセージのセットを取得します。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ストレージ アカウント名またはキュー エンドポイント
|
storageAccountName | True | string |
Azure Storage アカウント名またはキュー エンドポイントです。 |
|
キュー名
|
queueName | True | string |
メッセージの取得元のキュー。 |
|
メッセージ数
|
numofmessages | string |
キューから取得するメッセージの数 (既定値 1)。 |
|
|
表示タイムアウト
|
visibilitytimeout | string |
メッセージが他のコンシューマーに非表示になる時間 (秒) (既定値は 30)。 |
戻り値
- 本文
- Messages
メッセージを取得する [非推奨]
このアクションは非推奨になりました。 代わりに メッセージを取得する (V2) を使用してください。
キューから特定のメッセージのセットを取得します。メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
キュー名
|
queueName | True | string |
メッセージの取得元のキュー。 |
|
メッセージ数
|
numofmessages | string |
キューから取得するメッセージの数 (既定値 1)。 |
|
|
表示タイムアウト
|
visibilitytimeout | string |
メッセージが他のコンシューマーに非表示になる時間 (秒) (既定値は 30)。 |
戻り値
- 本文
- Messages
新しいキューを作成する (V2)
ご利用のアカウントにキューを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ストレージ アカウント名またはキュー エンドポイント
|
storageAccountName | True | string |
Azure Storage アカウント名またはキュー エンドポイントです。 |
|
キュー名
|
queueName | True | string |
作成するキューの名前。 |
戻り値
- 返答
- string
新しいキューを作成する [非推奨]
このアクションは非推奨になりました。 代わりに 新しいキューを作成する (V2) を使用してください。
ご利用のアカウントにキューを追加します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
キュー名
|
queueName | True | string |
作成するキューの名前。 |
戻り値
- 応答
- string
トリガー
| キューにメッセージが含まれるとき (V2) |
キューにメッセージがあるときはいつでもトリガーし、最大 32 個のメッセージを返します。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。 |
| キューにメッセージが含まれるとき [非推奨] |
このアクションは非推奨になりました。 代わりに、キューにメッセージが含まれるとき (V2) を使用してください。
|
| 指定された数のメッセージが指定のキューに含まれているとき (V2) |
指定した数のメッセージが指定のキューに含まれたときにトリガーします。 |
| 指定された数のメッセージが指定のキューに含まれているとき [非推奨] |
このアクションは非推奨になりました。 代わりに、指定された数のメッセージが指定のキューに含まれているとき (V2) を使用してください。
|
キューにメッセージが含まれるとき (V2)
キューにメッセージがあるときはいつでもトリガーし、最大 32 個のメッセージを返します。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ストレージ アカウント名またはキュー エンドポイント
|
storageAccountName | True | string |
Azure Storage アカウント名またはキュー エンドポイントです。 |
|
キュー名
|
queueName | True | string |
メッセージを確認するキュー |
|
表示タイムアウト
|
visibilitytimeout | string |
メッセージが他のコンシューマーに非表示になる時間 (秒) (既定値は 30) |
戻り値
- 本文
- Messages
キューにメッセージが含まれるとき [非推奨]
このアクションは非推奨になりました。 代わりに、キューにメッセージが含まれるとき (V2) を使用してください。
キューにメッセージがあるときはいつでもトリガーし、最大 32 個のメッセージを返します。メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
キュー名
|
queueName | True | string |
メッセージを確認するキュー |
|
表示タイムアウト
|
visibilitytimeout | string |
メッセージが他のコンシューマーに非表示になる時間 (秒) (既定値は 30) |
戻り値
- 本文
- Messages
指定された数のメッセージが指定のキューに含まれているとき (V2)
指定した数のメッセージが指定のキューに含まれたときにトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ストレージ アカウント名またはキュー エンドポイント
|
storageAccountName | True | string |
Azure Storage アカウント名またはキュー エンドポイントです。 |
|
キュー名
|
queueName | True | string |
メッセージを確認するキュー。 |
|
Threshold
|
threshold | True | integer |
トリガーを起動するまでに待つメッセージの数。 |
戻り値
- 応答
- string
指定された数のメッセージが指定のキューに含まれているとき [非推奨]
このアクションは非推奨になりました。 代わりに、指定された数のメッセージが指定のキューに含まれているとき (V2) を使用してください。
指定した数のメッセージが指定のキューに含まれたときにトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
キュー名
|
queueName | True | string |
メッセージを確認するキュー。 |
|
しきい値
|
threshold | True | integer |
トリガーを起動するまでに待つメッセージの数。 |
戻り値
- 応答
- string
定義
キュー
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
件名
|
Name | string |
キューの名前。 |
QueueArray
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
項目
|
Queue |
メッセージ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
QueueMessage
|
QueueMessagesList.QueueMessage | array of object | |
|
メッセージ ID
|
QueueMessagesList.QueueMessage.MessageId | string |
メッセージの一意識別子。 |
|
挿入時刻
|
QueueMessagesList.QueueMessage.InsertionTime | string |
メッセージがキューに挿入された時刻。 |
|
有効期限
|
QueueMessagesList.QueueMessage.ExpirationTime | string |
キューからメッセージが期限切れになる時刻。 |
|
ポップの受信
|
QueueMessagesList.QueueMessage.PopReceipt | string |
キューから取得された後、メッセージを削除するために使用されます。 |
|
次回表示時刻
|
QueueMessagesList.QueueMessage.TimeNextVisible | string |
メッセージが他のコンシューマーに表示される時刻。 |
|
メッセージ テキスト
|
QueueMessagesList.QueueMessage.MessageText | string |
メッセージのテキスト。 |
文字列
これは基本的なデータ型 '文字列' です。