次の方法で共有


Azure キュー

Azure Queue Storage は、アプリケーション コンポーネント間のクラウド メッセージングを提供します。 キュー ストレージでは、非同期タスクの管理とプロセスワーク フローの構築もサポートされています。

このコネクタは、次の製品とリージョンで使用できます。

サービス クラス リージョン
コピロット スタジオ Premium すべての Power Automate リージョン
ロジック アプリ Standard すべての Logic Apps リージョン
Power Apps Premium すべての Power Apps リージョン
Power Automate Premium すべての Power Automate リージョン
コネクタ メタデータ
Publisher Microsoft
Website https://azure.microsoft.com/services/storage/queues/

この統合を使用するには、Azure ストレージ アカウントにアクセスする必要があります。 詳細については、 こちらをご覧ください。 接続しようとすると、ストレージ アカウント名とストレージ キーを指定するように求められます。 ストレージ アカウントの名前は URL で確認できます。たとえば、URL が https://myaccount.queue.core.windows.net されている場合、アカウント名は "myaccount" になります。 複数のアカウントがある場合は、使用するアカウントを指定し、[ 作成] を選択します。 作成中にエラーが表示された場合は、アカウント名とキーを確認して、もう一度やり直してください。 これで、この統合の使用を開始する準備ができました。

既知の問題と制限事項

  1. ロジック アプリは、両方が同じリージョンにある場合、ファイアウォールの背後にあるストレージ アカウントに直接アクセスすることはできません。 回避策として、ロジック アプリとストレージ アカウントをさまざまなリージョンに配置できます。 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 キューへの Microsoft Entra ID 接続ではサポートされていません。 Microsoft Entra ID 認証を使用する場合 、V2 アクションのみがサポートされます。 非推奨のアクションは引き続き Access Key 認証で動作しますが、 Microsoft Entra ID 接続で使用すると失敗します

キュー エンドポイントを使用して Azure Queues コネクタに接続する

"アクセス キー" 接続を作成するとき、または V2 操作を使用するときに、完全な Azure Storage キュー エンドポイントを入力します。

  • "アクセス キー" 認証の場合は、パラメーターに完全な Azure Storage キュー エンドポイント Azure Storage account name or queue endpoint 入力します。

    • "アクセス キー" 認証で "V2" 操作を使用する場合は、キュー エンドポイントも storageAccountName パラメーターで指定する必要があります。
  • "V2" 操作の場合は、パラメーターに完全な Azure Storage キュー エンドポイント storageAccountName 入力します。

  • スキーマを含む完全なエンドポイントを指定する必要があります。次に例を示します。

    • 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 テキスト ボックスの [キュー サービス] の下にあります。
  • ストレージ アカウントの使用 - プロパティの取得 REST API 呼び出し

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

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

アクセス キー Azure Queue Storage にアクセスするには、Azure Storage アカウント名 (またはキュー エンドポイント) とアクセス キーを指定します。 Azure Government と US Government (GCC) と米国政府機関 (GCC-High) の Azure Government および国防総省 (DoD) を除くすべてのリージョン 共有可能
アクセス キー (Azure Government) Azure Queue Storage にアクセスするには、Azure Storage アカウント名 (またはキュー エンドポイント) とアクセス キーを指定します。 Azure Government および米国政府機関の Azure Government および国防総省 (DoD) (GCC-High) のみ 共有可能
アクセス キー (Azure Government) Azure Storage アカウント名 (またはキュー エンドポイント) とアクセス キーを指定して、Azure Government の Azure Queue Storage にアクセスします。 米国政府 (GCC) のみ 共有可能
クライアント証明書の認証 PFX 証明書とパスワードを使用して Microsoft Entra ID 資格情報を指定する すべてのリージョン 共有可能
ロジック アプリのマネージド ID LogicApps マネージド ID を使用して接続を作成する LOGICAPPS のみ 共有可能
Microsoft Entra ID 統合 Microsoft Entra ID を使用して Azure Queue Storage にアクセスします。 Azure Government と US Government (GCC) と米国政府機関 (GCC-High) の Azure Government および国防総省 (DoD) を除くすべてのリージョン 共有不可
Microsoft Entra ID Integrated (Azure Government) Microsoft Entra ID を使用して Azure Queue Storage にアクセスします。 Azure Government および米国政府機関の Azure Government および国防総省 (DoD) (GCC-High) のみ 共有不可
Microsoft Entra ID Integrated (Azure Government) Microsoft Entra ID を使用して、Azure Government の Azure Queue Storage にアクセスします。 米国政府 (GCC) のみ 共有不可
既定 [非推奨] このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 すべてのリージョン 共有不可

アクセス キー

認証 ID: keyBasedAuth

適用: Azure Government および米国政府 (GCC) および米国政府 (GCC-High) の Azure Government および国防総省 (DoD) を除くすべてのリージョン

Azure Queue Storage にアクセスするには、Azure Storage アカウント名 (またはキュー エンドポイント) とアクセス キーを指定します。

これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs

名前 タイプ Description 必須
Azure Storage アカウント名またはキュー エンドポイント 文字列 コネクタで使用する必要がある Azure Storage アカウントの名前またはキュー エンドポイント。 正しい
Azure Storage アカウントのアクセス キー securestring 有効なプライマリ/セカンダリ ストレージ アカウントのアクセス キーを指定します。

アクセス キー (Azure Government)

認証 ID: keyBasedAuth

適用: Azure Government および米国政府の Azure Government および国防総省 (DoD) (GCC-High) のみ

Azure Queue Storage にアクセスするには、Azure Storage アカウント名 (またはキュー エンドポイント) とアクセス キーを指定します。

これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs

名前 タイプ Description 必須
Azure Storage アカウント名またはキュー エンドポイント 文字列 コネクタで使用する必要がある Azure Storage アカウントの名前またはキュー エンドポイント。 正しい
Azure Storage アカウントのアクセス キー securestring 有効なプライマリ/セカンダリ ストレージ アカウントのアクセス キーを指定します。

アクセス キー (Azure Government)

認証 ID: keyBasedAuth

適用: 米国政府 (GCC) のみ

Azure Storage アカウント名 (またはキュー エンドポイント) とアクセス キーを指定して、Azure Government の Azure Queue Storage にアクセスします。

これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs

名前 タイプ Description 必須
Azure Storage アカウント名またはキュー エンドポイント 文字列 コネクタで使用する必要がある Azure Storage アカウントの名前またはキュー エンドポイント。 正しい
Azure Storage アカウントのアクセス キー securestring 有効なプライマリ/セカンダリ ストレージ アカウントのアクセス キーを指定します。

クライアント証明書の認証

認証 ID: certOauth

適用対象: すべてのリージョン

PFX 証明書とパスワードを使用して Microsoft Entra ID 資格情報を指定する

これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs

名前 タイプ Description 必須
Tenant 文字列 正しい
クライアントID 文字列 Microsoft Entra ID アプリケーションのクライアント ID 正しい
クライアント証明書シークレット クライアント証明書 このアプリケーションで許可されるクライアント証明書シークレット 正しい
Azure Storage アカウント名またはキュー エンドポイント 文字列 Azure Storage アカウントの名前またはキュー エンドポイント 正しい

Logic Apps マネージド ID

認証 ID: managedIdentityAuth

適用: LOGICAPPS のみ

LogicApps マネージド ID を使用して接続を作成する

これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs

名前 タイプ Description 必須
LogicApps マネージド ID managedIdentity Logic Apps マネージド ID を使用してサインインする 正しい

Microsoft Entra ID 統合

認証 ID: tokenBasedAuth

適用: Azure Government および米国政府 (GCC) および米国政府 (GCC-High) の Azure Government および国防総省 (DoD) を除くすべてのリージョン

Microsoft Entra ID を使用して Azure Queue Storage にアクセスします。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

Microsoft Entra ID Integrated (Azure Government)

認証 ID: tokenBasedAuth

適用: Azure Government および米国政府の Azure Government および国防総省 (DoD) (GCC-High) のみ

Microsoft Entra ID を使用して Azure Queue Storage にアクセスします。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

Microsoft Entra ID Integrated (Azure Government)

認証 ID: tokenBasedAuth

適用: 米国政府 (GCC) のみ

Microsoft Entra ID を使用して、Azure Government の Azure Queue Storage にアクセスします。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

既定 [非推奨]

適用対象: すべてのリージョン

このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前 タイプ Description 必須
Azure Storage アカウント名またはキュー エンドポイント 文字列 Azure Storage アカウントの名前またはキュー エンドポイント 正しい
共有ストレージ キー securestring ストレージ アカウントの共有ストレージ キー 正しい

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 1200 60 秒
トリガーポーリングの頻度 1 60 秒

アクション

キューにメッセージを配置する (V2)

指定されたキューにメッセージを追加します。

キューにメッセージを配置する [非推奨]

このアクションは非推奨になりました。 代わりに キュー (V2) にメッセージを配置 してください。

指定されたキューにメッセージを追加します。

キューの一覧表示 (V2)

ストレージ アカウントのすべてのキューを一覧表示します。

キューの一覧表示 [非推奨]

このアクションは非推奨になりました。 代わりに List キュー (V2) を使用してください。

ストレージ アカウントのすべてのキューを一覧表示します。

メッセージの削除 (V2)

キューから特定のメッセージを削除します。

メッセージの削除 [非推奨]

このアクションは非推奨になりました。 代わりに Delete メッセージ (V2) を使用してください。

キューから特定のメッセージを削除します。

メッセージの取得 [非推奨]

このアクションは非推奨になりました。 代わりに メッセージの取得 (V2) を使用してください。

キューから特定のメッセージ セットを取得します。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

メッセージを取得する (V2)

キューから特定のメッセージ セットを取得します。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

新しいキューを作成する (V2)

アカウントにキューを追加します。

新しいキューを作成する [非推奨]

このアクションは非推奨になりました。 代わりに 、新しいキューの作成 (V2) を使用してください。

アカウントにキューを追加します。

キューにメッセージを配置する (V2)

指定されたキューにメッセージを追加します。

パラメーター

名前 キー 必須 説明
ストレージ アカウント名またはキュー エンドポイント
storageAccountName True string

Azure Storage アカウント名またはキュー エンドポイント。

キュー名
queueName True string

メッセージを配置するキュー。

メッセージ
message True string

キューに投稿するメッセージの内容。

キューにメッセージを配置する [非推奨]

このアクションは非推奨になりました。 代わりに キュー (V2) にメッセージを配置 してください。

指定されたキューにメッセージを追加します。

パラメーター

名前 キー 必須 説明
キュー名
queueName True string

メッセージを配置するキュー。

メッセージ
message True string

キューに投稿するメッセージの内容。

キューの一覧表示 (V2)

ストレージ アカウントのすべてのキューを一覧表示します。

パラメーター

名前 キー 必須 説明
ストレージ アカウント名またはキュー エンドポイント
storageAccountName True string

Azure Storage アカウント名またはキュー エンドポイント。

戻り値

アイテム
QueueArray

キューの一覧表示 [非推奨]

このアクションは非推奨になりました。 代わりに List キュー (V2) を使用してください。

ストレージ アカウントのすべてのキューを一覧表示します。

戻り値

アイテム
QueueArray

メッセージの削除 (V2)

キューから特定のメッセージを削除します。

パラメーター

名前 キー 必須 説明
ストレージ アカウント名またはキュー エンドポイント
storageAccountName True string

Azure Storage アカウント名またはキュー エンドポイント。

キュー名
queueName True string

メッセージを削除するキュー。

メッセージ ID
messageId True string

削除するメッセージの ID。

Pop Receipt
popreceipt True string

メッセージの取得に対する以前の呼び出しから返された有効なポップレシート値。

メッセージの削除 [非推奨]

このアクションは非推奨になりました。 代わりに Delete メッセージ (V2) を使用してください。

キューから特定のメッセージを削除します。

パラメーター

名前 キー 必須 説明
キュー名
queueName True string

メッセージを削除するキュー。

メッセージ ID
messageId True string

削除するメッセージの ID。

Pop Receipt
popreceipt True string

メッセージの取得に対する以前の呼び出しから返された有効なポップレシート値。

メッセージの取得 [非推奨]

このアクションは非推奨になりました。 代わりに メッセージの取得 (V2) を使用してください。

キューから特定のメッセージ セットを取得します。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

パラメーター

名前 キー 必須 説明
キュー名
queueName True string

メッセージを取得するキュー。

メッセージの数
numofmessages string

キューから取得するメッセージの数 (既定値は 1)。

可視性のタイムアウト
visibilitytimeout string

メッセージが他のコンシューマーから見えなくなる時間 (既定値は 30)。

戻り値

Body
Messages

メッセージを取得する (V2)

キューから特定のメッセージ セットを取得します。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

パラメーター

名前 キー 必須 説明
ストレージ アカウント名またはキュー エンドポイント
storageAccountName True string

Azure Storage アカウント名またはキュー エンドポイント。

キュー名
queueName True string

メッセージを取得するキュー。

メッセージの数
numofmessages string

キューから取得するメッセージの数 (既定値は 1)。

可視性のタイムアウト
visibilitytimeout string

メッセージが他のコンシューマーから見えなくなる時間 (既定値は 30)。

戻り値

Body
Messages

新しいキューを作成する (V2)

アカウントにキューを追加します。

パラメーター

名前 キー 必須 説明
ストレージ アカウント名またはキュー エンドポイント
storageAccountName True string

Azure Storage アカウント名またはキュー エンドポイント。

キュー名
queueName True string

作成するキューの名前。

戻り値

response
string

新しいキューを作成する [非推奨]

このアクションは非推奨になりました。 代わりに 、新しいキューの作成 (V2) を使用してください。

アカウントにキューを追加します。

パラメーター

名前 キー 必須 説明
キュー名
queueName True string

作成するキューの名前。

戻り値

response
string

トリガー

キューにメッセージがある場合 (V2)

キューにメッセージが存在するたびにトリガーされ、最大 32 個のメッセージが返されます。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

キューにメッセージがある場合 [非推奨]

このアクションは非推奨になりました。 代わりに キュー (V2) にメッセージがある場合 に使用してください。

キューにメッセージが存在するたびにトリガーされ、最大 32 個のメッセージが返されます。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

指定された数のメッセージが特定のキューにある場合 (V2)

指定した数のメッセージが特定のキューにあるときにトリガーされます。

指定された数のメッセージが特定のキューにある場合 [DEPRECATED]

このアクションは非推奨になりました。 代わりに 、指定した数のメッセージが特定のキュー (V2) にある場合 に使用してください。

指定した数のメッセージが特定のキューにあるときにトリガーされます。

キューにメッセージがある場合 (V2)

キューにメッセージが存在するたびにトリガーされ、最大 32 個のメッセージが返されます。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

パラメーター

名前 キー 必須 説明
ストレージ アカウント名またはキュー エンドポイント
storageAccountName True string

Azure Storage アカウント名またはキュー エンドポイント。

キュー名
queueName True string

メッセージを確認するキュー

可視性のタイムアウト
visibilitytimeout string

メッセージが他のコンシューマーから見えなくなる時間 (既定値は 30)

戻り値

Body
Messages

キューにメッセージがある場合 [非推奨]

このアクションは非推奨になりました。 代わりに キュー (V2) にメッセージがある場合 に使用してください。

キューにメッセージが存在するたびにトリガーされ、最大 32 個のメッセージが返されます。 メッセージは非表示になりますが、削除アクションが使用されるまでキューに残ります。

パラメーター

名前 キー 必須 説明
キュー名
queueName True string

メッセージを確認するキュー

可視性のタイムアウト
visibilitytimeout string

メッセージが他のコンシューマーから見えなくなる時間 (既定値は 30)

戻り値

Body
Messages

指定された数のメッセージが特定のキューにある場合 (V2)

指定した数のメッセージが特定のキューにあるときにトリガーされます。

パラメーター

名前 キー 必須 説明
ストレージ アカウント名またはキュー エンドポイント
storageAccountName True string

Azure Storage アカウント名またはキュー エンドポイント。

キュー名
queueName True string

メッセージをチェックするキュー。

しきい値
threshold True integer

トリガーの起動を待機するメッセージの数。

戻り値

response
string

指定された数のメッセージが特定のキューにある場合 [DEPRECATED]

このアクションは非推奨になりました。 代わりに 、指定した数のメッセージが特定のキュー (V2) にある場合 に使用してください。

指定した数のメッセージが特定のキューにあるときにトリガーされます。

パラメーター

名前 キー 必須 説明
キュー名
queueName True string

メッセージをチェックするキュー。

しきい値
threshold True integer

トリガーの起動を待機するメッセージの数。

戻り値

response
string

定義

待ち行列

名前 パス 説明
名前
Name string

キューの名前。

QueueArray

名前 パス 説明
アイテム
Queue

Messages

名前 パス 説明
QueueMessage
QueueMessagesList.QueueMessage array of object
メッセージ ID
QueueMessagesList.QueueMessage.MessageId string

メッセージの一意識別子。

挿入時間
QueueMessagesList.QueueMessage.InsertionTime string

メッセージがキューに挿入された時刻。

有効期限
QueueMessagesList.QueueMessage.ExpirationTime string

メッセージがキューから期限切れになる時刻。

Pop Receipt
QueueMessagesList.QueueMessage.PopReceipt string

キューからメッセージをポップした後にメッセージを削除するために使用されます。

次の表示時間
QueueMessagesList.QueueMessage.TimeNextVisible string

メッセージが他のコンシューマーに表示される時刻。

メッセージ テキスト
QueueMessagesList.QueueMessage.MessageText string

メッセージのテキスト。

文字列

これは基本的なデータ型 'string' です。