Teilen über

Azure CLI-Skriptbeispiel – Erstellen einer Logik-App

Gilt für: Azure Logic Apps (Verbrauch)

Dieses Skript erstellt eine Beispiellogik-App über die Azure CLI Logic Apps-Erweiterung (az logic). Eine ausführliche Anleitung zum Erstellen und Verwalten von Logik-Apps über die Azure CLI finden Sie in der Logik-Apps-Schnellstartanleitung 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

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.

Beispiel einer Workflow-Erklärung

Diese Beispiel-Workflowdefinitionsdatei erstellt den gleichen grundlegenden Beispiel-App-Workflow für verbrauchslogik wie in der Schnellstartanleitung für das Azure-Portal.

Dieser Beispielworkflow:

  1. Gibt ein Schema $schemafür die Logik-App an.

  2. Definiert einen Trigger für die Logik-App in der Liste der Trigger. triggers Der Trigger rekursiert (recurrence) alle 3 Stunden. Die Aktionen werden ausgelöst, wenn ein neues Feedelement () für den angegebenen RSS-Feed (When_a_feed_item_is_publishedfeedUrl) veröffentlicht wird.

  3. 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.

Beispielworkflowdefinition

Bevor Sie das Beispielskript ausführen, müssen Sie zuerst eine Beispielworkflowdefinition erstellen.

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

  2. 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"
                }
            }
        }
    }
}

  3. Aktualisieren Sie die Platzhalterwerte mit Ihren eigenen Informationen:

    1. Ersetzen Sie die Platzhalter-E-Mail-Adresse ("To": "test@example.com"). Sie müssen eine E-Mail-Adresse verwenden, die mit Logic Apps-Connectors kompatibel ist. Weitere Informationen finden Sie auf der Website 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 Platzhalterabonnementwerte (00000000-0000-0000-0000-000000000000) für Ihre Verbindungs-IDs (connectionId und id) unter dem Verbindungsparameter ($connections) durch Ihre eigenen Abonnementwerte.

  4. Speichern Sie Ihre Änderungen.

Beispielskript

Hinweis

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

Führen Sie vor dem Ausführen dieses Beispielskripts 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 beispielsweise die JSON-Datei der Workflowdefinition auf Ihrem Desktop erstellt haben:


cd ~/Desktop

Führen Sie dann 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 das Beispielskript verwendet haben, führen Sie den folgenden Befehl aus, um Ihre Ressourcengruppe und alle geschachtelten Ressourcen einschließlich der Logik-App zu entfernen.


az group delete --name testResourceGroup --yes

Erklärung des Skripts

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

Befehl Hinweise
az group create Erstellt eine Ressourcengruppe, in der die Ressourcen Ihrer Logik-App gespeichert werden.
az logic workflow create Erstellt eine Logik-App basierend auf dem workflow, der im Parameter --definitiondefiniert ist.
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 Logic Apps finden Sie im Codebeispielbrowser von Microsoft.

  • Last updated on