---
title: "createPublicIpInstance"
slug: "compute-server-createpublicipinstance"
updated: 2026-10-22T10:47:05Z
published: 2026-10-22T10:47:05Z
canonical: "api-gov.ncloud-docs.com/compute-server-createpublicipinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# createPublicIpInstance

## 개요

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

## 요청

### 요청 파라미터

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

## 응답

### 응답 바디

- [PublicIpInstanceList](/docs/common-apidatatype-publicipinstancelist)

## 예시

### 요청 예시

```
GET {SERVER_API_URL}/createPublicIpInstance
```

### 응답 예시

```
<createPublicIpInstanceResponse>
  <requestId>2f8ca49e-0532-43f2-884d-d7f8a737cac4</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstance>
      <publicIpInstanceNo>1089236</publicIpInstanceNo>
      <publicIp>49.236.137.138</publicIp>
      <publicIpDescription></publicIpDescription>
      <createDate>2018-11-28T14:38:55+0900</createDate>
      <publicIpInstanceStatusName>created</publicIpInstanceStatusName>
      <publicIpInstanceStatus>
        <code>CREAT</code>
        <codeName>NET CREATE state</codeName>
      </publicIpInstanceStatus>
      <publicIpInstanceOperation>
        <code>NULL</code>
        <codeName>NET NULL OP</codeName>
      </publicIpInstanceOperation>
      <publicIpKindType>
        <code>GEN</code>
        <codeName>General</codeName>
      </publicIpKindType>
      <serverInstanceAssociatedWithPublicIp/>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>평촌 zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </publicIpInstance>
  </publicIpInstanceList>
</createPublicIpInstanceResponse>
```

## 에러 코드

아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 [NAVER Cloud Platform API](/docs/common-ncpapi-ncpapi)를 참고해주세요

| HTTP Response Code | 리턴 코드 | 리턴 메시지 |
| --- | --- | --- |
| 400 | 10101 | Unable to request for public IP. You may request as many public IPs as the number of server in possession. |
| 400 | 24300 | The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes. |
| 400 | 24094 | The line for internet access of server does not correspond with which of Public IP. |
| 400 | 25101 | The server is currently being operated. so public IP is unable to be associated with the server. |
| 400 | 28100 | Another public IP is already associated with the server. |