REST Resource: projects.locations.tlsRoutes

리소스: TlsRoute

TlsRoute는 SNI 및 기타 일치하는 L3 속성을 기반으로 트래픽을 라우팅하는 방법을 정의합니다.

JSON 표현 
{
  "name": string,
  "selfLink": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "rules": [
    {
      object (RouteRule)
    }
  ],
  "meshes": [
    string
  ],
  "gateways": [
    string
  ],
  "labels": {
    string: string,
    ...
  }
}
필드
name

string

필수 항목입니다. TlsRoute 리소스의 이름입니다. projects/*/locations/global/tlsRoutes/tls_route_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"입니다.
description

string

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

object (RouteRule)

필수 항목입니다. 트래픽이 라우팅되고 처리되는 방식을 정의하는 규칙입니다. RouteRule을 하나 이상 제공해야 합니다. 규칙이 여러 개 있는 경우 일치하는 첫 번째 규칙에 따라 작업이 실행됩니다.
meshes[]

string

선택사항입니다. 메시는 이 TlsRoute가 연결된 메시 목록을 메시에서 제공하는 요청을 라우팅하는 라우팅 규칙 중 하나로 정의합니다.

각 메시 참조는 projects/*/locations/global/meshes/<mesh_name> 패턴과 일치해야 합니다.

연결된 메시는 SIDECAR 유형이어야 합니다.
gateways[]

string

선택사항입니다. 게이트웨이는 이 TlsRoute가 연결된 게이트웨이 목록을 게이트웨이에서 제공하는 요청을 라우팅하는 라우팅 규칙 중 하나로 정의합니다.

각 게이트웨이 참조는 projects/*/locations/global/gateways/<gateway_name> 패턴과 일치해야 합니다.
labels

map (key: string, value: string)

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

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

RouteRule

트래픽을 비교하고 트래픽이 일치할 때 트래픽을 라우팅하는 방법을 지정합니다.

JSON 표현 
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
필드
matches[]

object (RouteMatch)

필수 항목입니다. RouteMatch는 요청을 특정 작업과 일치시키는 데 사용되는 조건자를 정의합니다. 여러 검색 유형은 평가를 위해 'OR'로 연결됩니다.
action

object (RouteAction)

필수 항목입니다. 일치하는 트래픽을 라우팅하는 방법을 정의하는 세부 규칙입니다.

RouteMatch

RouteMatch는 요청을 특정 작업과 일치시키는 데 사용되는 조건자를 정의합니다. 여러 검색 유형은 평가를 위해 'AND'로 연결됩니다. routeMatch 필드가 지정되지 않으면 이 규칙은 무조건 트래픽과 일치합니다.

JSON 표현 
{
  "sniHost": [
    string
  ],
  "alpn": [
    string
  ]
}
필드
sniHost[]

string

선택사항입니다. 일치시킬 SNI(서버 이름 표시기)입니다. SNI는 모든 와일드 카드 도메인과 일치합니다. 즉, www.example.com은 먼저 www.example.com과 일치한 다음 *.example.com과 일치한 다음 *.com.과 일치합니다. 부분 와일드 카드는 지원되지 않으며 *w.example.com과 같은 값은 유효하지 않습니다. sniHost와 alpn 중 하나 이상이 필요합니다. 모든 일치에서 최대 100개의 SNI 호스트를 설정할 수 있습니다.
alpn[]

string

선택사항입니다. 일치시킬 ALPN(애플리케이션 계층 프로토콜 협상)입니다. 예: 'http/1.1', 'h2'. sniHost와 alpn 중 하나 이상이 필요합니다. 모든 일치에 대해 최대 5개의 alpn을 설정할 수 있습니다.

RouteAction

트래픽 라우팅 및 연결된 정책 적용을 위한 사양입니다.

JSON 표현 
{
  "destinations": [
    {
      object (RouteDestination)
    }
  ],
  "idleTimeout": string
}
필드
destinations[]

object (RouteDestination)

필수 항목입니다. 트래픽을 전달해야 하는 대상 서비스입니다. 대상 서비스가 1개 이상 필요합니다.
idleTimeout

string (Duration format)

선택사항입니다. 선택한 경로의 유휴 제한 시간을 지정합니다. 유휴 시간 제한은 업스트림 또는 다운스트림 연결에서 전송되거나 수신되는 바이트가 없는 기간으로 정의됩니다. 설정하지 않으면 기본 유휴 시간 제한은 1시간입니다. 0으로 설정하면 제한 시간이 사용 중지됩니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

RouteDestination

트래픽을 라우팅할 대상을 설명합니다.

JSON 표현 
{
  "serviceName": string,
  "weight": integer
}
필드
serviceName

string

필수 항목입니다. 트래픽을 라우팅할 BackendService의 URL입니다.
weight

integer

선택사항입니다. serviceName 필드에서 참조하는 백엔드로 전달되는 요청의 비율을 지정합니다. 이 값은 가중치/합계(대상의 가중치)로 계산됩니다. 모든 대상의 가중치 합계가 100이 될 필요는 없습니다.

메서드

create

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

delete

 단일 TlsRoute를 삭제합니다.

get

 단일 TlsRoute의 세부정보를 가져옵니다.

getIamPolicy

 리소스의 액세스 제어 정책을 가져옵니다.

list

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

patch

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

setIamPolicy

 지정된 리소스의 액세스 제어 정책을 설정합니다.

testIamPermissions

 지정된 리소스에 대해 호출자가 보유한 권한을 반환합니다.