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" になります。 複数のアカウントがある場合は、使用するアカウントを指定し、[ 作成] を選択します。 作成中にエラーが表示された場合は、アカウント名とキーを確認して、もう一度やり直してください。
これで、この統合の使用を開始する準備ができました。
既知の問題と制限事項
- ロジック アプリは、両方が同じリージョンにある場合、ファイアウォールの背後にあるストレージ アカウントに直接アクセスすることはできません。 回避策として、ロジック アプリとストレージ アカウントをさまざまなリージョンに配置できます。 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" 操作を使用する場合は、キュー エンドポイントも
"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 を使用
- Microsoft Azure で、接続する Azure Storage アカウントに移動します
- [
Settingsセクション (左側のブレード) で、Endpoints - キュー エンドポイントは、
queue serviceテキスト ボックスの [キュー サービス] の下にあります。
ストレージ アカウントの使用 - プロパティの取得 REST API 呼び出し
- Azure Storage アカウントの
subscription Idとresource group nameを取得します。 - ストレージ アカウント - プロパティの取得に移動する
- HTTP 呼び出しの右上隅にある [
Try it] ボタンをクリックします - サインイン (ユーザーはストレージ アカウントにアクセスできる必要があります)
- Azure Storage アカウントが配置されている Azure テナントを選択する
- Azure Storage のアカウント名、リソース グループ名を入力し、ストレージ アカウントがあるサブスクリプションを選択します。
- クリック
Run - キュー エンドポイントは、応答
queueオブジェクトの下primaryEndpointsプロパティに配置されます
- Azure Storage アカウントの
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| アクセス キー | 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
キューの一覧表示 [非推奨]
メッセージの削除 (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) にメッセージがある場合 に使用してください。
|
| 指定された数のメッセージが特定のキューにある場合 (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' です。