---
title: "recreateServerInstance"
slug: "compute-server-recreateserverinstance"
updated: 2026-09-17T09:16:15Z
published: 2026-09-17T09:16:15Z
canonical: "api.ncloud-docs.com/compute-server-recreateserverinstance"
---

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

# recreateServerInstance

## 개요

서버 인스턴스를 재생성합니다. 이 API는 베어메탈(BareMetal) 상품 전용입니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| serverInstanceNo | Yes | String | 중복 불가 | - 재생성할 인스턴스 번호 serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능 |
| serverInstanceName | No | String |  | - 재생성 시 변경할 이름 Default : 원래 서버 이름으로 생성됨 |
| serverImageProductCode | Yes | String |  | - 서버이미지 상품코드 베어메탈 서버 이미지만 입력 가능 베어메탈 상품의 serverImageProductCode는 getServerImageProductList 액션을 통해 획득 가능 |
| userData | No | String | Min:1, Max:21847 | 사용자데이터 |
| instanceTagList.N.tagKey | No | List<String> |  | - 생성할 인스턴스의 태그 키 인스턴스의 태그 키를 통해 인스턴스 조회 가능 Instance의 TagKey는 getInstanceTagList 액션을 통해 획득 가능 ex) instanceTagList.1.tagKey=tag1 |
| instanceTagList.N.tagValue | No | List<String> |  | - 생성할 인스턴스의 태그 값 인스턴스의 태그 값을 통해 인스턴스 조회 가능 Instance의 TagValue는 getInstanceTagList 액션을 통해 획득 가능 ex) instanceTagList.1.tagValue=value1 |
| responseFormatType | No | String |  | - 응답 결과의 포맷 타입 Options : xml \| json Default : xml |

## 응답

### 응답 바디

- [serverinstance](/docs/common-apidatatype-serverinstance)

## 예시

### 요청 예시

```
GET {SERVER_API_URL}/recreateServerInstance
?serverInstanceNo=937507
&serverImageProductCode=SPSWBMWINNT00001
```

### 응답 예시

```
<recreateServerInstanceResponse>
   <requestId>d449a2eb-60a2-4e63-b8a9-f20edec8a98c</requestId>
   <returnCode>0</returnCode>
   <returnMessage>success</returnMessage>
   <totalRows>1</totalRows>
   <serverInstanceList>
      <serverInstance>
         <serverInstanceNo>680744</serverInstanceNo>
         <serverName>penguin-window</serverName>
         <serverDescription />
         <cpuCount>20</cpuCount>
         <memorySize>137438953472</memorySize>
         <baseBlockStorageSize>4123168604160</baseBlockStorageSize>
         <platformType>
            <code>WND64</code>
            <codeName>Windows 64 Bit</codeName>
         </platformType>
         <loginKeyName>yoon-nang-onlinetest03-newbeta</loginKeyName>
         <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
         <publicIp />
         <privateIp>10.39.64.12</privateIp>
         <serverImageName>win-2016-64-en</serverImageName>
         <serverInstanceStatus>
            <code>INIT</code>
            <codeName>Server init state</codeName>
         </serverInstanceStatus>
         <serverInstanceOperation>
            <code>NULL</code>
            <codeName>Server NULL OP</codeName>
         </serverInstanceOperation>
         <serverInstanceStatusName>init</serverInstanceStatusName>
         <createDate>2018-05-30T02:12:13+0000</createDate>
         <uptime>2018-05-30T02:12:13+0000</uptime>
         <serverImageProductCode>SPSWBMWINNT00001</serverImageProductCode>
         <serverProductCode>SPSVRBM000000001</serverProductCode>
         <isProtectServerTermination>false</isProtectServerTermination>
         <portForwardingPublicIp>49.236.160.11</portForwardingPublicIp>
         <portForwardingExternalPort>30006</portForwardingExternalPort>
         <portForwardingInternalPort>3389</portForwardingInternalPort>
         <zone>
            <zoneNo>2</zoneNo>
            <zoneName>KR-1</zoneName>
            <zoneDescription>가산 zone</zoneDescription>
         </zone>
         <region>
            <regionNo>1</regionNo>
            <regionCode>KR</regionCode>
            <regionName>Korea</regionName>
         </region>
         <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
         </baseBlockStorageDiskType>
         <baseBlockStorageDiskDetailType>
            <code>SSD</code>
            <codeName>SSD</codeName>
         </baseBlockStorageDiskDetailType>
         <serverInstanceType>
            <code>BM</code>
            <codeName>BareMetal</codeName>
         </serverInstanceType>
         <userData>#powershell
invoke-WebRequest http://125.209.192.32/ms-test/naver_download.ps1 -OutFile C:\Windows\Temp\naver_download.ps1
C:\Windows\Temp\naver_download.ps1</userData>
         <initScriptNo>4721</initScriptNo>
         <accessControlGroupList>
            <accessControlGroup>
               <accessControlGroupConfigurationNo>17791</accessControlGroupConfigurationNo>
               <accessControlGroupName>yoon-test</accessControlGroupName>
               <accessControlGroupDescription>ttADFEDFDFD</accessControlGroupDescription>
               <isDefault>false</isDefault>
               <createDate>2017-09-19T02:52:24+0000</createDate>
            </accessControlGroup>
         </accessControlGroupList>
      </serverInstance>
   </serverInstanceList>
</recreateServerInstanceResponse>
```