REST Resource: projects.locations.gateways

리소스: 게이트웨이

게이트웨이는 프록시(일반적으로 부하 분산기)의 구성을 나타냅니다. 프록시에 의해 서비스가 노출되는 ip:port와 정책 구성을 캡처합니다. 경로에는 이 게이트웨이에서 요청을 라우팅하는 방법을 지정하는 게이트웨이 참조가 있습니다. 다음 id: 33

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)
}
필드
name

string

필수 항목. 게이트웨이 리소스의 이름입니다. projects/*/locations/*/gateways/<gateway_name> 패턴과 일치합니다.
createTime

string (Timestamp format)

출력 전용입니다. 리소스가 생성된 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 리소스가 업데이트된 타임스탬프입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
labels

map (key: string, value: string)

선택사항. 게이트웨이 리소스와 연결된 라벨 태그 집합입니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
description

string

선택사항. 리소스에 대한 자유 텍스트 설명입니다. 최대 길이는 1,024자(영문 기준)입니다.
type

enum (Type)

변경할 수 없습니다. 고객 관리 게이트웨이의 유형입니다. 필수 필드입니다. 지정하지 않으면 오류가 반환됩니다.
addresses[]

string

선택사항. 게이트웨이가 트래픽을 수신하는 IPv4 또는 IPv6 주소 0개 또는 1개입니다. 주소를 제공하지 않으면 서브네트워크의 IP가 할당됩니다.

이 필드는 'SECURE_WEB_GATEWAY' 유형의 게이트웨이에만 적용됩니다. 'OPEN_MESH' 유형의 게이트웨이는 IPv4의 경우 0.0.0.0에서, IPv6의 경우 ::에서 리슨합니다.
ports[]

integer

필수 항목. 게이트웨이가 트래픽을 수신할 하나 이상의 포트 번호(1~65535)입니다. 프록시가 지정된 포트에 바인딩됩니다. 'SECURE_WEB_GATEWAY' 유형의 게이트웨이는 포트 1개로 제한됩니다. 'OPEN_MESH' 유형의 게이트웨이는 IPv4의 경우 0.0.0.0, IPv6의 경우 ::에서 수신 대기하고 여러 포트를 지원합니다.
scope

string

선택사항. 범위는 여러 게이트웨이 인스턴스의 구성이 병합되는 방식을 결정합니다. 동일한 범위의 여러 게이트웨이 인스턴스의 구성이 병합되어 프록시/부하 분산기에 단일 구성으로 표시됩니다.

최대 길이는 64자(영문 기준)입니다. 범위는 문자로 시작해야 하며 문자, 숫자, 하이픈만 포함할 수 있습니다.
serverTlsPolicy

string

선택사항. 정규화된 ServerTLSPolicy URL 참조입니다. TLS 트래픽이 종료되는 방식을 지정합니다. 비어 있으면 TLS 종료가 사용 중지됩니다.
certificateUrls[]

string

선택사항. 정규화된 인증서 URL 참조입니다. 프록시는 TLS 연결을 설정할 때 인증서(SNI를 기반으로 선택됨)를 표시합니다. 이 기능은 'SECURE_WEB_GATEWAY' 유형의 게이트웨이에만 적용됩니다.
gatewaySecurityPolicy

string

선택사항. 정규화된 GatewaySecurityPolicy URL 참조입니다. 서버가 인바운드(VM에서 프록시로) 시작 연결에 보안 정책을 적용하는 방법을 정의합니다.

예를 들면 projects/*/locations/*/gatewaySecurityPolicies/swg-policy입니다.

이 정책은 'SECURE_WEB_GATEWAY' 유형의 게이트웨이에만 적용됩니다.
network

string

선택사항. 이 구성을 사용하는 VPC 네트워크를 식별하는 상대 리소스 이름입니다. 예를 들면 projects/*/global/networks/network-1입니다.

현재 이 필드는 'SECURE_WEB_GATEWAY' 유형의 게이트웨이에만 적용됩니다.
subnetwork

string

선택사항. 이 SWG가 할당된 서브네트워크를 식별하는 상대 리소스 이름입니다. 예: projects/*/regions/us-central1/subnetworks/network-1

현재 이 필드는 'SECURE_WEB_GATEWAY' 유형의 게이트웨이에만 적용됩니다.
ipVersion

enum (IpVersion)

선택사항. 이 게이트웨이에서 사용할 IP 버전입니다. 유효한 옵션은 IPv4 또는 IPv6입니다. 기본값은 IPv4입니다.
envoyHeaders

enum (EnvoyHeaders)

선택사항. Envoy가 업스트림 요청에 내부 디버그 헤더를 삽입할지 여부를 결정합니다. 다른 Envoy 헤더는 계속 삽입될 수 있습니다. 기본적으로 Envoy는 디버그 헤더를 삽입하지 않습니다.

유형

고객 관리 게이트웨이의 유형입니다. 가능한 값은 다음과 같습니다. * OPEN_MESH * SECURE_WEB_GATEWAY

열거형
TYPE_UNSPECIFIED 고객 관리 게이트웨이 유형이 지정되지 않았습니다.
OPEN_MESH 고객 관리 게이트웨이의 유형이 TrafficDirector Open Mesh입니다.
SECURE_WEB_GATEWAY 고객 관리 게이트웨이의 유형이 SecureWebGateway(SWG)입니다.

IpVersion

게이트웨이의 IP 버전 유형입니다. 가능한 값은 다음과 같습니다. * IPv4 * IPv6

열거형
IP_VERSION_UNSPECIFIED IP 버전이 지정되지 않은 경우의 유형입니다. 기본값은 IPv4입니다.
IPV4 IP 버전 4의 유형입니다.
IPV6 IP 버전 6의 유형입니다.

메서드

create

 특정 프로젝트와 위치에 새 게이트웨이를 만듭니다.

delete

 단일 게이트웨이를 삭제합니다.

get

 단일 게이트웨이의 세부정보를 가져옵니다.

list

 특정 프로젝트와 위치의 게이트웨이를 나열합니다.

patch

 단일 게이트웨이의 파라미터를 업데이트합니다.