Azure CLI-Skriptbeispiel – Erstellen einer Logik-App

Artikel
01/04/2024

Gilt für: Azure Logic Apps (Verbrauch)

Dieses Skript erstellt eine Beispiel-Logik-App über die Logic Apps-Erweiterung in der Azure CLI (az logic). Eine ausführliche Anleitung zum Erstellen und Verwalten von Logik-Apps über die Azure CLI finden Sie im Logic Apps-Schnellstart für die Azure CLI.

Warnung

Die Logic Apps-Erweiterung für die Azure-Befehlszeilenschnittstelle ist derzeit eine experimentelle Erweiterung, für die kein Kundensupport bereitgestellt wird. Verwenden Sie diese CLI-Erweiterung mit Bedacht – insbesondere in Produktionsumgebungen.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen.
Installation der Azure-Befehlszeilenschnittstelle auf Ihrem lokalen Computer.
Installation der Logic Apps-Erweiterung für die Azure-Befehlszeilenschnittstelle auf Ihrem Computer. Verwenden Sie zum Installieren dieser Erweiterung den folgenden Befehl: az extension add --name logic
Eine Workflowdefinition für Ihre Logik-App. Diese JSON-Datei muss das Schema für die Workflowdefinitionssprache einhalten.
Eine API-Verbindung zu einem E-Mail-Konto über einen unterstützten Azure Logic Apps-Connector in derselben Ressourcengruppe wie Ihre Logik-App. In diesem Beispiel wird der Outlook 365-Connector verwendet, aber Sie können auch andere Connectors wie Outlook.com verwenden.

Prüfen der Voraussetzungen

Überprüfen Sie Ihre Umgebung, bevor Sie beginnen:

Melden Sie sich beim Azure-Portal an, und führen Sie az login aus, um sich zu vergewissern, dass Ihr Abonnement aktiv ist.
Überprüfen Sie Ihre Version der Azure-Befehlszeilenschnittstelle, indem Sie in einem Terminal oder Befehlsfenster az --versionausführen. Die neueste Version finden Sie unter Versionshinweise für die Azure CLI.
- Sollten Sie nicht über die neueste Version verfügen, aktualisieren Sie Ihre Installation wie unter Installieren der Azure CLI beschrieben.

Erläuterung des Beispielworkflows

Diese Definitionsdatei für den Beispiel-Workflow erstellt dasselbe einfache Beispiel für einen Logik-App-Verbrauchs-Workflow wie der Schnellstart für das Azure-Portal.

Dieser Beispielworkflow:

Gibt ein Schema namens $schema für die Logik-App an.
Definiert einen Trigger für die Logik-App in der Liste der Trigger (triggers). Der Trigger wird alle 3 Stunden wiederholt (recurrence). Die Aktionen werden ausgelöst, wenn ein neues Feedelement für den angegebenen RSS-Feed (feedUrl) veröffentlicht wird (When_a_feed_item_is_published).
Definiert eine Aktion für die Logik-App in der Liste der Aktionen (actions). Die Aktion sendet eine E-Mail (Send_an_email_(V2)) über Microsoft 365 mit Details aus den RSS-Feedelementen, wie im Textabschnitt (body) der Eingaben (inputs) der Aktion angegeben.

Definition des Beispielworkflows

Bevor Sie das Beispielskript ausführen, müssen Sie zunächst eine Beispielworkflowdefinition erstellen.

Erstellen Sie eine JSON-Datei namens testDefinition.json auf Ihrem Computer.

Kopieren Sie den folgenden Inhalt in die JSON-Datei:


{
    "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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/office365",
                    "connectionName": "office365",
                    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/office365"
                },
                "rss": {
                    "connectionId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testResourceGroup/providers/Microsoft.Web/connections/rss",
                    "connectionName": "rss",
                    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/westus/managedApis/rss"
                }
            }
        }
    }
}

Aktualisieren Sie die Platzhalterwerte durch Ihre eigenen Informationen:
1. Ersetzen Sie die Platzhalteradresse ("To": "test@example.com"). Sie müssen eine E-Mail-Adresse verwenden, die mit Logic Apps-Connectors kompatibel ist. Weitere Informationen finden Sie unter Voraussetzungen.
2. Ersetzen Sie zusätzliche Connectordetails, wenn Sie einen anderen E-Mail-Connector als den Office 365 Outlook-Connector verwenden.
3. Ersetzen Sie die Platzhalter-Abonnementwerte (00000000-0000-0000-0000-000000000000) für Ihre Verbindungsbezeichner (connectionId und id) unter dem connections-Parameter ($connections) durch Ihre eigenen Abonnementwerte.
Speichern Sie die Änderungen.

Beispielskript

Hinweis

Dieses Beispiel wurde für die bash-Shell geschrieben. Wenn Sie dieses Beispiel in einer anderen Shell ausführen möchten, z. B. in Windows PowerShell oder in der Eingabeaufforderung, müssen Sie möglicherweise Änderungen am Skript vornehmen.

Bevor Sie dieses Beispielskript ausführen, führen Sie diesen Befehl aus, um eine Verbindung mit Azure herzustellen:


az login

Navigieren Sie als Nächstes zu dem Verzeichnis, in dem Sie Ihre Workflowdefinition erstellt haben. Wenn Sie z. B. die JSON-Workflowdefinitionsdatei auf Ihrem Desktop erstellt haben:


cd ~/Desktop

Führen Sie dieses Skript aus, um eine Logik-App zu erstellen.


#!/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"

Bereinigen der Bereitstellung

Nachdem Sie die Verwendung des Beispielskripts beendet haben, führen Sie den folgenden Befehl aus, um Ihre Ressourcengruppe und alle deren geschachtelten Ressourcen, einschließlich der Logik-App, zu entfernen.


az group delete --name testResourceGroup --yes

Erläuterung des Skripts

In diesem Beispielskript werden die folgenden Befehle verwendet, um eine neue Ressourcengruppe und eine Logik-App zu erstellen.

Get-Help	Notizen
`az group create`	Erstellt eine Ressourcengruppe, in der die Ressourcen Ihrer Logik-App gespeichert sind.
`az logic workflow create`	Erstellt eine Logik-App auf Grundlage des im Parameter `--definition` definierten Workflows.
`az group delete`	Löscht eine Ressourcengruppe und alle ihre geschachtelten Ressourcen.

Nächste Schritte

Weitere Informationen zur Azure-Befehlszeilenschnittstelle finden Sie in der Azure CLI-Dokumentation.

Weitere CLI-Skriptbeispiele für Logik-Apps finden Sie Browser für Codebeispiele von Microsoft.

Freigeben über