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)
|
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"
}
}