az logicapp connection

Note

このリファレンスは、Azure CLI (バージョン 2.67.0 以降) の logicapp 拡張機能の一部です。 拡張機能は、 az logicapp connection コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

ローカルで作成し、デプロイされた Logic Apps Standard 接続を検査します。

コマンド

Name 説明 型 状態
az logicapp connection acl

マネージド API 接続のアクセス ポリシーを管理します。

Extension GA
az logicapp connection acl add

マネージド API 接続へのアクセス権を Entra ID に付与します。

Extension GA
az logicapp connection acl list

マネージド API 接続のアクセス ポリシーを一覧表示します。

Extension GA
az logicapp connection acl remove

マネージド API 接続からアクセス ポリシーを削除します。

Extension GA
az logicapp connection acl show

マネージド API 接続に対して 1 つのアクセス ポリシーを表示します。

Extension GA
az logicapp connection create

ローカル プロジェクトにサービス プロバイダー接続を追加するか、デプロイされたアプリにマネージド API 接続を追加します。

Extension GA
az logicapp connection delete

デプロイされたロジック アプリから接続を削除します。

Extension GA
az logicapp connection list

デプロイされた Logic App Standard アプリに接続された接続を一覧表示します。

Extension GA
az logicapp connection managed

ローカル プロジェクトまたはデプロイされた Standard サイトのマネージド API 接続Azure作成します。

Extension GA
az logicapp connection managed create

Azureマネージド API 接続を作成し、ローカル プロジェクトまたはデプロイされたアプリを接続します。

Extension GA
az logicapp connection show

デプロイされたロジック アプリ Standard アプリに接続された 1 つの接続を表示します。

Extension GA
az logicapp connection test

構成された Logic Apps Standard 接続をテストします。

Extension GA

az logicapp connection create

ローカル プロジェクトにサービス プロバイダー接続を追加するか、デプロイされたアプリにマネージド API 接続を追加します。

2 つのモード。 既定では、サービス プロバイダー接続がローカル プロジェクトに書き込まれます。 --managed-api を使用すると、代わりにデプロイされたロジック アプリのAzureマネージド API 接続が作成されます。--name は接続ではなくロジック アプリを意味し、接続に --connection-name という名前を付けます。

ローカル モード: 接続を connections.json に書き込み、任意のシークレット値を local.settings.jsonに書き込みます。デプロイ パッケージは除外します。 コマンド ラインでシークレットを受け入れることはありません。--secret はアプリ設定に名前を付け、値は標準入力から読み取られます。 ID ベースの接続の場合、--secret を完全に省略し、代わりに --parameter NAME=VALUE を指定します。ドットは値を入れ子にするため、authProvider.Type は入れ子になったオブジェクトになります。これはランタイムに必要です。 アプリ構成から提供されるパラメーターには、一致する --app-setting が必要です。 --no-gitignore が指定されていない限り、local.settings.json は .gitignore に追加されます。 べき等ではない: 接続またはアプリの設定が既に存在する場合は失敗するため、--force でのみ再試行しても安全です。

マネージド API モード (---managed-api): 3 つの結合された処理が作成されます。最初のものだけが使用できないため、ARM Microsoft。Web/接続リソース、アプリのマネージド ID に名前を付けるアクセス ポリシー、アプリの connections.json内の managedApiConnections エントリ。 V1 接続はアクセス ポリシーを拒否し、後で種類を変更できないため、接続は常に V2 の種類で作成されます。 アプリには既にマネージド ID が必要です。1 つを指定しないと、コマンドは何も作成する前に停止します。 ARM の変異の前に、強力な VFS ETag を持つ既存の有効な connections.json も必要です。 ファイルが見つからないか、バージョン管理されていない/弱いリビジョンが閉じられました。CLI では、非修飾の作成のみのファイル書き込みは試行されません。 パブリケーションとファイルエントリの復元では、完全に新しい再読み込み ETag が使用され、ワイルドカードは使用されません。 リビジョンの競合は再試行されません。ファイル ガードは ARM トランザクションではありません。 --auth-mode oauth は、接続を承認できるようにブラウザーを開きます。 CLI は、ループバック ポートでリダイレクトをリッスンします。これは、同意が完了したことを学習する方法です。同意サービスは承認コード自体を引き換えるので、通常、コールバックはコードを保持せず、それ以上何も確認されません。 ヘッドレス コンピューターで --no-browser を使用して、URL を起動するのではなく印刷します。 同意、アクセス ポリシーの作成、または connections.json の配線に失敗した場合、ARM リソースとアクセス ポリシーは手動で検査するために保持されます。 無条件 PUT は、フライト前の不在後でも、別のライターのリソースを更新できます。自動削除またはポリシーの復元は承認されません。 プロパティ、資格情報、またはアクセス許可が変更されている可能性があります。 再試行する前に、保持状態を調べて意図的に回復します。--force はコンカレンシーの保証ではありません。 保護されたファイルエントリの復元のみが試行されます。 既存の資格情報を ARM リードバックから常に復旧できるとは限りません。 読み取り不可または形式が正しくない既存の connections.json は、空のファイルに置き換えまれません。

Windows PowerShell では、@appsetting('NAME') 値が az にそのまま到達する必要があります。 PowerShell は引用符で囲まれていないかっこを cmd.exeに転送します。これにより、az.cmd内の IF EXIST ブロックが終了し、"--parameter was unexpected at this time" で失敗します。 最初の --parameter の直前に PowerShell の停止解析トークンを挿入して、残りの行を解析解除で渡します。

az logicapp connection create --connector
                              --name
                              [--acquire-policy-token]
                              [--app-setting]
                              [--auth-mode {managed-identity, oauth, raw, service-principal}]
                              [--change-reference]
                              [--connection-name]
                              [--consent-timeout]
                              [--context]
                              [--display-name]
                              [--force]
                              [--location]
                              [--managed-api]
                              [--no-browser]
                              [--no-gitignore]
                              [--parameter]
                              [--parameter-set]
                              [--path]
                              [--resource-group]
                              [--secret]
                              [--secret-parameter]
                              [--user-assigned-identity]

例

Service Bus接続を追加します。値はパイプ処理されます (PowerShell)。

$env:SB_CONNECTION | az logicapp connection create --path .\orders --name serviceBus --connector serviceBus --secret serviceBus_connectionString

Service Bus接続(bash)でパイプされた値を追加します。

printf '%s' "$SB_CONNECTION" | az logicapp connection create --path ./orders --name serviceBus --connector serviceBus --secret serviceBus_connectionString

シークレットのないマネージド ID を使用するService Bus接続を追加します。

az logicapp connection create --path ./orders --name serviceBus --connector serviceBus --parameter-set ManagedServiceIdentity --parameter "fullyQualifiedNamespace=@appsetting('serviceBus_fullyQualifiedNamespace')" authProvider.Type=ManagedServiceIdentity --app-setting serviceBus_fullyQualifiedNamespace=contoso.servicebus.windows.net

アプリの ID として認証するAzure BLOB マネージド API 接続を作成します。

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name blobProd --connector azureblob -l eastus --auth-mode managed-identity

Office 365接続を作成し、ブラウザーで承認します。

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name outlook --connector office365 -l eastus --auth-mode oauth

同じように、ヘッドレス コンピューターでは、ブラウザーを開くのではなく、同意 URL を印刷します。

az logicapp connection create --managed-api -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection-name outlook --connector office365 -l eastus --auth-mode oauth --no-browser

必須パラメーター

--connector

サービス プロバイダー コネクタ (例: "serviceBus")。

--name -n

ワークフローによって参照される接続名。 --managed-api では、これは代わりにロジック アプリ名であり、接続の名前は --connection-name です。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--app-setting

NAME=VALUE、反復可能なシークレット以外のアプリ設定。 アプリ構成から提供されるパラメーターの local.settings.json に書き込まれます。

--auth-mode

接続で使用される認証。 oauth は同意のためにブラウザーを開きます。 --managed-api で必要です。

プロパティ 値
指定可能な値: managed-identity, oauth, raw, service-principal
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--connection-name

作成するマネージド API 接続の名前。 --managed-api で必要です。

--consent-timeout

失敗する前にブラウザーの同意を待機する秒数。 デフォルトは 300 です。 接続/アクセス ポリシー リソースは保持できます。は、再試行する前に検査します。 --auth-mode oauth のみを使用します。

プロパティ 値
パラメーター グループ: OAuth consent Arguments
--context

名前付きローカル プロジェクト コンテキスト。 クラウド コンテキストは拒否されます。レガシ --managed-api モードでは使用できません。

--display-name

接続の表示名。 既定値は --connection-name です。

--force

既存の接続またはアプリの設定を置き換えます。

プロパティ 値
規定値: False
--location -l

接続とそのマネージド API の場所をAzureします。 --managed-api で必要です。

--managed-api

互換性モードが非推奨になりました。 接続マネージド作成 --name CONNECTION --logic-app-name APP を優先します。 従来の名前は、引き続きアプリを意味します。

プロパティ 値
規定値: False
--no-browser

ブラウザーを起動するのではなく、同意 URL を印刷します。 コマンドは引き続きリダイレクトをリッスンするため、ブラウザーはループバックでこのマシンに到達できる必要があります。 --auth-mode oauth のみを使用します。

プロパティ 値
パラメーター グループ: OAuth consent Arguments
規定値: False
--no-gitignore

.gitignore に local.settings.json を追加しないでください。

プロパティ 値
規定値: False
--parameter

NAME=VALUE、反復可能な接続パラメーター。 ドットを使用して入れ子にする (authProvider.Type=ManagedServiceIdentity など)。 値はシークレットにすることはできません。

--parameter-set

コネクタ パラメーター セット名。 既定値は connectionString です。

--path

既存のプロジェクト ルート。 既定では、ローカル コンテキスト パスまたは現在のディレクトリが使用されます。

--resource-group -g

ロジック アプリのリソース グループ。 --managed-api で必要です。

--secret

シークレットを保持するアプリ設定の名前。 値は標準入力から読み取られ、コマンド ラインからは読み取られます。 ID ベースの接続の場合は省略します。

--secret-parameter

シークレットがバインドされるパラメーター パス。 既定値は connectionString です。

--user-assigned-identity

アプリに既に割り当てられているユーザー割り当て ID のリソース ID。 既定値はシステム割り当て ID です。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az logicapp connection delete

デプロイされたロジック アプリから接続を削除します。

connections.json エントリを削除します。 マネージド API 接続の場合、エントリの排他的に所有されているシステム割り当て ID に一致するアクセス ポリシーのみを削除でき、リソースは排他的所有権が確立されたときにのみ削除されます。 ユーザー割り当て ID は複数のアプリで共有できるため、ポリシーと接続リソースは保持され、理由が報告されます。 このアプリに割り当てられている ID は、接続所有権の証拠ではありません。 --keep-resource を渡して、排他的に所有されているポリシーであってもリソースを保持します。このフラグは、共有ユーザー割り当て ID アクセスを取り消しません。 サービス プロバイダー接続によって参照されるアプリ設定は削除されません。他の接続では引き続き読み取る可能性があるため、報告されるだけです。 削除するには、現在の connections.json から強力な ETag を再読み取りし、その正確なリビジョンを送信する必要があります。 ETag が見つからない、または弱い場合、またはリビジョンの競合が発生すると、ARM のクリーンアップや無条件の再試行なしでコマンドが停止します。 VFS レシート/リードバック チェックは引き続き必要です。これらはリソース間トランザクションではありません。 作成されたマネージド接続 ID は、選択したサブスクリプションとリソース グループの正規の相対リソース ID である必要があります。 絶対 ID、形式が正しくない ID、またはクロススコープ ID は、接続リソースの ARM アクセスまたはリンク解除 (--keep-resource を含む) の前に拒否します。 クロススコープ リソースを明示的に管理します。

az logicapp connection delete --connection
                              --name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--class {managedApiConnections, serviceProviderConnections}]
                              [--keep-resource]
                              [--yes]

例

メッセージを表示せずに、アプリから接続を削除します。

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection cliPilotBlob --yes

このアプリのエントリと排他的に所有されているポリシーを削除し、リソースを保持します。

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection sharedBlob --keep-resource --yes

両方の接続クラスに存在する名前を明確にします。

az logicapp connection delete -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection blob --class managedApiConnections --yes

必須パラメーター

--connection

connections.jsonの接続名。

--name -n

ロジック アプリ Standard サイトの名前。

--resource-group -g

ロジック アプリ Standard サイトを含むリソース グループの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--class

検索する接続クラス。 両方のクラスに同じ名前が存在する場合にのみ必要です。

プロパティ 値
指定可能な値: managedApiConnections, serviceProviderConnections
--keep-resource

ARM 接続リソースを保持します。 このアプリが排他的に所有するアクセス ポリシーのみを削除します。共有ユーザー割り当て ID ポリシーは保持されます。 マネージド API 接続のみ。

プロパティ 値
規定値: False
--yes -y

確認のダイアログを表示しません。

プロパティ 値
規定値: False
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az logicapp connection list

デプロイされた Logic App Standard アプリに接続された接続を一覧表示します。

ARM VFS プロキシを介してアプリの connections.json ファイルのみを読み取ります。 これは、ワークフローで使用できるファイルプレーンの配線です。ARM Microsoftに対して調整されません。Web/接続リソースであるため、ARM によって作成されたが、未接続の接続と未接続のファイル参照は表示されません。 parameterValues とランタイム URL は、既定で編集されます。

az logicapp connection list --name
                            --resource-group
                            [--continuation-token --next-token]
                            [--max-items]
                            [--show-runtime-urls]

例

アプリの有線接続を一覧表示します。

az logicapp connection list --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8

ランタイム URL を含むアプリの有線接続を一覧表示します。

az logicapp connection list -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --show-runtime-urls

必須パラメーター

--name -n

ロジック アプリ Standard サイトの名前。

--resource-group -g

ロジック アプリ Standard サイトを含むリソース グループの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--continuation-token --next-token

次のページをフェッチするために、前の呼び出しによって nextContinuationToken として返されるトークン。

プロパティ 値
パラメーター グループ: Pagination Arguments
--max-items

このページで返される接続の最大数。

プロパティ 値
パラメーター グループ: Pagination Arguments
--show-runtime-urls

接続ランタイムの URL を表示します。 既定では、編集が行われます。

プロパティ 値
規定値: False
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az logicapp connection show

デプロイされたロジック アプリ Standard アプリに接続された 1 つの接続を表示します。

ARM VFS プロキシを介して connections.json のみを読み取ります。 このファイル プレーン ビューは、ARM Microsoftとは異なる場合があります。Web/接続インベントリ。 parameterValues とランタイム URL は既定で編集されます。は、現在のシェルでランタイム URL が必要な場合にのみ --show-runtime-urls を使用します。

az logicapp connection show --connection
                            --name
                            --resource-group
                            [--class {managedApiConnections, serviceProviderConnections}]
                            [--show-runtime-urls]

例

アプリの有線接続を 1 つ表示します。

az logicapp connection show --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8 --connection cliPilotBlob

マネージド クラスからの 1 つのマネージド API 接続を表示します。

az logicapp connection show -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection office365-prod --class managedApiConnections

必須パラメーター

--connection

connections.jsonの接続名。

--name -n

ロジック アプリ Standard サイトの名前。

--resource-group -g

ロジック アプリ Standard サイトを含むリソース グループの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--class

検索する接続クラス。

プロパティ 値
指定可能な値: managedApiConnections, serviceProviderConnections
--show-runtime-urls

接続ランタイムの URL を表示します。 既定では、編集が行われます。

プロパティ 値
規定値: False
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False

az logicapp connection test

構成された Logic Apps Standard 接続をテストします。

アプリの有線サービス プロバイダー接続、アプリでワイヤードされたマネージド API 接続、または ARM Microsoftをテストします。Web/connections リソース ID。アドバタイズされたテスト エンドポイントがないコネクタは正常として扱われません。コマンドは結果 noTestAvailable を報告し、接続が検証されなかったと言い、3 を終了します。 返される 5xx 応答は失敗であり、429 応答は retryAfter が指定されたときに保持されるNotReach になります。

az logicapp connection test --connection
                            --name
                            --resource-group
                            [--acquire-policy-token]
                            [--change-reference]
                            [--class {managedApiConnections, serviceProviderConnections}]

例

名前でアプリワイヤード接続をテストします。

az logicapp connection test --resource-group rg-lacli-ri2bg8 --name la-cli-pilot-ri2bg8 --connection cliPilotBlob

ID でマネージド ARM 接続リソースをテストします。

az logicapp connection test -g rg-lacli-ri2bg8 -n la-cli-pilot-ri2bg8 --connection /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-lacli-ri2bg8/providers/Microsoft.Web/connections/office365-prod

必須パラメーター

--connection

接続名または ARM Microsoft。Web/接続 ID。

--name -n

ロジック アプリ Standard サイトの名前。

--resource-group -g

ロジック アプリ Standard サイトを含むリソース グループの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ 値
パラメーター グループ: Global Policy Arguments
--class

--connection が名前の場合に検索する接続クラス。

プロパティ 値
指定可能な値: managedApiConnections, serviceProviderConnections
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ 値
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ 値
規定値: False
--output -o

出力フォーマット。

プロパティ 値
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ 値
規定値: False