Introduzione all'azione HTTP

Con l'azione HTTP è possibile estendere i flussi di lavoro per l'organizzazione e comunicare con qualsiasi endpoint su HTTP.

È possibile:

  • Creare flussi di lavoro con app per la logica che si attivano (trigger) quando un sito Web gestito diventa inattivo.
  • Comunicare con qualsiasi endpoint su HTTP per estendere i flussi di lavoro ad altri servizi.

Per informazioni su come iniziare a usare un'azione HTTP in un'app per la logica, vedere Creare un'app per la logica.

Usare un trigger HTTP

Un trigger è un evento che può essere usato per avviare il flusso di lavoro definito in un'app per la logica. Altre informazioni sui trigger.

Ecco una sequenza di esempio di come configurare un trigger HTTP nella finestra di progettazione dell'app per la logica.

  1. Aggiungere il trigger HTTP all'app per la logica.
  2. Specificare i parametri per l'endpoint HTTP di cui si vuole eseguire il polling.
  3. Modificare l'intervallo di ricorrenza che stabilisce la frequenza del polling.

    L'app per la logica ora si attiva con il contenuto restituito durante ogni controllo.

    Trigger HTTP

Come funziona il trigger HTTP

Il trigger HTTP invia una chiamata a un endpoint HTTP a intervalli ricorrenti. Per impostazione predefinita, il codice di risposta HTTP inferiore a 300 genera l'esecuzione di un'app per la logica. Per specificare se deve essere attivata l'app per la logica, è possibile modificare l'app per la logica nella visualizzazione del codice e aggiungere una condizione che verrà valutata dopo la chiamata HTTP. Di seguito è riportato un esempio di trigger HTTP che viene attivato quando il codice di stato restituito è maggiore di o uguale a 400.

"Http":
{
    "conditions": [
        {
            "expression": "@greaterOrEquals(triggerOutputs()['statusCode'], 400)"
        }
    ],
    "inputs": {
        "method": "GET",
        "uri": "https://blogs.msdn.microsoft.com/logicapps/",
        "headers": {
            "accept-language": "en"
        }
    },
    "recurrence": {
        "frequency": "Second",
        "interval": 15
    },
    "type": "Http"
}

Tutti i dettagli sui parametri dei trigger HTTP sono disponibili in MSDN.

Usare l'azione HTTP

Un'azione è un'operazione eseguita dal flusso di lavoro e definita in un'app per la logica. Altre informazioni sulle azioni.

  1. Scegliere Nuovo passaggio > Aggiungi un'azione.
  2. Nella casella di ricerca dell'azione digitare http per elencare le azioni HTTP.

    Selezionare l'azione HTTP

  3. Aggiungere i parametri richiesti per la chiamata HTTP.

    Completare l'azione HTTP

  4. Fare clic su Salva nella barra degli strumenti della finestra di progettazione. L'app per la logica viene salvata e pubblicata (attivata) nello stesso momento.

Trigger HTTP

Ecco i dettagli per il trigger supportato da questo connettore. Il connettore HTTP supporta un solo trigger.

Trigger Descrizione
http Esegue una chiamata HTTP e restituisce il contenuto della risposta.

Azione HTTP

Ecco i dettagli per l'azione supportata da questo connettore. Il connettore HTTP supporta una sola azione possibile.

Azione Descrizione
http Esegue una chiamata HTTP e restituisce il contenuto della risposta.

Dettagli di HTTP

La tabella seguente descrive i campi di input obbligatori e facoltativi per l'azione e i dettagli di output corrispondenti associati all'uso dell'azione.

Richiesta HTTP

Di seguito sono riportati campi di input per l'azione, che esegue una richiesta HTTP in uscita. Un asterisco (*) indica che è un campo obbligatorio.

Nome visualizzato Nome proprietà Descrizione
Metodo* statico Verbo HTTP da usare
URI* Uri URI per la richiesta HTTP
Headers Headers Un oggetto JSON delle intestazioni HTTP da includere
Corpo Corpo Il corpo della richiesta HTTP
Autenticazione Autenticazione Dettagli nella sezione Autenticazione .


Dettagli dell'output

Di seguito sono riportati i dettagli di output per la risposta HTTP.

Nome proprietà Tipo di dati Descrizione
headers object Intestazioni della risposta
Corpo object Oggetto della risposta
Codice di stato int Stato codice HTTP

Autenticazione

La funzionalità App per la logica permette di usare diversi tipi di autenticazione per gli endpoint HTTP. Questo tipo di autenticazione può essere usato con i connettori HTTP, HTTP e Swagger e Webhook HTTP. È possibile configurare i seguenti tipi di autenticazione:

Autenticazione di base

Per l'autenticazione di base è necessario l'oggetto di autenticazione seguente. Un asterisco (*) indica che è un campo obbligatorio.

Nome proprietà Tipo di dati Descrizione
Type* type Tipo di autenticazione (deve essere Basic per l'autenticazione di base)
Username* username Nome utente da autenticare
Password* password Password da autenticare
Suggerimento

Se si desidera usare una password che non può essere recuperata dalla definizione, usare un parametro securestring e la @parameters() funzione di definizione del flusso di lavoro.

Ad esempio:

{
    "type": "Basic",
    "username": "user",
    "password": "test"
}

Autenticazione con certificato client

Per l'autenticazione con certificato client è necessario l'oggetto di autenticazione seguente. Un asterisco (*) indica che è un campo obbligatorio.

Nome proprietà Tipo di dati Descrizione
Type* type Tipo di autenticazione (deve essere ClientCertificate per i certificati client SSL)
PFX* pfx Contenuto con codifica Base 64 del file di scambio di informazioni personali (PFX, Personal Information Exchange)
Password* password La password per accedere al file PFX
Suggerimento

Per usare un parametro che non sarà leggibile nella definizione dopo il salvataggio dell'app per la logica, è possibile usare un parametro securestring e la @parameters() funzione di definizione del flusso di lavoro.

Ad esempio:

{
    "type": "ClientCertificate",
    "pfx": "aGVsbG8g...d29ybGQ=",
    "password": "@parameters('myPassword')"
}

Autenticazione OAuth di Azure AD

Per l'autenticazione OAuth di Azure Ad è necessario l'oggetto di autenticazione seguente. Un asterisco (*) indica che è un campo obbligatorio.

Nome proprietà Tipo di dati Descrizione
Type* type Tipo di autenticazione (deve essere ActiveDirectoryOAuth per OAuth di Azure AD)
Tenant* tenant L'identificatore del tenant di Azure AD
Pubblico* audience La risorsa per cui si sta richiedendo l'autorizzazione per l'uso. Ad esempio: https://management.core.windows.net/
ID cliente* clientId Identificatore client per l'applicazione Azure AD
Segreto* secret Segreto del client che richiede il token
Suggerimento

È possibile usare un parametro securestring e la funzione di definizione del flusso di lavoro @parameters() per usare un parametro che non sarà leggibile nella definizione dopo il salvataggio.

Ad esempio:

{
    "type": "ActiveDirectoryOAuth",
    "tenant": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "audience": "https://management.core.windows.net/",
    "clientId": "34750e0b-72d1-4e4f-bbbe-664f6d04d411",
    "secret": "hcqgkYc9ebgNLA5c+GDg7xl9ZJMD88TmTJiJBgZ8dFo="
}

Passaggi successivi

Provare ora a usare la piattaforma e creare un'app per la logica. È possibile esplorare gli altri connettori disponibili nelle app per la logica esaminando l' elenco di API.