Inviare la richiesta a un servizio

SI APPLICA A: Sviluppatore | Premium

Il criterio set-backend-service imposta l'URL di destinazione per la richiesta corrente su http://localhost:3500/v1.0/invoke/{app-id}[.{ns-name}]/method/{method-name}, sostituendo i parametri del modello con i valori specificati nell'istruzione dei criteri.

Il criterio presuppone che il Dapr sia eseguito in un contenitore collaterale nello stesso pod del gateway. Al momento della ricezione della richiesta, il runtime Dapr esegue l'individuazione del servizio e la chiamata effettiva, inclusa la possibile conversione del protocollo tra HTTP e gRPC, tentativi, traccia distribuita e gestione degli errori. Altre informazioni sull'integrazione di Dapr con API Management.

Nota

Impostare gli elementi e gli elementi figlio del criterio nell'ordine specificato nell'istruzione del criterio. Altre informazioni su come impostare o modificare i criteri di API Management.

Istruzione del criterio

<set-backend-service backend-id="dapr" dapr-app-id="app-id" dapr-method="method-name" dapr-namespace="ns-name" />

Attributi

Attributo	Descrizione	Richiesto	Valore predefinito
backend-id	Deve essere impostato su "dapr".	Sì	N/D
dapr-app-id	Nome del microservizio di destinazione. Usato per formare il parametro appId in Dapr. Le espressioni di criteri sono consentite.	Sì	N/D
dapr-method	Nome del metodo o URL da richiamare nel microservizio di destinazione. Esegue il mapping al parametro method-name in Dapr. Le espressioni di criteri sono consentite.	Sì	N/D
dapr-namespace	Nome dello spazio dei nomi in cui risiede il microservizio di destinazione. Usato per formare il parametro appId in Dapr. Le espressioni di criteri sono consentite.	No	N/D

Utilizzo

• Sezioni del criterio: inbound
• Ambiti del criterio: globale, area di lavoro, prodotto, API, operazione
• Gateway: self-hosted

Note sull'utilizzo

Il supporto Dapr deve essere abilitato nel gateway self-hosted.

Esempio

Nell'esempio seguente viene illustrato come richiamare il metodo denominato "back" nel microservizio denominato "echo". Il set-backend-service criterio imposta l'URL di destinazione su http://localhost:3500/v1.0/invoke/echo.echo-app/method/back. Il criterio forward-request invia la richiesta al runtime Dapr, che lo recapita al microservizio.

Il criterioforward-request è illustrato qui per maggiore chiarezza. Il criterio viene in genere "ereditato" dall'ambito globale tramite la parola chiave base.

<policies>
    <inbound>
        <base />
        <set-backend-service backend-id="dapr" dapr-app-id="echo" dapr-method="back" dapr-namespace="echo-app" />
    </inbound>
    <backend>
        <forward-request />
    </backend>
    <outbound>
        <base />
    </outbound>
    <on-error>
        <base />
    </on-error>
</policies>

Criteri correlati

• Integrazione e comunicazione esterna

Contenuto correlato

Per ulteriori informazioni sull'utilizzo dei criteri, vedere:

• Esercitazione: trasformare e proteggere l'API
• Informazioni di riferimento sui criteri per un elenco completo delle istruzioni dei criteri e delle relative impostazioni
• Espressioni di criteri
• Impostare o modificare criteri
• Riutilizzare le configurazioni dei criteri
• Repository dei frammenti di criteri
• Creare criteri usando Microsoft Copilot in Azure