次の方法で共有


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」になります。 複数のアカウントをお持ちの場合は、使用するアカウントを指定して作成を選択します。 作成中にエラーが発生した場合、アカウント名とキーを確認して、もう一度お試しください。 これで、この統合の使用を開始する準備が整いました。

既知の問題と制限事項

  1. 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」接続の場合、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 を使用

    1. Microsoft Azure 上で、接続したい Azure Storage アカウントに移動
    2. Settings セクションで (左のブレード) で、Endpoints をクリック
    3. queue service テキスト ボックスで、キュー エンドポイントはキュー サービスの下になります。
  • Storage アカウント - プロパティの取得 REST API 呼び出し

    1. Azure Storage アカウント subscription Idresource group name を取得します。
    2. Storage アカウント - プロパティの取得 へ移動
    3. HTTP 呼び出しの右上隅で Try it ボタンをクリック
    4. サイン イン (ユーザーはストレージ アカウントにアクセスできる必要があります)
    5. Azure Storage アカウントが配置されている Azure テナントを選択
    6. Azure Storage アカウント名、リソース グループ名を入力し、ストレージ アカウントが配置されているサブスクリプションを選択します。
    7. Run をクリック
    8. キュー エンドポイントは応答の primaryEndpoints オブジェクトの下の queue プロパティに表示される

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

アクセス キー 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) を使用してください。

キューにメッセージがあるときはいつでもトリガーし、最大 32 個のメッセージを返します。メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

指定された数のメッセージが指定のキューに含まれているとき (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

メッセージのテキスト。

文字列

これは基本的なデータ型 '文字列' です。