setLoadBalancerInstanceSubnet

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

로드밸런서의 서브넷을 설정합니다. 기존에 설정된 서브넷을 포함하여 설정하며, 기존 서브넷과 다른 존에 위치한 서브넷을 추가할 수 있습니다.

구문

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

./ncloud vloadbalancer setLoadBalancerInstanceSubnet \
    --loadBalancerInstanceNo <load-balancer-instance-no> \
    --subnetNoList <subnet-no-list> \
    [--loadBalancerSubnetList <lb-subnet-config>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

옵션

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

필수 옵션

setLoadBalancerInstanceSubnet의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--loadBalancerInstanceNo`	String	Required	로드밸런서 인스턴스 번호 getLoadBalancerInstanceList 참조
`--subnetNoList`	List	Required	서브넷 번호 목록 `loadBalancerSubnetList`와 함께 입력 시 `loadBalancerSubnetList`가 적용됨 로드밸런서와 같은 VPC에 위치하는 서브넷 선택 기존에 설정된 서브넷을 포함하여 존별로 한 개의 로드밸런서 전용 서브넷 선택 가능 공백으로 구분하여 여러 개 입력 가능 (예시: `--subnetNoList 23456790 23456791`) getSubnetList 참조

선택 옵션

setLoadBalancerInstanceSubnet의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`--loadBalancerSubnetList`	List	Optional	로드밸런서 전용 서브넷 목록 `subnetNoList`와 함께 입력 시 `loadBalancerSubnetList`가 적용됨 각 서브넷은 따옴표 안에 {필드='값'} 쌍을 콤마로 구분하여 입력 `subnetNo` (Conditional): 서브넷 번호. `loadBalancerSubnetList` 적용 시 필수 입력. 로드밸런서와 같은 VPC에 위치하는 서브넷 선택. getSubnetList 참조 `publicIpInstanceNo` (Optional): 공인 IP 인스턴스 번호. 미입력 시 새로운 공인 IP를 생성하여 할당. 로드밸런서의 네트워크 유형이 `PUBLIC`이면 설정 가능 존별로 한 개의 로드밸런서 전용 서브넷 선택 가능

공통 옵션

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

예시

로드밸런서 서브넷 설정 요청이 성공하면 변경된 인스턴스의 구성 정보와 변경 상태가 반환됩니다.

명령

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

./ncloud vloadbalancer setLoadBalancerInstanceSubnet \
    --loadBalancerInstanceNo 41112223 \
    --subnetNoList 23456790 23456791 \
    --regionCode KR \
    --output json

출력

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

{
  "changeLoadBalancerInstanceConfigurationResponse": {
    "totalRows": 1,
    "loadBalancerInstanceList": [
      {
        "loadBalancerInstanceNo": "41112223",
        "loadBalancerInstanceStatus": {
          "code": "USED",
          "codeName": "LB USED state"
        },
        "loadBalancerInstanceOperation": {
          "code": "CHANG",
          "codeName": "LB CHANGE OP"
        },
        "loadBalancerInstanceStatusName": "Changing",
        "loadBalancerDescription": "Updated load balancer description",
        "createDate": "2026-07-07T17:12:11+0900",
        "loadBalancerName": "lb-test-01",
        "loadBalancerDomain": "lb-test-01-41112223-16dd7a5738c1.kr.lb.naverncp.com",
        "loadBalancerIpList": [
          "10.0.2.6"
        ],
        "loadBalancerType": {
          "code": "APPLICATION",
          "codeName": "Application Load Balancer"
        },
        "loadBalancerNetworkType": {
          "code": "PRIVATE",
          "codeName": "Private"
        },
        "throughputType": {
          "code": "SMALL",
          "codeName": "Small"
        },
        "idleTimeout": 120,
        "vpcNo": "12345678",
        "regionCode": "KR",
        "accessLogUseYn": "N",
        "subnetNoList": [
          "23456790",
          "23456791"
        ],
        "loadBalancerSubnetList": [
          {
            "zoneCode": "KR-1",
            "subnetNo": "23456790",
            "publicIpInstanceNo": ""
          },
          {
            "zoneCode": "KR-2",
            "subnetNo": "23456791",
            "publicIpInstanceNo": ""
          }
        ],
        "loadBalancerListenerNoList": [
          "60001111"
        ]
      }
    ],
    "requestId": "f6a7b8c9-d0e1-2345-fabc-678901234567",
    "returnCode": "0",
    "returnMessage": "success"
  }
}