---
title: "createPublicIpInstance"
slug: "cli-server-createpublicipinstance"
updated: 2026-09-17T09:16:00Z
published: 2026-09-17T09:16:00Z
canonical: "cli.ncloud-docs.com/cli-server-createpublicipinstance"
---

> ## 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

## 개요

공인 IP 인스턴스 생성

## 설명

공인 IP 인스턴스를 생성합니다.

## 요청 파라미터

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| serverInstanceNo | No | String |  | - 공인 IP를 생성 후 할당할 서버 인스턴스 번호 getPublicIpTargetServerInstanceList 액션을 통해 획득 가능 |
| publicIpDescription | No | String | Min : 10, Max : 1000 | 공인IP 설명 |
| regionNo | No | String |  | - 리전번호 입력 가능한 상태는 getRegionList 액션을 통해 획득 가능 |
| zoneNo | No | String |  | - ZONE번호 공인 IP가 생성될 ZONE을 결정 가능 Default : 해당리전의 첫번째 ZONE을 선택 |

## 응답 데이터 타입

- PublicIpInstanceList 타입

| PublicIpInstanceList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private List<publicipinstance data-tomark-pass=""> publicIpInstanceList = new ArrayList<publicipinstance data-tomark-pass="">();</publicipinstance></publicipinstance> |

| PublicIpInstance |
| --- |
| private String publicIpInstanceNo; |
| private String publiclIp; |
| private String publicIpDescription; |
| private Date createDate; |
| private String publicIpInstanceStatusName; |
| private CommonCode publicIpInstanceStatus; |
| private CommonCode publicIpInstanceOperation; |
| private CommonCode publicIpKindType; |
| private ServerInstance serverInstanceAssociatedWithPublicIp; |
| private Region region; |
| private Zone zone; |

## 예시

### 호출

```
ncloud server createPublicIpInstance --serverInstanceNo 397255
```

### 응답

```
{
  "createPublicIpInstanceResponse": {
    "requestId": "a2719e72-1709-48ac-acfe-d0d9197431e3",
    "returnCode": "0",
    "returnMessage": "success",
    "totalRows": 1,
    "publicIpInstanceList": [
      {
        "publicIpInstanceNo": "397266",
        "publicIp": "192.168.60.126",
        "publicIpDescription": "",
        "createDate": "2018-02-23T14:10:01+0900",
        "publicIpInstanceStatusName": "using",
        "publicIpInstanceStatus": {
          "code": "CREAT",
          "codeName": "NET CREAT State"
        },
        "publicIpInstanceOperation": {
          "code": "USE",
          "codeName": "NET USE OP"
        },
        "publicIpKindType": {
          "code": "GEN",
          "codeName": "General"
        },
        "serverInstanceAssociatedWithPublicIp": {
          "serverInstanceNo": "397255",
          "serverName": "ncloud-mktest",
          "serverDescription": "",
          "cpuCount": 1,
          "memorySize": 2147483648,
          "baseBlockStorageSize": 53687091200,
          "platformType": {
            "code": "LNX64",
            "codeName": "Linux 64 Bit"
          },
          "loginKeyName": "ysw",
          "isFeeChargingMonitoring": false,
          "publicIp": "192.168.60.126",
          "privateIp": "10.113.245.112",
          "serverImageName": "centos-7.3-64",
          "serverInstanceStatus": {
            "code": "RUN",
            "codeName": "Server RUN State"
          },
          "serverInstanceOperation": {
            "code": "NULL",
            "codeName": "Server NULL OP"
          },
          "serverInstanceStatusName": "running",
          "createDate": "2018-02-23T13:55:34+0900",
          "uptime": "2018-02-23T13:58:34+0900",
          "serverImageProductCode": "SPSW0LINUX000046",
          "serverProductCode": "SPSVRSTAND000003",
          "isProtectServerTermination": false,
          "portForwardingPublicIp": "192.168.120.111",
          "zone": {
            "zoneNo": "2",
            "zoneName": "KR-1",
            "zoneDescription": "KR-1 zone"
          },
          "region": {
            "regionNo": "1",
            "regionCode": "KR",
            "regionName": "Korea"
          },
          "baseBlockStorageDiskType": {
            "code": "NET",
            "codeName": "Network Storage"
          },
          "baseBlockStroageDiskDetailType": {
            "code": "HDD",
            "codeName": "HDD"
          },
          "userData": "",
          "accessControlGroupList": [
            {
              "accessControlGroupConfigurationNo": "1038",
              "accessControlGroupName": "ncloud-default-acg",
              "accessControlGroupDescription": "Default AccessControlGroup",
              "isDefault": true,
              "createDate": "2013-12-03T10:37:39+0900"
            }
          ],
          "instanceTagList" : [],
        },
        "zone": {
          "zoneNo": "2",
          "zoneName": "KR-1",
          "zoneCode": "KR-1",
          "zoneDescription": "KR-1 zone",
          "regionNo" : "1"
        }
      }
    ]
  }
}
```

```
<?xml version="1.0" encoding="UTF-8" ?>
<createPublicIpInstanceResponse>
  <requestId>a2719e72-1709-48ac-acfe-d0d9197431e3</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstanceNo>397266</publicIpInstanceNo>
    <publicIp>192.168.60.126</publicIp>
    <publicIpDescription></publicIpDescription>
    <createDate>2018-02-23T14:10:01+0900</createDate>
    <publicIpInstanceStatusName>using</publicIpInstanceStatusName>
    <publicIpInstanceStatus>
      <code>CREAT</code>
      <codeName>NET CREAT State</codeName>
    </publicIpInstanceStatus>
    <publicIpInstanceOperation>
      <code>USE</code>
      <codeName>NET USE OP</codeName>
    </publicIpInstanceOperation>
    <publicIpKindType>
      <code>GEN</code>
      <codeName>General</codeName>
    </publicIpKindType>
    <serverInstanceAssociatedWithPublicIp>
      <serverInstanceNo>397255</serverInstanceNo>
      <serverName>ncloud-mktest</serverName>
      <serverDescription></serverDescription>
      <cpuCount>1</cpuCount>
      <memorySize>2147483648</memorySize>
      <baseBlockStorageSize>53687091200</baseBlockStorageSize>
      <platformType>
        <code>LNX64</code>
        <codeName>Linux 64 Bit</codeName>
      </platformType>
      <loginKeyName>ysw</loginKeyName>
      <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
      <publicIp>192.168.60.126</publicIp>
      <privateIp>10.113.245.112</privateIp>
      <serverImageName>centos-7.3-64</serverImageName>
      <serverInstanceStatus>
        <code>RUN</code>
        <codeName>Server RUN State</codeName>
      </serverInstanceStatus>
      <serverInstanceOperation>
        <code>NULL</code>
        <codeName>Server NULL OP</codeName>
      </serverInstanceOperation>
      <serverInstanceStatusName>running</serverInstanceStatusName>
      <createDate>2018-02-23T13:55:34+0900</createDate>
      <uptime>2018-02-23T13:58:34+0900</uptime>
      <serverImageProductCode>SPSW0LINUX000046</serverImageProductCode>
      <serverProductCode>SPSVRSTAND000003</serverProductCode>
      <isProtectServerTermination>false</isProtectServerTermination>
      <portForwardingPublicIp>192.168.120.111</portForwardingPublicIp>
      <zone>
        <zoneNo>2</zoneNo>
        <zoneName>KR-1</zoneName>
        <zoneDescription>KR-1 zone</zoneDescription>
      </zone>
      <region>
        <regionNo>1</regionNo>
        <regionCode>KR</regionCode>
        <regionName>Korea</regionName>
      </region>
      <baseBlockStorageDiskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </baseBlockStorageDiskType>
      <baseBlockStroageDiskDetailType>
        <code>HDD</code>
        <codeName>HDD</codeName>
      </baseBlockStroageDiskDetailType>
      <userData></userData>
      <accessControlGroupList>
        <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
        <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
        <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
        <isDefault>true</isDefault>
        <createDate>2013-12-03T10:37:39+0900</createDate>
      </accessControlGroupList>
      <instanceTagList/>
    </serverInstanceAssociatedWithPublicIp>
    <zone>
      <zoneNo>2</zoneNo>
      <zoneName>KR-1</zoneName>
      <zoneCode>KR-1</zoneCode>
      <zoneDescription>KR-1 zone</zoneDescription>
      <regionNo>1</regionNo>
    </zone>
  </publicIpInstanceList>
</createPublicIpInstanceResponse>
```