REST Resource: projects.locations.gateways

Risorsa: gateway

Gateway rappresenta la configurazione di un proxy, in genere un bilanciatore del carico. Acquisisce l'indirizzo IP:porta su cui i servizi sono esposti dal proxy, insieme a eventuali configurazioni dei criteri. Le route fanno riferimento ai gateway per indicare in che modo le richieste devono essere instradate da 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" UTC RFC3339, con risoluzione a livello di nanosecondo 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 dell'aggiornamento della risorsa.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo 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. Set di tag etichetta associati alla risorsa Gateway.

Un oggetto contenente un elenco di coppie "key": value. 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 specificato, viene restituito un errore.
addresses[]

string

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

Questo campo si applica solo ai gateway di tipo "SECURE_WEB_GATEWAY". I gateway di tipo "OPEN_MESH" ascoltano 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" sono limitati a una porta. I gateway di tipo "OPEN_MESH" ascoltano su 0.0.0.0 per IPv4 e :: per IPv6 e supportano più porte.
scope

string

Facoltativo. L'ambito determina la modalità di unione della configurazione in più istanze di Gateway. La configurazione di più istanze di Gateway con lo stesso ambito verrà unita come una singola configurazione per il 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 all'URL ServerTLSPolicy completo. Specifica in che modo viene terminato il traffico TLS. Se vuoto, la terminazione TLS è disattivata.
certificateUrls[]

string

Facoltativo. Un riferimento all'URL dei certificati completo. Il proxy presenta un certificato (selezionato in base a SNI) durante l'instaurazione di una connessione TLS. Questa funzionalità si applica solo ai gateway di tipo "SECURE_WEB_GATEWAY".
gatewaySecurityPolicy

string

Facoltativo. Un riferimento all'URL completo di GatewaySecurityPolicy. Definisce in che modo un server deve applicare i criteri di sicurezza alle connessioni in entrata (VM to 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 relativa che identifica la rete VPC che utilizza questa configurazione. Ad esempio: projects/*/global/networks/network-1.

Al momento, 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 è allocata questa zona di traffico sicuro. Ad esempio: projects/*/regions/us-central1/subnetworks/network-1

Al momento, questo campo è specifico per i gateway di tipo "SECURE_WEB_GATEWAY".
ipVersion

enum (IpVersion)

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

enum (EnvoyHeaders)

Facoltativo. Determina se Envoy inserirà intestazioni di debug interne nelle richieste a monte. Altre intestazioni Envoy potrebbero comunque essere iniettate. Per impostazione predefinita, envoy non inserisce intestazioni 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 è TrafficDirector Open Mesh.
SECURE_WEB_GATEWAY Il tipo di gateway gestito dal cliente è SecureWebGateway (SWG).

IpVersion

I tipi di versione IP per il 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 per la versione IP 4.
IPV6 Il tipo per la versione IP 6.

Metodi

create

 Crea un nuovo gateway in un determinato progetto e posizione.

delete

 Consente di eliminare un singolo gateway.

get

 Recupera i dettagli di un singolo gateway.

list

 Elenca i gateway in un determinato progetto e località.

patch

 Aggiorna i parametri di un singolo gateway.

setIamPolicy

 Imposta il criterio di controllo dell'accesso sulla risorsa specificata.

testIamPermissions

 Restituisce le autorizzazioni di cui dispone un chiamante sulla risorsa specificata.