REST Resource: projects.locations.gateways

Recurso: gateway

O gateway representa a configuração de um proxy, normalmente um balanceador de carga. Ele captura o ip:port em que os serviços são expostos pelo proxy, junto com as configurações de política. As rotas fazem referência aos gateways para determinar como as solicitações devem ser roteadas por ele. Próximo ID: 33

Representação 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)
}
Campos
name

string

Obrigatório. Nome do recurso de gateway. Ele corresponde ao padrão projects/*/locations/*/gateways/<gateway_name>.
createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi criado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi atualizado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

Opcional. Conjunto de tags de rótulo associadas ao recurso de gateway.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
description

string

Opcional. Uma descrição de texto livre do recurso. Comprimento máximo de 1.024 caracteres.
type

enum (Type)

Imutável. O tipo de gateway gerenciado pelo cliente. Este campo é obrigatório. Se não for especificado, um erro será retornado.
addresses[]

string

Opcional. Zero ou um endereço IPv4 ou IPv6 em que o gateway vai receber o tráfego. Quando nenhum endereço é fornecido, um IP da sub-rede é alocado

Este campo só se aplica a gateways do tipo "SECURE_WEB_GATEWAY". Os gateways do tipo "OPEN_MESH" escutam em 0.0.0.0 para IPv4 e :: para IPv6.
ports[]

integer

Obrigatório. Um ou mais números de porta (1-65535), na qual o gateway receberá tráfego. O proxy é vinculado às portas especificadas. Os gateways do tipo 'SECURE_WEB_GATEWAY' são limitados a uma porta. Gateways do tipo "OPEN_MESH" detectar em 0.0.0.0 para IPv4 e :: para IPv6 e oferecer suporte a várias portas.
scope

string

Opcional. O escopo determina como a configuração em várias instâncias de gateway é mesclada. A configuração de várias instâncias de gateway com o mesmo escopo será mesclada e apresentada como uma única configuração para o balanceador de carga/proxy.

Tamanho máximo: 64 caracteres. O escopo precisa começar com uma letra e só pode ter letras, números e hifens.
serverTlsPolicy

string

Opcional. Uma referência de URL ServerTLSPolicy totalmente qualificada. Especifica como o tráfego TLS é encerrado. Se estiver vazio, o encerramento de TLS será desativado.
certificateUrls[]

string

Opcional. Uma referência de URL de certificados totalmente qualificado. O proxy apresenta um certificado (selecionado com base no SNI) ao estabelecer uma conexão TLS. Esse recurso só se aplica a gateways do tipo "SECURE_WEB_GATEWAY".
gatewaySecurityPolicy

string

Opcional. Uma referência de URL GatewaySecurityPolicy totalmente qualificada. Define como um servidor deve aplicar a política de segurança a conexões iniciadas de entrada (VM para proxy).

Por exemplo, projects/*/locations/*/gatewaySecurityPolicies/swg-policy.

Esta política é específica para gateways do tipo 'SECURE_WEB_GATEWAY'.
network

string

Opcional. O nome do recurso relativo que identifica a rede VPC que está usando essa configuração. Por exemplo, projects/*/global/networks/network-1.

No momento, esse campo é específico para gateways do tipo 'SECURE_WEB_GATEWAY'.
subnetwork

string

Opcional. O nome do recurso relativo que identifica a sub-rede em que este SWG está alocado. Por exemplo: projects/*/regions/us-central1/subnetworks/network-1

No momento, esse campo é específico para gateways do tipo 'SECURE_WEB_GATEWAY".
ipVersion

enum (IpVersion)

Opcional. A versão do IP que será usada por este gateway. As opções válidas são IPV4 ou IPV6. O padrão é IPV4.
envoyHeaders

enum (EnvoyHeaders)

Opcional. Determina se o envoy vai inserir cabeçalhos de depuração internos nas solicitações upstream. Outros cabeçalhos do Envoy ainda podem ser injetados. Por padrão, o envoy não insere nenhum cabeçalho de depuração.

Tipo

O tipo de gateway gerenciado pelo cliente. Os valores possíveis são: * OPEN_MESH * SECURE_WEB_GATEWAY

Enums
TYPE_UNSPECIFIED O tipo de gateway gerenciado pelo cliente não foi especificado.
OPEN_MESH O tipo de gateway gerenciado pelo cliente é o TrafficDirector Open Mesh.
SECURE_WEB_GATEWAY O tipo de gateway gerenciado pelo cliente é o SecureWebGateway (SWG).

IpVersion

Os tipos de versão de IP do gateway. Os valores possíveis são: * IPV4 * IPV6

Enums
IP_VERSION_UNSPECIFIED O tipo quando a versão do IP não é especificada. O padrão é IPV4.
IPV4 O tipo da versão 4 do IP.
IPV6 O tipo da versão 6 do IP.

Métodos

create

 Cria uma nova gateway em um determinado projeto e local.

delete

 Exclui um único gateway.

get

 Recebe detalhes de uma única gateway.

list

 Lista os gateways de um determinado projeto e local.

patch

 Atualiza os parâmetros de um único gateway.