Ressource: TcpRoute
tcpRoute ist die Ressource, die definiert, wie TCP-Traffic von einer Mesh-/Gateway-Ressource weitergeleitet werden soll.
JSON-Darstellung |
---|
{
"name": string,
"selfLink": string,
"createTime": string,
"updateTime": string,
"description": string,
"rules": [
{
object ( |
Felder | |
---|---|
name |
Erforderlich. Name der TcpRoute-Ressource. Er entspricht dem Muster |
selfLink |
Nur Ausgabe. Serverdefinierte URL dieser Ressource |
createTime |
Nur Ausgabe. Der Zeitstempel, der angibt, wann die Ressource erstellt wurde. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
updateTime |
Nur Ausgabe. Der Zeitstempel, der angibt, wann die Ressource aktualisiert wurde. Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: |
description |
Optional. Eine Freitextbeschreibung der Ressource. Maximale Länge: 1.024 Zeichen. |
rules[] |
Erforderlich. Regeln, die festlegen, wie Traffic weitergeleitet und verarbeitet wird. Es muss mindestens eine RouteRule angegeben werden. Wenn es mehrere Regeln gibt, ist die durchgeführte Aktion die erste Regel mit der Übereinstimmung. |
meshes[] |
Optional. Meshes definiert eine Liste von Mesh-Netzwerken, an die diese tcpRoute angehängt ist, als eine der Routingregeln zum Weiterleiten der vom Mesh-Netzwerk bereitgestellten Anfragen. Jede Mesh-Referenz muss dem Muster entsprechen: Das angehängte Mesh sollte vom Typ SIDECAR sein. |
gateways[] |
Optional. „Gateways“ definiert eine Liste von Gateways, an die diese tcpRoute angehängt ist, als eine der Routingregeln zum Weiterleiten der vom Gateway bereitgestellten Anfragen. Jede Gateway-Referenz muss dem Muster entsprechen: |
labels |
Optional. Mit der TcpRoute-Ressource verknüpfte Label-Tags. Ein Objekt, das eine Liste von |
RouteRule
Hier wird festgelegt, wie Traffic abgeglichen und weitergeleitet wird, wenn ein Abgleich erfolgt.
JSON-Darstellung |
---|
{ "matches": [ { object ( |
Felder | |
---|---|
matches[] |
Optional. Mit „RouteMatch“ wird das Prädikat definiert, mit dem Anfragen mit einer bestimmten Aktion abgeglichen werden. Mehrere Keyword-Optionen werden zur Auswertung mit „ODER“ verknüpft. Wenn kein Feld „routeMatch“ angegeben ist, wird mit dieser Regel der Traffic bedingungslos abgeglichen. |
action |
Erforderlich. Die detaillierte Regel, die festlegt, wie übereinstimmender Traffic weitergeleitet wird. |
RouteMatch
RouteMatch definiert das Prädikat, mit dem Anfragen einer bestimmten Aktion zugeordnet werden. Mehrere Keyword-Optionen werden zur Auswertung mit „ODER“ verknüpft. Wenn kein Feld „routeMatch“ angegeben ist, wird der Traffic mit dieser Regel bedingungslos abgeglichen.
JSON-Darstellung |
---|
{ "address": string, "port": string } |
Felder | |
---|---|
address |
Erforderlich. Muss im CIDR-Bereichsformat angegeben werden. Ein CIDR-Bereich besteht aus einer IP-Adresse und einer Präfixlänge, um die Subnetzmaske zu erstellen. Die Präfixlänge beträgt standardmäßig 32, d.h. entspricht einer einzelnen IP-Adresse. Nur IPv4-Adressen werden unterstützt. Beispiele: „10.0.0.1“ – Übereinstimmung mit genau dieser IP-Adresse. „10.0.0.0/8“ – stimmt mit jeder IP-Adresse im Subnetz 10.0.0.0 und der Maske 255.255.255.0 überein. „0.0.0.0/0“ - stimmt mit jeder IP-Adresse überein. |
port |
Erforderlich. Gibt den Zielport für den Abgleich an. |
RouteAction
Die Spezifikationen für das Routing von Traffic und die Anwendung der zugehörigen Richtlinien.
JSON-Darstellung |
---|
{
"destinations": [
{
object ( |
Felder | |
---|---|
destinations[] |
Optional. Die Zieldienste, an die Traffic weitergeleitet werden soll. Mindestens ein Zieldienst ist erforderlich. Es kann nur eines der beiden Ziele festgelegt werden. |
originalDestination |
Optional. Wenn diese Option aktiviert ist, verwendet der Router die Ziel-IP-Adresse und den Zielport der ursprünglichen Verbindung als Ziel der Anfrage. Der Standardwert ist "False". Es kann nur eines der Routenziele oder ein ursprüngliches Ziel festgelegt werden. |
idleTimeout |
Optional. Gibt das Zeitlimit für die Inaktivität für die ausgewählte Route an. Die Zeitüberschreitung bei Inaktivität wird als der Zeitraum definiert, in dem weder über die Upstream- noch über die Downstream-Verbindung Bytes gesendet oder empfangen werden. Wenn Sie keinen Wert festlegen, beträgt die Standardzeitüberschreitung für Inaktivität 30 Sekunden. Wenn der Wert auf „0 Sekunden“ gesetzt ist, wird die Zeitüberschreitung deaktiviert. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit " |
RouteDestination
Beschreiben Sie das Ziel, an das der Traffic weitergeleitet werden soll.
JSON-Darstellung |
---|
{ "serviceName": string, "weight": integer } |
Felder | |
---|---|
serviceName |
Erforderlich. Die URL eines Back-End-Dienstes, an den Traffic weitergeleitet werden soll. |
weight |
Optional. Gibt den Anteil der Anfragen an, die an das Back-End weitergeleitet wurden, auf das im Feld „serviceName“ verwiesen wird. Der Wert wird wie folgt berechnet: – Gewichtung/Summe(Gewichtungen in dieser Zielliste). Bei Werten ungleich Null kann je nach der von einer Implementierung unterstützten Genauigkeit ein gewisses Epsilon zu dem hier definierten Anteil vorliegen. Wenn nur ein Dienstname angegeben ist und dieser eine Gewichtung größer als 0 hat, werden 100% des Traffics an dieses Back-End weitergeleitet. Wenn Gewichte für einen Dienstnamen angegeben werden, müssen sie für alle Dienstnamen angegeben werden. Wenn für alle Dienste keine Gewichtungen angegeben sind, wird der Traffic zu gleichen Teilen auf alle Dienste verteilt. |
Methoden |
|
---|---|
|
Erstellt eine neue TcpRoute in einem bestimmten Projekt und an einem bestimmten Ort. |
|
Löscht eine einzelne TCP-Route. |
|
Ruft Details zu einer einzelnen TCP-Route ab. |
|
Listet TcpRoute in einem angegebenen Projekt und an einem angegebenen Standort auf. |
|
Aktualisiert die Parameter einer einzelnen TCP-Route. |