Azure CLI のサンプルスクリプト - ロジックアプリを作成する

[アーティクル]
01/04/2024

適用対象: Azure Logic Apps (従量課金)

このスクリプトでは、Azure CLI Logic Apps 拡張機能 (az logic) を使用して、サンプルのロジックアプリを作成します。 Azure CLI を使用してロジックアプリを作成および管理するための詳細なガイドについては、Azure CLI の Logic Apps クイックスタートを参照してください。

警告

Azure CLI Logic Apps 拡張機能は、現在、"試験段階" であり、"カスタマーサポートの対象外" です。この CLI 拡張機能は、特に運用環境での使用を選択する場合、慎重に使用してください。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。 Azure サブスクリプションをお持ちでない場合は、無料アカウントを作成してください。
ご利用のローカルコンピューターに Azure CLI がインストールされていること。
ご利用のローカルコンピューターに Azure CLI Logic Apps 拡張機能がインストールされていること。この拡張機能をインストールするには、コマンド az extension add --name logic を使用します。
ロジックアプリのワークフロー定義。この JSON ファイルは、ワークフロー定義言語スキーマに従う必要があります。
お使いのロジックアプリと同じリソースグループ内にある、サポートされている Azure Logic Apps コネクタを経由した電子メールアカウントへの API 接続。この例では Office 365 Outlook コネクタを使用しますが、Outlook.com などの他のコネクタを使用することもできます。

前提条件のチェック

開始する前に、環境を検証します。

Azure portal にサインインし、az login を実行して、ご利用のサブスクリプションがアクティブであることを確認します。
az --version を実行して、ターミナルまたはコマンドウィンドウの Azure CLI のバージョンを確認します。最新バージョンについては、最新のリリースノートを参照してください。
- 最新バージョンを使用していない場合は、オペレーティングシステムまたはプラットフォーム用のインストールガイドに従ってインストールを更新します。

サンプルワークフローの説明

このサンプルワークフローの定義ファイルでは、Azure portal のクイックスタートと同じ、基本的な従量課金ロジックアプリワークフローの例を作成します。

このサンプルワークフローでは、次のことを行います。

ロジックアプリのスキーマ ($schema) を指定します。
トリガーの一覧 (triggers) にロジックアプリのトリガーを定義します。トリガーは、3 時間ごとに繰り返されます (recurrence)。アクションは、指定された RSS フィード (feedUrl) に対して新しいフィード項目が発行されたとき (When_a_feed_item_is_published) にトリガーされます。
アクションの一覧 (actions) にロジックアプリのアクションを定義します。このアクションによって、アクションの入力 (inputs) の本文セクション (body) で指定されている RSS フィード項目の詳細が Microsoft 365 経由で電子メールで送信されます (Send_an_email_(V2))。

サンプルワーフクローの定義

サンプルスクリプトを実行する前に、最初にサンプルワークフローの定義を作成する必要があります。

お使いのコンピューターに JSON ファイル testDefinition.json を作成します。

次の内容をその JSON ファイルにコピーします。


{
    "definition": {
        "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
        "actions": {
            "Send_an_email_(V2)": {
                "inputs": {
                    "body": {
                        "Body": "<p>@{triggerBody()?['publishDate']}<br>\n@{triggerBody()?['title']}<br>\n@{triggerBody()?['primaryLink']}</p>",
                        "Subject": "@triggerBody()?['title']",
                        "To": "test@example.com"
                    },
                    "host": {
                        "connection": {
                            "name": "@parameters('$connections')['office365']['connectionId']"
                        }
                    },
                    "method": "post",
                    "path": "/v2/Mail"
                },
                "runAfter": {},
                "type": "ApiConnection"
            }
        },
        "contentVersion": "1.0.0.0",
        "outputs": {},
        "parameters": {
            "$connections": {
                "defaultValue": {},
                "type": "Object"
            }
        },
        "triggers": {
            "When_a_feed_item_is_published": {
                "inputs": {
                    "host": {
                        "connection": {
                            "name": "@parameters('$connections')['rss']['connectionId']"
                        }
                    },
                    "method": "get",
                    "path": "/OnNewFeed",
                    "queries": {
                        "feedUrl": "https://www.pbs.org/now/rss.xml"
                    }
                },
                "recurrence": {
                    "frequency": "Hour",
                    "interval": 3
                },
                "splitOn": "@triggerBody()?['value']",
                "type": "ApiConnection"
            }
        }
    },
    "parameters": {
        "$connections": {
            "value": {
                "office365": {
                    "connectionId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/office365",
                    "connectionName": "office365",
                    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/locations/westus/managedApis/office365"
                },
                "rss": {
                    "connectionId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/rss",
                    "connectionName": "rss",
                    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Web/locations/westus/managedApis/rss"
                }
            }
        }
    }
}

プレースホルダーの値を独自の情報に更新します。
1. プレースホルダーの電子メールアドレス ("To": "test@example.com") を置き換えます。 Logic Apps コネクタと互換性のある電子メールアドレスを使用する必要があります。詳細については、前提条件を参照してください。
2. Office 365 Outlook コネクタとは異なる電子メールコネクタを使用している場合は、追加のコネクタの詳細情報を置き換えます。
3. connections パラメーター ($connections) の下にある接続識別子 (connectionId と id) のプレースホルダーサブスクリプション値 (00000000-0000-0000-0000-000000000000) を独自のサブスクリプション値に置き換えます。
変更を保存します。

サンプルスクリプト

注意

このサンプルは、bash シェル用に記述されています。このサンプルを別のシェル (Windows PowerShell、コマンドプロンプトなど) で実行する場合は、スクリプトに変更を加える必要がある場合があります。

このサンプルスクリプトを実行する前に、このコマンドを実行して Azure に接続します。


az login

次に、ワークフロー定義を作成したディレクトリに移動します。たとえば、ワークフロー定義の JSON ファイルをデスクトップに作成した場合は、次のようになります。


cd ~/Desktop

次に、このスクリプトを実行してロジックアプリを作成します。


#!/bin/bash

# Create a resource group

az group create --name testResourceGroup --location westus

# Create your logic app

az logic workflow create --resource-group "testResourceGroup" --location "westus" --name "testLogicApp" --definition "testDefinition.json"

デプロイのクリーンアップ

サンプルスクリプトの使用が完了したら、次のコマンドを実行して、リソースグループと、そのすべての入れ子になったリソース (ロジックアプリを含む) を削除します。


az group delete --name testResourceGroup --yes

スクリプトの説明

このサンプルスクリプトでは、次のコマンドを使用して新しいリソースグループとロジックアプリを作成します。

command	メモ
`az group create`	ロジックアプリのリソースを格納するリソースグループを作成します。
`az logic workflow create`	パラメーター `--definition` で定義されているワークフローに基づいてロジックアプリを作成します。
`az group delete`	リソースグループと、そのすべての入れ子になったリソースを削除します。

次のステップ

Azure CLI の詳細については、Azure CLI のドキュメントのページを参照してください。

その他の Logic Apps CLI スクリプトのサンプルについては、Microsoft のコードサンプルブラウザーを参照してください。

Azure CLI のサンプル スクリプト - ロジック アプリを作成する

前提条件

前提条件のチェック

サンプル ワークフローの説明

サンプル ワーフクローの定義

サンプル スクリプト