REST Resource: projects.locations.gateways

Risorsa: gateway

Il gateway rappresenta la configurazione di un proxy, in genere un bilanciatore del carico. Acquisisce l'IP:porta su cui i servizi sono esposti dal proxy, insieme a tutte le configurazioni dei criteri. Le route fanno riferimento ai gateway per determinare le modalità di routing delle richieste da parte di questo gateway. ID successivo: 33

Rappresentazione 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),
  "envoyHeaders": enum (EnvoyHeaders)
}
Campi
name

string

Obbligatorio. Nome della risorsa gateway. Corrisponde al pattern projects/*/locations/*/gateways/<gateway_name>.

createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo output. Il timestamp di aggiornamento della risorsa.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Facoltativo. Insieme di tag di etichetta associati alla risorsa Gateway.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

description

string

Facoltativo. Una descrizione in testo libero della risorsa. Lunghezza massima: 1024 caratteri.

type

enum (Type)

Immutabile. Il tipo di gateway gestito dal cliente. Questo campo è obbligatorio. Se non specificati, viene restituito un errore.

addresses[]

string

Facoltativo. Nessuno o un indirizzo IPv4 o IPv6 su cui il gateway riceverà il traffico. Se non viene fornito alcun indirizzo, viene allocato un IP dalla subnet

Questo campo si applica solo ai gateway di tipo "SECURE_WEB_GATEWAY". I gateway di tipo "OPEN_MESH" restano in ascolto su 0.0.0.0 per IPv4 e :: per IPv6.

ports[]

integer

Obbligatorio. Uno o più numeri di porta (1-65535) su cui il gateway riceverà il traffico. Il proxy si associa alle porte specificate. I gateway di tipo "SECURE_WEB_GATEWAY" hanno un limite di 1 porta. I gateway di tipo 'OPEN_MESH' restano in ascolto su 0.0.0.0 per IPv4 e :: per IPv6 e supportano più porte.

scope

string

Facoltativo. L'ambito determina il modo in cui la configurazione in più istanze del gateway vengono unite. La configurazione per più istanze gateway con lo stesso ambito verrà unita in quanto presentata come un'unica configurazione al proxy/bilanciatore del carico.

Lunghezza massima: 64 caratteri. L'ambito deve iniziare con una lettera e può contenere solo lettere, numeri e trattini.

serverTlsPolicy

string

Facoltativo. Un riferimento dell'URL ServerTLSPolicy completo. Specifica la modalità di terminazione del traffico TLS. Se vuoto, la terminazione TLS è disabilitata.

certificateUrls[]

string

Facoltativo. Un riferimento all'URL di Certificates completo. Il proxy presenta un certificato (selezionato in base a SNI) quando stabilisce una connessione TLS. Questa funzionalità si applica solo ai gateway di tipo "SECURE_WEB_GATEWAY".

gatewaySecurityPolicy

string

Facoltativo. Un riferimento URL GatewaySecurityPolicy completo. Definisce in che modo un server deve applicare il criterio di sicurezza alle connessioni in entrata (da VM a proxy).

Ad esempio: projects/*/locations/*/gatewaySecurityPolicies/swg-policy.

Questo criterio è specifico per i gateway di tipo "SECURE_WEB_GATEWAY".

network

string

Facoltativo. Il nome della risorsa relativo che identifica la rete VPC che utilizza questa configurazione. Ad esempio: projects/*/global/networks/network-1.

Attualmente, questo campo è specifico per i gateway di tipo "SECURE_WEB_GATEWAY".

subnetwork

string

Facoltativo. Il nome della risorsa relativa che identifica la subnet in cui è allocato questo SWG. Ad esempio: projects/*/regions/us-central1/subnetworks/network-1

Attualmente, questo campo è specifico per i gateway di tipo "SECURE_WEB_GATEWAY".

ipVersion

enum (IpVersion)

Facoltativo. La versione IP che verrà utilizzata dal gateway. Le opzioni valide sono IPV4 o IPV6. Il valore predefinito è IPV4.

envoyHeaders

enum (EnvoyHeaders)

Facoltativo. Determina se Envoy inserirà le intestazioni di debug interne nelle richieste upstream. È possibile comunque inserire altre intestazioni Envoy. Per impostazione predefinita, envoy non inserisce alcuna intestazione di debug.

Tipo

Il tipo di gateway gestito dal cliente. I valori possibili sono: * OPEN_MESH * SECURE_WEB_GATEWAY

Enum
TYPE_UNSPECIFIED Il tipo di gateway gestito dal cliente non è specificato.
OPEN_MESH Il tipo di gateway gestito dal cliente è Mesh aperto TrafficDirector.
SECURE_WEB_GATEWAY Il tipo di gateway gestito dal cliente è SecureWebGateway (SWG).

IpVersion

I tipi di versione IP del gateway. I valori possibili sono: * IPV4 * IPV6

Enum
IP_VERSION_UNSPECIFIED Il tipo quando la versione IP non è specificata. Il valore predefinito è IPV4.
IPV4 Il tipo di IP versione 4.
IPV6 Il tipo di IP versione 6.

Metodi

create

Crea un nuovo gateway in un progetto e in una località specifici.

delete

Elimina un singolo gateway.

get

Recupera i dettagli di un singolo gateway.

list

Elenca i gateway in un progetto e in una località specifici.

patch

Aggiorna i parametri di un singolo gateway.