changeTargetGroupConfiguration

VPC 환경에서 이용 가능합니다.

타깃 그룹의 설정을 변경합니다.

구문

changeTargetGroupConfiguration 구문은 다음과 같습니다.

./ncloud vloadbalancer changeTargetGroupConfiguration \
    --targetGroupNo <target-group-no> \
    [--useStickySession <true|false>] \| [--useProxyProtocol <true|false>] \
    [--algorithmTypeCode <RR|SIPHS|LC|MH>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

changeTargetGroupConfiguration 실행 시 지정할 수 있는 옵션을 설명합니다.

필수 옵션

changeTargetGroupConfiguration의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--targetGroupNo`	String	Required	타깃 그룹의 번호 getTargetGroupList 참조
`--useStickySession`	Boolean	Conditional	세션별 접근 사용 여부 `true` \| `false` `true`: 사용 `false`: 사용 안 함 타깃 그룹의 프로토콜 유형이 `TCP`, `UDP`, `HTTP` 또는 `HTTPS`이면 설정 가능 타깃 그룹 설정 변경 시 `useStickySession`, `useProxyProtocol`, `algorithmTypeCode` 중 하나는 필수 입력
`--useProxyProtocol`	Boolean	Conditional	프록시 프로토콜 사용 여부 `true` \| `false` `true`: 사용 `false`: 사용 안 함 타깃 그룹의 프로토콜 유형이 `PROXY_TCP`이면 설정 가능 타깃 그룹 설정 변경 시 `useStickySession`, `useProxyProtocol`, `algorithmTypeCode` 중 하나는 필수 입력
`--algorithmTypeCode`	String	Conditional	로드밸런싱에 사용할 알고리즘 유형 `RR` \| `SIPHS` \| `LC` \| `MH` `RR`: Round Robin `SIPHS`: Source IP Hash `LC`: Least Connection `MH`: Maglev Hash 타깃 그룹의 프로토콜 유형에 따라서 설정할 수 있는 값이 제한됨 `HTTP`, `HTTPS`, `PROXY_TCP` 프로토콜: `RR` \| `SIPHS` \| `LC` `TCP`, `UDP` 프로토콜: `RR` \| `MH` 타깃 그룹 설정 변경 시 `useStickySession`, `useProxyProtocol`, `algorithmTypeCode` 중 하나는 필수 입력

공통 옵션

vloadbalancer 명령에서 공통으로 사용하는 옵션에 대한 정보는 Load Balancer (VPC) 옵션을 참조해 주십시오.

예시

타깃 그룹 설정 변경 요청이 성공하면 변경된 타깃 그룹의 구성 정보가 반환됩니다.

명령

명령 예시는 다음과 같습니다.

./ncloud vloadbalancer changeTargetGroupConfiguration \
    --targetGroupNo 55667788 \
    --useStickySession true \
    --algorithmTypeCode RR \
    --regionCode KR \
    --output json

출력

출력 예시는 다음과 같습니다.

{
  "changeTargetGroupConfigurationResponse": {
    "totalRows": 1,
    "targetGroupList": [
      {
        "targetGroupNo": "55667788",
        "targetGroupName": "lb-test-tg",
        "targetType": {
          "code": "VSVR",
          "codeName": "Server (VPC)"
        },
        "vpcNo": "12345678",
        "targetGroupProtocolType": {
          "code": "HTTP",
          "codeName": "HTTP protocol"
        },
        "targetGroupPort": 80,
        "targetGroupDescription": "Test target group",
        "useStickySession": true,
        "useProxyProtocol": false,
        "algorithmType": {
          "code": "RR",
          "codeName": "Round Robin"
        },
        "createDate": "2026-07-20T17:28:30+0900",
        "regionCode": "KR",
        "loadBalancerInstanceNo": "",
        "healthCheckProtocolType": {
          "code": "HTTP",
          "codeName": "HTTP protocol"
        },
        "healthCheckPort": 8080,
        "healthCheckUrlPath": "/",
        "healthCheckHttpMethodType": {
          "code": "GET",
          "codeName": "HTTP GET Method"
        },
        "healthCheckCycle": 30,
        "healthCheckUpThreshold": 2,
        "healthCheckDownThreshold": 2,
        "targetNoList": []
      }
    ],
    "requestId": "43e9e182-27df-4f4a-8bfd-c3e83f3dc674",
    "returnCode": "0",
    "returnMessage": "success"
  }
}