Consulta i connettori supportati per Application Integration.

Chiamata dell'attività endpoint REST

L'attività Chiama endpoint REST consente di chiamare qualsiasi API REST di terze parti dalla tua integrazione. La risposta della chiamata dell'API REST sarà disponibile in una variabile di integrazione e potrà essere utilizzata in altre attività downstream.

Nota:

• La configurazione di rete dell'attività Chiamata endpoint REST consente di chiamare endpoint disponibili solo tramite internet pubblico. Di conseguenza, l'attività non può connettersi a host o IP che si trovano solo all'interno di una rete privata come una VPC, anche se la VPC è in peering con altri tuoi servizi Google Cloud come Apigee X.
• Questa attività può elaborare un massimo di 50 MB di risposta REST.

Prima di iniziare

• Per connetterti a un endpoint di autenticazione per la chiamata all'API REST, assicurati di aver creato un profilo OAuth 2.0 o di aver allegato un account di servizio gestito dall'utente all'integrazione. Se la tua API non richiede l'autenticazione, il campo Profilo di autenticazione nel riquadro di configurazione dell'attività può essere lasciato vuoto. Per visualizzare un elenco di configurazioni, consulta Proprietà di configurazione.

  Se per l'integrazione sono configurati sia il profilo OAuth 2.0 sia un account di servizio gestito dall'utente, per impostazione predefinita viene utilizzato il profilo OAuth 2.0 per l'autenticazione. Se non sono configurati né il profilo OAuth 2.0 né l'account di servizio gestito dall'utente, l'esecuzione non va a buon fine.

• Se all'integrazione è associato un account di servizio, concedi a quest'ultimo il ruolo IAM richiesto in base all'URL dell'endpoint REST. Ad esempio, se l'URL dell'endpoint REST chiama un servizio Cloud Storage, concedi il ruolo IAM richiesto per il servizio Cloud Storage.

  Per informazioni sulla concessione di ruoli a un account di servizio, vedi Gestire l'accesso agli account di servizio.

• Assicurati che i Controlli di servizio VPC NON siano configurati per l'integrazione delle applicazioni nel tuo Google Cloud progetto.
  Avviso: Cloud Function non funziona o smette di funzionare se Controlli di servizio VPC sono configurati per l'integrazione delle applicazioni nel tuo Google Cloud progetto.

Configurare l'attività di chiamata endpoint REST

Per configurare l'attività Chiama endpoint REST:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

   Se stai creando una nuova integrazione:

   1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
   2. Seleziona una regione per l'integrazione.
      Nota: il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
   3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti di integrazione.
      Nota: l'opzione per selezionare un service account viene visualizzata solo se hai attivato la governance dell'integrazione per la regione selezionata.
   4. Fai clic su Crea.

   Viene visualizzata l'integrazione nell'editor di integrazione.

4. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco di attività e connettori disponibili.
5. Fai clic e posiziona l'elemento Chiama endpoint REST nell'editor di integrazione.
6. Fai clic sull'elemento Chiamata endpoint REST nel designer per visualizzare il riquadro di configurazione dell'attività Chiamata endpoint REST.
7. Configura i campi visualizzati utilizzando le proprietà di configurazione dell'attività, come descritto nella tabella seguente.

   Le modifiche alle proprietà vengono salvate automaticamente.

Proprietà di configurazione

La tabella seguente descrive le proprietà di configurazione dell'attività Chiama endpoint REST.

Proprietà	Tipo di dati	Descrizione
Etichetta	Stringa	(Facoltativo) Aggiungi un'etichetta per l'attività.
Autenticazione	Stringa	(Facoltativo) Configura e memorizza i dettagli di autenticazione per le connessioni ai sistemi esterni. Per ulteriori informazioni, vedi Creare profili di autenticazione in Application Integration.
URL di base dell'endpoint	Stringa	URL dell'endpoint REST senza i parametri di query.
Metodo HTTP	NA	Metodo HTTP da utilizzare. Puoi selezionare uno dei seguenti metodi HTTP: ELIMINA GET HEAD PATCH POST PUT
Parametri della stringa di query dell'URL	Chiave della stringa di query : Stringa Valore: Stringa	Parametri di query richiesti per la chiamata all'API REST. I parametri di query sono sotto forma di coppie chiave-valore, dove la chiave è il nome della chiave e il valore è il valore della chiave corrispondente. Puoi inserire più di una coppia chiave-valore facendo clic sull'icona Più.
Intestazioni HTTP	Chiave dell'intestazione HTTP: stringa Valore: Stringa	Intestazioni HTTP richieste per la chiamata all'API REST. Le intestazioni HTTP sono sotto forma di coppie chiave-valore, dove la chiave è il nome della chiave e il valore è il valore della chiave corrispondente. Puoi inserire più di una coppia chiave-valore facendo clic sull'icona Più.
Segui i reindirizzamenti	Booleano	Segui i reindirizzamenti URL. Puoi selezionare uno dei seguenti valori: True : chiama l'URL reindirizzato se l'URL di base dell'endpoint viene inoltrato a un altro URL. False: non chiama l'URL reindirizzato se l'URL di base dell'endpoint viene inoltrato a un altro URL.
L'attività deve non riuscire a causa di un errore HTTP	Booleano	Strategia di gestione delle eccezioni quando la chiamata all'API REST non va a buon fine. L'attività Chiama endpoint REST non va a buon fine se il codice di risposta HTTP è 4xx o 5xx. Per un elenco dei codici di errore, consulta Codici di errore. Per altri codici di risposta HTTP, restituisci il codice e il messaggio di errore nella risposta. Nota: per gli errori non correlati alla chiamata dell'API REST, ad esempio un URL errato, l'attività non va a buon fine indipendentemente dal valore impostato per questa opzione. Puoi selezionare uno dei seguenti valori: True : viene generata un'eccezione. False: non viene lanciata un'eccezione. ma restituisce il codice di errore e il messaggio di errore nella risposta.
Intestazione della risposta (<Task name>)	Stringa	Intestazione di risposta non compressa della risposta delle API REST.
Corpo della risposta (<Task name>)	Stringa	Corpo della risposta non compresso della risposta delle API REST.
Stato risposta (<Task name>)	Stringa	Codice di risposta HTTP e testo del codice corrispondente dalla risposta delle API REST.

Best practice

Per informazioni sui limiti di utilizzo che si applicano all'attività Chiama endpoint REST, consulta Limiti di utilizzo.

Strategia di gestione degli errori

Una strategia di gestione degli errori per un'attività specifica l'azione da intraprendere se l'attività non va a buon fine a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e sui diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.

Per scoprire come gestire le strategie di nuovo tentativo per gli errori 4xx o 5xx, consulta il blog Come eseguire nuovamente il tentativo di operazione Rest Caller in base allo stato della risposta.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi

• Scopri di più su tutte le attività e gli attivatori.
• Scopri come testare e pubblicare un'integrazione.
• Scopri di più sulla gestione degli errori.
• Scopri di più sui log di esecuzione dell'integrazione.