changeLoadBalancerInstanceConfiguration

Available in VPC

Change load balancer instance settings.

Syntax

The changeLoadBalancerInstanceConfiguration syntax is as follows:

./ncloud vloadbalancer changeLoadBalancerInstanceConfiguration \
    --loadBalancerInstanceNo <load-balancer-instance-no> \
    [--throughputTypeCode <SMALL|MEDIUM|LARGE|DYNAMIC|XLARGE>] \
    [--idleTimeout <idle-timeout>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running changeLoadBalancerInstanceConfiguration.

Required options

The following options are required for changeLoadBalancerInstanceConfiguration.

Options	Type	Required	Description
`--loadBalancerInstanceNo`	String	Required	Load balancer instance number See getLoadBalancerInstanceList.
`--throughputTypeCode`	String	Conditional	Load balancing performance type `SMALL` (default) \| `MEDIUM` \| `LARGE` \| `DYNAMIC` \| `XLARGE` Available values are limited depending on the load balancer type. Application, Network Proxy Load Balancer: `SMALL` (default) \| `MEDIUM` \| `LARGE` \| `XLARGE` Network Load Balancer: `DYNAMIC` (default)
`--idleTimeout`	Integer	Conditional	Connection idle timeout (second) `1`-`3600` (default: `60`) Can't be set if the load balancer type is `NETWORK`.

Common options

For information about the options common to all vloadbalancer subcommands, see Load Balancer (VPC) options.

Examples

If the request to change the load balancer instance settings is successful, the configuration information for the updated instance and the change status are returned.

Command

The command example is as follows:

./ncloud vloadbalancer changeLoadBalancerInstanceConfiguration \
    --loadBalancerInstanceNo 41112223 \
    --throughputTypeCode SMALL \
    --idleTimeout 120 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "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"
        ],
        "loadBalancerSubnetList": [
          {
            "zoneCode": "KR-1",
            "subnetNo": "23456790",
            "publicIpInstanceNo": ""
          }
        ],
        "loadBalancerListenerNoList": [
          "60001111"
        ]
      }
    ],
    "requestId": "d4e5f6a7-b8c9-0123-defa-456789012345",
    "returnCode": "0",
    "returnMessage": "success"
  }
}