Aanvraag verzenden naar een service

  • Artikel

VAN TOEPASSING OP: Ontwikkelaar | Premium

Het set-backend-service beleid stelt de doel-URL voor de huidige aanvraag http://localhost:3500/v1.0/invoke/{app-id}[.{ns-name}]/method/{method-name}in, waarbij sjabloonparameters worden vervangen door waarden die zijn opgegeven in de beleidsinstructie.

In het beleid wordt ervan uitgegaan dat Dapr wordt uitgevoerd in een sidecar-container in dezelfde pod als de gateway. Na ontvangst van de aanvraag voert Dapr Runtime servicedetectie en daadwerkelijke aanroep uit, inclusief mogelijke protocolomzetting tussen HTTP en gRPC, nieuwe pogingen, gedistribueerde tracering en foutafhandeling. Meer informatie over Dapr-integratie met API Management.

Notitie

Stel de elementen en onderliggende elementen van het beleid in de volgorde in die in de beleidsverklaring is opgegeven. Meer informatie over het instellen of bewerken van API Management-beleid.

Beleidsinstructie

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

Kenmerken

Kenmerk Beschrijving Vereist Standaardinstelling
back-end-id Moet zijn ingesteld op 'dapr'. Ja N.v.t.
dapr-app-id Naam van de doelmicroservice. Wordt gebruikt om de parameter appId in Dapr te vormen. Beleidsexpressies zijn toegestaan. Ja N.v.t.
dapr-methode Naam van de methode of een URL die moet worden aangeroepen op de doelmicroservice. Kaarten naar de parameter method-name in Dapr. Beleidsexpressies zijn toegestaan. Ja N.v.t.
dapr-naamruimte De naam van de naamruimte waarin de doelmicroservice zich bevindt. Wordt gebruikt om de parameter appId in Dapr te vormen. Beleidsexpressies zijn toegestaan. Nee N.v.t.

Gebruik

Gebruiksnotities

Dapr-ondersteuning moet zijn ingeschakeld in de zelf-hostende gateway.

Opmerking

In het volgende voorbeeld ziet u hoe u de methode 'back' aanroept op de microservice met de naam 'echo'. Het set-backend-service beleid stelt de doel-URL in op http://localhost:3500/v1.0/invoke/echo.echo-app/method/back. Het forward-request beleid verzendt de aanvraag naar de Dapr-runtime, die deze aan de microservice levert.

Het forward-request beleid wordt hier ter duidelijkheid weergegeven. Het beleid wordt doorgaans 'overgenomen' van het globale bereik via het base trefwoord.

<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>

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid: