REST Resource: projects.locations.tlsRoutes

Resource: TlsRoute

TlsRoute menentukan cara traffic dirutekan berdasarkan SNI dan atribut L3 lain yang cocok.

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

string

Wajib. Nama resource TlsRoute. Hasil ini cocok dengan pola projects/*/locations/global/tlsRoutes/tls_route_name>.

createTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource diupdate.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

description

string

Opsional. Deskripsi teks bebas resource. Panjang maksimal 1024 karakter.

rules[]

object (RouteRule)

Wajib. Aturan yang menentukan cara lalu lintas dirutekan dan ditangani. Minimal satu RouteRule harus diberikan. Jika ada beberapa aturan, tindakan yang diambil akan menjadi aturan pertama yang cocok.

meshes[]

string

Opsional. Mesh menentukan daftar mesh tempat TlsRoute ini dikaitkan sebagai salah satu aturan pemilihan rute untuk merutekan permintaan yang disalurkan oleh mesh.

Setiap referensi mesh harus cocok dengan pola: projects/*/locations/global/meshes/<mesh_name>

Mesh terlampir harus berjenis SIDECAR

gateways[]

string

Opsional. Gateway menentukan daftar gateway tempat TlsRoute ini dikaitkan, sebagai salah satu aturan pemilihan rute untuk mengarahkan permintaan yang dilayani oleh gateway.

Setiap referensi gateway harus cocok dengan pola: projects/*/locations/global/gateways/<gateway_name>

labels

map (key: string, value: string)

Opsional. Kumpulan tag label yang terkait dengan resource TlsRoute.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

RouteRule

Menentukan cara mencocokkan traffic dan cara mengarahkan traffic saat traffic dicocokkan.

Representasi JSON
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
Kolom
matches[]

object (RouteMatch)

Wajib. RouteMatch menentukan predikat yang digunakan untuk mencocokkan permintaan dengan tindakan tertentu. Beberapa jenis pencocokan diberi "ATAU" untuk evaluasi.

action

object (RouteAction)

Wajib. Aturan mendetail yang menentukan cara merutekan traffic yang cocok.

RouteMatch

RouteMatch menentukan predikat yang digunakan untuk mencocokkan permintaan dengan tindakan tertentu. Beberapa jenis pencocokan diberi "DAN" untuk evaluasi. Jika tidak ada kolom routeMatch yang ditentukan, aturan ini akan cocok dengan traffic tanpa syarat.

Representasi JSON
{
  "sniHost": [
    string
  ],
  "alpn": [
    string
  ]
}
Kolom
sniHost[]

string

Opsional. SNI (indikator nama server) yang akan dicocokkan. SNI akan dicocokkan dengan semua domain karakter pengganti, yaitu www.example.com akan dicocokkan terlebih dahulu dengan www.example.com, lalu *.example.com, kemudian *.com. Karakter pengganti parsial tidak didukung, dan nilai seperti *w.example.com tidak valid. Setidaknya salah satu dari sniHost dan alpn wajib ada. Hingga 100 host SNI di semua pertandingan dapat diatur.

alpn[]

string

Opsional. ALPN (Application-Layer Protocol Negotiation) untuk dicocokkan. Contoh: "http/1.1", "h2". Setidaknya salah satu dari sniHost dan alpn wajib ada. Hingga 5 alpn di semua pertandingan dapat ditetapkan.

RouteAction

Spesifikasi untuk mengarahkan traffic dan menerapkan kebijakan terkait.

Representasi JSON
{
  "destinations": [
    {
      object (RouteDestination)
    }
  ],
  "idleTimeout": string
}
Kolom
destinations[]

object (RouteDestination)

Wajib. Layanan tujuan di mana traffic harus diteruskan. Setidaknya satu layanan tujuan diperlukan.

idleTimeout

string (Duration format)

Opsional. Menentukan waktu tunggu tidak ada aktivitas untuk rute yang dipilih. Waktu tunggu tidak ada aktivitas didefinisikan sebagai periode saat tidak ada byte yang dikirim atau diterima di koneksi upstream atau downstream. Jika tidak disetel, waktu tunggu tidak ada aktivitas default adalah 1 jam. Jika disetel ke 0d, waktu tunggu akan dinonaktifkan.

Durasi dalam detik dengan maksimal sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".

RouteDestination

Deskripsikan destinasi untuk lalu lintas yang akan dirutekan.

Representasi JSON
{
  "serviceName": string,
  "weight": integer
}
Kolom
serviceName

string

Wajib. URL BackendService yang akan menjadi tujuan rute traffic.

weight

integer

Opsional. Menentukan proporsi permintaan yang dicadangkan ke backend yang direferensikan oleh kolom serviceName. Ini dihitung sebagai: - weight/Jumlah(bobot dalam tujuan) Bobot di semua tujuan tidak perlu dijumlahkan hingga 100.

Metode

create

Membuat TlsRoute baru di project dan lokasi tertentu.

delete

Menghapus satu TlsRoute.

get

Mendapatkan detail TlsRoute tunggal.

list

Mencantumkan TlsRoute di project dan lokasi tertentu.

patch

Memperbarui parameter TlsRoute tunggal.