Anforderung an einen Dienst senden

  • Artikel

GILT FÜR: Entwickler | Premium

Die Richtlinie set-backend-service legt die Ziel-URL für die aktuelle Anforderung auf http://localhost:3500/v1.0/invoke/{app-id}[.{ns-name}]/method/{method-name} fest und ersetzt dabei Vorlagenparameter durch Werte, die in der Richtlinienanweisung angegeben sind.

Die Richtlinie geht davon aus, dass Dapr in einem Sidecar-Container in demselben Pod wie das Gateway ausgeführt wird. Beim Empfangen der Anforderung führt die Dapr-Runtime die Dienstermittlung und den eigentlichen Aufruf aus, einschließlich einer etwaigen Protokollübersetzung zwischen HTTP und gRPC, Wiederholungsversuchen, verteilter Ablaufverfolgung und Fehlerbehandlung. Erfahren Sie mehr über die Dapr-Integration in API Management.

Hinweis

Legen Sie die Elemente und untergeordneten Elemente einer Richtlinie in der Reihenfolge fest, die in der Richtlinienanweisung angegeben ist. Erfahren Sie mehr darüber, wie Sie API Management-Richtlinien festlegen oder bearbeiten.

Richtlinienanweisung

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

Attribute

Attribut BESCHREIBUNG Erforderlich Standard
backend-id Muss auf „dapr“ festgelegt werden. Ja N/V
dapr-app-id Der Name des Ziel-Microservice. Wird zum Erstellen des Parameters appId in Dapr verwendet. Richtlinienausdrücke sind zulässig. Ja N/V
dapr-method Der Name der Methode oder eine URL, die auf dem Ziel-Microservice aufgerufen werden soll. Wird dem Parameter method-name in Dapr zugeordnet. Richtlinienausdrücke sind zulässig. Ja –
dapr-namespace Der Name des Namespace, in dem sich der Ziel-Microservice befindet. Wird zum Erstellen des Parameters appId in Dapr verwendet. Richtlinienausdrücke sind zulässig. Nein –

Verwendung

Hinweise zur Verwendung

Die Dapr-Unterstützung muss im selbstgehosteten Gateway aktiviert sein.

Beispiel

Im folgenden Beispiel wird das Aufrufen der Methode mit dem Namen „back“ für den Microservice mit dem Namen „echo“ gezeigt. Die Richtlinie set-backend-service legt die Ziel-URL auf http://localhost:3500/v1.0/invoke/echo.echo-app/method/back fest. Die Richtlinie forward-request versendet die Anforderung an die Dapr-Runtime, die sie an den Microservice übermittelt.

Die Richtlinie forward-request wird hier der besseren Verständlichkeit halber gezeigt. Die Richtlinie wird in der Regel über das Schlüsselwort base aus dem globalen Bereich „geerbt“.

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

Zugehöriger Inhalt

Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier: