REST Resource: projects.locations.tlsRoutes

Ressource: TlsRoute

Mit TlsRoute wird festgelegt, wie Traffic basierend auf SNI und anderen übereinstimmenden L3-Attributen weitergeleitet werden soll.

JSON-Darstellung
{
  "name": string,
  "selfLink": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "rules": [
    {
      object (RouteRule)
    }
  ],
  "meshes": [
    string
  ],
  "gateways": [
    string
  ],
  "labels": {
    string: string,
    ...
  }
}
Felder
name

string

Erforderlich. Name der TlsRoute-Ressource. Er entspricht dem Muster projects/*/locations/global/tlsRoutes/tls_route_name>.

createTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

description

string

Optional. Eine Freitextbeschreibung der Ressource. Maximale Länge: 1.024 Zeichen.

rules[]

object (RouteRule)

Erforderlich. Regeln, die festlegen, wie Traffic weitergeleitet und verarbeitet wird. Es muss mindestens eine Routingregel angegeben werden. Wenn es mehrere Regeln gibt, ist die durchgeführte Aktion die erste Regel mit der Übereinstimmung.

meshes[]

string

Optional. Mit „Meshes“ wird eine Liste von Meshes definiert, an die diese TlsRoute angehängt ist. Dies ist eine der Routingregeln für die Weiterleitung der vom Mesh gesendeten Anfragen.

Jeder Verweis auf das Mesh-Netzwerk sollte dem Muster projects/*/locations/global/meshes/<mesh_name> entsprechen.

Das angehängte Mesh sollte vom Typ SIDECAR sein.

gateways[]

string

Optional. „Gateways“ definiert eine Liste von Gateways, an die diese TlsRoute angehängt ist, als eine der Routingregeln für die Weiterleitung der vom Gateway verarbeiteten Anfragen.

Jede Gateway-Referenz muss dem Muster entsprechen: projects/*/locations/global/gateways/<gateway_name>

labels

map (key: string, value: string)

Optional. Label-Tags, die mit der TlsRoute-Ressource verknüpft sind.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

RouteRule

Hier wird festgelegt, wie Traffic abgeglichen und weitergeleitet wird, wenn ein Abgleich erfolgt.

JSON-Darstellung
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
Felder
matches[]

object (RouteMatch)

Erforderlich. Mit „RouteMatch“ wird das Prädikat definiert, mit dem Anfragen mit einer bestimmten Aktion abgeglichen werden. Bei der Auswertung werden mehrere Keyword-Optionen „ODER“ verknüpft.

action

object (RouteAction)

Erforderlich. Die detaillierte Regel, die festlegt, wie übereinstimmender Traffic weitergeleitet wird.

RouteMatch

Mit „RouteMatch“ wird das Prädikat definiert, mit dem Anfragen mit einer bestimmten Aktion abgeglichen werden. Mehrere Keyword-Optionen werden zur Auswertung mit UND verknüpft. Wenn kein Feld „routeMatch“ angegeben ist, wird mit dieser Regel der Traffic bedingungslos abgeglichen.

JSON-Darstellung
{
  "sniHost": [
    string
  ],
  "alpn": [
    string
  ]
}
Felder
sniHost[]

string

Optional. SNI (Server Name Indicator) für den Abgleich SNI wird mit allen Platzhalterdomains abgeglichen, d.h. www.example.com wird zuerst mit www.example.com, dann *.example.com abgeglichen, dann *.com. Teilweise Platzhalter werden nicht unterstützt und Werte wie *w.example.com sind ungültig. Es muss mindestens eine der beiden Optionen „sniHost“ oder „alpn“ angegeben werden. Es können bis zu 100 SNI-Hosts für alle Übereinstimmungen festgelegt werden.

alpn[]

string

Optional. ALPN (Application-Layer Protocol Negotiation) für den Abgleich. Beispiele: „http/1.1“, „h2“. Mindestens eines der Attribute sniHost oder alpn ist erforderlich. Für alle Übereinstimmungen können bis zu fünf ALPNs festgelegt werden.

RouteAction

Die Spezifikationen für die Weiterleitung von Traffic und die Anwendung zugehöriger Richtlinien.

JSON-Darstellung
{
  "destinations": [
    {
      object (RouteDestination)
    }
  ],
  "idleTimeout": string
}
Felder
destinations[]

object (RouteDestination)

Erforderlich. Die Zieldienste, an die Traffic weitergeleitet werden soll. Es ist mindestens ein Zieldienst erforderlich.

idleTimeout

string (Duration format)

Optional. Gibt das Zeitlimit bei 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 nicht festgelegt, beträgt die Standardzeitüberschreitung für Inaktivität 1 Stunde. 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 "s". Beispiel: "3.5s".

RouteDestination

Beschreiben Sie das Ziel, an das der Traffic weitergeleitet werden soll.

JSON-Darstellung
{
  "serviceName": string,
  "weight": integer
}
Felder
serviceName

string

Erforderlich. Die URL eines BackendService, an den der Traffic weitergeleitet werden soll.

weight

integer

Optional. Gibt den Anteil der Anfragen an, die an das Backend weitergeleitet wurden, auf das im Feld „serviceName“ verwiesen wird. Sie wird wie folgt berechnet: – Gewichtung/Summe(Gewichtungen in Zielen) Die Gewichtungen in allen Zielen müssen nicht die Summe von 100 ergeben.

Methoden

create

Erstellt eine neue TlsRoute in einem bestimmten Projekt und an einem bestimmten Standort.

delete

Löscht eine einzelne TlsRoute.

get

Ruft Details zu einer einzelnen TlsRoute ab.

getIamPolicy

Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab.

list

Listet TlsRoute in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

Aktualisiert die Parameter einer einzelnen TlsRoute.

setIamPolicy

Legt die Zugriffskontrollrichtlinie für die angegebene Ressource fest.

testIamPermissions

Gibt die Berechtigungen des Aufrufers für die angegebene Ressource zurück.