Inviare la richiesta a un servizio

  • Articolo

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

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>

Contenuto correlato

Per ulteriori informazioni sull'utilizzo dei criteri, vedere: