auslösen

Verwenden Sie die throw-Richtlinie, um einen Fehler auszulösen, wenn die Richtlinie während der Ausführung eines Assembly-Ablaufs erreicht wird.

Gateway-Unterstützung

Tabelle 1. Tabelle, aus der hervorgeht, welche Gateways diese Richtlinie unterstützen, sowie die entsprechende Richtlinienversion
Gateway Richtlinienversion
DataPower® Gateway (v5 compatible) 1.0.0
DataPower API Gateway 2.0.0

2.1.0 (DataPower API Gateway Version 10.0.3.0 oder höher)

In diesem Thema wird beschrieben, wie Sie die Richtlinie in der Benutzeroberfläche von Assembly konfigurieren; Einzelheiten zur Konfiguration der Richtlinie in Ihrer „ OpenAPI “-Quelle finden Sie unter throw.

Wenn die throw-Richtlinie zum Einsatz kommt, werden der angegebene Fehler und die angegebene Fehlernachricht ausgegeben.

Wenn ein Catch konfiguriert wurde, der durch den von der throw-Richtlinie erzeugten Fehler erfüllt wird, wird der Catch ausgelöst.

Wenn kein Catch durch den ausgelösten Fehler ausgelöst wird,500 Internal Server Errorwird an den API-Aufrufenden zurückgegeben.

Komponenteneigenschaftendetails

Sie können die Eigenschaften einer Komponente im Eigenschaftenblatt in der Assemblieransicht konfigurieren.

Tabelle 2. Die Eigenschaften einer Throw-Komponente
Eigenschaft Erforderlich Beschreibung
Titel Nein Ein angepasster Titel für Ihre Komponente, wenn sie im Erstellungsbereich angezeigt wird. Wenn kein Titel angegeben wird, wird standardmäßig throw verwendet.
Fehlername Ja Der Name des von der Richtlinie ausgelösten Fehlers.
Nur DataPower-API-GatewayFehlerstatuscode (Richtlinienversion 2.1.0 und höher) Nein Geben Sie den HTTP -Statuscode für den Fehler an. Sie können das Format $(variable) verwenden, um auf die API-Kontextvariable error.status.code zu verweisen.
Nur DataPower-API-GatewayGrund für den Fehlerstatus (Richtlinienversion 2.1.0 und höher) Nein Geben Sie den HTTP -Begründungssatz für den Fehler an. Sie können das Format $(variable) verwenden, um auf die API-Kontextvariable error.status.reason zu verweisen.
Error Message Nein Die Fehlernachricht, die mit dem Fehlernamen zurückgegeben wird.