REST Resource: projects.locations.httpRoutes

Resource: HttpRoute

HttpRoute adalah resource yang menentukan cara traffic HTTP 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

Wajib. Nama resource HttpRoute. Pola ini cocok dengan pola projects/*/locations/global/httpRoutes/http_route_name>.

description

string

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

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".

hostnames[]

string

Wajib. Nama host menentukan kumpulan host yang harus cocok dengan header host HTTP untuk memilih HttpRoute guna memproses permintaan. Nama host adalah nama domain yang sepenuhnya memenuhi syarat 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 "akurat", yaitu nama domain tanpa titik akhir host jaringan (misalnya, foo.example.com) atau "karakter pengganti", 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 '-', dan 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 tempat HttpRoute 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 HttpRoute 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 HttpRoute.

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

rules[]

object (RouteRule)

Wajib. Aturan yang menentukan cara traffic dirutekan dan ditangani. Aturan akan dicocokkan secara berurutan berdasarkan RouteMatch yang ditentukan untuk aturan.

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 cocok jika SALAH SATU kecocokan terpenuhi.

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

Jika aturan default ingin dikonfigurasi, tambahkan aturan tanpa pencocokan 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 pencocokan 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 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 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 disertakan dengan URL asli. Untuk tata bahasa ekspresi reguler, lihat https://github.com/google/re2/wiki/Syntax

Hanya 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 salah (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 di 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 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 satu dari exactMatch, regexMatch, atau presentMatch yang harus ditetapkan.

presentMatch

boolean

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

Hanya 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 tempat traffic akan diteruskan.

redirect

object (Redirect)

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

faultInjectionPolicy

object (FaultInjectionPolicy)

Spesifikasi untuk injeksi error yang dimasukkan ke dalam traffic untuk menguji ketahanan klien terhadap kegagalan layanan backend. Sebagai bagian dari injeksi error, saat klien mengirim permintaan ke layanan backend, penundaan dapat terjadi pada persentase permintaan sebelum mengirim permintaan tersebut ke layanan backend. Demikian pula, permintaan dari klien dapat dibatalkan untuk persentase permintaan.

timeout dan retryPolicy akan diabaikan oleh klien yang dikonfigurasi dengan faultInjectionPolicy

requestHeaderModifier

object (HeaderModifier)

Spesifikasi untuk mengubah header permintaan yang cocok sebelum pengiriman permintaan 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 mengirim 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 URL penulisan ulang 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, yang 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 di-shadow ke tujuan yang dicerminkan secara terpisah. Proxy tidak akan menunggu tujuan bayangan merespons sebelum menampilkan respons. Sebelum mengirim traffic ke layanan shadow, header host/otoritas diakhiri dengan -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, apa pun permintaannya.

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".

Tujuan

Spesifikasi tujuan yang akan dituju oleh permintaan.

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

string

URL BackendService yang akan dirutekan trafficnya.

weight

integer

Menentukan proporsi permintaan yang diteruskan ke backend yang dirujuk oleh kolom serviceName. Nilai ini dihitung sebagai: - weight/Sum(weights in this destination list). Untuk nilai non-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 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 pengiriman permintaan 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 mengirim 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)

Ganti sepenuhnya 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" }.

add

map (key: string, value: string)

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

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

remove[]

string

Menghapus header (pencocokan berdasarkan 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 atau tidak satu pun. Jika tidak ada yang diberikan, jalur permintaan asli akan digunakan untuk pengalihan.

prefixRewrite

string

Menunjukkan bahwa selama pengalihan, awalan (atau jalur) yang cocok harus ditukar 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 disetel ke https. Jika ditetapkan ke salah, skema URL permintaan yang dialihkan akan tetap sama dengan permintaan.

Nilai defaultnya ditetapkan ke salah (false).

stripQuery

boolean

jika ditetapkan ke benar, bagian kueri yang menyertai URL asli akan dihapus sebelum mengalihkan permintaan. Jika disetel ke salah (false), bagian kueri dari URL asli akan dipertahankan.

Nilai defaultnya ditetapkan ke salah (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 Berhubungan dengan 301.
FOUND Berhubungan dengan 302.
SEE_OTHER Sesuai dengan 303.
TEMPORARY_REDIRECT Bersesuaian dengan 307. Dalam hal ini, metode permintaan akan dipertahankan.
PERMANENT_REDIRECT Berhubungan dengan 308. Dalam hal ini, metode permintaan akan dipertahankan.

FaultInjectionPolicy

Spesifikasi untuk injeksi error yang dimasukkan ke dalam traffic untuk menguji ketahanan klien terhadap kegagalan layanan tujuan. Sebagai bagian dari injeksi error, saat klien mengirim permintaan ke tujuan, penundaan dapat terjadi 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 tertunda sebagai bagian dari injeksi error 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, yang diakhiri dengan 's'. Contoh: "3.5s".

percentage

integer

Persentase traffic yang akan mengalami penundaan.

Nilai harus antara [0, 100]

Batalkan

Spesifikasi cara permintaan klien dibatalkan sebagai bagian dari injeksi error 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 percobaan ulang jika layanan tujuan merespons dengan kode respons 5xx, atau jika layanan tujuan tidak merespons sama sekali, contoh: pemutusan koneksi, reset, waktu tunggu baca habis, kegagalan koneksi, dan aliran yang ditolak.

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

reset: Proxy akan mencoba percobaan ulang jika layanan tujuan tidak merespons sama sekali (waktu tunggu koneksi/reset/baca habis)

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

retriable-4xx: Proxy akan mencoba lagi 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 Anda dapat mencoba lagi dengan aman.

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 yang bukan nol per upaya percobaan ulang.

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

RequestMirrorPolicy

Menentukan kebijakan tentang cara permintaan di-shadow ke layanan tujuan yang dicerminkan secara terpisah. Proxy tidak menunggu respons dari layanan bayangan. Sebelum mengirim traffic ke layanan shadow, header host/otoritas diakhiri dengan -shadow.

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

object (Destination)

Tujuan tempat permintaan akan dicerminkan. Bobot tujuan akan diabaikan.

mirrorPercent

number

Opsional. Persentase permintaan yang akan dicerminkan 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 pra-penerbangan dapat disimpan dalam cache dalam hitungan detik. Hal ini diterjemahkan ke header Access-Control-Max-Age.

allowCredentials

boolean

Sebagai respons terhadap permintaan pra-penerbangan, menyetelnya ke true menunjukkan bahwa permintaan sebenarnya dapat menyertakan kredensial pengguna. Hal ini diterjemahkan ke header Access-Control-Allow-Credentials.

Nilai defaultnya adalah false (salah).

disabled

boolean

Jika benar, kebijakan CORS akan dinonaktifkan. Nilai defaultnya adalah salah, yang menunjukkan bahwa kebijakan CORS berlaku.

StatefulSessionAffinityPolicy

Spesifikasi untuk afinitas sesi stateful berbasis cookie dengan bidang tanggal yang 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 berfungsi.

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 berlaku cookie dapat ditetapkan ke nilai dari 1 hingga 86.400 detik (24 jam) tanpa kecuali.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang 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.

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.