Senden von ausgehenden Aufrufen an HTTP- oder HTTPS-Endpunkte mithilfe von Azure Logic AppsSend outgoing calls to HTTP or HTTPS endpoints by using Azure Logic Apps

Mit Azure Logic Apps und dem integrierten HTTP-Trigger oder der HTTP-Aktion können Sie automatisierte Tasks und Workflows erstellen, die regelmäßig Anforderungen an HTTP- oder HTTPS-Endpunkte senden.With Azure Logic Apps and the built-in HTTP trigger or action, you can create automated tasks and workflows that regularly send requests to any HTTP or HTTPS endpoint. Um stattdessen eingehende HTTP- oder HTTPS-Aufrufe zu empfangen und darauf zu reagieren, verwenden Sie den integrierten Anforderungstrigger oder die Antwortaktion.To receive and respond to incoming HTTP or HTTPS calls instead, use the built-in Request trigger or Response action.

So können Sie beispielsweise den Dienstendpunkt für Ihre Website überwachen, indem Sie diesen Endpunkt nach einem bestimmten Zeitplan überprüfen.For example, you can monitor the service endpoint for your website by checking that endpoint on a specified schedule. Wenn ein bestimmtes Ereignis (beispielsweise ein Ausfall Ihrer Website) an diesem Endpunkt auftritt, löst das Ereignis den Workflow Ihrer Logik-App aus und führt die angegebenen Aktionen aus.When a specific event happens at that endpoint, such as your website going down, the event triggers your logic app's workflow and runs the specified actions.

Um einen Endpunkt gemäß einem Zeitplan zu überprüfen oder abzurufen, können Sie den HTTP-Trigger als ersten Schritt in Ihrem Workflow verwenden.To check or poll an endpoint on a regular schedule, you can use the HTTP trigger as the first step in your workflow. Bei jeder Überprüfung sendet der Trigger einen Aufruf oder eine Anforderung an den Endpunkt.On each check, the trigger sends a call or request to the endpoint. Die Antwort des Endpunkts bestimmt, ob der Workflow der Logik-App ausgeführt wird.The endpoint's response determines whether your logic app's workflow runs. Der Trigger übergibt alle Inhalte aus der Antwort an die Aktionen in Ihrer Logik-App.The trigger passes along any content from the response to the actions in your logic app.

Sie können die HTTP-Aktion wie jeden anderen Schritt in Ihrem Workflow zum Abrufen des Endpunkts zum gewünschten Zeitpunkt verwenden.You can use the HTTP action as any other step in your workflow for calling the endpoint when you want. Die Antwort des Endpunkts bestimmt, wie die restlichen Aktionen des Workflows ausgeführt werden.The endpoint's response determines how your workflow's remaining actions run.

Basierend auf den Fähigkeiten des Zielendpunkts unterstützt der HTTP-Connector die TLS-Versionen (Transport Layer Security ) 1.0, 1.1 und 1.2.Based the target endpoint's capability, the HTTP connector supports Transport Layer Security (TLS) versions 1.0, 1.1, and 1.2. Logik-Apps handeln mit dem Endpunkt die Verwendung der höchstmöglich unterstützten Version aus.Logic Apps negotiates with the endpoint over using the highest supported version possible. Wenn der Endpunkt also z. B. 1.2 unterstützt, verwendet der Connector zuerst 1.2.So, for example, if the endpoint supports 1.2, the connector uses 1.2 first. Andernfalls verwendet der Connector die nächsthöhere unterstützte Version.Otherwise, the connector uses the next highest supported version.

VoraussetzungenPrerequisites

  • Ein Azure-Abonnement.An Azure subscription. Wenn Sie nicht über ein Azure-Abonnement verfügen, können Sie sich für ein kostenloses Azure-Konto registrieren.If you don't have an Azure subscription, sign up for a free Azure account.

  • Die URL für den Zielendpunkt, den Sie aufrufen möchtenThe URL for the target endpoint that you want to call

  • Grundlegende Kenntnisse über das Erstellen von Logik-Apps.Basic knowledge about how to create logic apps. Falls Sie noch nicht mit Logik-Apps vertraut sind, finden Sie weitere Informationen unter Was ist Azure Logic Apps?.If you're new to logic apps, review What is Azure Logic Apps?

  • Die Logik-App, von der aus Sie den Zielendpunkt aufrufen möchten.The logic app from where you want to call the target endpoint. Um mit dem HTTP-Trigger zu beginnen, erstellen Sie eine leere Logik-App.To start with the HTTP trigger, create a blank logic app. Um die HTTP-Aktion zu verwenden, starten Sie Ihre Logik-App mit einem beliebigen Trigger.To use the HTTP action, start your logic app with any trigger that you want. Dieses Beispiel verwendet den HTTP-Trigger als ersten Schritt.This example uses the HTTP trigger as the first step.

Hinzufügen eines HTTP-TriggersAdd an HTTP trigger

Dieser integrierte Trigger führt einen HTTP-Aufruf der angegebenen URL für einen Endpunkt aus und gibt eine Antwort zurück.This built-in trigger makes an HTTP call to the specified URL for an endpoint and returns a response.

  1. Melden Sie sich beim Azure-Portal an.Sign in to the Azure portal. Öffnen Sie Ihre leere Logik-App im Logik-App-Designer.Open your blank logic app in Logic App Designer.

  2. Geben Sie unter Aktion auswählen im Suchfeld „HTTP“ als Filter ein.Under Choose an action, in the search box, enter "http" as your filter. Wählen Sie in der Liste Trigger den HTTP-Trigger aus.From the Triggers list, select the HTTP trigger.

    Auswählen des HTTP-Triggers

    Dieses Beispiel benennt den Trigger in „HTTP trigger“ um, damit der Schritt über einen aussagekräftigeren Namen verfügt.This example renames the trigger to "HTTP trigger" so that the step has a more descriptive name. Darüber hinaus fügt das Beispiel später eine HTTP-Aktion hinzu, und beide Namen müssen eindeutig sein.Also, the example later adds an HTTP action, and both names must be unique.

  3. Geben Sie die Werte für die HTTP-Triggerparameter ein, die Sie in den Aufruf des Zielendpunkts aufnehmen möchten.Provide the values for the HTTP trigger parameters that you want to include in the call to the target endpoint. Geben Sie mithilfe einer Wiederholung an, wie oft der Trigger den Zielendpunkt überprüfen soll.Set up the recurrence for how often you want the trigger to check the target endpoint.

    Eingeben der HTTP-Triggerparameter

    Wenn Sie einen anderen Authentifizierungstyp als Keinerauswählen, unterscheiden sich die Authentifizierungseinstellungen je nach Ihrer Auswahl.If you select an authentication type other than None, the authentication settings differ based on your selection. Weitere Informationen zu verfügbaren Authentifizierungstypen für HTTP finden Sie unter den folgenden Themen:For more information about authentication types available for HTTP, see these topics:

  4. Öffnen Sie zum Hinzufügen weiterer verfügbarer Parameter die Liste Neuen Parameter hinzufügen, und wählen Sie die gewünschten Parameter aus.To add other available parameters, open the Add new parameter list, and select the parameters that you want.

  5. Fahren Sie mit dem Erstellen des Workflows Ihrer Logik-App fort, und fügen Sie weitere Aktionen hinzu, die bei Auslösung des Triggers ausgeführt werden.Continue building your logic app's workflow with actions that run when the trigger fires.

  6. Speichern Sie die Logik-App unbedingt, wenn Sie fertig sind.When you're done, remember to save your logic app. Wählen Sie auf der Symbolleiste des Designers Speichern aus.On the designer toolbar, select Save.

Hinzufügen einer HTTP-AktionAdd an HTTP action

Diese integrierte Aktion führt einen HTTP-Aufruf der angegebenen URL für einen Endpunkt aus und gibt eine Antwort zurück.This built-in action makes an HTTP call to the specified URL for an endpoint and returns a response.

  1. Melden Sie sich beim Azure-Portal an.Sign in to the Azure portal. Öffnen Sie Ihre Logik-App im Logik-App-Designer.Open your logic app in Logic App Designer.

    Dieses Beispiel verwendet den HTTP-Trigger als ersten Schritt.This example uses the HTTP trigger as the first step.

  2. Wählen Sie im Schritt zum Hinzufügen der HTTP-Aktion die Option Neuer Schritt aus.Under the step where you want to add the HTTP action, select New step.

    Wenn Sie zwischen Schritten eine Aktion einfügen möchten, bewegen Sie den Mauszeiger über den Pfeil zwischen den Schritten.To add an action between steps, move your pointer over the arrow between steps. Wählen Sie das angezeigte Pluszeichen ( + ) aus, und wählen Sie dann Aktion hinzufügen aus.Select the plus sign (+) that appears, and then select Add an action.

  3. Geben Sie unter Aktion auswählen im Suchfeld „HTTP“ als Filter ein.Under Choose an action, in the search box, enter "http" as your filter. Wählen Sie in der Liste Aktionen die HTTP-Aktion aus.From the Actions list, select the HTTP action.

    Auswählen der HTTP-Aktion

    Dieses Beispiel benennt die Aktion in „HTTP action“ um, damit der Schritt über einen aussagekräftigeren Namen verfügt.This example renames the action to "HTTP action" so that the step has a more descriptive name.

  4. Geben Sie die Werte für die HTTP-Aktionsparameter ein, die Sie in den Aufruf des Zielendpunkts aufnehmen möchten.Provide the values for the HTTP action parameters that you want to include in the call to the target endpoint.

    Eingeben der Parameter für die HTTP-Aktion

    Wenn Sie einen anderen Authentifizierungstyp als Keinerauswählen, unterscheiden sich die Authentifizierungseinstellungen je nach Ihrer Auswahl.If you select an authentication type other than None, the authentication settings differ based on your selection. Weitere Informationen zu verfügbaren Authentifizierungstypen für HTTP finden Sie unter den folgenden Themen:For more information about authentication types available for HTTP, see these topics:

  5. Öffnen Sie zum Hinzufügen weiterer verfügbarer Parameter die Liste Neuen Parameter hinzufügen, und wählen Sie die gewünschten Parameter aus.To add other available parameters, open the Add new parameter list, and select the parameters that you want.

  6. Speichern Sie die Logik-App unbedingt, wenn Sie fertig sind.When you're done, remember to save your logic app. Wählen Sie auf der Symbolleiste des Designers Speichern aus.On the designer toolbar, select Save.

Inhalt des Typs „multipart/form-data“Content with multipart/form-data type

Für die Verarbeitung von Inhalt mit dem Typ multipart/form-data in HTTP-Anforderung können Sie ein JSON-Objekt hinzufügen, das die Attribute $content-type und $multipart im HTTP-Anforderungstext enthält, indem Sie dieses Format verwenden.To handle content that has multipart/form-data type in HTTP requests, you can add a JSON object that includes the $content-type and $multipart attributes to the HTTP request's body by using this format.

"body": {
   "$content-type": "multipart/form-data",
   "$multipart": [
      {
         "body": "<output-from-trigger-or-previous-action>",
         "headers": {
            "Content-Disposition": "form-data; name=file; filename=<file-name>"
         }
      }
   ]
}

Angenommen, Sie verfügen über eine Logik-App, die eine HTTP POST-Anforderung für eine Excel-Datei an eine Website sendet, indem sie die API der Website nutzt, die den Typ multipart/form-data unterstützt.For example, suppose you have a logic app that sends an HTTP POST request for an Excel file to a website by using that site's API, which supports the multipart/form-data type. Diese Aktion könnte folgenderweise aussehen:Here's how this action might look:

Mehrteilige Formulardaten

Das folgende Beispiel entspricht der JSON-Definition der HTTP-Aktion in der zugrundeliegenden Workflowdefinition:Here is the same example that shows the HTTP action's JSON definition in the underlying workflow definition:

{
   "HTTP_action": {
      "body": {
         "$content-type": "multipart/form-data",
         "$multipart": [
            {
               "body": "@trigger()",
               "headers": {
                  "Content-Disposition": "form-data; name=file; filename=myExcelFile.xlsx"
               }
            }
         ]
      },
      "method": "POST",
      "uri": "https://finance.contoso.com"
   },
   "runAfter": {},
   "type": "Http"
}

Connector-ReferenzConnector reference

Weitere Informationen zu Trigger- und Aktionsparametern finden Sie in diesen Abschnitten:For more information about trigger and action parameters, see these sections:

AusgabedetailsOutput details

Hier finden Sie weitere Informationen zu den Ausgaben aus einem HTTP-Trigger oder einer -Aktion, die diese Informationen zurückgeben:Here is more information about the outputs from an HTTP trigger or action, which returns this information:

EigenschaftennameProperty name typeType BESCHREIBUNGDescription
headersheaders Objekt (object)object Die Header aus der AnforderungThe headers from the request
bodybody Objekt (object)object JSON-ObjektJSON object Das Objekt mit dem Inhalt des Texts aus der AnforderungThe object with the body content from the request
status codestatus code INTint Der Statuscode aus der AnforderungThe status code from the request
StatuscodeStatus code BeschreibungDescription
200200 OKOK
202202 ZulässigAccepted
400400 Ungültige AnforderungBad request
401401 Nicht autorisiertUnauthorized
403403 VerbotenForbidden
404404 Nicht gefundenNot Found
500500 Interner Serverfehler.Internal server error. Unbekannter Fehler.Unknown error occurred.

Nächste SchritteNext steps