REST Resource: projects.locations.httpRoutes

Resource: HttpRoute

HttpRoute adalah resource yang menentukan cara traffic HTTP diarahkan 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. Hasil ini cocok dengan pola projects/*/locations/global/httpRoutes/http_route_name>.

description

string

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

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

hostnames[]

string

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

Nama host dapat berupa "akurat" yang merupakan nama domain tanpa titik akhir host jaringan (misalnya foo.example.com) atau "karakter pengganti", yang merupakan nama domain yang diawali dengan label karakter pengganti tunggal (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 lain 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 (atau Gateway dalam cakupan yang sama), kedua rute tidak dapat dikaitkan dengan *.bar.com atau keduanya dengan bar.com.

meshes[]

string

Opsional. Mesh menentukan daftar mesh tempat HttpRoute 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 HttpRoute ini dikaitkan, sebagai salah satu aturan pemilihan rute untuk merutekan 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 HttpRoute.

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

rules[]

object (RouteRule)

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

RouteRule

Menentukan cara mencocokkan traffic dan cara mengarahkan 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 terhadap permintaan HTTP yang masuk. Setiap kecocokan bersifat independen. Artinya, aturan ini akan dicocokkan jika SALAH SATU dari 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 di bagian 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 kecocokan 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 awalanMatchMatch 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 yang berikut:

fullPathMatch

string

Nilai jalur permintaan HTTP harus sama persis dengan nilai ini.

Hanya salah satu dari fullPathMatch, prefiksMatch, atau regexMatch yang harus digunakan.

prefixMatch

string

Nilai jalur permintaan HTTP harus diawali dengan awalanMatch yang ditentukan. prefiksMatch harus diawali dengan /.

Hanya salah satu dari fullPathMatch, prefiksMatch, atau regexMatch yang harus digunakan.

regexMatch

string

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

Hanya salah satu dari fullPathMatch, prefiksMatch, atau regexMatch yang harus 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 kecocokan akan dibalik sebelum pemeriksaan. Nilai defaultnya ditetapkan ke false.

Kolom union MatchType.

MatchType hanya dapat berupa salah satu dari yang berikut:

exactMatch

string

Nilai header harus sama persis dengan kontenexactMatch.

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

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

Mewakili 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 yang berikut:

exactMatch

string

Nilai parameter kueri harus sama persis dengan kontenexactMatch.

Hanya salah satu dariexactMatch, regexMatch, atau presentMatch yang harus disetel.

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 dariexactMatch, regexMatch, atau presentMatch yang harus disetel.

presentMatch

boolean

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

Hanya salah satu dariexactMatch, regexMatch, atau presentMatch yang harus disetel.

RouteAction

Spesifikasi untuk mengarahkan 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 mana traffic harus diteruskan.

redirect

object (Redirect)

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

faultInjectionPolicy

object (FaultInjectionPolicy)

Spesifikasi untuk injeksi fault 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 terjadi pada sebagian persentase permintaan sebelum mengirim permintaan tersebut ke layanan backend. Demikian pula, permintaan dari klien dapat dibatalkan untuk sebagian persentase permintaan.

waktu tunggu dan tryPolicy akan diabaikan oleh klien yang dikonfigurasi dengan faultExtractionPolicy

requestHeaderModifier

object (HeaderModifier)

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

responseHeaderModifier

object (HeaderModifier)

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

urlRewrite

object (URLRewrite)

Spesifikasi untuk penulisan ulang URL sebelum meneruskan permintaan ke tujuan.

timeout

string (Duration format)

Menentukan waktu tunggu untuk rute yang dipilih. Waktu tunggu dihitung sejak permintaan selesai diproses (yaitu akhir streaming) hingga respons selesai diproses. 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 dicerminkan 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 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".

Tujuan

Spesifikasi tujuan tempat permintaan akan dirutekan.

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

string

URL BackendService yang akan menjadi tujuan rute traffic.

weight

integer

Menentukan proporsi permintaan yang diteruskan ke backend yang dirujuk oleh kolom serviceName. Hal ini dihitung sebagai: - weight/Sum(bobot dalam daftar tujuan ini). Untuk nilai bukan nol, mungkin ada beberapa epsilon dari proporsi yang tepat yang didefinisikan 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 harus ditentukan untuk semuanya.

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 pada Destination dan RouteAction, keduanya akan digabungkan. Konflik di antara keduanya tidak akan diselesaikan melalui konfigurasi.

responseHeaderModifier

object (HeaderModifier)

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

HeaderModifier

Spesifikasi untuk memodifikasi 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)

Sepenuhnya menimpa/mengganti header dengan peta yang diberikan dengan kunci adalah nama header, nilainya adalah nilai header.

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

add

map (key: string, value: string)

Menambahkan 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 (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 disediakan dalam permintaan.

pathRedirect

string

Jalur yang akan digunakan dalam respons pengalihan, bukan yang disediakan dalam permintaan. pathRedirect tidak dapat diberikan bersama denganprefixRedirect. Sediakan 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 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 disetel ke salah (false), skema URL permintaan yang dialihkan akan tetap sama dengan skema URL permintaan.

Nilai defaultnya adalah salah (false).

stripQuery

boolean

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

Nilai defaultnya adalah 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 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 fault yang diperkenalkan ke 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 beberapa persentase permintaan sebelum mengirim permintaan tersebut ke layanan tujuan. Demikian pula, permintaan dapat dibatalkan oleh proxy klien untuk sebagian dari 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 tentang bagaimana permintaan klien tertunda 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 tempat penundaan akan dimasukkan.

Nilai harus antara [0, 100]

Batalkan

Spesifikasi tentang bagaimana 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.

Nilainya 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 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 diterapkan. Nilai yang valid adalah: 5xx: Proxy akan mencoba mencoba lagi jika layanan tujuan merespons dengan kode respons 5xx apa pun, atau jika layanan tujuan tidak merespons sama sekali, contoh: putuskan sambungan, reset, waktu tunggu baca habis, 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 terputus/reset/baca)

kegagalan koneksi: Proxy akan mencoba lagi jika 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 lagi adalah 409.

streaming yang ditolak: Proxy akan mencoba lagi jika tujuan streaming tersebut direset dengan kode error REFUSE_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 dicerminkan terpisah. Proxy tidak menunggu respons dari layanan bayangan. Sebelum mengirim traffic ke layanan bayangan, header host/otoritas diberi akhiran -shadow.

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 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-mengekspos-Header.

maxAge

string

Menentukan berapa lama hasil permintaan preflight dapat di-cache dalam hitungan detik. Hal ini diartikan sebagai {i> header<i} Access-Control-Max-Age.

allowCredentials

boolean

Sebagai respons atas permintaan preflight, menyetel nilai ini ke benar (true) akan menunjukkan bahwa permintaan sebenarnya dapat menyertakan kredensial pengguna. Hal ini diartikan ke {i>header<i} {i>Access-Control-Allow-Credentials<i}.

Nilai defaultnya adalah false.

disabled

boolean

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

StatefulSessionAffinityPolicy

Spesifikasi untuk afinitas sesi stateful berbasis cookie dengan bidang tanggal 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 file bantuan 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 dibuat oleh bidang data. Masa aktif cookie dapat ditetapkan ke nilai mulai dari 1 hingga 86.400 detik (24 jam) inklusif.

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 untuk 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 tubuh maksimum adalah 4096B.

String berenkode base64.

Metode

create

Membuat HttpRoute baru dalam project dan lokasi tertentu.

delete

Menghapus satu HttpRoute.

get

Mendapatkan detail satu HttpRoute.

getIamPolicy

Mendapatkan kebijakan kontrol akses untuk resource.

list

Menampilkan daftar HttpRoute dalam project dan lokasi tertentu.

patch

Mengupdate parameter untuk satu HttpRoute.

setIamPolicy

Menetapkan kebijakan kontrol akses pada resource yang ditentukan.

testIamPermissions

Menampilkan izin yang dimiliki pemanggil atas resource yang ditentukan.