Wysyłanie żądania do usługi
DOTYCZY: Developer | Premia
Zasady set-backend-service
ustawia docelowy adres URL bieżącego żądania na http://localhost:3500/v1.0/invoke/{app-id}[.{ns-name}]/method/{method-name}
, zastępując parametry szablonu wartościami określonymi w instrukcji zasad.
Zasady zakładają, że język Dapr działa w kontenerze przyczepki w tym samym zasobniku co brama. Po otrzymaniu żądania środowisko uruchomieniowe języka Dapr wykonuje odnajdywanie usługi i rzeczywiste wywołanie, w tym możliwe tłumaczenie protokołu między protokołami HTTP i gRPC, ponawianie prób, śledzenie rozproszone i obsługa błędów. Dowiedz się więcej o integracji języka Dapr z usługą API Management.
Uwaga
Ustaw elementy zasad i elementy podrzędne w kolejności podanej w instrukcji zasad. Dowiedz się więcej na temat ustawiania lub edytowania zasad usługi API Management.
Instrukcja zasad
<set-backend-service backend-id="dapr" dapr-app-id="app-id" dapr-method="method-name" dapr-namespace="ns-name" />
Atrybuty
Atrybut | opis | Wymagani | Wartość domyślna |
---|---|---|---|
identyfikator zaplecza | Musi być ustawiona wartość "dapr". | Tak | Nie dotyczy |
dapr-app-id | Nazwa docelowej mikrousługi. Służy do tworzenia parametru appId w języku Dapr. Wyrażenia zasad są dozwolone. | Tak | Nie dotyczy |
dapr-method | Nazwa metody lub adresu URL, który ma być wywoływany w docelowej mikrousłudze. Mapuje na parametr method-name w języku Dapr. Wyrażenia zasad są dozwolone. | Tak | Nie dotyczy |
dapr-namespace | Nazwa przestrzeni nazw, w których znajduje się docelowa mikrousługa. Służy do tworzenia parametru appId w języku Dapr. Wyrażenia zasad są dozwolone. | Nie. | Nie dotyczy |
Użycie
- Sekcje zasad: ruch przychodzący
- Zakresy zasad: globalny, produkt, interfejs API, operacja
- Bramy: self-hosted
Uwagi dotyczące użycia
Obsługa języka Dapr musi być włączona w bramie hostowanej samodzielnie.
Przykład
W poniższym przykładzie pokazano wywołanie metody o nazwie "back" w mikrousłudze o nazwie "echo". Zasady set-backend-service
ustawia docelowy adres URL na http://localhost:3500/v1.0/invoke/echo.echo-app/method/back
. Zasady forward-request
wysyła żądanie do środowiska uruchomieniowego języka Dapr, które dostarcza je do mikrousługi.
W forward-request
tym miejscu przedstawiono zasady w celu zachowania przejrzystości. Zasady są zwykle "dziedziczone" z zakresu globalnego za pośrednictwem słowa kluczowego 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>
Powiązane zasady
Powiązana zawartość
Aby uzyskać więcej informacji na temat pracy z zasadami, zobacz:
- Samouczek: przekształcanie i ochrona interfejsu API
- Dokumentacja zasad dla pełnej listy instrukcji zasad i ich ustawień
- Wyrażenia zasad
- Ustawianie lub edytowanie zasad
- Ponowne używanie konfiguracji zasad
- Repozytorium fragmentów zasad
- Tworzenie zasad przy użyciu rozwiązania Microsoft Copilot na platformie Azure