Documentation Index

Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

createPublicIpInstance

Prev Next

Available in VPC

Create a public IP instance.

Syntax

The createPublicIpInstance syntax is as follows:

./ncloud vserver createPublicIpInstance \
    [--serverInstanceNo <server-instance-no>] \
    [--publicIpDescription <public-ip-description>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running createPublicIpInstance.

Optional options

These are the optional options for createPublicIpInstance. Options that are not specified will use their default values.

Options Type Required Description
--serverInstanceNo String Optional Server instance number
--publicIpDescription String Optional Public IP description (byte)
  • 0-1000

Common options

For information about the options common to all vserver subcommands, see Server (VPC) options.

Examples

If the request to create a public IP instance is successful, the identification information and status of the created public IP are returned.

Command

The command example is as follows:

./ncloud vserver createPublicIpInstance \
    --publicIpDescription "Test public IP" \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "createPublicIpInstanceResponse": {
    "totalRows": 1,
    "publicIpInstanceList": [
      {
        "publicIpInstanceNo": "78901234",
        "publicIp": "203.0.113.10",
        "publicIpDescription": "Test public IP",
        "createDate": "2026-05-14T19:53:38+0900",
        "publicIpInstanceStatusName": "Creating",
        "publicIpInstanceStatus": {
          "code": "INIT",
          "codeName": "Under preparation"
        },
        "serverInstanceNo": "",
        "serverName": "",
        "privateIp": "",
        "publicIpInstanceOperation": {
          "code": "CREAT",
          "codeName": "CREAT OP"
        }
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}