Server 개요
    • PDF

    Server 개요

    • PDF

    기사 요약

    개요

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

    공통 설정

    API URL

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

    요청 헤더

    헤더명설명
    x-ncp-apigw-timestamp1970 년 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리전 리스트 조회
    getZoneListZONE 리스트 조회
    getServerImageProductList네이버 클라우드 플랫폼에서 제공하는 서버 이미지 상품 리스트 조회
    getServerProductList서버 이미지 상품 코드를 이용하여 네이버 클라우드 플랫폼에서 제공하는 서버 스펙 상품 리스트 조회
    getRaidList사용 가능한 RAID 리스트 조회

    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를 입력하지 않으면 해당 서버 인스턴스의 암호화된 비밀번호 조회
    setProtectServerTermination서버 반납 보호 여부 설정

    Server Image

    API명설명
    getMemberServerImageInstanceList회원 서버 이미지 인스턴스 리스트 조회
    getMemberServerImageInstanceDetail회원 서버 이미지 인스턴스 번호를 이용하여 회원 서버 이미지 인스턴스 상세 정보 조회
    createMemberServerImageInstance정지/운영 중 상태의 서버 인스턴스로부터 회원 서버 이미지 인스턴스 생성
    deleteMemberServerImageInstances회원 서버 이미지 인스턴스 리스트 삭제
    setMemberServerImageSharingPermission회원 서버 이미지 공유 권한 설정
    addMemberServerImageSharingPermission회원 서버 이미지 공유 권한 추가
    removeMemberServerImageSharingPermission회원 서버 이미지 공유 권한 제거

    Storage

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

    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가 적용되어야 함
    assignSecondaryIps네트워크 인터페이스에 보조 IP 할당
    unassignSecondaryIps네트워크 인터페이스에 할당된 보조 IP 해제
    enableFlowLogFlowLog 활성화
    disableFlowLogFlowLog 비활성화
    getFlowLogConfigurationListFlowLog 설정 정보 조회

    ACG

    API명설명
    getAccessControlGroupListACG 리스트 조회
    ACG는 네트워크 인터페이스에 설정하여 접근 제어 기능 가능
    getAccessControlGroupDetailACG 번호를 이용하여 ACG 상세 정보 조회
    createAccessControlGroupACG 생성
    deleteAccessControlGroupACG 삭제
    getAccessControlGroupRuleListACG 번호를 이용하여 ACG의 Rule 리스트 조회
    addAccessControlGroupInboundRuleACG의 Inbound Rule 리스트 추가
    addAccessControlGroupOutboundRuleACG의 Outbound Rule 리스트 추가
    removeAccessControlGroupInboundRuleACG의 Inbound Rule 리스트 제거
    removeAccessControlGroupOutboundRuleACG의 Outbound Rule 리스트 제거

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.