REST Resource: projects.locations.gateways

Resource: Gateway

Gateway mewakili konfigurasi untuk proxy, biasanya load balancer. Objek ini mencatat ip:port yang digunakan proxy untuk mengekspos layanan, beserta konfigurasi kebijakan apa pun. Rute memiliki referensi ke Gateway untuk menentukan cara permintaan harus dirutekan oleh Gateway ini.

Representasi JSON 
{
  "name": string,
  "selfLink": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "type": enum (Type),
  "addresses": [
    string
  ],
  "ports": [
    integer
  ],
  "scope": string,
  "serverTlsPolicy": string,
  "certificateUrls": [
    string
  ],
  "gatewaySecurityPolicy": string,
  "network": string,
  "subnetwork": string,
  "ipVersion": enum (IpVersion),
  "routingMode": enum (RoutingMode),
  "envoyHeaders": enum (EnvoyHeaders)
}
Kolom
name

string

ID. Nama resource Gateway. Cocok dengan pola projects/*/locations/*/gateways/<gateway_name>.
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".
labels

map (key: string, value: string)

Opsional. Kumpulan tag label yang terkait dengan resource Gateway.

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

string

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

enum (Type)

Tidak dapat diubah. Jenis gateway yang dikelola pelanggan. Kolom ini wajib diisi. Jika tidak ditentukan, pesan error akan ditampilkan.
addresses[]

string

Opsional. Nol atau satu alamat IPv4 atau IPv6 tempat Gateway akan menerima traffic. Jika tidak ada alamat yang diberikan, IP dari subnetwork akan dialokasikan

Kolom ini hanya berlaku untuk gateway jenis 'SECURE_WEB_GATEWAY'. Gateway jenis 'OPEN_MESH' memproses 0.0.0.0 untuk IPv4 dan :: untuk IPv6.
ports[]

integer

Wajib. Satu atau beberapa nomor port (1-65535), tempat Gateway akan menerima traffic. Proxy terikat ke port yang ditentukan. Gateway jenis 'SECURE_WEB_GATEWAY' dibatasi hingga 1 port. Gateway jenis 'OPEN_MESH' memproses 0.0.0.0 untuk IPv4 dan :: untuk IPv6 serta mendukung beberapa port.
scope

string

Opsional. Cakupan menentukan cara konfigurasi di beberapa instance Gateway digabungkan. Konfigurasi untuk beberapa instance Gateway dengan cakupan yang sama akan digabungkan dan ditampilkan sebagai satu konfigurasi ke proxy/load balancer.

Panjang maksimum 64 karakter. Cakupan harus diawali dengan huruf dan hanya dapat berisi huruf, angka, tanda hubung.
serverTlsPolicy

string

Opsional. Referensi URL ServerTLSPolicy yang sepenuhnya memenuhi syarat. Menentukan cara menghentikan traffic TLS. Jika kosong, penghentian TLS dinonaktifkan.
certificateUrls[]

string

Opsional. Referensi URL Sertifikat yang sepenuhnya memenuhi syarat. Proxy menampilkan Sertifikat (dipilih berdasarkan SNI) saat membuat koneksi TLS. Fitur ini hanya berlaku untuk gateway jenis 'SECURE_WEB_GATEWAY'.
gatewaySecurityPolicy

string

Opsional. Referensi URL GatewaySecurityPolicy yang sepenuhnya memenuhi syarat. Menentukan cara server menerapkan kebijakan keamanan ke koneksi yang dimulai inbound (VM ke Proxy).

Misalnya: projects/*/locations/*/gatewaySecurityPolicies/swg-policy.

Kebijakan ini khusus untuk gateway berjenis 'SECURE_WEB_GATEWAY'.
network

string

Opsional. Nama resource relatif yang mengidentifikasi jaringan VPC yang menggunakan konfigurasi ini. Misalnya: projects/*/global/networks/network-1.

Saat ini, kolom ini khusus untuk gateway berjenis 'SECURE_WEB_GATEWAY'.
subnetwork

string

Opsional. Nama resource relatif yang mengidentifikasi subnetwork tempat SWG ini dialokasikan. Contoh: projects/*/regions/us-central1/subnetworks/network-1

Saat ini, kolom ini khusus untuk gateway berjenis 'SECURE_WEB_GATEWAY".
ipVersion

enum (IpVersion)

Opsional. Versi IP yang akan digunakan oleh gateway ini. Opsi yang valid adalah IPV4 atau IPV6. Defaultnya adalah IPV4.
routingMode

enum (RoutingMode)

Opsional. Mode perutean Gateway. Kolom ini hanya dapat dikonfigurasi untuk gateway jenis SECURE_WEB_GATEWAY. Kolom ini wajib diisi untuk gateway jenis SECURE_WEB_GATEWAY.
envoyHeaders

enum (EnvoyHeaders)

Opsional. Menentukan apakah Envoy akan menyisipkan header debug internal ke dalam permintaan upstream. Header Envoy lainnya mungkin masih disisipkan. Secara default, Envoy tidak akan menyisipkan header debug apa pun.

Jenis

Jenis gateway yang dikelola pelanggan. Nilai yang mungkin adalah: * OPEN_MESH * SECURE_WEB_GATEWAY

Enum
TYPE_UNSPECIFIED Jenis gateway yang dikelola pelanggan tidak ditentukan.
OPEN_MESH Jenis gateway yang dikelola pelanggan adalah TrafficDirector Open Mesh.
SECURE_WEB_GATEWAY Jenis gateway yang dikelola pelanggan adalah SecureWebGateway (SWG).

IpVersion

Jenis versi IP untuk gateway. Nilai yang mungkin adalah: * IPV4 * IPV6

Enum
IP_VERSION_UNSPECIFIED Jenis saat versi IP tidak ditentukan. Defaultnya adalah IPV4.
IPV4 Jenis untuk IP versi 4.
IPV6 Jenis untuk IP versi 6.

RoutingMode

Mode perutean Gateway, untuk menentukan cara Gateway merutekan traffic. Saat ini, kolom ini hanya berlaku untuk Gateway jenis SECURE_WEB_GATEWAY. Nilai yang mungkin adalah: * EXPLICIT_ROUTING_MODE * NEXT_HOP_ROUTING_MODE

Enum
EXPLICIT_ROUTING_MODE Mode perutean bersifat eksplisit; klien dikonfigurasi untuk mengirim traffic melalui gateway. Ini adalah mode pemilihan rute default.
NEXT_HOP_ROUTING_MODE Mode perutean adalah next-hop. Klien tidak mengetahui gateway, dan rute (rute lanjutan atau jenis rute lainnya) dapat dikonfigurasi untuk mengarahkan traffic dari klien ke gateway. Kemudian, gateway bertindak sebagai next-hop ke tujuan.

Metode

create

 Membuat Gateway baru di project dan lokasi tertentu.

delete

 Menghapus satu Gateway.

get

 Mendapatkan detail satu Gateway.

list

 Mencantumkan Gateway dalam project dan lokasi tertentu.

patch

 Memperbarui parameter satu Gateway.

setIamPolicy

 Menetapkan kebijakan kontrol akses pada resource yang ditentukan.

testIamPermissions

 Menampilkan izin yang dimiliki pemanggil pada resource tertentu.