REST Resource: projects.locations.httpRoutes

Resource: HttpRoute

HttpRoute adalah resource yang menentukan cara traffic HTTP harus dirutekan oleh resource Mesh atau Gateway.

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

string

ID. Nama resource HttpRoute. URL ini cocok dengan pola projects/*/locations/*/httpRoutes/http_route_name>.

description

string

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

createTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

hostnames[]

string

Wajib. Nama host menentukan kumpulan host yang harus cocok dengan header host HTTP untuk memilih HttpRoute yang akan memproses permintaan. Nama host adalah nama domain yang sepenuhnya memenuhi syarat (FQDN) dari host jaringan, seperti yang ditentukan oleh RFC 1123 dengan pengecualian bahwa: - IP tidak diizinkan. - Nama host dapat diawali dengan label karakter pengganti (*.). Label karakter pengganti harus muncul sendiri sebagai label pertama.

Nama host dapat berupa "precise", yaitu nama domain tanpa titik akhir host jaringan (misalnya foo.example.com) atau "wildcard", yaitu nama domain yang diawali dengan satu label karakter pengganti (misalnya *.example.com).

Perhatikan bahwa sesuai dengan RFC1035 dan RFC1123, label harus terdiri dari karakter alfanumerik huruf kecil atau '-', serta harus diawali dan diakhiri dengan karakter alfanumerik. Tanda baca lainnya tidak diizinkan.

Rute yang terkait dengan Mesh atau Gateway harus memiliki nama host yang unik. Jika Anda mencoba melampirkan beberapa rute dengan nama host yang bertentangan, konfigurasi akan ditolak.

Misalnya, meskipun rute untuk nama host *.foo.bar.com dan *.bar.com dapat dikaitkan dengan Mesh yang sama (atau Gateway dalam cakupan yang sama), Anda tidak dapat mengaitkan dua rute dengan *.bar.com atau keduanya dengan bar.com.

meshes[]

string

Opsional. Mesh menentukan daftar mesh yang dilampirkan ke HttpRoute ini, sebagai salah satu aturan pemilihan rute untuk merutekan permintaan yang disajikan oleh mesh.

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

Mesh yang terpasang harus berjenis SIDECAR

gateways[]

string

Opsional. Gateway menentukan daftar gateway yang terhubung ke HttpRoute ini, sebagai salah satu aturan pemilihan rute untuk merutekan permintaan yang disajikan oleh gateway.

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

labels

map (key: string, value: string)

Opsional. Kumpulan tag label yang terkait dengan resource HttpRoute.

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

rules[]

object (RouteRule)

Wajib. Aturan yang menentukan cara perutean dan penanganan traffic. Aturan akan dicocokkan secara berurutan berdasarkan RouteMatch yang ditentukan untuk aturan tersebut.

RouteRule

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

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

object (RouteMatch)

Daftar kecocokan menentukan kondisi yang digunakan untuk mencocokkan aturan dengan permintaan HTTP yang masuk. Setiap kecocokan bersifat independen, yaitu aturan ini akan dicocokkan jika SALAH SATU kecocokan terpenuhi.

Jika tidak ada kolom kecocokan yang ditentukan, aturan ini akan mencocokkan traffic tanpa syarat.

Jika ingin mengonfigurasi aturan default, tambahkan aturan tanpa kecocokan yang ditentukan ke akhir daftar aturan.

action

object (RouteAction)

Aturan mendetail yang menentukan cara merutekan traffic yang cocok.

RouteMatch

RouteMatch menentukan spesifikasi yang digunakan untuk mencocokkan permintaan. Jika beberapa jenis pencocokan ditetapkan, RouteMatch ini akan cocok jika SEMUA jenis pencocokan cocok.

Representasi JSON
{
  "ignoreCase": boolean,
  "headers": [
    {
      object (HeaderMatch)
    }
  ],
  "queryParameters": [
    {
      object (QueryParameterMatch)
    }
  ],

  // Union field PathMatch can be only one of the following:
  "fullPathMatch": string,
  "prefixMatch": string,
  "regexMatch": string
  // End of list of possible types for union field PathMatch.
}
Kolom
ignoreCase

boolean

Menentukan apakah kecocokan prefixMatch dan fullPathMatch peka huruf besar/kecil. Nilai defaultnya adalah false.

headers[]

object (HeaderMatch)

Menentukan daftar header permintaan HTTP yang akan dicocokkan. SEMUA header yang diberikan harus cocok.

queryParameters[]

object (QueryParameterMatch)

Menentukan daftar parameter kueri yang akan dicocokkan. SEMUA parameter kueri harus cocok.

Kolom union PathMatch.

PathMatch hanya dapat berupa salah satu dari hal berikut:

fullPathMatch

string

Nilai jalur permintaan HTTP harus sama persis dengan nilai ini.

Hanya salah satu dari fullPathMatch, prefixMatch, atau regexMatch yang boleh digunakan.

prefixMatch

string

Nilai jalur permintaan HTTP harus diawali dengan prefixMatch yang ditentukan. prefixMatch harus diawali dengan /.

Hanya salah satu dari fullPathMatch, prefixMatch, atau regexMatch yang boleh digunakan.

regexMatch

string

Nilai jalur permintaan HTTP harus memenuhi ekspresi reguler yang ditentukan oleh regexMatch setelah menghapus parameter kueri dan anchor yang diberikan dengan URL asli. Untuk tata bahasa ekspresi reguler, lihat https://github.com/google/re2/wiki/Syntax

Hanya salah satu dari fullPathMatch, prefixMatch, atau regexMatch yang boleh digunakan.

HeaderMatch

Menentukan cara memilih aturan rute berdasarkan header permintaan HTTP.

Representasi JSON
{
  "header": string,
  "invertMatch": boolean,

  // Union field MatchType can be only one of the following:
  "exactMatch": string,
  "regexMatch": string,
  "prefixMatch": string,
  "presentMatch": boolean,
  "suffixMatch": string,
  "rangeMatch": {
    object (IntegerRange)
  }
  // End of list of possible types for union field MatchType.
}
Kolom
header

string

Nama header HTTP yang akan dicocokkan.

invertMatch

boolean

Jika ditentukan, hasil pencocokan akan dibalik sebelum diperiksa. Nilai default ditetapkan ke false.

Kolom union MatchType.

MatchType hanya dapat berupa salah satu dari hal berikut:

exactMatch

string

Nilai header harus sama persis dengan konten exactMatch.

regexMatch

string

Nilai header harus cocok dengan ekspresi reguler yang ditentukan dalam regexMatch. Untuk tata bahasa ekspresi reguler, lihat: https://github.com/google/re2/wiki/Syntax

prefixMatch

string

Nilai header harus diawali dengan konten prefixMatch.

presentMatch

boolean

Header dengan headerName harus ada. Pencocokan terjadi terlepas dari apakah header memiliki nilai atau tidak.

suffixMatch

string

Nilai header harus diakhiri dengan konten suffixMatch.

rangeMatch

object (IntegerRange)

Jika ditentukan, aturan akan cocok jika nilai header permintaan berada dalam rentang.

IntegerRange

Merepresentasikan rentang nilai bilangan bulat.

Representasi JSON
{
  "start": integer,
  "end": integer
}
Kolom
start

integer

Awal rentang (inklusif)

end

integer

Akhir rentang (eksklusif)

QueryParameterMatch

Spesifikasi untuk mencocokkan parameter kueri dalam permintaan.

Representasi JSON
{
  "queryParameter": string,

  // Union field MatchType can be only one of the following:
  "exactMatch": string,
  "regexMatch": string,
  "presentMatch": boolean
  // End of list of possible types for union field MatchType.
}
Kolom
queryParameter

string

Nama parameter kueri yang akan dicocokkan.

Kolom union MatchType.

MatchType hanya dapat berupa salah satu dari hal berikut:

exactMatch

string

Nilai parameter kueri harus sama persis dengan konten exactMatch.

Hanya salah satu dari exactMatch, regexMatch, atau presentMatch yang harus ditetapkan.

regexMatch

string

Nilai parameter kueri harus cocok dengan ekspresi reguler yang ditentukan oleh regexMatch. Untuk tata bahasa ekspresi reguler, lihat https://github.com/google/re2/wiki/Syntax

Hanya salah satu dari exactMatch, regexMatch, atau presentMatch yang harus ditetapkan.

presentMatch

boolean

Menentukan bahwa QueryParameterMatcher cocok jika permintaan berisi parameter kueri, terlepas dari apakah parameter tersebut memiliki nilai atau tidak.

Hanya salah satu dari exactMatch, regexMatch, atau presentMatch yang harus ditetapkan.

RouteAction

Spesifikasi untuk merutekan traffic dan menerapkan kebijakan terkait.

Representasi JSON
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "redirect": {
    object (Redirect)
  },
  "faultInjectionPolicy": {
    object (FaultInjectionPolicy)
  },
  "requestHeaderModifier": {
    object (HeaderModifier)
  },
  "responseHeaderModifier": {
    object (HeaderModifier)
  },
  "urlRewrite": {
    object (URLRewrite)
  },
  "timeout": string,
  "retryPolicy": {
    object (RetryPolicy)
  },
  "requestMirrorPolicy": {
    object (RequestMirrorPolicy)
  },
  "corsPolicy": {
    object (CorsPolicy)
  },
  "statefulSessionAffinity": {
    object (StatefulSessionAffinityPolicy)
  },
  "directResponse": {
    object (HttpDirectResponse)
  },
  "idleTimeout": string
}
Kolom
destinations[]

object (Destination)

Tujuan penerusan traffic.

redirect

object (Redirect)

Jika ditetapkan, permintaan akan diarahkan seperti yang dikonfigurasi oleh kolom ini.

faultInjectionPolicy

object (FaultInjectionPolicy)

Spesifikasi untuk injeksi kesalahan yang diperkenalkan ke traffic untuk menguji ketahanan klien terhadap kegagalan layanan backend. Sebagai bagian dari injeksi kesalahan, saat klien mengirim permintaan ke layanan backend, penundaan dapat diterapkan pada persentase permintaan sebelum mengirim permintaan tersebut ke layanan backend. Demikian pula, permintaan dari klien dapat dibatalkan untuk persentase permintaan tertentu.

timeout dan retryPolicy akan diabaikan oleh klien yang dikonfigurasi dengan faultInjectionPolicy

requestHeaderModifier

object (HeaderModifier)

Spesifikasi untuk mengubah header permintaan yang cocok sebelum permintaan dikirim ke tujuan. Jika HeaderModifiers ditetapkan di Destination dan RouteAction, keduanya akan digabungkan. Konflik antara keduanya tidak akan diselesaikan pada konfigurasi.

responseHeaderModifier

object (HeaderModifier)

Spesifikasi untuk mengubah header respons sebelum mengirimkan respons kembali ke klien. Jika HeaderModifiers ditetapkan di Destination dan RouteAction, keduanya akan digabungkan. Konflik antara keduanya tidak akan diselesaikan pada konfigurasi.

urlRewrite

object (URLRewrite)

Spesifikasi untuk menulis ulang URL sebelum meneruskan permintaan ke tujuan.

timeout

string (Duration format)

Menentukan waktu tunggu untuk rute yang dipilih. Waktu tunggu dihitung dari saat permintaan telah diproses sepenuhnya (yaitu akhir streaming) hingga respons telah diproses sepenuhnya. Waktu tunggu mencakup semua percobaan ulang.

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

retryPolicy

object (RetryPolicy)

Menentukan kebijakan percobaan ulang yang terkait dengan rute ini.

requestMirrorPolicy

object (RequestMirrorPolicy)

Menentukan kebijakan tentang cara permintaan yang ditujukan untuk tujuan rute dibayangi ke tujuan yang diduplikasi secara terpisah. Proxy tidak akan menunggu tujuan bayangan merespons sebelum menampilkan respons. Sebelum mengirim traffic ke layanan bayangan, header host/otoritas diberi akhiran -shadow.

corsPolicy

object (CorsPolicy)

Spesifikasi untuk mengizinkan permintaan lintas origin sisi klien.

statefulSessionAffinity

object (StatefulSessionAffinityPolicy)

Opsional. Menentukan afinitas sesi stateful berbasis cookie.

directResponse

object (HttpDirectResponse)

Opsional. Objek Respons HTTP statis yang akan ditampilkan, terlepas dari permintaannya.

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 pada koneksi upstream atau downstream. Jika tidak ditetapkan, waktu tunggu tidak ada aktivitas default-nya adalah 1 jam. Jika disetel ke 0 dtk, waktu tunggu akan dinonaktifkan.

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

Tujuan

Spesifikasi tujuan yang harus menjadi tujuan perutean permintaan.

Representasi JSON
{
  "serviceName": string,
  "weight": integer,
  "requestHeaderModifier": {
    object (HeaderModifier)
  },
  "responseHeaderModifier": {
    object (HeaderModifier)
  }
}
Kolom
serviceName

string

URL BackendService yang menjadi tujuan perutean traffic.

weight

integer

Menentukan proporsi permintaan yang diteruskan ke backend yang direferensikan oleh kolom serviceName. Nilai ini dihitung sebagai: - bobot/Jumlah(bobot dalam daftar tujuan ini). Untuk nilai bukan nol, mungkin ada beberapa epsilon dari proporsi persis yang ditentukan di sini, bergantung pada presisi yang didukung implementasi.

Jika hanya satu serviceName yang ditentukan dan memiliki bobot lebih besar dari 0, 100% traffic akan diteruskan ke backend tersebut.

Jika bobot ditentukan untuk salah satu nama layanan, bobot tersebut harus ditentukan untuk semua nama layanan.

Jika bobot tidak ditentukan untuk semua layanan, traffic akan didistribusikan dalam proporsi yang sama ke semua layanan.

requestHeaderModifier

object (HeaderModifier)

Opsional. Spesifikasi untuk mengubah header permintaan yang cocok sebelum permintaan dikirim ke tujuan. Jika HeaderModifiers ditetapkan di Destination dan RouteAction, keduanya akan digabungkan. Konflik antara keduanya tidak akan diselesaikan pada konfigurasi.

responseHeaderModifier

object (HeaderModifier)

Opsional. Spesifikasi untuk mengubah header respons sebelum mengirimkan respons kembali ke klien. Jika HeaderModifiers ditetapkan di Destination dan RouteAction, keduanya akan digabungkan. Konflik antara keduanya tidak akan diselesaikan pada konfigurasi.

HeaderModifier

Spesifikasi untuk mengubah header HTTP dalam permintaan HTTP dan respons HTTP.

Representasi JSON
{
  "set": {
    string: string,
    ...
  },
  "add": {
    string: string,
    ...
  },
  "remove": [
    string
  ]
}
Kolom
set

map (key: string, value: string)

Menimpa/mengganti header sepenuhnya dengan peta yang diberikan, dengan kunci sebagai nama header, dan nilai sebagai nilai header.

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

add

map (key: string, value: string)

Tambahkan header dengan peta yang diberikan, dengan kunci adalah nama header, dan nilai adalah nilai header.

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

remove[]

string

Menghapus header (yang cocok dengan nama header) yang ditentukan dalam daftar.

Pengalihan

Spesifikasi untuk mengalihkan traffic.

Representasi JSON
{
  "hostRedirect": string,
  "pathRedirect": string,
  "prefixRewrite": string,
  "responseCode": enum (ResponseCode),
  "httpsRedirect": boolean,
  "stripQuery": boolean,
  "portRedirect": integer
}
Kolom
hostRedirect

string

Host yang akan digunakan dalam respons pengalihan, bukan host yang diberikan dalam permintaan.

pathRedirect

string

Jalur yang akan digunakan dalam respons pengalihan, bukan jalur yang diberikan dalam permintaan. pathRedirect tidak dapat diberikan bersama dengan prefixRedirect. Berikan salah satu saja atau tidak keduanya. Jika keduanya tidak diberikan, jalur permintaan asli akan digunakan untuk pengalihan.

prefixRewrite

string

Menunjukkan bahwa selama pengalihan, awalan (atau jalur) yang cocok harus diganti dengan nilai ini. Opsi ini memungkinkan URL dibuat secara dinamis berdasarkan permintaan.

responseCode

enum (ResponseCode)

Kode Status HTTP yang akan digunakan untuk pengalihan.

httpsRedirect

boolean

Jika disetel ke benar (true), skema URL dalam permintaan yang dialihkan akan ditetapkan ke https. Jika ditetapkan ke false, skema URL permintaan yang dialihkan akan tetap sama dengan skema URL permintaan.

Defaultnya disetel ke false.

stripQuery

boolean

Jika ditetapkan ke true, setiap bagian kueri yang menyertai URL asli akan dihapus sebelum permintaan dialihkan. Jika ditetapkan ke false, bagian kueri dari URL origin akan dipertahankan.

Defaultnya disetel ke false.

portRedirect

integer

Port yang akan digunakan dalam permintaan yang dialihkan, bukan port yang diberikan dalam permintaan.

ResponseCode

Kode respons HTTP yang didukung.

Enum
RESPONSE_CODE_UNSPECIFIED Nilai default
MOVED_PERMANENTLY_DEFAULT Sesuai dengan 301.
FOUND Sesuai dengan 302.
SEE_OTHER Sesuai dengan 303.
TEMPORARY_REDIRECT Sesuai dengan 307. Dalam hal ini, metode permintaan akan dipertahankan.
PERMANENT_REDIRECT Sesuai dengan 308. Dalam hal ini, metode permintaan akan dipertahankan.

FaultInjectionPolicy

Spesifikasi untuk injeksi kesalahan yang dimasukkan ke dalam traffic untuk menguji ketahanan klien terhadap kegagalan layanan tujuan. Sebagai bagian dari injeksi kesalahan, saat klien mengirim permintaan ke tujuan, penundaan dapat diperkenalkan oleh proxy klien pada persentase permintaan sebelum mengirim permintaan tersebut ke layanan tujuan. Demikian pula, permintaan dapat dibatalkan oleh proxy klien untuk persentase permintaan.

Representasi JSON
{
  "delay": {
    object (Delay)
  },
  "abort": {
    object (Abort)
  }
}
Kolom
delay

object (Delay)

Spesifikasi untuk memasukkan penundaan ke permintaan klien.

abort

object (Abort)

Spesifikasi untuk membatalkan permintaan klien.

Penundaan

Spesifikasi cara permintaan klien ditunda sebagai bagian dari injeksi kesalahan sebelum dikirim ke tujuan.

Representasi JSON
{
  "fixedDelay": string,
  "percentage": integer
}
Kolom
fixedDelay

string (Duration format)

Tentukan penundaan tetap sebelum meneruskan permintaan.

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

percentage

integer

Persentase traffic yang akan diinjeksikan penundaan.

Nilai harus antara [0, 100]

Batalkan

Spesifikasi cara permintaan klien dibatalkan sebagai bagian dari injeksi kesalahan sebelum dikirim ke tujuan.

Representasi JSON
{
  "httpStatus": integer,
  "percentage": integer
}
Kolom
httpStatus

integer

Kode status HTTP yang digunakan untuk membatalkan permintaan.

Nilai harus antara 200 dan 599 inklusif.

percentage

integer

Persentase traffic yang akan dibatalkan.

Nilai harus antara [0, 100]

URLRewrite

Spesifikasi untuk mengubah URL permintaan, sebelum meneruskan permintaan ke tujuan.

Representasi JSON
{
  "pathPrefixRewrite": string,
  "hostRewrite": string
}
Kolom
pathPrefixRewrite

string

Sebelum meneruskan permintaan ke tujuan yang dipilih, bagian yang cocok dari jalur permintaan akan diganti dengan nilai ini.

hostRewrite

string

Sebelum meneruskan permintaan ke tujuan yang dipilih, header host permintaan akan diganti dengan nilai ini.

RetryPolicy

Spesifikasi untuk percobaan ulang.

Representasi JSON
{
  "retryConditions": [
    string
  ],
  "numRetries": integer,
  "perTryTimeout": string
}
Kolom
retryConditions[]

string

Menentukan satu atau beberapa kondisi saat kebijakan percobaan ulang ini berlaku. Nilai yang valid adalah: 5xx: Proxy akan mencoba lagi jika layanan tujuan merespons dengan kode respons 5xx, atau jika layanan tujuan tidak merespons sama sekali, misalnya: pemutusan koneksi, reset, waktu tunggu baca, kegagalan koneksi, dan streaming yang ditolak.

gateway-error: Mirip dengan 5xx, tetapi hanya berlaku untuk kode respons 502, 503, 504.

reset: Proxy akan mencoba lagi jika layanan tujuan tidak merespons sama sekali (waktu tunggu koneksi terputus/reset/baca)

connect-failure: Proxy akan mencoba lagi jika gagal terhubung ke tujuan, misalnya karena waktu tunggu koneksi habis.

retriable-4xx: Proxy akan mencoba ulang untuk kode respons 4xx yang dapat dicoba ulang. Saat ini, satu-satunya error yang dapat dicoba ulang yang didukung adalah 409.

refused-stream: Proxy akan mencoba lagi jika tujuan mereset streaming dengan kode error REFUSED_STREAM. Jenis reset ini menunjukkan bahwa aman untuk mencoba lagi.

numRetries

integer

Menentukan jumlah percobaan ulang yang diizinkan. Angka ini harus > 0. Jika tidak ditentukan, defaultnya adalah 1.

perTryTimeout

string (Duration format)

Menentukan waktu tunggu bukan nol per upaya percobaan ulang.

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

RequestMirrorPolicy

Menentukan kebijakan tentang cara permintaan dibayangi ke layanan tujuan yang diduplikasi secara terpisah. Proxy tidak menunggu respons dari layanan bayangan. Sebelum mengirim traffic ke layanan bayangan, header host/otoritas diberi akhiran -shadow. Pencerminan saat ini tidak didukung untuk tujuan Cloud Run.

Representasi JSON
{
  "destination": {
    object (Destination)
  },
  "mirrorPercent": number
}
Kolom
destination

object (Destination)

Tujuan tempat permintaan akan diduplikasi. Bobot tujuan akan diabaikan.

mirrorPercent

number

Opsional. Persentase permintaan yang akan diduplikasi ke tujuan yang diinginkan.

CorsPolicy

Spesifikasi untuk mengizinkan permintaan lintas origin sisi klien.

Representasi JSON
{
  "allowOrigins": [
    string
  ],
  "allowOriginRegexes": [
    string
  ],
  "allowMethods": [
    string
  ],
  "allowHeaders": [
    string
  ],
  "exposeHeaders": [
    string
  ],
  "maxAge": string,
  "allowCredentials": boolean,
  "disabled": boolean
}
Kolom
allowOrigins[]

string

Menentukan daftar origin yang akan diizinkan untuk melakukan permintaan CORS. Origin diizinkan jika cocok dengan item di allowOrigins atau item di allowOriginRegexes.

allowOriginRegexes[]

string

Menentukan pola ekspresi reguler yang cocok dengan origin yang diizinkan. Untuk tata bahasa ekspresi reguler, lihat https://github.com/google/re2/wiki/Syntax.

allowMethods[]

string

Menentukan konten untuk header Access-Control-Allow-Methods.

allowHeaders[]

string

Menentukan konten untuk header Access-Control-Allow-Headers.

exposeHeaders[]

string

Menentukan konten untuk header Access-Control-Expose-Headers.

maxAge

string

Menentukan berapa lama hasil permintaan preflight dapat di-cache dalam detik. Header ini diterjemahkan ke header Access-Control-Max-Age.

allowCredentials

boolean

Sebagai respons terhadap permintaan preflight, menyetel nilai ini ke true menunjukkan bahwa permintaan sebenarnya dapat menyertakan kredensial pengguna. Ini diterjemahkan ke header Access-Control-Allow-Credentials.

Nilai defaultnya adalah false.

disabled

boolean

Jika benar (true), kebijakan CORS akan dinonaktifkan. Nilai defaultnya adalah false, yang menunjukkan bahwa kebijakan CORS berlaku.

StatefulSessionAffinityPolicy

Spesifikasi untuk afinitas sesi stateful berbasis cookie, dengan date plane menyediakan “cookie sesi” dengan nama "GSSA" yang mengenkode host tujuan tertentu dan setiap permintaan yang berisi cookie tersebut akan diarahkan ke host tersebut selama host tujuan tetap aktif dan responsif.

Library mesh tanpa proxy gRPC atau proxy sidecar akan mengelola cookie sesi, tetapi kode aplikasi klien bertanggung jawab untuk menyalin cookie dari setiap RPC dalam sesi ke sesi berikutnya.

Representasi JSON
{
  "cookieTtl": string
}
Kolom
cookieTtl

string (Duration format)

Wajib. Nilai TTL cookie untuk header Set-Cookie yang dihasilkan oleh bidang data. Masa aktif cookie dapat ditetapkan ke nilai dari 0 hingga 86.400 detik (24 jam) inklusif.

Tetapkan ke 0s untuk menggunakan cookie sesi dan menonaktifkan masa berlaku cookie.

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

HttpDirectResponse

Objek respons HTTP statis yang akan ditampilkan.

Representasi JSON
{
  "status": integer,

  // Union field HttpBody can be only one of the following:
  "stringBody": string,
  "bytesBody": string
  // End of list of possible types for union field HttpBody.
}
Kolom
status

integer

Wajib. Status yang akan ditampilkan sebagai bagian dari Respons HTTP. Harus berupa bilangan bulat positif.

Kolom union HttpBody. Isi yang akan ditampilkan sebagai bagian dari Respons HTTP. HttpBody hanya ada berupa salah satu diantara berikut:
stringBody

string

Opsional. Isi respons sebagai string. Panjang isi maksimum adalah 1.024 karakter.

bytesBody

string (bytes format)

Opsional. Isi respons sebagai byte. Ukuran isi maksimum adalah 4096B.

String berenkode base64.

Metode

create

Membuat HttpRoute baru di project dan lokasi tertentu.

delete

Menghapus satu HttpRoute.

get

Mendapatkan detail satu HttpRoute.

getIamPolicy

Mendapatkan kebijakan kontrol akses untuk resource.

list

Mencantumkan HttpRoute di project dan lokasi tertentu.

patch

Memperbarui parameter satu HttpRoute.

setIamPolicy

Menetapkan kebijakan kontrol akses pada resource yang ditentukan.

testIamPermissions

Menampilkan izin yang dimiliki pemanggil pada resource yang ditentukan.