REST Resource: projects.locations.tlsRoutes

Resource: TlsRoute

TlsRoute menentukan cara traffic harus dirutekan berdasarkan SNI dan atribut L3 pencocokan lainnya.

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. Pola 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 hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource diperbarui.

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

description

string

Opsional. Deskripsi teks bebas tentang resource. Panjang maksimum 1.024 karakter.

rules[]

object (RouteRule)

Wajib. Aturan yang menentukan cara traffic dirutekan dan ditangani. Setidaknya 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 dilampirkan, sebagai salah satu aturan pemilihan rute untuk merutekan permintaan yang ditayangkan oleh mesh.

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

Mesh yang terpasang harus berjenis SIDECAR

gateways[]

string

Opsional. Gateway menentukan daftar gateway tempat TlsRoute ini dilampirkan, sebagai salah satu aturan pemilihan rute untuk merutekan permintaan yang ditayangkan 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 merutekan 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 dihubungkan dengan "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 digabungkan dengan "AND" untuk evaluasi. Jika tidak ada kolom routeMatch yang ditentukan, aturan ini akan mencocokkan traffic tanpa syarat.

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

string

Opsional. SNI (server name indicator) 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, lalu *.com. Karakter pengganti sebagian tidak didukung, dan nilai seperti *w.example.com tidak valid. Setidaknya salah satu dari sniHost dan alpn diperlukan. Anda dapat menetapkan hingga 100 host sni di semua kecocokan.

alpn[]

string

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

RouteAction

Spesifikasi untuk merutekan traffic dan menerapkan kebijakan terkait.

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

object (RouteDestination)

Wajib. Layanan tujuan tempat traffic harus diteruskan. Setidaknya diperlukan satu layanan tujuan.

idleTimeout

string (Duration format)

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

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

RouteDestination

Deskripsikan tujuan traffic yang akan dirutekan.

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

string

Wajib. URL BackendService yang akan dirutekan trafficnya.

weight

integer

Opsional. Menentukan proporsi permintaan yang diteruskan ke backend yang dirujuk oleh kolom serviceName. Ini dihitung sebagai: - weight/Sum(weights in destinations) Bobot di semua tujuan tidak perlu berjumlah 100.

Metode

create

Membuat TlsRoute baru di project dan lokasi tertentu.

delete

Menghapus satu TlsRoute.

get

Mendapatkan detail satu TlsRoute.

getIamPolicy

Mendapatkan kebijakan kontrol akses untuk resource.

list

Mencantumkan TlsRoute di project dan lokasi tertentu.

patch

Memperbarui parameter satu TlsRoute.

setIamPolicy

Menetapkan kebijakan kontrol akses pada resource yang ditentukan.

testIamPermissions

Menampilkan izin yang dimiliki pemanggil pada resource yang ditentukan.