Come inviare messaggi al bus di servizio di Azure da Gestione API di Azure

SI APPLICA A: Sviluppatore | Base | Standard | Premium

Questo articolo descrive come inviare messaggi da Gestione API al bus di servizio di Azure usando l'integrazione basata su criteri. Usare Gestione API per fornire un modo sicuro e scalabile per inviare messaggi al bus di servizio.

Il bus di servizio di Azure è un servizio di messaggistica aziendale completamente gestito progettato per disaccoppiare applicazioni e servizi, abilitando la messaggistica cloud affidabile tra sistemi distribuiti. Supporta AMQP (Advanced Message Queuing Protocol) per consentire ai sistemi di inviare messaggi alle code di messaggi per comunicazioni uno-a-uno e ai topic per modelli di pubblicazione/sottoscrizione. Il bus di servizio è ideale per scenari che richiedono operazioni asincrone, livellamento del carico o integrazione in ambienti cloud ibridi. Per altre informazioni, vedere la documentazione del bus di servizio di Azure.

Con l'integrazione basata su criteri, Gestione API offre:

• Proteggere la messaggistica basata su REST per i client esterni : i sistemi esterni e le app per dispositivi mobili che non dispongono del supporto AMQP nativo possono inviare messaggi al bus di servizio usando LE API HTTP/REST standard tramite Gestione API. Questo approccio semplifica l'integrazione e migliora la sicurezza eliminando la necessità di intermediari personalizzati.
• Integrazioni regolate di terze parti : le aziende possono esporre gli endpoint del bus di servizio tramite Gestione API con l'autenticazione di identità gestita predefinita, abilitando modelli di messaggistica sicuri ed osservabili per partner e applicazioni di terze parti.
• Modello fire and forget : non sono necessari altri servizi back-end per inviare messaggi al bus di servizio, consentendo architetture più semplici e un sovraccarico operativo ridotto.

Annotazioni

• L'integrazione di API Management con il Service Bus è attualmente disponibile in anteprima.
• È supportato solo l'invio di messaggi al bus di servizio.

Annotazioni

Attualmente, questa funzionalità non è disponibile nelle aree di lavoro.

Prerequisiti

• Istanza del servizio Gestione API. Se non ne hai una, vedi Creare un'istanza del servizio Gestione API.

• API di gestione usata per inviare messaggi a Service Bus.

• Una coda o argomento in uno spazio dei nomi del bus di servizio di Azure per ricevere messaggi. Per i passaggi dettagliati, vedere una delle operazioni seguenti:

  • Creare una coda e uno spazio dei nomi del bus di servizio
  • Creare un argomento del bus di servizio e le sottoscrizioni all'argomento

  Annotazioni

  • Per usare argomenti e sottoscrizioni, scegliere il livello Standard o Premium del bus di servizio.
  • La risorsa del bus di servizio può trovarsi in una sottoscrizione diversa o anche in un tenant diverso rispetto alla risorsa di Gestione API.

• Autorizzazioni per assegnare ruoli a un'identità gestita.

Configurare l'accesso al bus di servizio

Per inviare messaggi al bus di servizio, è necessario configurare un'identità gestita per l'istanza di Gestione API:

1. Abilitare un'identità gestita assegnata dal sistema o assegnata dall'utente per Gestione API nell'istanza di Gestione API.

   • Se si abilita un'identità gestita assegnata dall'utente, prendere nota dell'ID client dell'identità.

2. Assegnare l'identità al ruolo Mittente dei dati del bus di servizio di Azure nello nell'ambito del bus di servizio. Per assegnare il ruolo, usare il portale di Azure o altri strumenti di Azure.

Configurare il criterio send-service-bus-message

Configurare il criterio send-service-bus-message per inviare messaggi alla coda o all'argomento desiderato.

Ad esempio, usare il criterio send-service-bus-message nella sezione criterio in ingresso per inviare il corpo della richiesta API quando il gateway lo riceve.

1. Nel portale di Azure passare all'istanza di Gestione API.

2. Nel menu a sinistra selezionare API, quindi selezionare l'API in cui si vuole aggiungere il criterio.

3. Selezionare Tutte le operazioni.

4. Nella parte superiore della schermata selezionare la scheda Progettazione .

5. Nella finestra Elaborazione in ingresso o Elaborazione in uscita selezionare l'icona </> (editor di codice). Per altre informazioni, vedere Come impostare o modificare i criteri.

6. Posizionare il cursore nella inbound o outbound sezione dei criteri.

7. Aggiungere i send-service-bus-message criteri alla configurazione dei criteri, quindi configurare gli attributi e gli elementi in base alle esigenze.

   Ad esempio, inviare il corpo della richiesta come messaggio:

   <send-service-bus-message queue-name="my-queue">
       <payload>@(context.Request.Body.As<string>())</payload>
   </send-service-bus-message>
   

   È possibile usare qualsiasi espressione che restituisca una stringa come valore per l'elemento payload .

8. Selezionare Salva per salvare la configurazione aggiornata dei criteri. Non appena viene salvato, la politica è attiva e i messaggi vengono inviati al bus di servizio assegnato.

Contenuti correlati

• Uso di servizi esterni
• criterio send-service-bus-message