Server (on VPC)

참고

네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서][API 참조서]를 구분하여 제공하고 있습니다.

Server (VPC) API 참조서 바로가기 >>
Server 설명서 바로가기 >>

개요

네이버 클라우드 플랫폼은 NAVER의 최신 컴퓨팅 기술과 운영 노하우가 축적된 클라우드 서비스입니다. 네이버 클라우드 플랫폼에서 제공하는 여러 가지 상품군 중에 솔루션 상품을 이용할 수 있도록 제공하는 응용 프로그램 인터페이스(API)를 네이버 클라우드 플랫폼 API 라고 합니다. 네이버 클라우드 플랫폼 API 는 RESTful 형태로 제공됩니다. HTTP 방식의 GET/POST 메서드 호출을 통해서 이루어집니다.

공통 설정

API URL

GET or POST
https://ncloud.apigw.ntruss.com/vserver/v2/

요청 헤더

헤더명 설명
x-ncp-apigw-timestamp 1970 년 1 월 1 일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것이다.
API Gateway 서버와 시간 차가 5 분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-iam-access-key 네이버 클라우드 플랫폼에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
x-ncp-apigw-signature-v2 위 예제의 Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명
HMAC 암호화 알고리즘은 HmacSHA256 사용

오퍼레이션

Common

API명 설명
getRegionList 리전 리스트를 조회합니다.
getZoneList ZONE 리스트를 조회합니다.
getServerImageProductList 네이버 클라우드 플랫폼에서 제공하는 서버 이미지 상품 리스트를 조회합니다.
getServerProductList 서버 이미지 상품 코드를 이용하여 네이버 클라우드 플랫폼에서 제공하는 서버 스펙 상품 리스트를 조회합니다.

Login Key

API명 설명
getLoginKeyList 서버 인스턴스(VM)에 접속 시 로그인 키를 이용하여 비밀번호를 암호화하고 복호화하는 키를 조회합니다.
createLoginKey 서버 인스턴스(VM)에 접속 시 로그인 키를 이용하여 비밀번호를 암호화하고 복호화하는 키를 생성합니다.
deleteLoginKeys 서버 인스턴스(VM)에 접속 시 로그인 키를 이용하여 비밀번호를 암호화하고 복호화하는 키를 삭제합니다.
importLoginKey 서버 인스턴스(VM)에 접속 시 로그인 키를 이용하여 비밀번호를 암호화하고 복호화하는 키를 생성합니다. 사용자가 직접 ssh-keygen으로 생성한 public key를 import 합니다.

Placement Group

API명 설명
getPlacementGroupList 서버 인스턴스(VM)가 소속되는 물리 배치 그룹 리스트를 조회합니다.
getPlacementGroupDetail 물리 배치 그룹 번호를 이용하여 물리 배치 그룹 상세 정보를 조회합니다.
createPlacementGroup 서버 인스턴스(VM)가 소속되는 물리 배치 그룹을 생성합니다.
deletePlacementGroup 물리 배치 그룹을 삭제합니다.
addPlacementGroupServerInstance 물리 배치 그룹에 서버 인스턴스를 추가합니다.
removePlacementGroupServerInstance 물리 배치 그룹에서 서버 인스턴스를 제거합니다.

Server

API명 설명
getServerInstanceList 서버 인스턴스(VM) 리스트를 조회합니다.
getServerInstanceDetail 서버 인스턴스 번호를 이용하여 서버 인스턴스 상세 정보를 조회합니다.
createServerInstances 서버 인스턴스(VM)를 생성합니다.
startServerInstances 정지 상태의 서버 인스턴스(VM)를 시작합니다.
stopServerInstances 운영 중 상태의 서버 인스턴스(VM)를 정지합니다.
rebootServerInstances 운영 중 상태의 서버 인스턴스(VM)를 재시작합니다.
terminateServerInstances 정지 상태의 서버 인스턴스(VM)를 반납합니다.
changeServerInstanceSpec 정지 상태의 서버 인스턴스(VM) 스펙을 변경합니다.
getRootPassword 서버 인스턴스(VM)의 로그인 키를 이용하여 root 계정의 비밀번호를 조회합니다. privateKey를 입력하지 않으면 해당 서버 인스턴스의 암호화된 비밀번호를 조회합니다.
getRootPasswordServerInstanceList 서버 인스턴스(VM)의 로그인 키를 이용하여 root 계정의 비밀번호를 리스트 형태로 조회합니다. privateKey를 입력하지 않으면 해당 서버 인스턴스의 암호화된 비밀번호를 조회합니다.

Server Image

API명 설명
getMemberServerImageInstanceList 회원 서버 이미지 인스턴스 리스트를 조회합니다.
getMemberServerImageInstanceDetail 회원 서버 이미지 인스턴스 번호를 이용하여 회원 서버 이미지 인스턴스 상세 정보를 조회합니다.
createMemberServerImageInstance 정지/운영 중 상태의 서버 인스턴스로부터 회원 서버 이미지 인스턴스를 생성합니다.
deleteMemberServerImageInstances 회원 서버 이미지 인스턴스 리스트를 삭제합니다.

Storage

API명 설명
getBlockStorageInstanceList 블록 스토리지 인스턴스 리스트를 조회합니다.
getBlockStorageInstanceDetail 블록 스토리지 인스턴스 번호를 이용하여 블록 스토리지 인스턴스 상세 정보를 조회합니다.
createBlockStorageInstance 블록 스토리지 인스턴스를 생성합니다.
deleteBlockStorageInstances 블록 스토리지 인스턴스 리스트를 삭제합니다.
attachBlockStorageInstance 블록 스토리지 인스턴스를 서버 인스턴스에 할당합니다.
detachBlockStorageInstances 블록 스토리지 인스턴스 리스트를 서버 인스턴스에서 할당 해제합니다.
changeBlockStorageVolumeSize 블록 스토리지 볼륨 사이즈를 변경합니다.

Snapshot

API명 설명
getBlockStorageSnapshotInstanceList 블록 스토리지 스냅샷 인스턴스 리스트를 조회합니다.
getBlockStorageSnapshotInstanceDetail 블록 스토리지 스냅샷 인스턴스 번호를 이용하여 블록 스토리지 스냅샷 인스턴스 상세 정보를 조회합니다.
createBlockStorageSnapshotInstance 블록 스토리지 스냅샷 인스턴스를 생성합니다.
deleteBlockStorageSnapshotInstances 블록 스토리지 스냅샷 인스턴스 리스트를 삭제합니다.

Public IP

API명 설명
getPublicIpInstanceList 공인 IP 인스턴스 리스트를 조회합니다.
getPublicIpInstanceDetail 공인 IP 인스턴스 번호를 이용하여 공인 IP 인스턴스 상세 정보를 조회합니다.
createPublicIpInstance 공인 IP 인스턴스를 생성합니다.
deletePublicIpInstance 공인 IP 인스턴스를 삭제합니다.
getPublicIpTargetServerInstanceList 공인 IP 인스턴스를 할당 가능한 서버 인스턴스 리스트를 조회합니다.
associatePublicIpWithServerInstance 공인 IP 인스턴스를 서버 인스턴스에 할당합니다.
disassociatePublicIpFromServerInstance 공인 IP 인스턴스를 서버 인스턴스에서 할당 해제합니다.

Init Script

API명 설명
getInitScriptList 사용자가 생성한 초기화 스크립트 리스트를 조회합니다.
getInitScriptDetail 초기화 스크립트 번호를 이용하여 초기화 스크립트 상세 정보를 조회합니다.
createInitScript 초기화 스크립트를 생성합니다.
deleteInitScripts 초기화 스크립트 리스트를 삭제합니다.

Network Interface

API명 설명
getNetworkInterfaceList 네트워크 인터페이스 리스트를 조회합니다.
getNetworkInterfaceDetail 네트워크 인터페이스 번호를 이용하여 네트워크 인터페이스 상세 정보를 조회합니다.
createNetworkInterface 네트워크 인터페이스를 생성합니다.
deleteNetworkInterface 네트워크 인터페이스를 삭제합니다.
attachNetworkInterface 서버 인스턴스에 네트워크 인터페이스를 할당합니다. 서버 인스턴스의 기본 네트워크 인터페이스를 포함하여 최대 3개의 네트워크 인터페이스를 할당할 수 있습니다.
detachNetworkInterface 서버 인스턴스에 할당된 네트워크 인터페이스를 해제합니다. 서버 인스턴스의 기본 네트워크 인터페이스는 해제할 수 없습니다.
addNetworkInterfaceAccessControlGroup 네트워크 인터페이스에 적용될 ACG 리스트를 추가합니다. 네트워크 인터페이스당 최대 3개의 ACG를 적용할 수 있습니다.
removeNetworkInterfaceAccessControlGroup 네트워크 인터페이스에 적용된 ACG 리스트를 제거합니다. 네트워크 인터페이스당 최소 1개의 ACG가 적용되어야 합니다.

ACG

API명 설명
getAccessControlGroupList ACG 리스트를 조회합니다. ACG는 네트워크 인터페이스에 설정하여 접근 제어 기능을 할 수 있습니다.
getAccessControlGroupDetail ACG 번호를 이용하여 ACG 상세 정보를 조회합니다.
createAccessControlGroup ACG를 생성합니다.
deleteAccessControlGroup ACG를 삭제합니다.
getAccessControlGroupRuleList ACG 번호를 이용하여 ACG의 Rule 리스트를 조회합니다.
addAccessControlGroupInboundRule ACG의 Inbound Rule 리스트를 추가합니다.
addAccessControlGroupOutboundRule ACG의 Outbound Rule 리스트를 추가합니다.
removeAccessControlGroupInboundRule ACG의 Inbound Rule 리스트를 제거합니다.
removeAccessControlGroupOutboundRule ACG의 Outbound Rule 리스트를 제거합니다.