---
title: "Server (VPC) 개요"
slug: "compute-vserver"
tags: ["Server"]
updated: 2026-10-22T10:47:00Z
published: 2026-10-22T10:47:00Z
canonical: "api-gov.ncloud-docs.com/compute-vserver"
---

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

# Server (VPC) 개요

VPC 환경에서 이용 가능합니다.

Server는 클라우드 환경에서 서버를 생성하고 확장하며, 운영하고 관리할 수 있도록 돕는 네이버 클라우드 플랫폼의 서비스입니다. Server에서는 서버, 스토리지, 스냅샷, 공인 IP, Init Script, 네트워크 인터페이스(Network Interface), ACG(Access Control Group), Fabric Cluster 기능에 대한 API를 RESTful 형태로 제공합니다.

## Server 공통 설정

Server API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

### 요청

공통 요청 형식을 설명합니다.

#### API URL

요청 API URL은 다음과 같습니다.

```
https://ncloud.apigw.gov-ntruss.com
```

### 요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

| 필드 | 필수 여부 | 설명 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초) - API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주 - Unix Timestamp 형식 |
| `x-ncp-iam-access-key` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key - Access Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi-ncpapi#API%EC%9D%B8%EC%A6%9D%ED%82%A4) 참조 - 서브 계정의 Access Key 발급 및 확인: [서브 계정 생성](https://guide-gov.ncloud-docs.com/docs/subaccount-use#%EC%84%9C%EB%B8%8C%EA%B3%84%EC%A0%95%EC%83%9D%EC%84%B1) 참조 |
| `x-ncp-apigw-signature-v2` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 - Secret Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi-ncpapi#API%EC%9D%B8%EC%A6%9D%ED%82%A4) 참조 - 서명 생성: [시그니처 생성](/docs/common-ncpapi-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1) 참조 |

### 응답

공통 응답 형식을 설명합니다.

#### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

**responseError** responseError는 API 호출 실패 정보를 정의합니다. responseError에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `returnCode` | String | Required | 오류 코드 |
| `returnMessage` | String | Required | 오류 메시지 |

#### 응답 상태 코드

Server API는 네이버 클라우드 플랫폼의 공통 응답 상태 코드를 사용합니다. 네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud API 응답 상태 코드](/docs/api-call-lgc-errorhandling)를 참조해 주십시오.

## Server API

Server 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

### Login Key

인증키 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createLoginKey](/docs/compute-vserver-server-loginkey-createloginkey) | 인증키 생성 |
| [importLoginKey](/docs/compute-vserver-server-loginkey-importloginkey) | 사용자가 직접 생성한 공개키를 인증키로 가져오기 |
| [getLoginKeyList](/docs/compute-vserver-server-loginkey-getloginkeylist) | 인증키 목록 조회 |
| [deleteLoginKeys](/docs/compute-vserver-server-loginkey-deleteloginkeys) | 인증키 삭제 |

### ACG

ACG (Access Control Group) 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createAccessControlGroup](/docs/compute-vserver-acg-createaccesscontrolgroup) | ACG 생성 |
| [getAccessControlGroupList](/docs/compute-vserver-acg-getaccesscontrolgrouplist) | ACG 목록 조회 |
| [getAccessControlGroupDetail](/docs/compute-vserver-acg-getaccesscontrolgroupdetail) | ACG 상세 정보 조회 |
| [getAccessControlGroupRuleList](/docs/compute-vserver-acg-getaccesscontrolgrouprulelist) | ACG의 규칙 목록 조회 |
| [addAccessControlGroupInboundRule](/docs/compute-vserver-acg-addaccesscontrolgroupinboundrule) | ACG에 인바운드 규칙 추가 |
| [removeAccessControlGroupInboundRule](/docs/compute-vserver-acg-removeaccesscontrolgroupinboundrule) | ACG에서 인바운드 규칙 삭제 |
| [addAccessControlGroupOutboundRule](/docs/compute-vserver-acg-addaccesscontrolgroupoutboundrule) | ACG에 아웃바운드 규칙 추가 |
| [removeAccessControlGroupOutboundRule](/docs/compute-vserver-acg-removeaccesscontrolgroupoutboundrule) | ACG에서 아웃바운드 규칙 삭제 |
| [deleteAccessControlGroup](/docs/compute-vserver-acg-deleteaccesscontrolgroup) | ACG 삭제 |

### Init Script

초기화 스크립트 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createInitScript](/docs/compute-vserver-initscript-createinitscript) | 초기화 스크립트 생성 |
| [getInitScriptList](/docs/compute-vserver-initscript-getinitscriptlist) | 초기화 스크립트 목록 조회 |
| [getInitScriptDetail](/docs/compute-vserver-initscript-getinitscriptdetail) | 초기화 스크립트 상세 정보 조회 |
| [deleteInitScripts](/docs/compute-vserver-initscript-deleteinitscripts) | 초기화 스크립트 삭제 |

### Placement Group

물리 배치 그룹 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createPlacementGroup](/docs/compute-vserver-server-placementgroup-createplacementgroup) | 서버 인스턴스가 소속되는 물리 배치 그룹 생성 |
| [getPlacementGroupList](/docs/compute-vserver-server-placementgroup-getplacementgrouplist) | 물리 배치 그룹 목록 조회 |
| [getPlacementGroupDetail](/docs/compute-vserver-server-placementgroup-getplacementgroupdetail) | 물리 배치 그룹 상세 정보 조회 |
| [addPlacementGroupServerInstance](/docs/compute-vserver-server-placementgroup-addplacementgroupserverinstance) | 물리 배치 그룹에 서버 인스턴스 추가 |
| [removePlacementGroupServerInstance](/docs/compute-vserver-server-placementgroup-removeplacementgroupserverinstance) | 물리 배치 그룹에서 서버 인스턴스 제거 |
| [deletePlacementGroup](/docs/compute-vserver-server-placementgroup-deleteplacementgroup) | 물리 배치 그룹 삭제 |

### Server Image

서버 이미지 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createServerImage](/docs/compute-vserver-serverimage-createserverimage) | 서버 인스턴스로 서버 이미지 생성 |
| [createServerImageFromSnapshot](/docs/compute-vserver-serverimage-createserverimagefromsnapshot) | 스냅샷으로 서버 이미지 생성 |
| [getServerImageList](/docs/compute-vserver-serverimage-getserverimagelist) | 서버 이미지 목록 조회 |
| [getServerImageDetail](/docs/compute-vserver-serverimage-getserverimagedetail) | 서버 이미지 상세 정보 조회 |
| [addServerImageSharingPermission](/docs/compute-vserver-serverimage-addimagesharingpermission) | 서버 이미지에 공유 권한 추가 |
| [removeServerImageSharingPermission](/docs/compute-vserver-serverimage-removeserveimagesharingpermission) | 서버 이미지에서 공유 권한 삭제 |
| [deleteServerImage](/docs/compute-vserver-serverimage-deleteserverimage) | 서버 이미지 삭제 |
| [createMemberServerImageInstance](/docs/compute-vserver-serverimage-creatememberserverimageinstance) | 서버 인스턴스로 회원 서버 이미지 생성 |
| [getMemberServerImageInstanceList](/docs/compute-vserver-serverimage-getmemberserverimageinstancelist) | 회원 서버 이미지 목록 조회 |
| [getMemberServerImageInstanceDetail](/docs/compute-vserver-serverimage-getmemberserverimageinstancedetail) | 회원 서버 이미지 상세 정보 조회 |
| [addMemberServerImageSharingPermission](/docs/compute-vserver-serverimage-addmemberserverimagesharingpermission) | 회원 서버 이미지에 공유 권한 추가 |
| [setMemberServerImageSharingPermission](/docs/compute-vserver-serverimage-setmemberserverimagesharingpermission) | 회원 서버 이미지의 공유 권한 설정 |
| [removeMemberServerImageSharingPermission](/docs/compute-vserver-serverimage-removememberserverimagesharingpermission) | 회원 서버 이미지에서 공유 권한 삭제 |
| [deleteMemberServerImageInstances](/docs/compute-vserver-serverimage-deletememberserverimageinstances) | 회원 서버 이미지 삭제 |

### Server Instance

서버 인스턴스 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createServerInstances](/docs/compute-vserver-server-createserverinstances) | 서버 인스턴스 생성 |
| [getServerInstanceList](/docs/compute-vserver-server-getserverinstancelist) | 서버 인스턴스 목록 조회 |
| [getServerInstanceDetail](/docs/compute-vserver-server-getserverinstancedetail) | 서버 인스턴스 상세 정보 조회 |
| [getRootPasswordServerInstanceList](/docs/compute-vserver-server-getrootpasswordserverinstancelist) | 서버 인스턴스의 인증키를 사용하여 관리자 비밀번호 목록 조회 |
| [getRootPassword](/docs/compute-vserver-server-getrootpassword) | 서버 인스턴스의 인증키를 사용하여 관리자 비밀번호 조회 |
| [changeServerInstanceName](/docs/compute-vserver-server-changeserverinstancename) | 서버 인스턴스의 이름 변경 |
| [changeServerInstanceSpec](/docs/compute-vserver-server-changeserverinstancespec) | 서버 인스턴스의 스펙 변경 |
| [setProtectServerTermination](/docs/compute-vserver-server-setprotectservertermination) | 서버 인스턴스의 반납 보호 여부 설정 |
| [startServerInstances](/docs/compute-vserver-server-startserverinstances) | 정지 상태인 서버 인스턴스 시작 |
| [stopServerInstances](/docs/compute-vserver-server-stopserverinstances) | 운영 중 상태인 서버 인스턴스 정지 |
| [rebootServerInstances](/docs/compute-vserver-server-rebootserverinstances) | 운영 중 상태인 서버 인스턴스 재시작 |
| [interruptServerInstance](/docs/compute-vserver-server-interruptserverinstance) | 서버 인스턴스의 상태를 분석하기 위해 진단 인터럽트 실행 |
| [terminateServerInstances](/docs/compute-vserver-server-terminateserverinstances) | 정지 상태인 서버 인스턴스 반납 |

### Network Interface

네트워크 인터페이스 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createNetworkInterface](/docs/compute-vserver-networkinterface-createnetworkinterface) | 네트워크 인터페이스 생성 |
| [getNetworkInterfaceList](/docs/compute-vserver-networkinterface-getnetworkinterfacelist) | 네트워크 인터페이스 목록 조회 |
| [getNetworkInterfaceDetail](/docs/compute-vserver-networkinterface-getnetworkinterfacedetail) | 네트워크 인터페이스 상세 정보 조회 |
| [attachNetworkInterface](/docs/compute-vserver-networkinterface-attachnetworkinterface) | 네트워크 인터페이스를 서버 인스턴스에 할당 |
| [detachNetworkInterface](/docs/compute-vserver-networkinterface-detachnetworkinterface) | 서버 인스턴스에 할당된 네트워크 인터페이스 해제 |
| [addNetworkInterfaceAccessControlGroup](/docs/compute-vserver-networkinterface-addnetworkinterfaceaccesscontrolgroup) | 네트워크 인터페이스에 ACG 추가 |
| [removeNetworkInterfaceAccessControlGroup](/docs/compute-vserver-networkinterface-removenetworkinterfaceaccesscontrolgroup) | 네트워크 인터페이스에서 ACG 삭제 |
| [assignSecondaryIps](/docs/compute-vserver-networkinterface-assignsecondaryips) | 네트워크 인터페이스에 보조 IP 할당 |
| [unassignSecondaryIps](/docs/compute-vserver-networkinterface-unassignsecondaryips) | 네트워크 인터페이스에서 보조 IP 해제 |
| [enableFlowLog](/docs/compute-vserver-networkinterface-enableflowlog) | Flow Log 활성화 |
| [getFlowLogConfigurationList](/docs/compute-vserver-networkinterface-getflowlogconfigurationlist) | Flow Log 설정 정보 조회 |
| [disableFlowLog](/docs/compute-vserver-networkinterface-disableflowlog) | Flow Log 비활성화 |
| [deleteNetworkInterface](/docs/compute-vserver-networkinterface-deletenetworkinterface) | 네트워크 인터페이스 삭제 |

### Public IP

공인 IP 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createPublicIpInstance](/docs/compute-vserver-publicip-createpublicipinstance) | 공인 IP 인스턴스 생성 |
| [getPublicIpInstanceList](/docs/compute-vserver-publicip-getpublicipinstancelist) | 공인 IP 인스턴스 목록 조회 |
| [getPublicIpInstanceDetail](/docs/compute-vserver-publicip-getpublicipinstancedetail) | 공인 IP 인스턴스 상세 정보 조회 |
| [getPublicIpTargetServerInstanceList](/docs/compute-vserver-publicip-getpubliciptargetserverinstancelist) | 공인 IP 인스턴스를 할당 가능한 서버 인스턴스 목록 조회 |
| [associatePublicIpWithServerInstance](/docs/compute-vserver-publicip-associatepublicipwithserverinstance) | 공인 IP 인스턴스를 서버 인스턴스에 할당 |
| [disassociatePublicIpFromServerInstance](/docs/compute-vserver-publicip-disassociatepublicipfromserverinstance) | 공인 IP 인스턴스를 서버 인스턴스에서 할당 해제 |
| [deletePublicIpInstance](/docs/compute-vserver-publicip-deletepublicipinstance) | 공인 IP 인스턴스 삭제 |

### Storage

스토리지 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createBlockStorageInstance](/docs/compute-vserver-storage-createblockstorageinstance) | 블록 스토리지 인스턴스 생성 |
| [getBlockStorageInstanceList](/docs/compute-vserver-storage-getblockstorageinstancelist) | 블록 스토리지 인스턴스 목록 조회 |
| [getBlockStorageInstanceDetail](/docs/compute-vserver-storage-getblockstorageinstancedetail) | 블록 스토리지 인스턴스 상세 정보 조회 |
| [getBlockStorageVolumeTypeList](/docs/compute-vserver-storage-getblockstoragevolumetypelist) | 블록 스토리지 볼륨 유형 목록 조회 |
| [attachBlockStorageInstance](/docs/compute-vserver-storage-attachblockstorageinstance) | 블록 스토리지 인스턴스를 서버 인스턴스에 할당 |
| [detachBlockStorageInstances](/docs/compute-vserver-storage-detachblockstorageinstances) | 서버 인스턴스에 할당된 블록 스토리지 인스턴스 목록 해제 |
| [changeBlockStorageInstance](/docs/compute-vserver-storage-changeblockstorageinstance) | 블록 스토리지 볼륨 크기 변경 |
| [changeBlockStorageVolumeSize](/docs/compute-vserver-storage-changeblockstoragevolumesize) | 블록 스토리지 볼륨 크기 변경 |
| [setBlockStorageReturnProtection](/docs/compute-vserver-storage-setblockstoragereturnprotection) | 블록 스토리지 반납 보호 여부 설정 |
| [deleteBlockStorageInstances](/docs/compute-vserver-storage-deleteblockstorageinstances) | 블록 스토리지 인스턴스 삭제 |

### Snapshot

스냅샷 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createBlockStorageSnapshotInstance](/docs/compute-vserver-snapshot-createblockstoragesnapshotinstance) | 블록 스토리지 스냅샷 인스턴스 생성 |
| [getBlockStorageSnapshotInstanceList](/docs/compute-vserver-snapshot-getblockstoragesnapshotinstancelist) | 블록 스토리지 스냅샷 인스턴스 목록 조회 |
| [getBlockStorageSnapshotInstanceDetail](/docs/compute-vserver-snapshot-getblockstoragesnapshotinstancedetail) | 블록 스토리지 스냅샷 인스턴스 상세 정보 조회 |
| [deleteBlockStorageSnapshotInstances](/docs/compute-vserver-snapshot-deleteblockstoragesnapshotinstances) | 블록 스토리지 스냅샷 인스턴스 삭제 |

### Fabric Cluster

Fabric Cluster 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [createFabricCluster](/docs/compute-vserver-fabriccluster-createfabriccluster) | Fabric Cluster 생성 |
| [getFabricClusterPoolList](/docs/compute-vserver-fabriccluster-getfabricclusterpoollist) | Fabric Cluster Pool 목록 조회 |
| [getFabricClusterList](/docs/compute-vserver-fabriccluster-getfabricclusterlist) | Fabric Cluster 목록 조회 |
| [getFabricClusterDetail](/docs/compute-vserver-fabriccluster-getfabricclusterdetail) | Fabric Cluster 상세 정보 조회 |
| [changeFabricClusterName](/docs/compute-vserver-fabriccluster-changefabricclustername) | Fabric Cluster의 이름 변경 |
| [changeFabricClusterDescription](/docs/compute-vserver-fabriccluster-changefabricclusterdescription) | Fabric Cluster 설명 변경 |
| [changeFabricClusterServerInstances](/docs/compute-vserver-fabriccluster-changefabricclusterserverinstances) | Fabric Cluster 서버 인스턴스 목록 변경 |
| [deleteFabricCluster](/docs/compute-vserver-fabriccluster-deletefabriccluster) | Fabric Cluster 삭제 |

### Common

리소스 생성 시 참조하는 공통 조회 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [getRegionList](/docs/compute-vserver-server-common-getregionlist) | 리전 목록 조회 |
| [getZoneList](/docs/compute-vserver-server-common-getzonelist) | 존 목록 조회 |
| [getServerImageProductList](/docs/compute-vserver-server-common-getserverimageproductlist) | 서버 이미지 상품 목록 조회 |
| [getServerProductList](/docs/compute-vserver-server-common-getserverproductlist) | 서버 상품 목록 조회 |
| [getServerSpecList](/docs/compute-vserver-server-common-getserverspeclist) | 서버 스펙 목록 조회 |
| [getServerSpecDetail](/docs/compute-vserver-server-common-getserverspecdetail) | 서버 스펙 상세 정보 조회 |
| [getHypervisorTypeList](/docs/compute-vserver-server-common-gethypervisortypelist) | 하이퍼바이저 유형 목록 조회 |
| [getRaidList](/docs/compute-vserver-server-common-getraidlist) | RAID 목록 조회 |

## Server 연관 리소스

Server API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

- Server API 사용 방법
  - [서명(시그니처) 생성](/docs/common-ncpapi-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1): 요청 헤더에 추가할 서명 생성 방법
  - [Sub Account 사용 가이드](https://guide-gov.ncloud-docs.com/docs/subaccount-overview): 요청 헤더에 추가할 Access Key 발급 방법
  - [Ncloud 공통 응답 상태 코드](/docs/api-call-lgc-errorhandling): Server 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Server 서비스 사용 방법
  - [Server 사용 가이드](https://guide-gov.ncloud-docs.com/docs/compute-server-virtualmachineserver-overview): 네이버 클라우드 플랫폼 콘솔에서 Server를 사용하는 방법
  - [Ncloud 사용 환경 가이드](https://guide-gov.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 플랫폼 및 지원 여부에 대한 가이드
  - [요금 소개, 특징, 상세 기능](https://www.gov-ncloud.com/product/compute/server): Server의 요금 체계, 특징, 상세 기능 요약
  - [서비스 최신 소식](https://www.gov-ncloud.com/intro/news?categoryCode=SVR&serviceCode=SV_0002): Server 관련 최신 소식
  - [자주 하는 질문](https://www.gov-ncloud.com/support/faq/prod?categoryCode2=SVR&categoryCode3=SV_0002&page=1): Server 사용자들이 자주 하는 질문
  - [고객 지원](https://www.gov-ncloud.com/support/question/service): API 가이드를 통해서도 궁금증이 해결되지 않는 경우, 직접 문의