REST Resource: projects.locations.serviceLbPolicies

리소스: ServiceLbPolicy

ServiceLbPolicy에는 BackendService에 적용할 수 있는 전역 부하 분산 및 트래픽 분산 구성이 포함됩니다.

JSON 표현
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "description": string,
  "loadBalancingAlgorithm": enum (LoadBalancingAlgorithm),
  "autoCapacityDrain": {
    object (AutoCapacityDrain)
  },
  "failoverConfig": {
    object (FailoverConfig)
  }
}
필드
name

string

필수 항목. ServiceLbPolicy 리소스의 이름입니다. projects/{project}/locations/{location}/serviceLbPolicies/{service_lb_policy_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)

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

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

description

string

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

loadBalancingAlgorithm

enum (LoadBalancingAlgorithm)

선택사항. 사용할 부하 분산 알고리즘 유형입니다. 기본 동작은 WATERFALL_BY_REGION입니다.

autoCapacityDrain

object (AutoCapacityDrain)

선택사항. 연결된 백엔드 서비스의 비정상 IG/NEG에서 자동으로 트래픽을 배제하는 구성입니다.

failoverConfig

object (FailoverConfig)

선택사항. 상태 기반 장애 조치와 관련된 구성입니다.

LoadBalancingAlgorithm

사용할 전역 부하 분산 알고리즘입니다.

열거형
LOAD_BALANCING_ALGORITHM_UNSPECIFIED 부하 분산 알고리즘 유형은 지정되지 않습니다.
SPRAY_TO_WORLD 전 세계 모든 백엔드 간에 용량에 비례하여 트래픽을 분산합니다.
SPRAY_TO_REGION 다른 리전으로 스필링하기 전에 엔드포인트 및 용량이 있는 가장 가까운 리전으로 트래픽을 전달하고 각 클라이언트에서 리전 내 모든 MIG/NEG로 트래픽을 분산합니다.
WATERFALL_BY_REGION 다른 리전으로 스필오버하기 전에 엔드포인트 및 용량이 있는 가장 가까운 리전으로 트래픽을 전달합니다. 한 리전 내의 모든 MIG/NEG에 균일하게 부하가 걸리지만 각 클라이언트는 리전의 모든 MIG/NEG로 트래픽을 분산하지 않을 수도 있습니다.
WATERFALL_BY_ZONE 다른 영역으로 스필오버하기 전에 트래픽을 클라이언트에 가장 가까운 단일 영역에 유지하려고 시도합니다.

AutoCapacityDrain

전역 부하 분산 및 트래픽 라우팅에 비정상 IG/NEG를 고려할지 여부를 지정하는 옵션입니다.

JSON 표현
{
  "enable": boolean
}
필드
enable

boolean

선택사항. 'True'로 설정하면 비정상 IG/NEG가 드레이닝됨으로 설정됩니다. - IG/NEG에서 정상 인스턴스/엔드포인트의 비율이 25% 미만이면 IG/NEG가 비정상으로 간주됩니다. - 이 옵션을 사용하면 백엔드 서비스에 구성된 IG/NEG의 드레이닝 비율이 어떠한 경우에도 50%를 초과하지 않습니다.

FailoverConfig

상태 기반 장애 조치 동작을 지정하는 옵션입니다. 네트워크 부하 분산기 FailoverPolicy와 관련이 없습니다.

JSON 표현
{
  "failoverHealthThreshold": integer
}
필드
failoverHealthThreshold

integer

선택사항. 부하 분산기가 트래픽을 장애 조치 백엔드로 전송하기 시작할 백분율 기준점입니다. MIG/NEG의 엔드포인트 백분율이 이 값보다 작으면 트래픽이 가능한 경우 장애 조치 백엔드로 전송됩니다. 이 필드는 1~99 사이의 값으로 설정해야 합니다. 기본값은 전역 외부 HTTP(S) 부하 분산기(기본) 및 프록시리스 서비스 메시의 경우 50, 그 외의 경우 70입니다.

메서드

create

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

delete

단일 ServiceLbPolicy를 삭제합니다.

get

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

getIamPolicy

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

list

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

patch

단일 ServiceLbPolicy의 매개변수를 업데이트합니다.

setIamPolicy

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

testIamPermissions

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