REST Resource: projects.locations.tlsRoutes

Ressource: TlsRoute

TlsRoute definiert, wie Traffic anhand von 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. Sie 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 für den Zeitpunkt, zu dem 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 definieren, wie Traffic weitergeleitet und verarbeitet wird. Es muss mindestens eine RouteRule angegeben werden. Wenn es mehrere Regeln gibt, ist die ausgeführte Aktion die erste Regel, die übereinstimmt.

meshes[]

string

Optional. Meshes definiert eine Liste von Mesh-Netzwerken, an die diese TlsRoute angehängt ist, als eine der Routingregeln zum Weiterleiten der vom Mesh verarbeiteten Anfragen.

Jeder Mesh-Verweis sollte diesem Muster entsprechen: projects/*/locations/global/meshes/<mesh_name>

Das angehängte Mesh-Netzwerk muss vom Typ SIDECAR sein

gateways[]

string

Optional. Gateways definieren eine Liste von Gateways, an die diese TlsRoute angehängt ist. Dies geschieht als eine der Routingregeln zum Weiterleiten der vom Gateway bereitgestellten Anfragen.

Jeder Gatewayverweis sollte dem Muster entsprechen: projects/*/locations/global/gateways/<gateway_name>

labels

map (key: string, value: string)

Optional. Satz von 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

Gibt an, wie der Verkehr abgeglichen und weitergeleitet wird, wenn er abgeglichen wird.

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

object (RouteMatch)

Erforderlich. RouteMatch definiert das Prädikat, mit dem Anfragen einer bestimmten Aktion zugeordnet werden. Mehrere Keyword-Optionen werden zur Auswertung mit „ODER“ verknüpft.

action

object (RouteAction)

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 UND verbunden. Wenn kein „routeMatch“-Feld angegeben ist, gleicht diese Regel den Traffic unbedingt ab.

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 und dann *.example.com abgeglichen. *.com. Teilweise Platzhalter werden nicht unterstützt und Werte wie *w.example.com sind ungültig. Mindestens entweder „sniHost“ oder „alpn“ ist erforderlich. Für alle Übereinstimmungen können bis zu 100 sni-Hosts eingerichtet werden.

alpn[]

string

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

RouteAction

Die Spezifikationen für das Routing 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. Mindestens ein Zieldienst ist erforderlich.

idleTimeout

string (Duration format)

Optional. Gibt das Zeitlimit bei Inaktivität für die ausgewählte Route an. Das Zeitlimit bei Inaktivität ist definiert als der Zeitraum, in dem keine Byte über die Upstream- oder die Downstream-Verbindung gesendet oder empfangen wurden. Wenn die Richtlinie nicht konfiguriert ist, beträgt die standardmäßige Zeitüberschreitung bei Inaktivität 1 Stunde. Bei der Einstellung auf 0 s wird das Zeitlimit 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 Traffic weitergeleitet werden soll.

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

string

Erforderlich. Die URL eines BackendService, an den 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. Dies wird wie folgt berechnet: -weight/Sum(Gewichtungen in Zielen) Die Summe der Gewichtungen in allen Zielen muss nicht 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.

list

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

patch

Aktualisiert die Parameter einer einzelnen TlsRoute.

setIamPolicy

Legt die Richtlinie für die Zugriffssteuerung für die angegebene Ressource fest.

testIamPermissions

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