---
title: "createPublicIpInstance"
slug: "compute-server-createpublicipinstance"
updated: 2026-09-17T09:57:42Z
published: 2026-09-17T09:57:42Z
canonical: "api.ncloud-docs.com/compute-server-createpublicipinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.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 | 最小: 1, 最大: 1000 | グローバル IPアドレスの説明 |
| regionNo | No | String |  | - リージョン番号 グローバル IPアドレスが作成される regionNoは getRegionListアクションを通じて取得可能 |
| zoneNo | No | String |  | - ZONE番号 グローバル IPアドレスが作成される zoneNoは getZoneListアクションを通じて取得可能 デフォルト: そのリージョンの最初の ZONEを選択 |
| responseFormatType | No | String |  | - レスポンス結果の形式タイプ オプション: xml \| json デフォルト: xml |

## レスポンス

### レスポンスボディ

- [PublicIpInstanceList](/docs/ja/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>坪村ゾーン</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </publicIpInstance>
  </publicIpInstanceList>
</createPublicIpInstanceResponse>
```

## エラーコード

以下のエラーコードは、このアクション(Action)で発生する特徴的なエラーです。共通して発生するエラーについての詳細説明は、[NAVERクラウドプラットフォーム API](/docs/ja/common-ncpapi-index)をご参照ください。

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