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
必須パラメーター
サービス プロバイダー コネクタ (例: "serviceBus")。
ワークフローによって参照される接続名。 --managed-api では、これは代わりにロジック アプリ名であり、接続の名前は --connection-name です。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
NAME=VALUE、反復可能なシークレット以外のアプリ設定。 アプリ構成から提供されるパラメーターの local.settings.json に書き込まれます。
接続で使用される認証。 oauth は同意のためにブラウザーを開きます。 --managed-api で必要です。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | managed-identity, oauth, raw, service-principal |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
作成するマネージド API 接続の名前。 --managed-api で必要です。
失敗する前にブラウザーの同意を待機する秒数。 デフォルトは 300 です。 接続/アクセス ポリシー リソースは保持できます。は、再試行する前に検査します。 --auth-mode oauth のみを使用します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | OAuth consent Arguments |
名前付きローカル プロジェクト コンテキスト。 クラウド コンテキストは拒否されます。レガシ --managed-api モードでは使用できません。
接続の表示名。 既定値は --connection-name です。
既存の接続またはアプリの設定を置き換えます。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
接続とそのマネージド API の場所をAzureします。 --managed-api で必要です。
互換性モードが非推奨になりました。 接続マネージド作成 --name CONNECTION --logic-app-name APP を優先します。 従来の名前は、引き続きアプリを意味します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
ブラウザーを起動するのではなく、同意 URL を印刷します。 コマンドは引き続きリダイレクトをリッスンするため、ブラウザーはループバックでこのマシンに到達できる必要があります。 --auth-mode oauth のみを使用します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | OAuth consent Arguments |
| 規定値: | False |
.gitignore に local.settings.json を追加しないでください。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
NAME=VALUE、反復可能な接続パラメーター。 ドットを使用して入れ子にする (authProvider.Type=ManagedServiceIdentity など)。 値はシークレットにすることはできません。
コネクタ パラメーター セット名。 既定値は connectionString です。
既存のプロジェクト ルート。 既定では、ローカル コンテキスト パスまたは現在のディレクトリが使用されます。
ロジック アプリのリソース グループ。 --managed-api で必要です。
シークレットを保持するアプリ設定の名前。 値は標準入力から読み取られ、コマンド ラインからは読み取られます。 ID ベースの接続の場合は省略します。
シークレットがバインドされるパラメーター パス。 既定値は connectionString です。
アプリに既に割り当てられているユーザー割り当て ID のリソース ID。 既定値はシステム割り当て ID です。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須パラメーター
connections.jsonの接続名。
ロジック アプリ Standard サイトの名前。
ロジック アプリ Standard サイトを含むリソース グループの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
検索する接続クラス。 両方のクラスに同じ名前が存在する場合にのみ必要です。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | managedApiConnections, serviceProviderConnections |
ARM 接続リソースを保持します。 このアプリが排他的に所有するアクセス ポリシーのみを削除します。共有ユーザー割り当て ID ポリシーは保持されます。 マネージド API 接続のみ。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
確認のダイアログを表示しません。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須パラメーター
ロジック アプリ Standard サイトの名前。
ロジック アプリ Standard サイトを含むリソース グループの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
次のページをフェッチするために、前の呼び出しによって nextContinuationToken として返されるトークン。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Pagination Arguments |
このページで返される接続の最大数。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Pagination Arguments |
接続ランタイムの URL を表示します。 既定では、編集が行われます。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須パラメーター
connections.jsonの接続名。
ロジック アプリ Standard サイトの名前。
ロジック アプリ Standard サイトを含むリソース グループの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
検索する接続クラス。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | managedApiConnections, serviceProviderConnections |
接続ランタイムの URL を表示します。 既定では、編集が行われます。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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
必須パラメーター
接続名または ARM Microsoft。Web/接続 ID。
ロジック アプリ Standard サイトの名前。
ロジック アプリ Standard サイトを含むリソース グループの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
--connection が名前の場合に検索する接続クラス。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | managedApiConnections, serviceProviderConnections |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |