Ressource : TlsRoute
TlsRoute définit la manière dont le trafic doit être acheminé en fonction du SNI et d'autres attributs L3 correspondants.
Représentation JSON |
---|
{
"name": string,
"selfLink": string,
"createTime": string,
"updateTime": string,
"description": string,
"rules": [
{
object ( |
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource TlsRoute. Il correspond au schéma |
selfLink |
Uniquement en sortie. URL définie par le serveur de cette ressource |
createTime |
Uniquement en sortie. Code temporel de la création de la ressource. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
updateTime |
Uniquement en sortie. Code temporel de la mise à jour de la ressource. Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : |
description |
Facultatif. Description en texte libre de la ressource. Longueur maximale : 1 024 caractères. |
rules[] |
Obligatoire. Des règles qui définissent la manière dont le trafic est acheminé et géré. Vous devez indiquer au moins un RouteRule. Si plusieurs règles sont définies, l'action effectuée correspond à la première règle correspondante. |
meshes[] |
Facultatif. Les "maillages" définissent une liste de maillages auxquels ce TlsRoute est associé, en tant qu'une des règles de routage permettant d'acheminer les requêtes traitées par le maillage. Chaque référence de maillage doit respecter le format suivant : La structure Mesh associée doit être de type SIDECAR. |
gateways[] |
Facultatif. Les passerelles définissent une liste de passerelles auxquelles ce TlsRoute est associé, car il s'agit de l'une des règles de routage permettant d'acheminer les requêtes diffusées par la passerelle. Chaque référence de passerelle doit respecter le format suivant : |
labels |
Facultatif. Ensemble de tags d'étiquettes associés à la ressource TlsRoute. Objet contenant une liste de paires |
RouteRule
Indique comment mettre en correspondance le trafic et comment l'acheminer lorsqu'il est mis en correspondance.
Représentation JSON |
---|
{ "matches": [ { object ( |
Champs | |
---|---|
matches[] |
Obligatoire. RouteMatch définit le prédicat utilisé pour faire correspondre les requêtes à une action donnée. Plusieurs types de correspondance sont associés à l'opérateur "OU" pour l'évaluation. |
action |
Obligatoire. Règle détaillée définissant comment acheminer le trafic mis en correspondance. |
RouteMatch
RouteMatch définit le prédicat utilisé pour faire correspondre les requêtes à une action donnée. Plusieurs types de correspondance sont associés à l'opérateur "AND" pour l'évaluation. Si aucun champ routeMatch n'est spécifié, cette règle correspondra inconditionnellement au trafic.
Représentation JSON |
---|
{ "sniHost": [ string ], "alpn": [ string ] } |
Champs | |
---|---|
sniHost[] |
Facultatif. SNI (indicateur de nom de serveur) à mettre en correspondance. Le SNI sera mis en correspondance avec tous les domaines avec caractères génériques, c'est-à-dire que |
alpn[] |
Facultatif. ALPN (Application-Layer Protocol Negotiation) à mettre en correspondance. Exemples : "http/1.1", "h2". Vous devez indiquer au moins l'un des champs sniHost et alpn. Vous pouvez définir jusqu'à cinq ALPN pour toutes les correspondances. |
RouteAction
Spécifications pour le routage du trafic et l'application des règles associées.
Représentation JSON |
---|
{
"destinations": [
{
object ( |
Champs | |
---|---|
destinations[] |
Obligatoire. Services de destination vers lesquels le trafic doit être transféré. Veuillez indiquer au moins un service de destination. |
idleTimeout |
Facultatif. Spécifie le délai d'inactivité pour la route sélectionnée. Le délai d'inactivité est défini comme la période au cours de laquelle aucun octet n'est envoyé ni reçu sur la connexion en amont ou en aval. Si ce paramètre n'est pas défini, le délai avant expiration par défaut est de 1 heure. Si cette valeur est définie sur 0 s, le délai avant expiration est désactivé. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
RouteDestination
Décrivez la destination vers laquelle le trafic doit être acheminé.
Représentation JSON |
---|
{ "serviceName": string, "weight": integer } |
Champs | |
---|---|
serviceName |
Obligatoire. URL d'un BackendService vers lequel acheminer le trafic. |
weight |
Facultatif. Spécifie la proportion de requêtes transmises au backend référencé par le champ serviceName. Le calcul est le suivant : - weight/Somme(pondérations dans les destinations) : la somme des pondérations de toutes les destinations n'a pas besoin d'être égale à 100. |
Méthodes |
|
---|---|
|
Crée un TlsRoute dans un projet et un emplacement donnés. |
|
Supprime un seul TlsRoute. |
|
Récupère les détails d'un seul TlsRoute. |
|
Répertorie les TlsRoute dans un projet et un emplacement donnés. |
|
Met à jour les paramètres d'un seul TlsRoute. |