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. Cocok dengan pola projects/*/locations/global/httpRoutes/http_route_name>.

description

string

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

createTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource dibuat.

Menggunakan RFC 3339, dengan output yang dihasilkan 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, dengan output yang dihasilkan 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 sekumpulan host yang harus cocok dengan header host HTTP untuk memilih HttpRoute guna memproses permintaan. Hostname adalah nama domain yang sepenuhnya memenuhi syarat dari host jaringan, sebagaimana ditentukan oleh RFC 1123 dengan pengecualian bahwa: - 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 "precise" yang merupakan nama domain tanpa titik penghentian host jaringan (misalnya, foo.example.com) atau "wildcard", yang merupakan 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), dua rute tidak dapat dikaitkan dengan *.bar.com atau bar.com secara bersamaan.

meshes[]

string

Opsional. Mesh menentukan daftar mesh yang terlampir ke HttpRoute ini, sebagai salah satu aturan perutean untuk merutekan permintaan yang ditayangkan 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 yang terlampir pada HttpRoute ini, 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 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 cocok jika SALAH SATU kecocokan terpenuhi.

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

Jika Anda 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 kecocokan 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 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 satu dari fullPathMatch, prefixMatch, atau regexMatch yang boleh digunakan.

prefixMatch

string

Nilai jalur permintaan HTTP harus dimulai dengan prefixMatch yang ditentukan. prefixMatch harus dimulai 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 semua parameter kueri dan anchor yang diberikan 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 kecocokan akan dibalik sebelum diperiksa. Nilai defaultnya 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

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 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 ke mana lalu lintas harus diteruskan.

redirect

object (Redirect)

Jika disetel, permintaan akan diarahkan sesuai konfigurasi kolom ini.

faultInjectionPolicy

object (FaultInjectionPolicy)

Spesifikasi untuk injeksi kesalahan yang dimasukkan ke dalam 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 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 pengiriman permintaan ke tujuan. Jika HeaderModifiers ditetapkan di Tujuan 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 Tujuan 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, 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 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 permintaan.

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 pada koneksi upstream atau downstream. Jika tidak disetel, waktu tunggu tidak ada aktivitas default 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 menjadi tujuan perutean permintaan.

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

string

URL BackendService untuk merutekan traffic.

weight

integer

Menentukan proporsi permintaan yang diteruskan ke backend yang dirujuk 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 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 tersebut.

requestHeaderModifier

object (HeaderModifier)

Opsional. Spesifikasi untuk mengubah header permintaan yang cocok sebelum pengiriman permintaan ke tujuan. Jika HeaderModifiers ditetapkan di Tujuan 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 Tujuan 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 adalah nama header, 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 (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 atau tidak satu pun. 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 permintaan.

Nilai defaultnya ditetapkan ke false.

stripQuery

boolean

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

Nilai defaultnya ditetapkan 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 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 tertentu.

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

object (Delay)

Spesifikasi untuk menyisipkan penundaan pada permintaan klien.

abort

object (Abort)

Spesifikasi untuk membatalkan permintaan klien.

Penundaan

Spesifikasi cara permintaan klien ditunda sebagai bagian dari penyisipan 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, yang diakhiri dengan 's'. Contoh: "3.5s".

percentage

integer

Persentase traffic yang akan mengalami penundaan.

Nilai harus antara [0, 100]

Batalkan

Spesifikasi tentang 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 jalur permintaan yang cocok diganti dengan nilai ini.

hostRewrite

string

Sebelum meneruskan permintaan ke tujuan yang dipilih, header host permintaan 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, contoh: terputus, reset, waktu tunggu baca, kegagalan koneksi, dan aliran 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)

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

dapat dicoba ulang-4xx: Proxy akan mencoba ulang kode respons 4xx yang dapat dicoba ulang. Saat ini, satu-satunya error yang dapat dicoba lagi 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, nilai defaultnya adalah 1.

perTryTimeout

string (Duration format)

Menentukan waktu tunggu 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 bayangan, header host/otoritas diberi akhiran -shadow.

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

object (Destination)

Tujuan tempat permintaan akan di-mirror. 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. Asal diizinkan jika cocok dengan item di allowOrigins atau item di allowOriginRegexes.

allowOriginRegexes[]

string

Menentukan pola ekspresi reguler yang cocok dengan asal 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. Ini diterjemahkan ke header Access-Control-Max-Age.

allowCredentials

boolean

Sebagai respons terhadap permintaan pra-penerbangan, menyetelnya ke benar (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 di mana 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 berfungsi dengan baik.

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 RPC 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 1 hingga 86400 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 1024 karakter.

bytesBody

string (bytes format)

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

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 dalam 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 tertentu.