[중요] API 활용 가이드 문서 지원 종료 (Deprecated) 안내

본 API 문서는 네이버 클라우드 플랫폼의 확장성 있는 API 제공을 위해 Deprecated 되어 공식적으로 사용하지 않으며, 앞으로 사용이 정지될 예정입니다. (2018년 12월)
새롭게 제공되는 Ncloud APIs 가이드에서 네이버 클라우드 플랫폼의 API 사용 방법을 확인해 주십시오.



=========================================== @deprecated 문서(~2018년12월) ==========================================



네이버 클라우드 플랫폼 API 개요

네이버 클라우드 플랫폼은 NAVER의 최신 컴퓨팅 기술과 운영 노하우가 축적된 클라우드 서비스입니다.

네이버 클라우드 플랫폼에서 제공하는 여러 가지 상품군 중에서 솔루션 상품을 이용할 수 있도록 제공하는 응용 프로그램 인터페이스(API)를 네이버 클라우드 플랫폼 API라고 합니다. 네이버 클라우드 플랫폼 API는 RESTful 형태로 제공되며 HTTP 방식의 GET/POST 메서드 호출을 사용합니다.

API 요청

API 요청 메시지는 아래와 같이 구성됩니다.

API URL + 액션 + 액션 파라미터 + 응답 포맷 + AUTHPARMS

  • API URL
  • 액션
    • 컴퓨팅 자원 요청 액션(생성, 삭제, 조회 등)
    • action=createServerInstances
  • 액션 파라미터
    • 액션 관련 파라미터
    • serverName=myserver&serverImageProductCode=SPSWLINUX000031
  • 응답 포맷
    • XML, JSON 응답 포맷을 지원하며 옵션 항목입니다. 지정하지 않으면 기본값은 xml입니다.
    • responseFormatType=xml
  • AUTHPARAMS
    • oauth_consumer_key=CCe2T0ilv4aO3kIevT3x
    • oauth_signature_method=HMAC-SHA1
    • oauth_version=1.0
    • oauth_timestamp=1392264315
    • oauth_nonce=9196882534520920143
    • oauth_signature=rtKrFoEAHqRFTqon5vt4fObtv%2F8%3D

API 요청 예

https://api.ncloud.com/server/?action=createServerInstances&serverImageProductCode=SPSW0LINUX000031&responseFormatType=xml&oauth_consumer_key=CCe2T0ilv4aO3kIevT3x&oauth_nonce=9196882534520920143&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1392264315&oauth_version=1.0&oauth_signature=rtKrFoEAHqRFTqon5vt4fObtv%2F8%3D

API 요청 예 구성

구분 설명
https://api.ncloud.com/server/? API URL
action=createServerInstances 액션
&serverImageProductCode=SPSW0LINUX000031 액션 파라미터
&responseFormatType=xml 응답 포맷
&oauth_consumer_key=CCe2T0ilv4aO3kIevT3x AUTHPARAMS
&oauth_nonce=9196882534520920143 AUTHPARAMS
&oauth_signature_method=HMAC-SHA1 AUTHPARAMS
&oauth_timestamp=1392264315 AUTHPARAMS
&oauth_version=1.0 AUTHPARAMS
&oauth_signature=rtKrFoEAHqRFTqon5vt4fObtv%2F8%3D AUTHPARAMS

액션 파라미터

기본적으로 Key, Value 쌍으로 구성되어 있으며, 리스트(List< Object >) 형식의 파라미터의 경우 리스트형 파라미터명.N 형식으로 구성되어 있습니다.

맵 리스트(Map < String, List < Object > >) 형식의 파라미터의 경우 리스트명.N.파라미터명 형식으로 구성되어 있습니다.

N 값은 1부터 시작되며 100을 넘길 수 없습니다.

  • 일반적인 액션 파라미터

    &pageNo=1
    &serverName=myServer
    …
    
  • 리스트형 액션 파라미터

    &serverInstanceNoList.1=1
    &serverInstanceNoList.2=2
    …
    
  • 맵 리스트형 액션 파라미터

    &loadBalancerRuleList.1.protocolTypeCode=HTTP
    &loadBalancerRuleList.1.loadBalancerPort=80
    &loadBalancerRuleList.1.serverPort=80
    &loadBalancerRuleList.2.l7HealthCheckPath=/l7check.html
    &loadBalancerRuleList.1.protocolTypeCode=HTTP
    &loadBalancerRuleList.1.loadBalancerPort=81
    &loadBalancerRuleList.1.serverPort=81
    &loadBalancerRuleList.2.l7HealthCheckPath=/l7check2.html
    …
    

AUTHPARAMS

여기에서는 인증 방법을 간략하게 설명합니다. 인증 파라미터에 대한 자세한 내용은 네이버 클라우드 플랫폼 OAuth 이용 가이드를 참고하시기 바랍니다.

인증키를 생성하기 위해서 아래와 같은 절차를 따릅니다.

  • base string 생성

    • 액션 파라미터에 base string 생성에 필요한 인증 파라미터를 추가
    • 요청 파라미터와 value 값을 알파벳순으로 정렬
    • base string = RequestMethod + '&' + oauthEncode(requestUrl) + '&' + oauthEncode(queryString)

    • Java 생성 예

      private SortedMap<String, SortedSet<String>> getSignificateParametersForSiganturBaseString(Map<String, List<String>> requestParameters, String consumerKey) {
      SortedMap<String, SortedSet<String>> significateParameters = convertTypeToSortedMap(requestParameters);
      
      SortedSet<String> consumerKeySet = new TreeSet<String>();
      consumerKeySet.add(consumerKey);
      significateParameters.put("oauth_consumer_key", consumerKeySet);
      
      SortedSet<String> nonceSet = new TreeSet<String>();
      nonceSet.add(generateNonce());
      significateParameters.put("oauth_nonce", nonceSet);
      
      SortedSet<String> signatureMethodSet = new TreeSet<String>();
      signatureMethodSet.add("HMAC-SHA1");
      significateParameters.put("oauth_signature_method", signatureMethodSet);
      
      SortedSet<String> timestampSet = new TreeSet<String>();
      timestampSet.add(generateTimestamp());
      significateParameters.put("oauth_timestamp", timestampSet);
      
      SortedSet<String> versionSet = new TreeSet<String>();
      versionSet.add("1.0");
      significateParameters.put("oauth_version", versionSet);
      
      return significateParameters;
      }
      
      private String makeSignatureBaseString(String requestMethod, String requestUrl, SortedMap<String, SortedSet<String>> significantParameters) {
      StringBuilder queryString = getRequestQueryString(significantParameters);
      
      requestUrl = normalizeUrl(requestUrl);
      requestUrl = OAuthCode3.oauthEncode(requestUrl);
      
      return new StringBuilder(requestMetho4.toUpperCase()).append('&').append(requestUrl).append('&').append(OAuthCode3.oauthEncode(queryString.toString())).toString();
      }
      
    • base string 예

      POST&http%3A%2F%2F10.101.54.72%2Fserver%2F&action%3DgetServerProductList%26oauth_consumer_key%3DCCe2T0ilv4aO3kIevT3x%26oauth_nonce%3D7179137053311691172%26oauth_signature_method%3DHMAC-SHA1%26oauth_timestamp%3D1392277044%26oauth_version%3D1.0%26responseFormatType%3Dxml
      
  • 서명서 생성

    • Secret Key와 위에서 생성한 baseString으로 HMAC SHA-1 해시 알고리즘을 이용하여 서명서를 생성합니다.

    • Java 생성 예

      private String sign(String signatureBaseString, String consumerSecret) throws NoSuchAlgorithmException, UnsupportedEncodingException, InvalidKeyException {
      Mac mac = Ma3.getInstance("HmacSHA1");
      SecretKeySpec spec = new SecretKeySpec(new String(consumerSecret + "&").getBytes("UTF-8"), "HmacSHA1");
      ma3.init(spec);
      byte text[] = signatureBaseString.getBytes("UTF-8");
      byte signatureBytes[] = ma3.doFinal(text);
      signatureBytes = Base64.encodeBase64(signatureBytes);
      String signature = new String(signatureBytes, "UTF-8");
      logger.debug("signature : " + signature);
      return signature;
      }
      
    • 서명서 예

      vMissQDb84MhEn7NGh1+Yuyfank=
      

API 응답

API 응답에 대해 설명합니다.

API 응답 포맷

기본적으로 XML, JSON 형식의 응답 포맷을 지원합니다.

  • XML 응답

    <getZoneListResponse>
      <requestId>c385247e-6c76-4b20-ba67-509d5dc95f68</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <zoneList>
        <zone>
          <zoneNo>2</zoneNo>
          <zoneName>zone2</zoneName>
          <zoneDescription>nang zone</zoneDescription>
        </zone>
        <zone>
          <zoneNo>3</zoneNo>
          <zoneName>zone3</zoneName>
          <zoneDescription>nang zone2</zoneDescription>
        </zone>
      </zoneList>
    </getZoneListResponse>
    
  • JSON 응답

    {
      "getZoneListResponse":{
        "requestId":"b6b9d54f-2770-40bb-a8a9-cc6aa46f75e0",
        "returnCode":0,
        "returnMessage":"success",
        "zoneList":[{
          "zone":[{
            "zoneNo":2,
            "zoneName":"zone2",
            "zoneDescription":"nang zone"
          },{
            "zoneNo":3,
            "zoneName":"zone3",
            "zoneDescription":"nang zone2"
          }]
        }]
      }
    }
    

응답 데이터 타입

네이버 클라우드 플랫폼의 모든 응답은 데이터 타입으로 구성되어 있습니다. 첫 Response 태그는 < 액션명+Response > 형식으로 구성되어 있습니다.

예를 들면 ProductList 데이터 타입에 대한 기본적인 구성은 아래와 같습니다.

CommonResponse
private String requestId;
private String returnCode;
private String returnMessage;
ProductList extends CommonResponse
private List< Product > productList = new ArrayList< Product >();
Product
private String productCode;
private String productName;
private CommonCode productType;
private String productDescription;
private CommonCode infraResourceType;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;

공통으로 전달하는 CommonResponse 데이터 타입이 ProductList에 extends되어 있고, ProductList는 List< Product >으로 구성되어 있습니다.

오류 처리

API 요청이 잘못되거나 처리 도중 오류가 발생하면 오류 정보를 응답으로 전달합니다.

오류 발생 시 HTTP 응답 코드는 200 OK 외의 값이 전달되며, 오류 정보는 반환 코드 < returnCode >와 반환 메시지 < returnMessage >로 구성되며, CommonResponse 데이터 타입을 가집니다. 또한 모든 오류는 < responseError >라는 이름으로 반환됩니다.

  • 사용자 오류 예: HTTP 응답 코드 400

      <responseError>
        <returnCode>900</returnCode>
        <returnMessage>
        Required field is not specifie4. location : serverImageProductCode.
        </returnMessage>
      </responseError>
    
  • 인증 오류 예: HTTP 응답 코드 401

      <responseError>
        <returnCode>801</returnCode>
        <returnMessage>Signature is invalided</returnMessage>
      </responseError>

아래는 HTTP 응답 코드 기준으로 정렬한 오류 정보입니다.

HTTP 응답 코드 반환 코드 반환 메시지
400 900 ~ 999 파라미터 관련 오류
400 1100 BAD REQUEST
400 1400 ~ 1499 사용자에 의해 발생한 기타 오류
400 10000 ~ 29999 사용자에 의해 발생한 기타 오류
401 800 ~ 899 인증 관련 오류
404 1101 NOT FOUND
405 1102 METHOD NOT ALLOWED
500 1000 ~ 1399 서버 내부 오류

아래는 위와 동일한 오류 정보를 반환 코드 기준으로 정렬한 표입니다.

HTTP 응답 코드 반환 코드 반환 메시지
401 800 – 899 인증 관련 오류
400 900 – 999 파라미터 관련 오류
500 1000 – 1399 서버 내부 오류
400 1100 BAD REQUEST
404 1101 NOT FOUND
405 1102 METHOD NOT ALLOWED
400 1400 – 1499 사용자에 의해 발생한 기타 오류
400 10000 - 29999 사용자에 의해 발생한 기타 오류

액션

여기에서는 액션과 액션 파라미터 정보 및 응답에 대해서 기술합니다.

코드 예에서 사용되는 ${SERVER_API_URL}은 네이버 클라우드 플랫폼 서버 API URL(https://api.ncloud.com/server/?)이고 ${LOADBALANCER_API_URL}은 네이버 클라우드 플랫폼 로드밸런서 API URL(https://api.ncloud.com/loadbalancer/?)입니다.

Product(상품)

기본적으로 네이버 클라우드 플랫폼은 상품 단위로 구매를 진행합니다. 따라서 서버 인스턴스(VM)를 생성하려면 서버 이미지 상품과 서버 상품을 조회하여 해당 상품을 구매해야 합니다.

getServerImageProductList

API명

서버 이미지 상품 리스트 조회

설명

서버 인스턴스(VM)를 생성하려면 먼저 서버 이미지 상품을 선택해야 합니다. 이를 위해서 서버 이미지 상품을 조회할 수 있는 API를 제공합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
exclusionProductCode 제외할 상품 코드 String Min:1, Max:2 No
productCode 조회할 상품 코드 String Min:1, Max:20 No
platformTypeCodeList.N 플랫폼 구분 코드 리스트 String Min:1, Max:5 No
  • exclusionProductCode
    리스트에서 제외할 상품 코드를 입력합니다.

  • productCode
    리스트에서 조회할 상품 코드를 입력합니다. 1건 조회 시 사용합니다.

  • platformTypeCodeList.N
    플랫폼 구분에 필요한 값을 리스트 형태로 전달합니다. 아래의 값이 입력될 수 있습니다.

    • 리눅스32Bit(LNX32) | 리눅스64Bit(LNX64) | 윈도우32Bit(WND32) | 윈도우64Bit(WND64) | 우분투데스크톱64Bit(UBD64) | 우분투서버64Bit(UBS64)

응답 데이터 타입

  • ProductList 타입
ProcessList extends CommonResponse
private Integer totalRows;
private List processList = new ArrayList();
Product
private String productCode;
private String productName;
private CommonCode productType;
private String productDescription;
private CommonCode infraResourceType;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String osInformation;
private CommonCode diskType;
private Long addBlockStroageSize;

오류

  • 요청

    ${SERVER_API_URL}?action=getServerImageProductList
    &platformTypeCodeList.1=LNX64
    &platformTypeCodeList.2=WND64
    &AUTHPARAMS
    
  • 응답

    <getServerImageProductListResponse>
      <requestId>bf4d5bd2-587f-4e1e-8ac3-f7fb0e6cde03</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <productList>
        <product>
          <productCode>SPSW0LINUX000010</productCode>
          <productName>centos-5.7-64</productName>
          <productType>
            <code>LINUX</code>
            <codeName>Linux</codeName>
          </productType>
          <productDescription>CentOS 5.7(64bit)</productDescription>
          <infraResourceType>
            <code>SW</code>
            <codeName>Software</codeName>
          </infraResourceType>
          <cpuCount>0</cpuCount>
          <memorySize>0</memorySize>
          <baseBlockStorageSize>0</baseBlockStorageSize>
          <platformType>
            <code>LNX64</code>
            <codeName>Linux 64 Bit</codeName>
          </platformType>
          <osInformation>CentOS 5.7 64Bit</osInformation>
          <addBlockStroageSize>0</addBlockStroageSize>
        </product>
        <product>
          <productCode>SPSW0WINNT000014</productCode>
          <productName>win-2008-64-R2</productName>
          <productType>
            <code>WINNT</code>
            <codeName>Windows NT</codeName>
          </productType>
          <productDescription>Windows Server 2008(64bit) R2 with SP1</productDescription>
          <infraResourceType>
            <code>SW</code>
            <codeName>Software</codeName>
          </infraResourceType>
          <cpuCount>0</cpuCount>
          <memorySize>0</memorySize>
          <baseBlockStorageSize>0</baseBlockStorageSize>
          <platformType>
            <code>WND64</code>
            <codeName>Windows 64 Bit</codeName>
          </platformType>
          <osInformation>Windows Server 2008(64bit) R2</osInformation>
          <addBlockStroageSize>0</addBlockStroageSize>
        </product>
        <product>
          <productCode>SPSW0LINUX000031</productCode>
          <productName>centos-6.3-64</productName>
          <productType>
            <code>LINUX</code>
            <codeName>Linux</codeName>
          </productType>
          <productDescription>CentOS 6.3(64bit)</productDescription>
          <infraResourceType>
            <code>SW</code>
            <codeName>Software</codeName>
          </infraResourceType>
          <cpuCount>0</cpuCount>
          <memorySize>0</memorySize>
          <baseBlockStorageSize>0</baseBlockStorageSize>
          <platformType>
            <code>LNX64</code>
            <codeName>Linux 64 Bit</codeName>
          </platformType>
          <osInformation>CentOS 6.3 64Bit</osInformation>
          <addBlockStroageSize>0</addBlockStroageSize>
        </product>
      </productList>
    </getServerImageProductListResponse>

getServerProductList

API명

서버 상품 리스트 조회

설명

서버 인스턴스를 생성하려면 서버 상품(서버 스펙)을 선택해야 합니다. 이를 위해서 서버 상품을 조회할 수 있는 API를 제공합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
exclusionProductCode 제외할 상품 코드 String Min:1, Max:2 No
productCode 조회할 상품 코드 String Min:1, Max:20 No
serverImageProductCode 서버 이미지 상품 코드 String Min:1, Max:20 Yes
  • exclusionProductCode
    리스트에서 제외할 상품 코드를 입력합니다.

  • productCode
    리스트에서 조회할 상품 코드를 입력합니다. 1건 조회 시 사용합니다.

  • serverImageProductCode
    서버 이미지 상품 리스트 조회(getServerImageProdutList) API를 통해서 획득할 수 있습니다. 필수값이며, 서버 이미지 상품에 따라서 생성 가능한 서버 스펙이 달라집니다.

응답 데이터 타입

  • ProductList 타입
ProcessList extends CommonResponse
private Integer totalRows;
private List processList = new ArrayList();
Product
private String productCode;
private String productName;
private CommonCode productType;
private String productDescription;
private CommonCode infraResourceType;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String osInformation;
private CommonCode diskType;
private Long addBlockStroageSize;

오류

  • 요청

    ${SERVER_API_URL}?action=getServerProductList
    &serverImageProductCode=SPSW0LINUX0 00031
    &AUTHPARAMS
    
  • 응답

    <getServerProductListResponse>
      <requestId>12ae51b2-0624-4522-98e1-f41fd475e7f6</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <productList>
        <product>
          <productCode>SPSVRSTAND000043</productCode>
          <productName>[Local Disk] vCPU 2개, 메모리 4GB, 디스크 100GB</productName>
          <productType>
            <code>STAND</code>
            <codeName>Standard</codeName>
          </productType>
          <productDescription>[Local Disk] vCPU 2개, 메모리 4GB, 디스크 100GB</productDescription>
          <infraResourceType>
            <code>SVR</code>
            <codeName>Server</codeName>
          </infraResourceType>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <osInformation/>
          <diskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </diskType>
          <addBlockStroageSize>53687091200</addBlockStroageSize>
        </product>
        <product>
          <productCode>SPSVRSTAND000028</productCode>
          <productName>[Local Disk] vCPU 4개, 메모리 8GB, 디스크 200GB</productName>
          <productType>
            <code>STAND</code>
            <codeName>Standard</codeName>
          </productType>
          <productDescription>[Local Disk] vCPU 4개, 메모리 8GB, 디스크 200GB</productDescription>
          <infraResourceType>
            <code>SVR</code>
            <codeName>Server</codeName>
          </infraResourceType>
          <cpuCount>4</cpuCount>
          <memorySize>8589934592</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <osInformation/>
          <diskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </diskType>
          <addBlockStroageSize>161061273600</addBlockStroageSize>
        </product>
        <product>
          <productCode>SPSVRSTAND000029</productCode>
          <productName>[Local Disk] vCPU 8개, 메모리 16GB, 디스크 400GB</productName>
          <productType>
            <code>STAND</code>
            <codeName>Standard</codeName>
          </productType>
          <productDescription>[Local Disk] vCPU 8개, 메모리 16GB, 디스크 400GB</productDescription>
          <infraResourceType>
            <code>SVR</code>
            <codeName>Server</codeName>
          </infraResourceType>
          <cpuCount>8</cpuCount>
          <memorySize>17179869184</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <osInformation/>
          <diskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </diskType>
          <addBlockStroageSize>375809638400</addBlockStroageSize>
        </product>
      </productList>
    </getServerProductListResponse>
    

Zone(존)

네이버 클라우드 플랫폼에서 제공하는 존(Zone)에 서버 인스턴스(VM)을 생성할 수 있습니다. 기본적으로 존(Zone)을 나누는 기준은 DS(Distribution Switch)입니다.

getZoneList

API명

존(Zone) 리스트 조회

설명

서버 인스턴스(VM)를 생성할 때, 특정한 존(Zone)에 생성할 수 있습니다. 이를 위해서 네이버 클라우드 플랫폼에서 제공하는 존(Zone) 정보를 조회할 수 있는 API를 제공합니다.

요청 파라미터

존재하지 않습니다.

응답 데이터 타입

  • ZoneList 타입
ZoneList extends CommonResponse
private List zoneList = new ArrayList();
Zone
private String zoneNo;
private String zoneName;
private String zoneDescription;

오류

Response 반환 코드 반환 메시지
400 23005 There is no zone available for use.

  • 요청

    ${SERVER_API_URL}?action= getZoneList
    &AUTHPARAMS
    
  • 응답

    <getZoneListResponse>
      <requestId>cb437d90-6f9a-4c74-944d-d09d90a89ca8</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <zoneList>
        <zone>
          <zoneNo>2</zoneNo>
          <zoneName>zone2</zoneName>
          <zoneDescription>nang zone</zoneDescription>
        </zone>
        <zone>
          <zoneNo>3</zoneNo>
          <zoneName>zone3</zoneName>
          <zoneDescription>nang zone2</zoneDescription>
        </zone>
      </zoneList>
    </getZoneListResponse>
    

LoginKey(로그인 키)

getLoginKeyList

API명

로그인 키 리스트 조회

설명

서버 인스턴스(VM)를 생성하고, 생성된 서버 인스턴스(VM)에 접속 시, 로그인 키를 이용하여 비밀번호를 암호화하고 복호화하는 키를 조회합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
keyName 키명 String Min:3, Max:30 No
pageNo 페이지 번호 Integer Min:0, Max:2147483647 No
pageSize 페이지 사이즈 Integer Min:0, Max:2147483647 No
  • keyName
    조회할 키명

  • pageNo
    건수가 많아 페이징하는 경우 해당하는 페이지 번호

  • pageSize
    한 페이지에서 조회할 건수

응답 데이터 타입

  • LoginKeyList 타입
LoginKey
private String fingerprint;
private String keyName;
private Date createDate;
LoginKeyList extends CommonResponse
private Integer totalRows;
private List loginKeyList = new ArrayList();

오류

  • 요청

    ${SERVER_API_URL}?action=getLoginKeyList
    &AUTHPARAMS
    
  • 응답

    <getLoginKeyListResponse>
      <requestId>23c7e367-4d17-403a-beb9-8e4644624bf0</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>18</totalRows>
      <loginKeyList>
        <loginKey>
          <fingerprint>0e:d4:3e:ce:4b:18:75:d3:2a:03:ae:2a:df:ea:7a:e8</fingerprint>
          <keyName>yh-nang-test</keyName>
          <createDate>2014-02-03T11:33:53+0900</createDate>
        </loginKey></loginKeyList>
    </getLoginKeyListResponse>
    

createLoginKey

API명

로그인 생성

설명

서버 인스턴스(VM)를 생성하고, 생성된 서버 인스턴스(VM)에 접속 시, 로그인 키를 이용하여 비밀번호를 암호화하고 복호화하는 키를 생성합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
keyName 키명 String Min:3, Max:30 No
  • keyName
    생성할 키명. 같은 이름의 키가 존재하면 오류가 발생합니다.

응답 데이터 타입

  • PrivateKey 타입
PrivateKey extends CommonResponse
private String privateKey;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10405 The key name already exists. keyName : ${0}

  • 요청

    ${SERVER_API_URL}?action=createLoginKey
    &keyName=mykey
    &AUTHPARAMS
    
  • 응답

    <createLoginKeyResponse>
      <requestId>2f4b95a0-555c-4e64-a47f-cb5aa289e1d7</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <privateKey>
      -----BEGIN RSA PRIVATE KEY----- MIIEpAIBAAKCAQEAtNkTS9cHBLXQcDY0s02KqaLb8GGupaeCLvWzNDM3aVZxUDFo kZYaEKFXbWhR1oZ4HyZnwo4y1VDxV1m35Ltq/HRCHP8+caNHaM6n2rivfHT8nMxg KvzsXjopWIVp+8oHvmi0TO+zcEusoNOv/jb7LcJwfeZ0WQvianQ7j6ppaXgHfZSX Tdqwyuf9UmzppUa8f2wLslDOlcYQW6VQ9S5f9cx9HgTXbc4vlb+NDLwdx0E+AIjw p5PgWCjbEqGKz2Myw4X7HJ06619BScwXSkyG+G3g0VjtL7WnEhhdmfGLCUE/BcKv Fz9KeRXIQAx8NrAW4c0Vq+CPyBgz5EWWMpTUXQIDAQABAoIBABn7AXmot3pmwD4O m32SyzPZkK0060kjCmHCrG74WKKKZ5b0sigQH0h6VTwDe5ZNFR6sfsWFdioNCc7Z tcBnaFRCQ2k1Bfx/T3fwEE8srxE7ITtJZRtn4HEc++maqQIiIQCqvBQ9b1LXnEIy hxsHPQhy4YREwjw0p99ROWlHOwOKm6KWbc4YFbDKmEc9v+NLxxNjf2KF7jNuQK0l VjeJEzBa02sFBGhMeLAMvhmHj9u1NbAFUn/uC4MrMFiQMoCnx2qBSoUPxuvL6WXH NpUoLT/rJrlqKUCffS3RIVt+lwjU6vVXlrxuYNTLDH4c+XJHkFprYDdq/lZktuRM f9uYa4ECgYEA75xeol7dvFGe6Es8pcNrdZUMEwkVR16DER+nfndl3fJMNu1YIBaf XKnDZLjS505pP+a0alwq0aQdXY8FIik9O9ugqpnd1EfI2fMlrVynUOcBIhVbvYip PNFg+tIuz37f3vMms7NCQ5W3SlincB63ptl2tovkOjXKbo1r1sZaGf0CgYEAwTfB wqvGm1GpMv8jrCFGNS7FXxZy5VcP/APXqfQb6Lpwe4rarxfb8nnap5KYOn0qSbY7 BOoidV6QysT9Xm3pDjNUoeH9CujK0mx3sL/4utZiCqmVhGljGq9D4A7PsCnT4X4+ Akvk9L9RS+xNs9NsK8jTz9zthaJRUzhAHcWSAeECgYEA7rUvqj8sVBJUZ0OdFd8L zUZBky03X7SOip6odNtqRqS+vPHTG5SuCtitakifBAUf4aNrFZLgrZ38C1sSWCgR cvKoq41Ca9tgA5GydXWa0oRwoo34qWfeglJtdTOzos/ZI/nFEr2BRGeBBLYxiQdx Gu4G0HGpWzx/gYeuaXeOB9kCgYBEKznPRu+RSORbO60IQ80TYmb8P11WELtw/KIQ MjHOkEizLbAt6ksNZ3R/frb6m8JZs1NrTnfN1QlcoNeLg1egTPflDWhLewpj5yTr VS+aK5z3ihFYYB45AfD+kfswefFpMzMJeGFVAFLcaIiZk1QstnQUeCvM5BGxPL1S Q6xZwQKBgQCSeU8FRIa0jUxN7hx5R1+IAIBPl2JUM7bMME9T3eX3Qh6wNCMjTxse NU70sp2m+8sv7Bq4QY5P13Cajo/+fwI1BSa83mF2kXnyEpXsrfw+4FM74YTrX0JA FlSDMaL95g7fCSSMuM8sOqMuIBn7d7DiK2nbrez/iRsZFH2qOqusOA==
      -----END RSA PRIVATE KEY-----
      </privateKey>
    </createLoginKeyResponse>
    

AccessControlGroup(ACG)

getAccessControlGroupList

API명

AccessControlGroup 리스트 조회

설명

서버 인스턴스(VM)를 생성할 때, 사용자가 설정한 AccessControlGroup을 넣어 방화벽 기능을 설정할 수 있습니다. 이를 위해서 네이버 클라우드 플랫폼에서는 해당 설정에 필요한 AccessControlGroup 리스트 조회 API를 제공합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
accessControlGroupConfigurationNoList.N ACG 설정 번호 리스트 String No
isDefault 디폴트 ACG 여부 Boolean No
accessControlGroupName ACG명 String Min:3, Max:30 No
pageNo 페이지 번호 Integer Min:0, Max:2147483647 No
  • accessControlGroupConfigurationNoList.N
    조회할 ACG 설정 번호 리스트

  • isDefault
    디폴트 ACG만 조회 여부

  • accessControlGroupName
    조회할 ACG명

  • pageNo
    건수가 많아 페이징하는 경우 해당하는 페이지 번호

  • pageSize
    한 페이지에서 조회할 건수

응답 데이터 타입

  • AccessControlGroupList 타입
AccessControlGroupList extends CommonResponse
private Integer totalRows;
private List accessControlGroupList = new ArrayList();
AccessControlGroup
private String accessControlGroupConfigurationNo;
private String accessControlGroupName;
private String accessControlGroupDescription;
private Boolean isDefault;
private Date createDate;

오류

  • 요청

    ${SERVER_API_URL}?action=getAccessControlGroupList
    &isDefault=true
    &AUTHPARAMS
    
  • 응답

    <getAccessControlGroupListResponse>
      <requestId>c8f9597d-178b-4ba9-87bf-efc4922abafe</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <accessControlGroupList>
        <accessControlGroup>
          <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
          <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
          <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
          <isDefault>true</isDefault>
          <createDate>2013-12-03T10:37:39+0900</createDate>
        </accessControlGroup>
      </accessControlGroupList>
    </getAccessControlGroupListResponse>
    

ServerInstance(서버 인스턴스)

getServerInstanceList

API명

서버 인스턴스 리스트 조회

설명

서버 인스턴스(VM) 리스트를 조회합니다. 페이징 처리가 가능합니다. 응답 항목 중 userData는 서버 인스턴스 상세 조회 시에만 제공됩니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String No
searchFilterName 검색할 필터명 String No
searchFilterValue 검색할 필터값 String No
pageNo 페이지 번호 Integer Min:0, Max:2147483647 No
pageSize 페이지 사이즈 Integer Min:0, Max:2147483647 No
serverInstanceStatusCode 서버 인스턴스 상태 코드 String Min:0, Max:5 No
internetLineTypeCode 인터넷 라인 구분 코드 String Min:0, Max:5 No
sortedBy 정렬 대상 String No
sortingOrder 정렬 순서 String No
  • serverInstanceNoList.N
    조회할 서버 인스턴스 번호 리스트

    • searchFilterName
    • 서버 이름(serverName) | IP 주소(ip)
      (대소문자를 구분하지 않습니다.)
      IP 주소(ip)의 경우에는 사설 IP 주소, 공인 IP 주소 모두 검색할 수 있습니다.
  • searchFilterValue
    검색할 값

  • pageNo
    건수가 많아 페이징하는 경우 해당하는 페이지 번호

  • pageSize
    한 페이지에서 조회할 건수

  • serverInstanceStatusCode
    조회할 서버 인스턴스 상태 코드별 서버 리스트
    입력 가능한 상태는 서버 인스턴스 데이터 타입(ServerInstance)의 서버 인스턴스 상태(serverInstanceStatus)값을 참고하시기 바랍니다.

  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)

  • sortedBy

    • 서버 이름(serverName) | 서버 인스턴스 번호(serverInstanceNo)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 서버 인스턴스 번호(serverInstanceNo)
  • sortingOrder

    • 오름차순(ascending) | 내림차순(descending)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 오름차순(ascending)

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String privateIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

  • 요청

    ${SERVER_API_URL}?action=getServerInstanceList
    &AUTHPARAMS
    
  • 응답

    <getServerInstanceListResponse>
      <requestId>365dc851-25ae-4836-a022-04b148c27fdc</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>7</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67920</serverInstanceNo>
          <serverName>svr-7f86d7cf2279599</serverName>
          <serverDescription></serverDescription>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>yh-nang-test</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp>192.168.200.156</publicIp>
          <privateIp>10.101.6.75</privateIp>
          <serverImageName>centos-5.7-32-cnc1</serverImageName>
          <serverInstanceStatus>
            <code>RUN</code>
            <codeName>Server run state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>NULL</code>
            <codeName>Server NULL OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>running</serverInstanceStatusName>
          <createDate>2014-02-17T12:30:21+0900</createDate>
          <uptime>2014-02-17T13:55:03+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>2</zoneNo>
            <zoneName>zone2</zoneName>
            <zoneDescription>nang zone</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance></serverInstanceList>
    </getServerInstanceListResponse>
    

createServerInstances

API명

서버 인스턴스 생성

설명

서버 인스턴스(VM)를 생성합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverImageProductCode 서버 이미지 상품 코드 String Min:1, Max:20 Conditional
serverProductCode 서버 상품 코드 String Min:1, Max:20 No
memberServerImageNo 회원 서버 이미지 번호 String Conditional
serverName 서버명 String Min:3, Max:30 No
serverDescription 서버 설명 String Min:1, Max:1000 No
loginKeyName 로그인 키명 String Min:3, Max:30 No
isProtectServerTermination 반납 보호 여부 Boolean No
serverCreateCount 서버 생성 개수 Integer Min:1, Max:20 No
serverCreateStartNo 서버 생성 시작 번호 Integer No
internetLineTypeCode 인터넷 라인 구분 코드 String Min:1, Max:5 No
feeSystemTypeCode 요금제 구분 코드 String Min:1, Max:5 No
zoneNo Zone 번호 String No
accessControlGroupConfigurationNoList.N ACG 설정 번호 리스트 String No
userData 사용자 데이터 String Min:0, Max:21847 No
  • serverImageProductCode
    생성할 서버 이미지를 결정하기 위한 서버 이미지 상품 코드
    getServerImageProductList 액션을 통해서 획득할 수 있습니다.
    서버 이미지 상품 코드(serverImageProductCode) 또는 회원 서버 이미지 번호(memberServerImageNo) 두 개의 파라미터 중 하나의 파라미터는 필수 항목입니다.

  • serverProductCode
    생성할 서버 스펙을 결정하기 위한 서버 상품 코드
    getServerProductList 액션을 통해서 획득할 수 있습니다.

    • 기본값: 최소 사양으로 선택됨. 최소 사양 기준은 1. 메모리 2. CPU 3. 기본 블록 스토리지 사이즈 4. 디스크 유형(NET, LOCAL)
  • memberServerImageNo
    직접 생성한 서버 이미지로부터 서버를 생성 시 필요한 값
    getMemberServerImageList 액션을 통해서 획득할 수 있습니다.

  • serverName
    생성할 서버명

    • 기본값: Ncloud가 자동으로 배정
  • serverDescription
    생성할 서버 설명

  • loginKeyName
    공개키로 암호화할 로그인 키명

    • 기본값: 가장 최근에 생성된 로그인 키명 사용
  • isProtectServerTermination
    반납 보호 여부

    • 기본값: false
  • serverCreateCount
    한 번에 생성할 서버 생성 개수. 한 번에 20대 이상을 생성할 수 없습니다.

    • 기본값: 1
  • serverCreateStartNo
    한 번에 여러 대의 서버를 생성할 경우 서버명에 일련번호가 붙습니다. 일련번호의 시작 번호를 설정할 수 있습니다.
    서버 생성 개수와 서버 생성 시작 번호의 합은 1000을 넘을 수 없습니다.

    • 기본값: 서버 생성 개수(serverCreateCount)가 1보다 크고 해당 파라미터 값이 없는 경우 001부터 시작
  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)

    • 기본값: PUBLC(Public)
  • feeSystemTypeCode
    요금제 구분 코드이며 시간 요금제(MTRAT)와 정액제(FXSUM)가 존재합니다.

    • 기본값: 시간 요금제(MTRAT)
  • zoneNo
    서버가 생성될 Zone을 결정할 수 있습니다.
    getZoneList 액션을 통해서 획득할 수 있습니다.

    • 기본값: 네이버 클라우드 플랫폼이 자동으로 배정
  • accessControlGroupConfigurationNoList.N
    생성 시 사용자가 생성한 ACG를 설정할 수 있습니다.
    getAccessControlGroupList 액션을 통해서 ACG 설정 번호를 획득할 수 있습니다.

    • 기본값: 기본 ACG 번호
  • userData
    서버가 최초 부팅 시 사용자가 설정한 사용자 데이터 스크립트를 수행합니다.
    해당 칼럼을 조회하려면 개별 서버 인스턴스를 조회해야 합니다.

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10300 Instance name is already in use. please use other name.
400 10706 The starting number or the number of servers cannot be entered because the combination makes more than 3 digits.
400 10707 More than 20 servers are unable to be created at a time.
400 10710 Not found login key.
400 10711 Invalid fee system.
400 10712 Not found product. Please check your input product.
400 10721 Can not use global internet line. Please contract customer service center.
400 10800 This name is already in use.
400 23003 Since entire return of previous server has yet to be completed, new server cannot be created. Please try again after completing returning process.
400 23006 You cannot request for server return and creation at the same time. Please make one request at a time.
400 24110 The input parameter server image number is invalid.
400 24111 The input parameter zone number is invalid.
400 24124 The input parameter ACG configuration number is invalid.
400 24300 The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes.
400 24301 The length constraints of the parameter userData were violated. The minimum length is 0 byte, the maximum, 21,847 bytes.
400 24302 UserData is not base64-encoded.
400 25038 Currently the server image is not existing normally.
400 25040 The server image is being operated. So a server is unable to be created.

  • 요청

    ${SERVER_API_URL}?action=createServerInstances
    &serverImageProductCode=SPSW0LINUX000032
    &serverName=myserver
    &AUTHPARAMS
    
  • 응답

    <createServerInstancesResponse>
      <requestId>82999cec-4c9d-4be7-ad03-062b9c559aeb</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67953</serverInstanceNo>
          <serverName>myserver</serverName>
          <serverDescription/>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>hkey-0217</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp/>
          <serverImageName>centos-6.3-32</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>2014-02-17T18:04:49+0900</createDate>
          <uptime>2014-02-17T18:04:49+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1944</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-load-balancer</accessControlGroupName>
              <accessControlGroupDescription>Default Loadbalancer AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2014-02-06T11:19:16+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance>
      </serverInstanceList>
    </createServerInstancesResponse>
    

terminateServerInstances

API명

서버 인스턴스 반납

설명

서버 인스턴스(VM)를 반납(Terminate)합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String 중복 불가 Yes
  • serverInstanceNoList.N
    반납할 서버 인스턴스 번호 리스트

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String privateIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10713 Not found contract information. Please check your input parameter.
400 10501 After deleting additional storage, please try again. Additional storage must be deleted by customer
400 21001 Unable to perform returning process due to set return protection. Server name : {0}
400 23006 You cannot request for server return and creation at the same time. Please make one request at a time.
400 24073 Unable to destroy the server since a public IP is associated with the server. First, please disassociate a public IP from the server. publicIpInstanceNo = {0}
400 24103 Input parameter value is invalid. The minimum length of the name is 3 bytes and the maximum, 30 bytes.
400 24105 Input parameter value is invalid. The name must contain only lower case letters, digits, and hyphen('-'); it must start with a letter and end with a letter or digit.
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 25014 Unable to control the server since (other) user is currently operating storage allocated to the server.
400 25015 Unable to delete since (other) user is currently operating the server or creating server image from the server.
400 25016 Public IP is currently being allocated or deallocated to the target server. Please return the server after the task is complete.
400 25021 The settings of load balancer related to target server is currently being modified. Please return the server after the task is complete.
400 25022 Unable to return the server since (other) user is either operating target server or an error in the target server. Please confirm the status of server/ storage.
400 25023 Unable to return the server since (other) user is either operating target server or an error in default storage of the target server. Please confirm the status of server/ storage.
400 25024 Unable to return the server since (other) user is either operating target server or storage allocated to sever. Please confirm the status of server/ storage.
400 25027 You may not change since (other) user is operating the target load balance.
400 25050 (Other)Unable to operate load balancer since use is manipulating the applying server.

  • 요청

    ${SERVER_API_URL}?action=terminateServerInstances
    &serverInstanceNoList.1=67947
    &AUTHPARAMS
    
  • 응답

    <terminateServerInstancesResponse>
      <requestId>940fcae4-5d16-4e48-99d4-2b480221dbdd</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67927</serverInstanceNo>
          <serverName>i-0217s</serverName>
          <serverDescription/>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>mykey</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp>10.101.5.87</privateIp>
          <serverImageName>centos-5.7-32-cnc1</serverImageName>
          <serverInstanceStatus>
            <code>NSTOP</code>
            <codeName>Server normal stopped state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>TERMT</code>
            <codeName>Server TERMINATE OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>terminating</serverInstanceStatusName>
          <createDate>2014-02-17T12:39:19+0900</createDate>
          <uptime>2014-02-17T13:37:12+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance>
      </serverInstanceList>
    </terminateServerInstancesResponse>
    

changeServerInstanceSpec

API명

서버 인스턴스 스펙 변경

설명

서버 인스턴스(VM) 스펙을 변경합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNoList 서버 인스턴스 번호 String Yes
serverProductCode 서버 상품 코드 String Min : 1, Max : 20 Yes
  • serverInstanceNoList
    스펙을 변경할 서버 인스턴스 번호

  • serverProductCode
    스펙에 대한 상품 코드
    getServerProductList 액션을 통해 획득할 수 있습니다.

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String privateIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10500 Unable to use server specification change function. You may freely change server specification on paid servers.
400 10501 After deleting additional storage, please try again. Additional storage must be deleted by customer.
400 10502 Selected server does not allow spec change.
400 10503 You may not change to spec of same level.
400 10504 You may not change the spec to a different disk type.
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 25013 Unable to change server specification since (other) user is either operating the target server or due to an error in target server. Please check the server status.
400 25014 Unable to control the server since (other) user is currently operating storage allocated to the server.
400 25018 Operation is currently unavailable since (other) user is either operating server or creating server image of the server.

  • 요청

    ${SERVER_API_URL}?action=changeServerInstanceSpec
    &serverInstanceNo=67947
    &serverProductCode=SPSVRSTAND000043
    &AUTHPARAMS
    
  • 응답

    <changeServerInstanceSpecResponse>
      <requestId>940fcae4-5d16-4e48-99d4-2b480221dbdd</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67927</serverInstanceNo>
          <serverName>i-0217s</serverName>
          <serverDescription/>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>mykey</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp>10.101.5.87</privateIp>
          <serverImageName>centos-5.7-32-cnc1</serverImageName>
          <serverInstanceStatus>
            <code>NSTOP</code>
            <codeName>Server normal stopped state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>CHNG</code>
            <codeName>Server SPEC CHANGE OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName> changingSpec</serverInstanceStatusName>
          <createDate>2014-02-17T12:39:19+0900</createDate>
          <uptime>2014-02-17T13:37:12+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance>
      </serverInstanceList>
    </changeServerInstanceSpecResponse>
    

rebootServerInstances

API명

서버 인스턴스 재시작

설명

서버 인스턴스(VM)를 재시작합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String 중복 불가 Yes
  • serverInstanceNoList.N
    재시작할 서버 인스턴스 번호 리스트

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String privateIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 22001 {1} among {0} servers failed for operation. The problem is being handle* Please hold for a moment.
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 25014 Unable to control the server since (other) user is currently operating storage allocated to the server.
400 25041 Unable to perform operation command since (other) user is either manipulating the target server or a problem in target server. Please confirm server status once again.
400 28004 Unable to perform restart command since target server is already suspended. (Other) user might have suspended the server by connecting through terminal. Please confirm the server status once again.

  • 요청

    ${SERVER_API_URL}?action=rebootServerInstances
    &serverInstanceNoList.1=67953
    &AUTHPARAMS
    
  • 응답

    <rebootServerInstancesResponse>
      <requestId>742c4550-b144-4500-ae97-d0c8c75f8cf2</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67953</serverInstanceNo>
          <serverName>myserver</serverName>
          <serverDescription/>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>hkey-0217</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp>10.101.5.105</privateIp>
          <serverImageName>centos-6.3-32</serverImageName>
          <serverInstanceStatus>
            <code>RUN</code>
            <codeName>Server run state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>RESTA</code>
            <codeName>Server RESTART OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>rebooting</serverInstanceStatusName>
          <createDate>2014-02-17T18:04:49+0900</createDate>
          <uptime>2014-02-17T18:10:34+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance>
      </serverInstanceList>
    </rebootServerInstancesResponse>
    

startServerInstances

API명

서버 인스턴스 시작

설명

서버 인스턴스(VM)를 시작합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String 중복 불가 Yes
  • serverInstanceNoList.N
    시작할 서버 인스턴스 번호 리스트

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String privateIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 22001 {1} among {0} servers failed for operation. The problem is being handled. Please hold for a moment.
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 25014 Unable to control the server since (other) user is currently operating storage allocated to the server.
400 25041 Unable to perform operation command since (other) user is either manipulating the target server or a problem in target server. Please confirm server status once again.
400 28001 Unable to perform start command since target server is currently in operation. Please confirm the server status.

  • 요청

    ${SERVER_API_URL}?action=startServerInstances
    &serverInstanceNoList.1=67953
    &AUTHPARAMS
    
  • 응답

    <startServerInstancesResponse>
      <requestId>317aae32-fe75-4061-9f8e-08a58cc6c14f</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67953</serverInstanceNo>
          <serverName>myserver</serverName>
          <serverDescription/>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>hkey-0217</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp>10.101.5.105</privateIp>
          <serverImageName>centos-6.3-32</serverImageName>
          <serverInstanceStatus>
            <code>NSTOP</code>
            <codeName>Server normal stopped state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>START</code>
            <codeName>Server START OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>booting</serverInstanceStatusName>
          <createDate>2014-02-17T18:04:49+0900</createDate>
          <uptime>2014-02-18T12:01:31+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance>
      </serverInstanceList>
    </startServerInstancesResponse>
    

stopServerInstances

API명

서버 인스턴스 정지

설명

서버 인스턴스(VM)를 정지합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String 중복 불가 Yes
  • serverInstanceNoList.N
    정지할 서버 인스턴스 번호

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String privateIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 22001 {1} among {0} servers failed for operation. The problem is being handled. Please hold for a moment.
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 25014 Unable to control the server since (other) user is currently operating storage allocated to the server.
400 25041 Unable to perform operation command since (other) user is either manipulating the target server or a problem in target server. Please confirm server status once again.
400 28005 Unable to perform suspension command since target server is already suspended. (Other) user might have suspended the server by connecting through terminal. Please confirm the server status once again.

  • 요청

    ${SERVER_API_URL}?action=stopServerInstances
    &serverInstanceNoList.1=67953
    &AUTHPARAMS
    
  • 응답

    <stopServerInstancesResponse>
      <requestId>d3709b68-3540-48a7-8fa0-3a40cde57d2c</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67953</serverInstanceNo>
          <serverName>myserver</serverName>
          <serverDescription/>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>hkey-0217</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp>10.101.5.105</privateIp>
          <serverImageName>centos-6.3-32</serverImageName>
          <serverInstanceStatus>
            <code>RUN</code>
            <codeName>Server run state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>SHTDN</code>
            <codeName>Server SHUTDOWN OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>shutting down</serverInstanceStatusName>
          <createDate>2014-02-17T18:04:49+0900</createDate>
          <uptime>2014-02-18T14:58:26+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance>
      </serverInstanceList>
    </stopServerInstancesResponse>
    

getRootPassword

API명

서버의 root 계정의 비밀번호 조회

설명

서버(VM)의 로그인 키로 root 계정의 비밀번호를 조회합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNo 서버 인스턴스 번호 String Yes
privateKey 서버의 로그인 키(인증키) String 로그인 키 내용이 그대로 들어와야 하므로, \n을 붙여야 합니다. Yes

응답 데이터 타입

  • RootPassword 타입
RootPassword extends CommonResponse
private String rootPassword;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 24001 Invalid authentication key. Please check authentication key or input type and try again.

  • 요청

    ${SERVER_API_URL}?action=getRootPassword
    &serverInstanceNo=67953
    &privateKey=-----BEGIN RSA PRIVATE KEY-----\nMIIEpAIBAAKCAQEAtNkTS9cHBLXQcDY0s02KqaLb8GGupaeCLvWzNDM3aVZxUDFo\n kZYaEKFXbWhR1oZ4HyZnwo4y1VDxV1m35Ltq/HRCHP8+caNHaM6n2rivfHT8nMxg\n KvzsXjopWIVp+8oHvmi0TO+zcEusoNOv/jb7LcJwfeZ0WQvianQ7j6ppaXgHfZSX\n Tdqwyuf9UmzppUa8f2wLslDOlcYQW6VQ9S5f9cx9HgTXbc4vlb+NDLwdx0E+AIjw\n p5PgWCjbEqGKz2Myw4X7HJ06619BScwXSkyG+G3g0VjtL7WnEhhdmfGLCUE/BcKv\n Fz9KeRXIQAx8NrAW4c0Vq+CPyBgz5EWWMpTUXQIDAQABAoIBABn7AXmot3pmwD4O\n m32SyzPZkK0060kjCmHCrG74WKKKZ5b0sigQH0h6VTwDe5ZNFR6sfsWFdioNCc7Z\n tcBnaFRCQ2k1Bfx/T3fwEE8srxE7ITtJZRtn4HEc++maqQIiIQCqvBQ9b1LXnEIy\n hxsHPQhy4YREwjw0p99ROWlHOwOKm6KWbc4YFbDKmEc9v+NLxxNjf2KF7jNuQK0l\n VjeJEzBa02sFBGhMeLAMvhmHj9u1NbAFUn/uC4MrMFiQMoCnx2qBSoUPxuvL6WXH\n NpUoLT/rJrlqKUCffS3RIVt+lwjU6vVXlrxuYNTLDH4c+XJHkFprYDdq/lZktuRM\n f9uYa4ECgYEA75xeol7dvFGe6Es8pcNrdZUMEwkVR16DER+nfndl3fJMNu1YIBaf\n XKnDZLjS505pP+a0alwq0aQdXY8FIik9O9ugqpnd1EfI2fMlrVynUOcBIhVbvYip\n PNFg+tIuz37f3vMms7NCQ5W3SlincB63ptl2tovkOjXKbo1r1sZaGf0CgYEAwTfB\n wqvGm1GpMv8jrCFGNS7FXxZy5VcP/APXqfQb6Lpwe4rarxfb8nnap5KYOn0qSbY7\n BOoidV6QysT9Xm3pDjNUoeH9CujK0mx3sL/4utZiCqmVhGljGq9D4A7PsCnT4X4+\n Akvk9L9RS+xNs9NsK8jTz9zthaJRUzhAHcWSAeECgYEA7rUvqj8sVBJUZ0OdFd8L\n zUZBky03X7SOip6odNtqRqS+vPHTG5SuCtitakifBAUf4aNrFZLgrZ38C1sSWCgR\n cvKoq41Ca9tgA5GydXWa0oRwoo34qWfeglJtdTOzos/ZI/nFEr2BRGeBBLYxiQdx\n Gu4G0HGpWzx/gYeuaXeOB9kCgYBEKznPRu+RSORbO60IQ80TYmb8P11WELtw/KIQ\n MjHOkEizLbAt6ksNZ3R/frb6m8JZs1NrTnfN1QlcoNeLg1egTPflDWhLewpj5yTr\n VS+aK5z3ihFYYB45AfD+kfswefFpMzMJeGFVAFLcaIiZk1QstnQUeCvM5BGxPL1S\n Q6xZwQKBgQCSeU8FRIa0jUxN7hx5R1+IAIBPl2JUM7bMME9T3eX3Qh6wNCMjTxse\n NU70sp2m+8sv7Bq4QY5P13Cajo/+fwI1BSa83mF2kXnyEpXsrfw+4FM74YTrX0JA\n FlSDMaL95g7fCSSMuM8sOqMuIBn7d7DiK2nbrez/iRsZFH2qOqusOA==\n
    -----END RSA PRIVATE KEY-----\n
    &AUTHPARAMS
    
  • 응답

    <getRootPasswordResponse>
      <requestId>d3709b68-3540-48a7-8fa0-3a40cde57d2c</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <rootPassword>
        <rootPassword>YY64RG6UET2</rootPassword>
      </rootPassword>
    </getRootPasswordResponse>
    

BlockStorageInstance(블록 스토리지 인스턴스)

getBlockStorageInstanceList

API명

블록 스토리지 인스턴스 리스트 조회

설명

블록 스토리지 인스턴스 리스트를 조회합니다. 페이징 처리가 가능합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNo 서버 인스턴스 번호 String No
blockStorageInstanceNoList.N 블록 스토리지 인스턴스 번호 리스트 String No
searchFilterName 검색할 필터명 String No
searchFilterValue 검색할 필터값 String No
blockStorageTypeCodeList.N 블록 스토리지 구분 코드 리스트 String Min : 1,
Max : 5
No
blockStorageInstanceStatusCode 블록 스토리지 인스턴스 상태 코드 String Min : 1,
Max : 5
No
pageNo 페이지 번호 Integer Min : 0,
Max : 2147483647
No
pageSize 페이지 사이즈 Integer Min : 0,
Max : 2147483647
No
sortedBy 정렬 대상 String No
sortingOrder 정렬 순서 String No
  • serverInstanceNo
    서버 인스턴스에 attach된 블록 스토리지 조회 시 사용됩니다.

  • blockStorageInstanceNoList.N
    블록 스토리지 인스턴스 번호 리스트에 해당하는 블록 스토리지를 조회합니다.

  • searchFilterName

    • 블록 스토리지명(blockStorageName) | 연결 정보(attachmentInformation)
      (대소문자를 구분하지 않습니다.)
      연결 정보는 '블록 스토리지명[공백]연결 정보' 또는 '블록 스토리지명:연결 정보' 형식으로 입력해야 합니다.
  • searchFilterValue
    검색할 값

  • blockStorageTypeCodeList.N
    블록 스토리지 구분 코드 리스트에 해당하는 블록 스토리지만 조회할 수 있습니다. 아래의 값을 입력할 수 있습니다.

    • 기본 블록 스토리지(BASIC) | 추가 블록 스토리지(SVRBS)
    • 기본값: 기본 블록 스토리지(BASIC), 추가 블록 스토리지(SVRBS)
  • blockStorageInstanceStatusCode
    블록 스토리지 인스턴스 상태별로 조회가 가능합니다.
    입력 가능한 상태는 블록 스토리지 인스턴스 데이터 타입(BlockStorageInstance)의 블록 스토리지 인스턴스 상태(blockStorageInstanceStatus)값을 참고하시기 바랍니다.

  • pageNo
    건수가 많아 페이징하는 경우 해당하는 페이지 번호

  • pageSize
    한 페이지에서 조회할 건수

  • sortedBy
    결과 목록을 정렬할 기준 칼럼

    • 블록 스토리지명(blockStorageName) | 블록 스토리지 인스턴스 번호(blockStorageInstanceNo)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 블록 스토리지 인스턴스 번호(blockStorageInstanceNo)
  • sortingOrder
    목록 정렬 순서

    • 오름차순(ascending) | 내림차순(descending)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 오름차순(ascending)

응답 데이터 타입

  • BlockStorageInstanceList 타입
BlockStorageInstanceList extends CommonResponse
private Integer totalRows;
private List blockStorageInstanceList = new ArrayList();
BlockStorageInstance
private String blockStorageInstanceNo;
private String serverInstanceNo;
private String serverName;
private CommonCode blockStorageType;
private String blockStorageName;
private Long blockStorageSize;
private String deviceName;
private String blockStorageProductCode;
private CommonCode blockStorageInstanceStatus;
private CommonCode blockStorageInstanceOperation;
private String blockStorageInstanceStatusName;
private Date createDate;
private String blockStorageInstanceDescription;
private CommonCode diskTypeCode;

오류

  • 요청

    ${SERVER_API_URL}?action=getBlockStorageInstanceList
    &blockStorageInstanceStatusCode=ATTAC
    &blockStorageTypeCodeList.1=BASIC
    &AUTHPARAMS
    
  • 응답

    <getBlockStorageInstanceListResponse>
      <requestId>2c4464e9-4ef9-4e7d-a06b-ae27ec225d4f</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>6</totalRows>
      <blockStorageInstanceList>
        <blockStorageInstance>
          <blockStorageInstanceNo>67921</blockStorageInstanceNo>
          <serverInstanceNo>67920</serverInstanceNo>
          <serverName>svr-7f86d7cf2279599</serverName>
          <blockStorageType>
            <code>BASIC</code>
            <codeName>Basic BS</codeName>
          </blockStorageType>
          <blockStorageName>svr-7f86d7cf2279599</blockStorageName>
          <blockStorageSize>12884901888</blockStorageSize>
          <deviceName>/dev/xvda</deviceName>
          <blockStorageProductCode>SPBSTBSTBS000003</blockStorageProductCode>
          <blockStorageInstanceStatus>
            <code>ATTAC</code>
            <codeName>Block storage ATTACHED state</codeName>
          </blockStorageInstanceStatus>
          <blockStorageInstanceOperation>
            <code>NULL</code>
            <codeName>Block Storage NULLOP</codeName>
          </blockStorageInstanceOperation>
          <blockStorageInstanceStatusName>attached</blockStorageInstanceStatusName>
          <createDate>2014-02-17T12:30:21+0900</createDate>
          <blockStorageInstanceDescription>svr-7f86d7cf2279599's basic storage</blockStorageInstanceDescription>
          <diskTypeCode>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </diskTypeCode>
        </blockStorageInstance></blockStorageInstanceList>
    </getBlockStorageInstanceListResponse>
    

createBlockStorageInstance

API명

블록 스토리지 인스턴스 생성

설명

블록 스토리지 인스턴스를 생성합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
blockStorageName 블록 스토리지명 String Min : 3, Max : 30 No
blockStorageSize 블록 스토리지 사이즈 String Min : 10, Max : 1000 Yes
blockStorageDescription 블록 스토리지 설명 String Min : 10, Max : 1000 No
serverInstanceNo 서버 인스턴스 번호 String Yes
diskDetailTypeCode 디스크상세유형코드 String No
  • blockStorageName
    생성할 블록 스토리지명

    • 기본값: Ncloud가 자동으로 배정
  • blockStorageSize
    생성할 블록 스토리지 사이즈를 입력합니다. GB 단위로 입력이 가능하고, 최대 1000GB까지 입력할 수 있습니다.

  • blockStorageDescription
    블록 스토리지 설명

  • serverInstanceNo
    attach할 서버 인스턴스 번호
    필수 항목이며, getServerInstanceList 액션을 통해 서버 인스턴스 번호를 획득할 수 있습니다.

  • diskDetailTypeCode
    하드디스크(HDD)와 SSD(SSD) 중, 선택 가능합니다.
    default : HDD

응답 데이터 타입

  • BlockStorageInstanceList 타입
BlockStorageInstanceList extends CommonResponse
private Integer totalRows;
private List blockStorageInstanceList = new ArrayList();
BlockStorageInstance
private String blockStorageInstanceNo;
private String serverInstanceNo;
private String serverName;
private CommonCode blockStorageType;
private String blockStorageName;
private Long blockStorageSize;
private String deviceName;
private String blockStorageProductCode;
private CommonCode blockStorageInstanceStatus;
private CommonCode blockStorageInstanceOperation;
private String blockStorageInstanceStatusName;
private Date createDate;
private String blockStorageInstanceDescription;
private CommonCode diskTypeCode;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10300 Instance name is already in use. please use other name.
400 10708 Server shall not be beyond {0}G2.
400 10713 Not found contract information. Please check your input parameter.
400 23001 Unable to allocate more than {0} storages (included default storage) to the corresponding Linux server.
400 23002 Unable to allocate more than {0} storages (included default storage) to the corresponding Windows server.
400 24100 Input parameter value is invalid. The value of the storage size must be a integer greater than zero.
400 24101 Input parameter value is invalid. The minimum value of the storage size is 10 GB and the maximum, 1 T2.
400 24102 Input parameter value is invalid. The value of storage size must be a multiple of 10 G2.
400 24103 Input parameter value is invalid. The minimum length of the name is 3 bytes and the maximum, 30 bytes.
400 24105 Input parameter value is invalid. The name must contain only lower case letters, digits, and hyphen('-'); it must start with a letter and end with a letter or digit.
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 24300 The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes.
400 2500 Unable to perform allocation command since (other) user is either operating the target server which is to be allocated with storage or an error in target server.

  • 요청

    ${SERVER_API_URL}?action=createBlockStorageInstance
    &blockStorageSize=10
    &serverInstanceNo=67953
    &diskDetailTypeCode=SSD
    &AUTHPARAMS
    
  • 응답

    <createBlockStorageInstanceResponse>
      <requestId>cd6f50b5-cfd5-493c-8200-8b00738c1c03</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <blockStorageInstanceList>
        <blockStorageInstance>
          <blockStorageInstanceNo>67999</blockStorageInstanceNo>
          <serverInstanceNo>67953</serverInstanceNo>
          <serverName>myserver</serverName>
          <blockStorageType>
            <code>SVRBS</code>
            <codeName>Server BS</codeName>
          </blockStorageType>
          <blockStorageName>bst-7f8715f2c6c3543</blockStorageName>
          <blockStorageSize>10737418240</blockStorageSize>
          <deviceName/>
          <blockStorageProductCode>SPBSTBSTAD000002</blockStorageProductCode>
          <blockStorageInstanceStatus>
            <code>INIT</code>
            <codeName>Block storage INIT state</codeName>
          </blockStorageInstanceStatus>
          <blockStorageInstanceOperation>
            <code>NULL</code>
            <codeName>Block Storage NULLOP</codeName>
          </blockStorageInstanceOperation>
          <blockStorageInstanceStatusName>initialized</blockStorageInstanceStatusName>
          <createDate>2014-02-18T16:55:44+0900</createDate>
          <blockStorageInstanceDescription/>
          <diskTypeCode>
            <code>NET</code>
            <codeName>Network Storage</codeName>
          </diskTypeCode>
        </blockStorageInstance>
      </blockStorageInstanceList>
    </createBlockStorageInstanceResponse>
    

deleteBlockStorageInstances

API명

블록 스토리지 인스턴스 삭제

설명

블록 스토리지 인스턴스를 삭제합니다. detach 후 삭제를 진행합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
blockStorageInstanceNoList.N 블록 스토리지 인스턴스 번호 리스트 String 중복 불가 Yes
  • blockStorageInstanceNoList.N
    삭제할 블록 스토리지 인스턴스 번호 리스트
    getBlockStorageInstanceList 액션을 통해서 획득할 수 있습니다.

응답 데이터 타입

  • BlockStorageInstanceList 타입
BlockStorageInstanceList extends CommonResponse
private Integer totalRows;
private List blockStorageInstanceList = new ArrayList();
BlockStorageInstance
private String blockStorageInstanceNo;
private String serverInstanceNo;
private String serverName;
private CommonCode blockStorageType;
private String blockStorageName;
private Long blockStorageSize;
private String deviceName;
private String blockStorageProductCode;
private CommonCode blockStorageInstanceStatus;
private CommonCode blockStorageInstanceOperation;
private String blockStorageInstanceStatusName;
private Date createDate;
private String blockStorageInstanceDescription;
private CommonCode diskTypeCode;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10713 Not found contract information. Please check your input parameter.
400 24002 It seems that storage {0} is mounted to server {1}. Please unmount the storage and try again.
400 24109 The input parameter instance number is invalid
400 24121 The input parameter storage instance number is invalid.
400 25002 Unable to perform deallocation command since (other) user is operating target server to be allocated with storage or an error in target server.
400 25003 Unable to perform deallocation command since (other) user is operating target server or the it has already been deallocated.
400 25004 Unable to return since (other) user is either operating the target storage or an error in target storage.
400 25041 Unable to perform operation command since (other) user is either manipulating the target server or a problem in target server. Please confirm server status once again.

  • 요청

    ${SERVER_API_URL}?action=deleteBlockStorageInstances
    &blockStorageInstanceNoList.1=67999
    &AUTHPARAMS
    
  • 응답

    <deleteBlockStorageInstancesResponse>
      <requestId>9b806197-f070-4a81-ab41-42923fcf6502</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <blockStorageInstanceList>
        <blockStorageInstance>
          <blockStorageInstanceNo>67999</blockStorageInstanceNo>
          <serverInstanceNo>67953</serverInstanceNo>
          <serverName>myserver</serverName>
          <blockStorageType>
            <code>SVRBS</code>
            <codeName>Server BS</codeName>
          </blockStorageType>
          <blockStorageName>bst-7f8715f2c6c3543</blockStorageName>
          <blockStorageSize>10737418240</blockStorageSize>
          <deviceName>/dev/xvdc</deviceName>
          <blockStorageProductCode>SPBSTBSTAD000002</blockStorageProductCode>
          <blockStorageInstanceStatus>
            <code>ATTAC</code>
            <codeName>Block storage ATTACHED state</codeName>
          </blockStorageInstanceStatus>
          <blockStorageInstanceOperation>
            <code>DETAC</code>
            <codeName>Block Storage RESTART OP</codeName>
          </blockStorageInstanceOperation>
          <blockStorageInstanceStatusName>detaching</blockStorageInstanceStatusName>
          <createDate>2014-02-18T16:55:44+0900</createDate>
          <blockStorageInstanceDescription/>
          <diskTypeCode>
            <code>NET</code>
            <codeName>Network Storage</codeName>
          </diskTypeCode>
        </blockStorageInstance>
      </blockStorageInstanceList>
    </deleteBlockStorageInstancesResponse>
    

MemberServerImage(회원 서버 이미지)

getMemberServerImageList

API명

회원 서버 이미지 리스트 조회

설명

회원 서버 이미지 리스트를 조회합니다. 페이징 처리가 가능합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
memberServerImageNoList.N 회원 서버 이미지 번호 리스트 String No
platformTypeCodeList.N 플랫폼 구분 코드 리스트 String Min : 1,
Max : 5
No
pageNo 페이지 번호 Integer Min : 0,
Max : 2147483647
No
pageSize 페이지 사이즈 Integer Min : 0,
Max : 2147483647
No
sortedBy 정렬 대상 String No
sortingOrder 정렬 순서 String No
  • memberServerImageNoList.N
    조회할 회원 서버 이미지 번호 리스트

  • platformTypeCodeList.N
    조회할 서버 이미지의 플랫폼 코드 리스트
    아래의 코드가 입력 가능합니다.

    • 리눅스32Bit(LNX32) | 리눅스64Bit(LNX64) | 윈도우 32Bit(WND32) | 윈도우 64Bit(WND64) | 우분투 데스크톱 64Bit(UBD64) | 우분투 서버 64Bit(UBS64)
  • pageNo
    건수가 많아 페이징하는 경우 해당하는 페이지 번호

  • pageSize
    한 페이지에서 조회할 건수

  • sortedBy
    결과 목록을 정렬할 기준 칼럼

    • 회원 서버 이미지명(memberServerImageName) | 회원 서버 이미지 번호(memberServerImageNo)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 회원 서버 이미지 번호(memberServerImageNo)
  • sortingOrder
    목록 정렬 순서

    • 오름차순(ascending) | 내림차순(descending)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 오름차순(ascending)

응답 데이터 타입

  • MemberServerImageList 타입
MemberServerImageList extends CommonResponse
private Integer totalRows;
private List memberServerImageList = new ArrayList();
MemberServerImage
private String memberServerImageNo;
private String memberServerImageName;
private String memberServerImageDescription;
private String originalServerInstanceNo;
private String originalServerProductCode;
private String originalServerName;
private CommonCode originalBaseBlockStorageDiskType;
private String originalServerImageProductCode;
private String originalOsInformation;
private String originalServerImageName;
private String memberServerImageStatusName;
private CommonCode memberServerImageStatus;
private CommonCode memberServerImageOperation;
private CommonCode memberServerImagePlatformType;
private Zone zone;
private Date createDate;
private Integer memberServerImageBlockStorageTotalRows;
private Long memberServerImageBlockStorageTotalSize;

오류

  • 요청

    ${SERVER_API_URL}?action=getMemberServerImageList
    &platformTypeCodeList.1=LNX32
    &AUTHPARAMS
    
  • 응답

    <getMemberServerImageListResponse>
      <requestId>d5b1eaff-659a-452a-a64b-7dcf5f5e1ddc</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <memberServerImageList>
        <memberServerImage>
          <memberServerImageNo>1755</memberServerImageNo>
          <memberServerImageName>img</memberServerImageName>
          <memberServerImageDescription/>
          <originalServerInstanceNo>67916</originalServerInstanceNo>
          <originalServerProductCode>SPSVRSTAND000043</originalServerProductCode>
          <originalServerName>i-0217</originalServerName>
          <originalBaseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </originalBaseBlockStorageDiskType>
          <originalServerImageProductCode>SPSW0LINUX000009</originalServerImageProductCode>
          <originalOsInformation>CentOS 5.7 32Bit</originalOsInformation>
          <originalServerImageName>centos-5.7-32-cnc1</originalServerImageName>
          <memberServerImageStatusName>created</memberServerImageStatusName>
          <memberServerImageStatus>
            <code>CREAT</code>
            <codeName>NSI CREATED state</codeName>
          </memberServerImageStatus>
          <memberServerImageOperation>
            <code>NULL</code>
            <codeName>NSI NULLOP</codeName>
          </memberServerImageOperation>
          <memberServerImagePlatformTypeCode>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </memberServerImagePlatformTypeCode>
          <createDate>2014-02-17T15:20:51+0900</createDate>
          <zone>
            <zoneNo>2</zoneNo>
            <zoneName>zone2</zoneName>
            <zoneDescription>nang zone</zoneDescription>
          </zone>
          <memberServerImageBlockStorageTotalRows>2</memberServerImageBlockStorageTotalRows>
          <memberServerImageBlockStorageTotalSize>13409189888</memberServerImageBlockStorageTotalSize>
        </memberServerImage>
      </memberServerImageList>
    </getMemberServerImageListResponse>
    

createMemberServerImage

API명

회원 서버 이미지 생성

설명

회원 서버 이미지를 생성합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
memberServerImageName 회원 서버 이미지명 String Min : 3, Max : 30 No
memberServerImageDescription 회원 서버 이미지 설명 String Min : 10,
Max : 1000
No
serverInstanceNo 서버 인스턴스 번호 String Yes
  • memberServerImageName
    생성할 회원 서버 이미지명

    • 기본값: Ncloud가 자동으로 배정
  • memberServerImageDescription
    생성할 회원 서버 이미지에 대한 설명

  • serverInstanceNo
    이미지를 생성할 대상이 되는 서버 인스턴스 번호
    필수 항목이며, getServerInstanceList 액션을 통해 서버 인스턴스 번호를 획득할 수 있습니다.

응답 데이터 타입

  • MemberServerImageList 타입
MemberServerImageList extends CommonResponse
private Integer totalRows;
private List memberServerImageList = new ArrayList();
MemberServerImage
private String memberServerImageNo;
private String memberServerImageName;
private String memberServerImageDescription;
private String originalServerInstanceNo;
private String originalServerProductCode;
private String originalServerName;
private CommonCode originalBaseBlockStorageDiskType;
private String originalServerImageProductCode;
private String originalOsInformation;
private String originalServerImageName;
private String memberServerImageStatusName;
private CommonCode memberServerImageStatus;
private CommonCode memberServerImageOperation;
private CommonCode memberServerImagePlatformType;
private Zone zone;
private Date createDate;
private Integer memberServerImageBlockStorageTotalRows;
private Long memberServerImageBlockStorageTotalSize;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10300 Instance name is already in use. please use other name.
400 10703 Unable to create my server image. Local disk server does not allow creating my server image when there is additional storage. Please submit additional storage to proceed.
400 10704 You may not create local disk server with persistent disk server image.
400 10705 You can only create server with identical spec with local disk server image.
400 24103 Input parameter value is invalid. The minimum length of the name is 3 bytes and the maximum, 30 bytes.
400 24105 Input parameter value is invalid. The name must contain only lower case letters, digits, and hyphen('-'); it must start with a letter and end with a letter or digit.
400 24109 The input parameter instance number is invalid
400 24300 The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes.
400 25008 Unable to create server image since server is either not in suspended status or in operation.
400 25036 The server is currently being operated. So a server image is unable to be created from the server.

  • 요청

    ${SERVER_API_URL}?action=createMemberServerImage
    &serverInstanceNo=67953
    &AUTHPARAMS
    
  • 응답

    <createMemberServerImageResponse>
      <requestId>303a26e1-85a9-4a0d-ba70-950282144b37</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <memberServerImageList>
        <memberServerImage>
          <memberServerImageNo>1756</memberServerImageNo>
          <memberServerImageName>img-7f871658ff847d8</memberServerImageName>
          <memberServerImageDescription/>
          <originalServerInstanceNo>67953</originalServerInstanceNo>
          <originalServerProductCode>SPSVRSTAND000043</originalServerProductCode>
          <originalServerName>myserver</originalServerName>
          <originalBaseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </originalBaseBlockStorageDiskType>
          <originalServerImageProductCode>SPSW0LINUX000032</originalServerImageProductCode>
          <originalOsInformation>CentOS 6.3 32Bit</originalOsInformation>
          <originalServerImageName>centos-6.3-32</originalServerImageName>
          <memberServerImageStatusName>creating</memberServerImageStatusName>
          <memberServerImageStatus>
            <code>INIT</code>
            <codeName>NSI INIT state</codeName>
          </memberServerImageStatus>
          <memberServerImageOperation>
            <code>CREAT</code>
            <codeName>NSI CREAT OP</codeName>
          </memberServerImageOperation>
          <memberServerImagePlatformTypeCode>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </memberServerImagePlatformTypeCode>
          <createDate>2014-02-18T17:22:43+0900</createDate>
          <memberServerImageBlockStorageTotalRows>0</memberServerImageBlockStorageTotalRows>
          <memberServerImageBlockStorageTotalSize>0</memberServerImageBlockStorageTotalSize>
        </memberServerImage>
      </memberServerImageList>
    </createMemberServerImageResponse>
    

deleteMemberServerImages

API명

회원 서버 이미지 삭제

설명

회원 서버 이미지를 삭제합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
memberServerImageNoList.N 회원 서버 이미지 리스트 String 중복 불가 Yes
  • memberServerImageNoList.N
    삭제할 회원 서버 이미지 번호 리스트
    getMemberServerImageList 액션을 통해서 획득할 수 있습니다.

응답 데이터 타입

  • MemberServerImageList 타입
MemberServerImageList extends CommonResponse
private Integer totalRows;
private List memberServerImageList = new ArrayList();
MemberServerImage
private String memberServerImageNo;
private String memberServerImageName;
private String memberServerImageDescription;
private String originalServerInstanceNo;
private String originalServerProductCode;
private String originalServerName;
private CommonCode originalBaseBlockStorageDiskType;
private String originalServerImageProductCode;
private String originalOsInformation;
private String originalServerImageName;
private String memberServerImageStatusName;
private CommonCode memberServerImageStatus;
private CommonCode memberServerImageOperation;
private CommonCode memberServerImagePlatformType;
private Zone zone;
private Date createDate;
private Integer memberServerImageBlockStorageTotalRows;
private Long memberServerImageBlockStorageTotalSize;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10713 Not found contract information. Please check your input parameter.
400 24109 The input parameter instance number is invalid
400 24110 The input parameter server image number is invalid.
400 25035 Currently (other) user is either creating server or operating server image from server image, thus unable to delete.
400 25200 The server images cannot be deleted becasue they are referenced by auto scaling launch configurations.

  • 요청

    ${SERVER_API_URL}?action=deleteMemberServerImages
    &memberServerImageNoList.1=1756
    &AUTHPARAMS
    
  • 응답

    <deleteMemberServerImagesResponse>
      <requestId>b5bc0716-32e5-4edf-bf39-9eabfb2efdaf</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <memberServerImageList>
        <memberServerImage>
          <memberServerImageNo>1756</memberServerImageNo>
          <memberServerImageName>img-7f871658ff847d8</memberServerImageName>
          <memberServerImageDescription/>
          <originalServerInstanceNo>67953</originalServerInstanceNo>
          <originalServerProductCode>SPSVRSTAND000043</originalServerProductCode>
          <originalServerName>myserver</originalServerName>
          <originalBaseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </originalBaseBlockStorageDiskType>
          <originalServerImageProductCode>SPSW0LINUX000032</originalServerImageProductCode>
          <originalOsInformation>CentOS 6.3 32Bit</originalOsInformation>
          <originalServerImageName>centos-6.3-32</originalServerImageName>
          <memberServerImageStatusName>terminating</memberServerImageStatusName>
          <memberServerImageStatus>
            <code>CREAT</code>
            <codeName>NSI CREATED state</codeName>
          </memberServerImageStatus>
          <memberServerImageOperation>
            <code>TERMT</code>
            <codeName>NSI TERMINATE OP</codeName>
          </memberServerImageOperation>
          <memberServerImagePlatformTypeCode>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </memberServerImagePlatformTypeCode>
          <createDate>2014-02-18T17:22:43+0900</createDate>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <memberServerImageBlockStorageTotalRows>2</memberServerImageBlockStorageTotalRows>
          <memberServerImageBlockStorageTotalSize>13409189888</memberServerImageBlockStorageTotalSize>
        </memberServerImage>
      </memberServerImageList>
    </deleteMemberServerImagesResponse>
    

PublicIpInstance(공인 IP 주소 인스턴스)

getPublicIpInstanceList

API명

공인 IP 주소 인스턴스 리스트 조회

설명

공인 IP 주소 인스턴스 리스트를 조회합니다. 페이징 처리가 가능합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
isAssociated 할당 여부 Boolean No
publicIpInstanceNoList.N 공인 IP 주소 인스턴스 번호 리스트 String 중복 불가 No
publicIpList.N 공인 IP 주소 리스트 String Min : 5, Max : 15 No
searchFilterName 검색할 필터명 String No
searchFilterValue 검색할 필터값 String No
internetLineTypeCode 인터넷 라인 구분 코드 String Min : 1, Max : 5 No
pageNo 페이지 번호 Integer Min : 0,
Max : 2147483647
No
pageSize 페이지 사이즈 Integer Min : 0,
Max : 2147483647
No
sortedBy 정렬 대상 String No
sortingOrder 정렬 순서 String No
  • isAssociated
    할당된 공인 IP 주소, 할당되지 않은 공인 IP 주소를 조회할 수 있습니다.

  • publicIpInstanceNoList.N
    조회할 공인 IP 주소 인스턴스 번호 리스트

  • publicIpList.N
    조회할 공인 IP 주소 리스트

  • searchFilterName

    • 공인 IP 주소(publicIp) | 할당된 서버명(associatedServerName)
  • searchFilterValue
    조회할 값

  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)

  • pageNo
    건수가 많아 페이징하는 경우 해당하는 페이지 번호

  • pageSize
    한 페이지에서 조회할 건수

  • sortedBy
    결과 목록을 정렬할 기준 칼럼

    • 공인 IP 주소(publicIp) | 공인 IP 주소 인스턴스 번호(publicIpInstanceNo)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 공인 IP 주소 인스턴스 번호(publicIpInstanceNo)
  • sortingOrder
    목록 정렬 순서

    • 오름차순(ascending) | 내림차순(descending)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 오름차순(ascending)

응답 데이터 타입

  • PublicIpInstanceList 타입
PublicIpInstanceList extends CommonResponse
private Integer totalRows;
private List publicIpInstanceList = new ArrayList();
PublicIpInstance
private String publicIpInstanceNo;
private String publiclIp;
private String publicIpDescription;
private Date createDate;
private CommonCode internetLineType;
private String publicIpInstanceStatusName;
private CommonCode publicIpInstanceStatus;
private CommonCode publicIpInstanceOperation;
private CommonCode publicIpKindType;

오류

  • 요청

    ${SERVER_API_URL}?action=getPublicIpInstanceList
    &AUTHPARAMS
    
  • 응답

    <getPublicIpInstanceListResponse>
      <requestId>98275c8a-0865-4c8f-8273-80878b42704c</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>2</totalRows>
      <publicIpInstanceList>
        <publicIpInstance>
          <publicIpInstanceNo>67653</publicIpInstanceNo>
          <publicIp>192.168.200.156</publicIp>
          <publicIpDescription>기본 제공 공인 아이피</publicIpDescription>
          <createDate>2014-02-06T15:21:41+0900</createDate>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <publicIpInstanceStatusName>used</publicIpInstanceStatusName>
          <publicIpInstanceStatus>
            <code>USED</code>
            <codeName>NET USED state</codeName>
          </publicIpInstanceStatus>
          <publicIpInstanceOperation>
            <code>NULL</code>
            <codeName>NET NULL OP</codeName>
          </publicIpInstanceOperation>
          <publicIpKindType>
            <code>DFLT</code>
            <codeName>Default</codeName>
          </publicIpKindType>
          <serverInstanceAssociatedWithPublicIp>
            <serverInstanceNo>67920</serverInstanceNo>
            <serverName>svr-7f86d7cf2279599</serverName>
            <serverDescription>Auto scaling group 'asg-0212' 소속의 자동 생성된 서버</serverDescription>
            <cpuCount>2</cpuCount>
            <memorySize>4294967296</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>LNX32</code>
              <codeName>Linux 32 Bit</codeName>
            </platformType>
            <loginKeyName>yh-nang-test</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp>192.168.200.156</publicIp>
            <privateIp>10.101.6.75</privateIp>
            <serverImageName>centos-5.7-32-cnc1</serverImageName>
            <serverInstanceStatus>
              <code>RUN</code>
              <codeName>Server run state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>running</serverInstanceStatusName>
            <createDate>2014-02-17T12:30:21+0900</createDate>
            <uptime>2014-02-17T13:55:03+0900</uptime>
            <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000043</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp/>
            <zone>
              <zoneNo>2</zoneNo>
              <zoneName>zone2</zoneName>
              <zoneDescription>nang zone</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>LOCAL</code>
              <codeName>Local storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                <isDefault>true</isDefault>
                <createDate>2013-12-03T10:37:39+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstanceAssociatedWithPublicIp>
        </publicIpInstance>
        <publicIpInstance>
          <publicIpInstanceNo>68002</publicIpInstanceNo>
          <publicIp>192.168.200.195</publicIp>
          <publicIpDescription/>
          <createDate>2014-02-18T17:42:23+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/>
        </publicIpInstance>
      </publicIpInstanceList>
    </getPublicIpInstanceListResponse>
    

getPublicIpTargetServerInstanceList

API명

공인 IP 주소 할당(가능) 서버 인스턴스 리스트 조회

설명

공인 IP 주소 할당(가능) 서버 인스턴스 리스트를 조회합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
internetLineTypeCode 인터넷 라인 구분 코드 String Min : 1, Max : 5 No
  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String privateIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

  • 요청

    ${SERVER_API_URL}?action=getPublicIpTargetServerInstanceList
    &serverInstanceNo=67953
    &AUTHPARAMS
    
  • 응답

    <getPublicIpTargetServerInstanceListResponse>
      <requestId>fc0a990d-1536-4285-a6cb-d2a4cc203b52</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>3</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67943</serverInstanceNo>
          <serverName>svr-7f86d867d343949</serverName>
          <serverDescription>Auto scaling group 'asg-0212' 소속의 자동 생성된 서버</serverDescription>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>yh-nang-test</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp>10.101.5.109</privateIp>
          <serverImageName>centos-5.7-32-cnc1</serverImageName>
          <serverInstanceStatus>
            <code>RUN</code>
            <codeName>Server run state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>NULL</code>
            <codeName>Server NULL OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>running</serverInstanceStatusName>
          <createDate>2014-02-17T13:30:28+0900</createDate>
          <uptime>2014-02-17T13:37:30+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance></serverInstanceList>
    </getPublicIpTargetServerInstanceListResponse>
    

createPublicIpInstance

API명

공인 IP 인스턴스 생성

설명

공인 IP 인스턴스를 생성합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
serverInstanceNo 서버 인스턴스 번호 String No
publicIpDescription 공인 IP 주소 설명 String Min : 10, Max : 1000 No
internetLineTypeCode 인터넷 라인 구분 코드 String Min : 1, Max : 5 No
  • serverInstanceNo
    공인 IP 주소를 생성후 할당할 서버 인스턴스 번호
    getPublicIpTargetServerInstanceList 액션을 통해 획득할 수 있습니다.

  • publicIpDescription
    공인 IP 주소 설명

  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)

    • 기본값: PUBLC(Public)

응답 데이터 타입

  • PublicIpInstanceList 타입
PublicIpInstanceList extends CommonResponse
private Integer totalRows;
private List publicIpInstanceList = new ArrayList();
PublicIpInstance
private String publicIpInstanceNo;
private String publiclIp;
private String publicIpDescription;
private Date createDate;
private CommonCode internetLineType;
private String publicIpInstanceStatusName;
private CommonCode publicIpInstanceStatus;
private CommonCode publicIpInstanceOperation;
private CommonCode publicIpKindType;

오류

HTTP 응답 코드 반환 코드 반환 메시지
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.

  • 요청

    ${SERVER_API_URL}?action=createPublicIpInstance
    &serverInstanceNo=67953
    &AUTHPARAMS
    
  • 응답

    <createPublicIpInstanceResponse>
      <requestId>f1a120a8-c5b3-4b2f-b672-9f4b40f4d8a4</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <publicIpInstanceList>
        <publicIpInstance>
          <publicIpInstanceNo>68003</publicIpInstanceNo>
          <publicIp>192.168.200.198</publicIp>
          <publicIpDescription/>
          <createDate>2014-02-18T17:50:05+0900</createDate>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <publicIpInstanceStatusName>using</publicIpInstanceStatusName>
          <publicIpInstanceStatus>
            <code>CREAT</code>
            <codeName>NET CREATE state</codeName>
          </publicIpInstanceStatus>
          <publicIpInstanceOperation>
            <code>USE</code>
            <codeName>NET USE OP</codeName>
          </publicIpInstanceOperation>
          <publicIpKindType>
            <code>GEN</code>
            <codeName>General</codeName>
          </publicIpKindType>
          <serverInstanceAssociatedWithPublicIp>
            <serverInstanceNo>67953</serverInstanceNo>
            <serverName>myserver</serverName>
            <serverDescription/>
            <cpuCount>2</cpuCount>
            <memorySize>4294967296</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>LNX32</code>
              <codeName>Linux 32 Bit</codeName>
            </platformType>
            <loginKeyName>hkey-0217</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp>192.168.200.198</publicIp>
            <privateIp>10.101.5.105</privateIp>
            <serverImageName>centos-6.3-32</serverImageName>
            <serverInstanceStatus>
              <code>NSTOP</code>
              <codeName>Server normal stopped state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>stopped</serverInstanceStatusName>
            <createDate>2014-02-17T18:04:49+0900</createDate>
            <uptime>2014-02-18T14:58:26+0900</uptime>
            <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000043</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp/>
            <zone>
              <zoneNo>3</zoneNo>
              <zoneName>zone3</zoneName>
              <zoneDescription>nang zone2</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>LOCAL</code>
              <codeName>Local storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                <isDefault>true</isDefault>
                <createDate>2013-12-03T10:37:39+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstanceAssociatedWithPublicIp>
        </publicIpInstance>
      </publicIpInstanceList>
    </createPublicIpInstanceResponse>
    

associatePublicIpWithServerInstance

API명

공인 IP 주소를 서버 인스턴스에 할당

설명

공인 IP 주소를 서버 인스턴스에 할당합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
publicIpInstanceNo 공인 IP 인스턴스 번호 String Yes
serverInstanceNo 서버 인스턴스 번호 String Yes
  • publicIpInstanceNo
    할당할 공인 IP 인스턴스 번호

  • serverInstanceNo
    할당할 서버 인스턴스 번호
    getPublicIpTargetServerInstanceList 액션을 통해 획득할 수 있습니다.

응답 데이터 타입

  • PublicIpInstanceList 타입
PublicIpInstanceList extends CommonResponse
private Integer totalRows;
private List publicIpInstanceList = new ArrayList();
PublicIpInstance
private String publicIpInstanceNo;
private String publiclIp;
private String publicIpDescription;
private Date createDate;
private CommonCode internetLineType;
private String publicIpInstanceStatusName;
private CommonCode publicIpInstanceStatus;
private CommonCode publicIpInstanceOperation;
private CommonCode publicIpKindType;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 24094 The line for internet access of server does not correspond with which of Public IP.
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 24122 The input parameter public IP instance number is invalid.
400 25029 You may not perform the allocate task since (other) user is changing the target public IP settings.
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.
400 28101 A public IP is already associated with server.

  • 요청

    ${SERVER_API_URL}?action=associatePublicIpWithServerInstance
    &publicIpInstanceNo=68002
    &serverInstanceNo=67953
    &AUTHPARAMS
    
  • 응답

    <associatePublicIpWithServerInstanceResponse>
      <requestId>9b87c1c5-416f-442f-8f11-74e34ba75999</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <publicIpInstanceList>
        <publicIpInstance>
          <publicIpInstanceNo>68002</publicIpInstanceNo>
          <publicIp>192.168.200.195</publicIp>
          <publicIpDescription/>
          <createDate>2014-02-18T17:42:23+0900</createDate>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <publicIpInstanceStatusName>using</publicIpInstanceStatusName>
          <publicIpInstanceStatus>
            <code>CREAT</code>
            <codeName>NET CREATE state</codeName>
          </publicIpInstanceStatus>
          <publicIpInstanceOperation>
            <code>USE</code>
            <codeName>NET USE OP</codeName>
          </publicIpInstanceOperation>
          <publicIpKindType>
            <code>GEN</code>
            <codeName>General</codeName>
          </publicIpKindType>
          <serverInstanceAssociatedWithPublicIp>
            <serverInstanceNo>67953</serverInstanceNo>
            <serverName>myserver</serverName>
            <serverDescription/>
            <cpuCount>2</cpuCount>
            <memorySize>4294967296</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>LNX32</code>
              <codeName>Linux 32 Bit</codeName>
            </platformType>
            <loginKeyName>hkey-0217</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp>192.168.200.195</publicIp>
            <privateIp>10.101.5.105</privateIp>
            <serverImageName>centos-6.3-32</serverImageName>
            <serverInstanceStatus>
              <code>NSTOP</code>
              <codeName>Server normal stopped state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>stopped</serverInstanceStatusName>
            <createDate>2014-02-17T18:04:49+0900</createDate>
            <uptime>2014-02-18T14:58:26+0900</uptime>
            <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000043</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp/>
            <zone>
              <zoneNo>3</zoneNo>
              <zoneName>zone3</zoneName>
              <zoneDescription>nang zone2</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>LOCAL</code>
              <codeName>Local storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                <isDefault>true</isDefault>
                <createDate>2013-12-03T10:37:39+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstanceAssociatedWithPublicIp>
        </publicIpInstance>
      </publicIpInstanceList>
    </associatePublicIpWithServerInstanceResponse>
    

disassociatePublicIpFromServerInstance

API명

공인 IP 주소를 서버 인스턴스에 할당 해제

설명

공인 IP 주소를 서버 인스턴스에 할당 해제합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
publicIpInstanceNo 공인 IP 인스턴스 번호 String Yes
  • publicIpInstanceNo
    할당 해제할 공인 IP 인스턴스 번호

응답 데이터 타입

  • PublicIpInstanceList 타입
PublicIpInstanceList extends CommonResponse
private Integer totalRows;
private List publicIpInstanceList = new ArrayList();
PublicIpInstance
private String publicIpInstanceNo;
private String publiclIp;
private String publicIpDescription;
private Date createDate;
private CommonCode internetLineType;
private String publicIpInstanceStatusName;
private CommonCode publicIpInstanceStatus;
private CommonCode publicIpInstanceOperation;
private CommonCode publicIpKindType;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 24109 The input parameter instance number is invalid
400 24122 The input parameter public IP instance number is invalid.
400 25031 You may not perform allocated cancellation task since (other) user is changing the target public IP settings.
400 25032 You may not delete sk since (other) user is changing the target public IP settings.
400 28102 The public IP is already disassociated from the server.

  • 요청

    ${SERVER_API_URL}?action=disassociatePublicIpFromServerInstance
    &publicIpInstanceNo=68002
    &AUTHPARAMS
    
  • 응답

    <disassociatePublicIpFromServerInstanceResponse>
      <requestId>cc6072ce-4ac4-4606-abd4-7b0e226918a7</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <publicIpInstanceList>
        <publicIpInstance>
          <publicIpInstanceNo>68002</publicIpInstanceNo>
          <publicIp>192.168.200.195</publicIp>
          <publicIpDescription/>
          <createDate>2014-02-18T17:42:23+0900</createDate>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <publicIpInstanceStatusName>disusing</publicIpInstanceStatusName>
          <publicIpInstanceStatus>
            <code>USED</code>
            <codeName>NET USED state</codeName>
          </publicIpInstanceStatus>
          <publicIpInstanceOperation>
            <code>DISUS</code>
            <codeName>NET DISUSE OP</codeName>
          </publicIpInstanceOperation>
          <publicIpKindType>
            <code>GEN</code>
            <codeName>General</codeName>
          </publicIpKindType>
          <serverInstanceAssociatedWithPublicIp>
            <serverInstanceNo>67953</serverInstanceNo>
            <serverName>myserver</serverName>
            <serverDescription/>
            <cpuCount>2</cpuCount>
            <memorySize>4294967296</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>LNX32</code>
              <codeName>Linux 32 Bit</codeName>
            </platformType>
            <loginKeyName>hkey-0217</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp>192.168.200.195</publicIp>
            <privateIp>10.101.5.105</privateIp>
            <serverImageName>centos-6.3-32</serverImageName>
            <serverInstanceStatus>
              <code>NSTOP</code>
              <codeName>Server normal stopped state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>stopped</serverInstanceStatusName>
            <createDate>2014-02-17T18:04:49+0900</createDate>
            <uptime>2014-02-18T14:58:26+0900</uptime>
            <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000043</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp/>
            <zone>
              <zoneNo>3</zoneNo>
              <zoneName>zone3</zoneName>
              <zoneDescription>nang zone2</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>LOCAL</code>
              <codeName>Local storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                <isDefault>true</isDefault>
                <createDate>2013-12-03T10:37:39+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstanceAssociatedWithPublicIp>
        </publicIpInstance>
      </publicIpInstanceList>
    </disassociatePublicIpFromServerInstanceResponse>
    

deletePublicIpInstances

API명

공인 IP 인스턴스 삭제

설명

공인 IP 인스턴스를 삭제합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
publicIpInstanceNoList.N 공인 IP 인스턴스 번호 리스트 String 중복 불가 Yes
  • publicIpInstanceNoList.N
    삭제할 공인 IP 인스턴스 번호 리스트
    getPublicIpInstanceList 액션을 통해서 획득할 수 있습니다.

응답 데이터 타입

  • PublicIpInstanceList 타입
PublicIpInstanceList extends CommonResponse
private Integer totalRows;
private List publicIpInstanceList = new ArrayList();
PublicIpInstance
private String publicIpInstanceNo;
private String publiclIp;
private String publicIpDescription;
private Date createDate;
private CommonCode internetLineType;
private String publicIpInstanceStatusName;
private CommonCode publicIpInstanceStatus;
private CommonCode publicIpInstanceOperation;
private CommonCode publicIpKindType;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10713 Not found contract information. Please check your input parameter.
400 10709 Basic public ip can not be deleted.
400 24073 Unable to destroy the server since a public IP is associated with the server. First, please disassociate a public IP from the server. publicIpInstanceNo = {0}
400 24109 The input parameter instance number is invalid
400 24122 The input parameter public IP instance number is invalid.

  • 요청

    ${SERVER_API_URL}?action=deletePublicIpInstances
    &publicIpInstanceNoList.1=68002
    &AUTHPARAMS
    
  • 응답

    <deletePublicIpInstancesResponse>
      <requestId>72c30b26-1c10-4c1b-a6d2-4669e1899e9c</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <publicIpInstanceList>
        <publicIpInstance>
          <publicIpInstanceNo>68002</publicIpInstanceNo>
          <publicIp>192.168.200.195</publicIp>
          <publicIpDescription/>
          <createDate>2014-02-18T17:42:23+0900</createDate>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <publicIpInstanceStatusName>terminated</publicIpInstanceStatusName>
          <publicIpInstanceStatus>
            <code>TERMT</code>
            <codeName>NET TERMINATED state</codeName>
          </publicIpInstanceStatus>
          <publicIpInstanceOperation>
            <code>NULL</code>
            <codeName>NET NULL OP</codeName>
          </publicIpInstanceOperation>
          <publicIpKindType>
            <code>GEN</code>
            <codeName>General</codeName>
          </publicIpKindType>
          <serverInstanceAssociatedWithPublicIp/>
        </publicIpInstance>
      </publicIpInstanceList>
    </deletePublicIpInstancesResponse>
    

PortForwarding(포트포워딩)

getPortForwardingRuleList

API명

포트포워딩 룰 리스트 조회

설명

포트포워딩 룰 리스트 정보를 조회합니다. 최초에 서버를 생성하면 계정당 하나씩 포트포워딩용 공인 IP 주소가 부여됩니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
internetLineTypeCode 인터넷 라인 구분 코드 String Min : 1, Max : 5 No
  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)
    • 기본값: PUBLC(Public)

응답 데이터 타입

  • PortForwardingRuleList 타입
PortForwardingRuleList extends CommonResponse
private String portForwardingConfigurationNo;
private String portForwardingPublicIp;
private Integer totalRows;
private List portForwardingRuleList = new ArrayList();
PortForwardingRule
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private ServerInstance serverInstance;

오류

  • 요청

    ${SERVER_API_URL}?action=getPortForwardingRuleList
    &AUTHPARAMS
    
  • 응답

    <getPortForwardingRuleListResponse>
      <requestId>08842664-ea53-49b5-9192-7e4d165b86d6</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <portForwardingConfigurationNo>1676</portForwardingConfigurationNo>
      <portForwardingPublicIp>192.168.120.28</portForwardingPublicIp>
      <totalRows>2</totalRows>
      <portForwardingRuleList>
        <portForwardingRule>
          <portForwardingExternalPort>1025</portForwardingExternalPort>
          <portForwardingInternalPort>3389</portForwardingInternalPort>
          <serverInstance>
            <serverInstanceNo>274079</serverInstanceNo>
            <serverName>pjaser-2</serverName>
            <serverDescription/>
            <cpuCount>1</cpuCount>
            <memorySize>2147483648</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>WND32</code>
              <codeName>Windows 32 Bit</codeName>
            </platformType>
            <loginKeyName>pja-1126</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp/>
            <privateIp>10.101.6.101</privateIp>
            <serverImageName>win-2008-32-R1</serverImageName>
            <serverInstanceStatus>
              <code>FSTOP</code>
              <codeName>Server failure stopped state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>repairing</serverInstanceStatusName>
            <createDate>2015-03-04T15:12:47+0900</createDate>
            <uptime>2015-03-27T11:36:29+0900</uptime>
            <serverImageProductCode>SPSW0WINNT000013</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000003</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp>192.168.120.28</portForwardingPublicIp>
            <portForwardingExternalPort>1025</portForwardingExternalPort>
            <portForwardingInternalPort>3389</portForwardingInternalPort>
            <zone>
              <zoneNo>2</zoneNo>
              <zoneName>nang_zone</zoneName>
              <zoneDescription>nang zone</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>NET</code>
              <codeName>Network Storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>3321</accessControlGroupConfigurationNo>
                <accessControlGroupName>pja-acg</accessControlGroupName>
                <accessControlGroupDescription/>
                <isDefault>false</isDefault>
                <createDate>2015-03-04T15:12:21+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstance>
        </portForwardingRule>
        <portForwardingRule>
          <portForwardingExternalPort>1026</portForwardingExternalPort>
          <portForwardingInternalPort>22</portForwardingInternalPort>
          <serverInstance>
            <serverInstanceNo>274317</serverInstanceNo>
            <serverName>x0312b</serverName>
            <serverDescription/>
            <cpuCount>1</cpuCount>
            <memorySize>2147483648</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>LNX64</code>
              <codeName>Linux 64 Bit</codeName>
            </platformType>
            <loginKeyName>pja-1126</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp/>
            <privateIp>10.101.6.115</privateIp>
            <serverImageName>centos-6.3-64</serverImageName>
            <serverInstanceStatus>
              <code>FSTOP</code>
              <codeName>Server failure stopped state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>repairing</serverInstanceStatusName>
            <createDate>2015-03-12T18:29:39+0900</createDate>
            <uptime>2015-03-13T10:08:45+0900</uptime>
            <serverImageProductCode>SPSW0LINUX000031</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000003</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp>192.168.120.28</portForwardingPublicIp>
            <portForwardingExternalPort>1026</portForwardingExternalPort>
            <portForwardingInternalPort>22</portForwardingInternalPort>
            <zone>
              <zoneNo>2</zoneNo>
              <zoneName>nang_zone</zoneName>
              <zoneDescription>nang zone</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>NET</code>
              <codeName>Network Storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                <isDefault>true</isDefault>
                <createDate>2013-12-03T10:37:39+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstance>
        </portForwardingRule>
      </portForwardingRuleList>
    </getPortForwardingRuleListResponse>
    

addPortForwardingRules

API명

포트포워딩 룰 추가

설명

포트포워딩 룰을 추가합니다. 가지고 있는 서버에 포트포워딩 룰을 추가하여 포트포워딩 공인 IP 주소로 접속할 수 있습니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
portForwardingConfigurationNo 포트포워딩 설정 번호 String Yes
portForwardingRuleList.N.serverInstanceNo 포트포워딩 룰 리스트.N.서버 인스턴스 번호 String Yes
portForwardingRuleList.N.portForwardingExternalPort 포트포워딩 룰 리스트.N.포트포워딩 외부 포트 String Min : 1, Max : 65534 Yes
portForwardingRuleList.N.portForwardingInternalPort 포트포워딩 룰 리스트.N.포트포워딩 내부 포트 String Min : 1, Max : 65534 Yes
  • portForwardingConfigurationNo
    포트포워딩 설정 번호
    네이버 클라우드 플랫폼에서 포트포워딩을 위해 생성한 key값

  • portForwardingRuleList.N.serverInstanceNo
    포트포워딩을 설정한 서버 인스턴스 번호

  • portForwardingRuleList.N.portForwardingExternalPort
    포트포워딩으로 접속할 외부 포트

  • portForwardingRuleList.N.portForwardingInternalPort
    포트포워딩으로 접속할 내부 포트
    아래의 포트만 입력이 가능합니다.

    • 리눅스: 22 | 윈도우: 3389

응답 데이터 타입

  • PortForwardingRuleList 타입
PortForwardingRuleList extends CommonResponse
private String portForwardingConfigurationNo;
private String portForwardingPublicIp;
private Integer totalRows;
private List portForwardingRuleList = new ArrayList();
PortForwardingRule
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private ServerInstance serverInstance;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 26035 Not found certificateName. Please check your input parameter.
400 25033 Currently port forwarding setting is being created/ modifying/ deleting. Please try again a few seconds later.
400 24068 {0} cannot be controlled. instanceNo = {1}
400 24069 Invalid internal port has been configured. Usable internal port(LINUX type : 22, WINDOWS type : 3389)
400 24070 A single external port number is used in multiple rules. External port number : {0}
400 24071 Single server is existing in multiple rules. Server IP address : {0}
400 24074 External & internal port as well as server instance number are not designated to port forward rule.

  • 요청

    ${SERVER_API_URL}?action=addPortForwardingRules
    $portForwardingConfigurationNo=1676
    &portForwardingRuleList.1.serverInstanceNo=274079
    &portForwardingRuleList.1.portForwardingExternalPort=1025
    &portForwardingRuleList.1.portForwardingInternalPort=3389
    &AUTHPARAMS
    
  • 응답

    <addPortForwardingRulesResponse>
      <requestId>943e41d1-f2b9-43a9-b308-5f12152a2f7f</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <portForwardingConfigurationNo>1676</portForwardingConfigurationNo>
      <portForwardingPublicIp>192.168.120.28</portForwardingPublicIp>
      <totalRows>2</totalRows>
      <portForwardingRuleList>
        <portForwardingRule>
          <portForwardingExternalPort>1025</portForwardingExternalPort>
          <portForwardingInternalPort>3389</portForwardingInternalPort>
          <serverInstance>
            <serverInstanceNo>274079</serverInstanceNo>
            <serverName>pjaser-2</serverName>
            <serverDescription/>
            <cpuCount>1</cpuCount>
            <memorySize>2147483648</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>WND32</code>
              <codeName>Windows 32 Bit</codeName>
            </platformType>
            <loginKeyName>pja-1126</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp/>
            <privateIp>10.101.6.101</privateIp>
            <serverImageName>win-2008-32-R1</serverImageName>
            <serverInstanceStatus>
              <code>FSTOP</code>
              <codeName>Server failure stopped state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>repairing</serverInstanceStatusName>
            <createDate>2015-03-04T15:12:47+0900</createDate>
            <uptime>2015-03-27T11:36:29+0900</uptime>
            <serverImageProductCode>SPSW0WINNT000013</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000003</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp>192.168.120.28</portForwardingPublicIp>
            <portForwardingExternalPort>1025</portForwardingExternalPort>
            <portForwardingInternalPort>3389</portForwardingInternalPort>
            <zone>
              <zoneNo>2</zoneNo>
              <zoneName>nang_zone</zoneName>
              <zoneDescription>nang zone</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>NET</code>
              <codeName>Network Storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>3321</accessControlGroupConfigurationNo>
                <accessControlGroupName>pja-acg</accessControlGroupName>
                <accessControlGroupDescription/>
                <isDefault>false</isDefault>
                <createDate>2015-03-04T15:12:21+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstance>
        </portForwardingRule>
        <portForwardingRule>
          <portForwardingExternalPort>1026</portForwardingExternalPort>
          <portForwardingInternalPort>22</portForwardingInternalPort>
          <serverInstance>
            <serverInstanceNo>274317</serverInstanceNo>
            <serverName>x0312b</serverName>
            <serverDescription/>
            <cpuCount>1</cpuCount>
            <memorySize>2147483648</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>LNX64</code>
              <codeName>Linux 64 Bit</codeName>
            </platformType>
            <loginKeyName>pja-1126</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp/>
            <privateIp>10.101.6.115</privateIp>
            <serverImageName>centos-6.3-64</serverImageName>
            <serverInstanceStatus>
              <code>FSTOP</code>
              <codeName>Server failure stopped state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>repairing</serverInstanceStatusName>
            <createDate>2015-03-12T18:29:39+0900</createDate>
            <uptime>2015-03-13T10:08:45+0900</uptime>
            <serverImageProductCode>SPSW0LINUX000031</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000003</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp>192.168.120.28</portForwardingPublicIp>
            <portForwardingExternalPort>1026</portForwardingExternalPort>
            <portForwardingInternalPort>22</portForwardingInternalPort>
            <zone>
              <zoneNo>2</zoneNo>
              <zoneName>nang_zone</zoneName>
              <zoneDescription>nang zone</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>NET</code>
              <codeName>Network Storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                <isDefault>true</isDefault>
                <createDate>2013-12-03T10:37:39+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstance>
        </portForwardingRule>
      </portForwardingRuleList>
    </addPortForwardingRulesResponse>
    

deletePortForwardingRules

API명

포트포워딩 룰 삭제

설명

포트포워딩 룰을 삭제합니다. 가지고 있는 서버에 포트포워딩 룰을 삭제할 수 있습니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
portForwardingConfigurationNo 포트포워딩 설정 번호 String Yes
portForwardingRuleList.N.serverInstanceNo 포트포워딩 룰 리스트.N.서버 인스턴스 번호 String Yes
portForwardingRuleList.N.portForwardingExternalPort 포트포워딩 룰 리스트.N.포트포워딩 외부 포트 String Min : 1, Max : 65534 Yes
portForwardingRuleList.N.portForwardingInternalPort 포트포워딩 룰 리스트.N.포트포워딩 내부 포트 String Min : 1, Max : 65534 Yes
  • portForwardingConfigurationNo
    포트포워딩 설정 번호
    네이버 클라우드 플랫폼에서 포트포워딩을 위해 생성한 key값

  • portForwardingRuleList.N.serverInstanceNo
    포트포워딩을 설정한 삭제 대상 서버 인스턴스 번호

  • portForwardingRuleList.N.portForwardingExternalPort
    삭제 대상 외부 포트

  • portForwardingRuleList.N.portForwardingInternalPort
    삭제 대상 내부 포트
    아래의 포트만 입력이 가능합니다.

    • 리눅스: 22 | 윈도우: 3389

응답 데이터 타입

  • PortForwardingRuleList 타입
PortForwardingRuleList extends CommonResponse
private String portForwardingConfigurationNo;
private String portForwardingPublicIp;
private Integer totalRows;
private List portForwardingRuleList = new ArrayList();
PortForwardingRule
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private ServerInstance serverInstance;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 26035 Not found certificateName. Please check your input parameter.
400 25033 Currently port forwarding setting is being created/ modifying/ deleting. Please try again a few seconds later.
400 24068 {0} cannot be controlled. instanceNo = {1}
400 24069 Invalid internal port has been configured. Usable internal port(LINUX type : 22, WINDOWS type : 3389)
400 24074 External & internal port as well as server instance number are not designated to port forward rule.

  • 요청

    ${SERVER_API_URL}?action=deletePortForwardingRules
    $portForwardingConfigurationNo=1676
    &portForwardingRuleList.1.serverInstanceNo=274079
    &portForwardingRuleList.1.portForwardingExternalPort=1025
    &portForwardingRuleList.1.portForwardingInternalPort=3389
    &AUTHPARAMS
    
  • 응답

    <deletePortForwardingRulesResponse>
      <requestId>54b32354-3acb-489c-8bdb-09a722555a75</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <portForwardingConfigurationNo>1676</portForwardingConfigurationNo>
      <portForwardingPublicIp>192.168.120.28</portForwardingPublicIp>
      <totalRows>1</totalRows>
      <portForwardingRuleList>
        <portForwardingRule>
          <portForwardingExternalPort>1026</portForwardingExternalPort>
          <portForwardingInternalPort>22</portForwardingInternalPort>
          <serverInstance>
            <serverInstanceNo>274317</serverInstanceNo>
            <serverName>x0312b</serverName>
            <serverDescription/>
            <cpuCount>1</cpuCount>
            <memorySize>2147483648</memorySize>
            <baseBlockStorageSize>53687091200</baseBlockStorageSize>
            <platformType>
              <code>LNX64</code>
              <codeName>Linux 64 Bit</codeName>
            </platformType>
            <loginKeyName>pja-1126</loginKeyName>
            <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
            <publicIp/>
            <privateIp>10.101.6.115</privateIp>
            <serverImageName>centos-6.3-64</serverImageName>
            <serverInstanceStatus>
              <code>FSTOP</code>
              <codeName>Server failure stopped state</codeName>
            </serverInstanceStatus>
            <serverInstanceOperation>
              <code>NULL</code>
              <codeName>Server NULL OP</codeName>
            </serverInstanceOperation>
            <serverInstanceStatusName>repairing</serverInstanceStatusName>
            <createDate>2015-03-12T18:29:39+0900</createDate>
            <uptime>2015-03-13T10:08:45+0900</uptime>
            <serverImageProductCode>SPSW0LINUX000031</serverImageProductCode>
            <serverProductCode>SPSVRSTAND000003</serverProductCode>
            <isProtectServerTermination>false</isProtectServerTermination>
            <portForwardingPublicIp>192.168.120.28</portForwardingPublicIp>
            <portForwardingExternalPort>1026</portForwardingExternalPort>
            <portForwardingInternalPort>22</portForwardingInternalPort>
            <zone>
              <zoneNo>2</zoneNo>
              <zoneName>nang_zone</zoneName>
              <zoneDescription>nang zone</zoneDescription>
            </zone>
            <baseBlockStorageDiskType>
              <code>NET</code>
              <codeName>Network Storage</codeName>
            </baseBlockStorageDiskType>
            <userData/>
            <accessControlGroupList>
              <accessControlGroup>
                <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                <isDefault>true</isDefault>
                <createDate>2013-12-03T10:37:39+0900</createDate>
              </accessControlGroup>
            </accessControlGroupList>
          </serverInstance>
        </portForwardingRule>
      </portForwardingRuleList>
    </deletePortForwardingRulesResponse>
    

LoadBalancerInstance(로드밸런서 인스턴스)

getLoadBalancerInstanceList

API명

로드밸런서 인스턴스 리스트 조회

설명

로드밸런서 인스턴스 리스트를 조회합니다. 페이징 처리가 가능합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
loadBalancerInstanceNoList.N 로드밸런서 인스턴스 번호 리스트 String 중복 불가 No
internetLineTypeCode 인터넷 라인 구분 코드 String Min : 1, Max : 5 No
networkUsageTypeCode 네트워크 용도 구분 코드 String Min : 1, Max : 5 No
pageNo 페이지 번호 Integer Min : 0,
Max : 2147483647
No
pageSize 페이지 사이즈 Integer Min : 0,
Max : 2147483647
No
sortedBy 정렬 대상 String No
sortingOrder 정렬 순서 String No
  • loadBalancernstanceNoList.N
    조회할 공인 IP 주소 인스턴스 번호 리스트

  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)

  • networkUsageTypeCode
    네트워크 용도 구분 코드
    예: PBLIP(Public), PRVT(Private)

  • pageNo
    건수가 많아 페이징하는 경우 해당하는 페이지 번호

  • pageSize
    한 페이지에서 조회할 건수

  • sortedBy
    결과 목록을 정렬할 기준 칼럼

    • 로드밸런서명(loadBalancerName) | 로드밸런서 인스턴스 번호(loadBalancerInstanceNo)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 로드밸런서 인스턴스 번호(loadBalancerInstanceNo)
  • sortingOrder
    목록 정렬 순서

    • 오름차순(ascending) | 내림차순(descending)
      (대소문자를 구분하지 않습니다.)
    • 기본값: 오름차순(ascending)

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private String loadBalancerName;
private String loadBalancerName;
private CommonCode loadBalancerAlgorithmType;
private String loadBalancerDescription;
private Date createDate;
private String domainName;
private CommonCode internetLineType;
private CommonCode networkUsageType;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private List loadBalancerRuleList;
private List loadBalancedServerInstanceList;

오류

  • 요청

    ${SERVER_API_URL}?action=getLoadBalancerInstanceList
    &AUTHPARAMS
    
  • 응답

    <getLoadBalancerInstanceListResponse>
      <requestId>33439fed-63da-4d8c-aafd-ec1dd2c1c067</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>3</totalRows>
      <loadBalancerInstanceList>
        <loadBalancerInstance>
          <loadBalancerInstanceNo>67668</loadBalancerInstanceNo>
          <virtualIp/>
          <loadBalancerName>lb-0206-8</loadBalancerName>
          <loadBalancerAlgorithmType>
            <code>LC</code>
            <codeName>Least Connection</codeName>
          </loadBalancerAlgorithmType>
          <loadBalancerDescription/>
          <createDate>2014-02-06T15:22:11+0900</createDate>
          <domainName>slb-67668.sl2.ncloud.com</domainName>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <loadBalancerInstanceStatusName>used</loadBalancerInstanceStatusName>
          <loadBalancerInstanceStatus>
            <code>USED</code>
            <codeName>NET USED state</codeName>
          </loadBalancerInstanceStatus>
          <loadBalancerInstanceOperation>
            <code>NULL</code>
            <codeName>NET NULL OP</codeName>
          </loadBalancerInstanceOperation>
          <networkUsageType>
            <code>PBLIP</code>
            <codeName>Public</codeName>
          </networkUsageType>
          <loadBalancerRuleList>
            <loadBalancerRule>
              <protocolType>
                <code>TCP</code>
                <codeName>tcp</codeName>
              </protocolType>
              <loadBalancerPort>22000</loadBalancerPort>
              <serverPort>22</serverPort>
              <l7HealthCheckPath/>
              <certificateName/>
            </loadBalancerRule>
          </loadBalancerRuleList>
          <loadBalancedServerInstanceList>
            <loadBalancedServerInstance>
              <serverInstance>
                <serverInstanceNo>67953</serverInstanceNo>
                <serverName>myserver</serverName>
                <serverDescription/>
                <cpuCount>2</cpuCount>
                <memorySize>4294967296</memorySize>
                <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                <platformType>
                  <code>LNX32</code>
                  <codeName>Linux 32 Bit</codeName>
                </platformType>
                <loginKeyName>hkey-0217</loginKeyName>
                <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                <publicIp/>
                <privateIp>10.101.5.105</privateIp>
                <serverImageName>centos-6.3-32</serverImageName>
                <serverInstanceStatus>
                  <code>NSTOP</code>
                  <codeName>Server normal stopped state</codeName>
                </serverInstanceStatus>
                <serverInstanceOperation>
                  <code>NULL</code>
                  <codeName>Server NULL OP</codeName>
                </serverInstanceOperation>
                <serverInstanceStatusName>stopped</serverInstanceStatusName>
                <createDate>2014-02-17T18:04:49+0900</createDate>
                <uptime>2014-02-18T14:58:26+0900</uptime>
                <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
                <serverProductCode>SPSVRSTAND000043</serverProductCode>
                <isProtectServerTermination>false</isProtectServerTermination>
                <portForwardingPublicIp/>
                <zone>
                  <zoneNo>3</zoneNo>
                  <zoneName>zone3</zoneName>
                  <zoneDescription>nang zone2</zoneDescription>
                </zone>
                <baseBlockStorageDiskType>
                  <code>LOCAL</code>
                  <codeName>Local storage</codeName>
                </baseBlockStorageDiskType>
                <userData/>
                <accessControlGroupList>
                  <accessControlGroup>
                    <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                    <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                    <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                    <isDefault>true</isDefault>
                    <createDate>2013-12-03T10:37:39+0900</createDate>
                  </accessControlGroup>
                </accessControlGroupList>
              </serverInstance>
              <serverHealthCheckStatusList>
                <serverHealthCheckStatus>
                  <serverPort>22</serverPort>
                  <serverStatus>false</serverStatus>
                </serverHealthCheckStatus>
              </serverHealthCheckStatusList>
            </loadBalancedServerInstance>
          </loadBalancedServerInstanceList>
        </loadBalancerInstance></loadBalancerInstanceList>
    </getLoadBalancerInstanceListResponse>
    

getLoadBalancancerTargetServerInstanceList

API명

로드밸런서에 할당가능한 서버 인스턴스 리스트 조회

설명

로드밸런서에 할당가능한 서버 인스턴스 리스트를 조회합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
internetLineTypeCode 인터넷 라인 구분 코드 String Min : 1, Max : 5 No
  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)
    • 기본값: PUBLC(Public)

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private String loadBalancerName;
private String loadBalancerName;
private CommonCode loadBalancerAlgorithmType;
private String loadBalancerDescription;
private Date createDate;
private String domainName;
private CommonCode internetLineType;
private CommonCode networkUsageType;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private List loadBalancerRuleList;
private List loadBalancedServerInstanceList;

오류

  • 요청

    ${LOADBALANCER_API_URL}?action=getLoadBalancancerTargetServerInstanceList
    &AUTHPARAMS
    
  • 응답

    <getLoadBalancancerTargetServerInstanceListResponse>
      <requestId>ad8ae23f-7bbf-4696-a40a-d6eb9973fafe</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>5</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67953</serverInstanceNo>
          <serverName>myserver</serverName>
          <serverDescription/>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>hkey-0217</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp>10.101.5.105</privateIp>
          <serverImageName>centos-6.3-32</serverImageName>
          <serverInstanceStatus>
            <code>NSTOP</code>
            <codeName>Server normal stopped state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>NULL</code>
            <codeName>Server NULL OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>stopped</serverInstanceStatusName>
          <createDate>2014-02-17T18:04:49+0900</createDate>
          <uptime>2014-02-18T14:58:26+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance></serverInstanceList>
    </getLoadBalancancerTargetServerInstanceListResponse>
    

createLoadBalancerInstance

API명

로드밸런서 인스턴스 생성

설명

로드밸런서 인스턴스를 생성합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
loadBalancerName 로드밸런서명 String Min : 3,
Max : 30
No
loadBalancerAlgorithmTypeCode 로드밸런서 알고리즘 구분 코드 String Min : 1,
Max : 5
No
loadBalancerDescription 로드밸런서 설명 String Min : 1,
Max : 1000
No
internetLineTypeCode 인터넷 라인 구분 코드 String Min : 1,
Max : 5
No
networkUsageTypeCode 네트워크 용도 구분 코드 String Min : 1,
Max : 5
No
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String 중복 불가 No
loadBalancerRuleList.N.protocolTypeCode 로드밸런서 룰 리스트.N.프로토콜 구분 코드 String Min : 1,
Max : 5
Yes
loadBalancerRuleList.N.loadBalancerPort 로드밸런서 룰 리스트.N.로드밸런서 포트 Integer Min : 1,
Max : 65534
Yes
loadBalancerRuleList.N.serverPort 로드밸런서 룰 리스트.N.서버 포트 Integer Min : 1,
Max : 65534
Yes
loadBalancerRuleList.N.l7HealthCheckPath 로드밸런서 룰 리스트.N.헬스 체크 경로 String Min : 1,
Max : 600
Conditional
loadBalancerRuleList.N.certificateName 로드밸런서 룰 리스트.N.공인인증서 String Min : 1,
Max : 300
Conditional
  • loadBalancerName
    생성할 로드밸런서명

    • 기본값: Ncloud가 자동으로 배정
  • loadBalancerAlgorithmTypeCode
    로드밸런서 알고리즘 구분 코드
    입력 가능한 알고리즘은 다음과 같습니다.

    • ROUND ROBIN (RR), LEAST_CONNECTION (LC)
    • 기본값: ROUND ROBIN (RR)
  • internetLineTypeCode
    인터넷 라인 구분 코드
    예: PUBLC(Public), GLBL(글로벌)

    • 기본값: PUBLC(Public)
  • networkUsageTypeCode
    네트워크 용도 구분 코드
    예: PBLIP(Public), PRVT(Private)

    • 기본값: PBLIP(Public)
  • loadBalancerDescription
    로드밸런서 설명

  • serverInstanceNoList.N
    로드밸런서에 바인드할 서버 인스턴스 번호 리스트
    getLoadBalancancerTargetServerInstanceList 액션을 통해서 서버 인스턴스 번호를 조회할 수 있습니다.

  • loadBalancerRuleList.N.protocolTypeCode
    로드밸런서 룰의 프로토콜 구분 코드
    입력 가능한 프로토콜 구분 코드는 다음과 같습니다.

    • HTTP | TCP
  • loadBalancerRuleList.N.loadBalancerPort
    로드밸런서 룰의 로드밸런서 포트 번호

  • loadBalancerRuleList.N.serverPort
    로드밸런서 룰의 서버 포트

  • loadBalancerRuleList.N.l7HealthCheckPath
    로드밸런서 룰의 헬스 체크 경로
    loadBalancerRuleList.N.protocolTypeCode값이 HTTP/HTTPS인 경우에는 필수 항목입니다.

  • loadBalancerRuleList.N.certificateName
    로드밸런서 룰의 SSL 공인인증서
    loadBalancerRuleList.N.protocloTypeCode값이 SSL/HTTPS인 경우에는 필수 항목입니다.

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private String loadBalancerName;
private String loadBalancerName;
private CommonCode loadBalancerAlgorithmType;
private String loadBalancerDescription;
private Date createDate;
private String domainName;
private CommonCode internetLineType;
private CommonCode networkUsageType;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private List loadBalancerRuleList;
private List loadBalancedServerInstanceList;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10300 Instance name is already in use. please use other name.
400 10105 Unable to create load balancer anymore since contract limitation setting has been exceeded. Number of contract limitation: {0} Number of current contracts : {1}
400 23011 We are sorry that {0} cannot be used for load balancer ports since the ports are in use for load balancer management.
400 23017 This version of the load balancer can not create with private IP.
400 23018 Can not create the load balancer.
400 23019 There is not enough resources to create the load balancer.
400 24063 The number of load balancer settings has been exceeded.
400 24064 The range of usable {0} port is from 1 to 66534.
400 24065 {0} Duplicated port number. Port number : {1}
400 24066 When setting load balancer, Health Check route must be configured to HTTP protocol.
400 24091 No IP address is assigned to the server instance (no. {0}).
400 24099 When setting load balancer, Health Check route must be configured to HTTP or HTTPS protocol.
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 24130 The input parameter load balancing algorithm is invalid.
400 24131 The field {0} in the load balancer rule parameter is invalid.
400 24132 The field healthCheckPath in the load balancer rule parameter is invalid. If the protocol is HTTP, it is required. it must start with slash('/') and contain no blank.
400 24133 The field healthCheckPath in the load balancer rule parameter is invalid. If the protocol is NOT HTTP, it must not be specified.
400 24134 The number of input parameter load balancer rules is the minimum of 1, maximum of 5.
400 24300 The length constraints of the parameter description (memo) were violated. The minimum length is 0 byte, the maximum, 1,000 bytes.
400 25050 (Other)Unable to operate load balancer since use is manipulating the applying server.
400 25051 Server is already being applied to load balancer.
400 25052 Server {0} is unable to apply to load balancer since it is either in operation or not being suspended.
400 26034 An error occurred during certificate verification.
400 26035 Not found memberNo OR certificateName. Please check your input parameter.
400 26036 Not found memberNo OR certificateName OR privateKey OR publicKeyCertificate. Please check your input parameter.
400 26037 Certificate is being used in another loadBalancer.
400 26002 The issuer certificate of a looked up certificate could not be found. This normally means the list of trusted certificates is not complete.
400 26003 The CRL of a certificate could not be found.
400 26004 The certificate signature could not be decrypted. This means that the actual signature value could not be determined rather than it not matching the expected value, this is only meaningful for RSA keys.
400 26005 The CRL signature could not be decrypted: this means that the actual signature value could not be determined rather than it not matching the expected value. Unused.
400 26006 The public key in the certificate SubjectPublicKeyInfo could not be read.
400 26007 The signature of the certificate is invalid.
400 26008 The signature of the certificate is invalid.
400 26009 The certificate is not yet valid: the notBefore date is after the current time.
400 26010 The certificate has expired: that is the notAfter date is before the current time.
400 26011 The CRL is not yet valid.
400 26012 The CRL has expired.
400 26013 The certificate notBefore field contains an invalid time.
400 26014 The certificate notAfter field contains an invalid time.
400 26015 The CRL lastUpdate field contains an invalid time.
400 26016 The CRL nextUpdate field contains an invalid time.
400 26017 An error occurred trying to allocate memory. This should never happen.
400 26018 The passed certificate is self signed and the same certificate cannot be found in the list of trusted certificates.
400 26019 The certificate chain could be built up using the untrusted certificates but the root could not be found locally.
400 26020 The issuer certificate could not be found: this occurs if the issuer certificate of an untrusted certificate cannot be found.
400 26021 No signatures could be verified because the chain contains only one certificate and it is not self signed.
400 26022 The certificate chain length is greater than the supplied maximum depth. Unused.
400 26023 The certificate has been revoked.
400 26024 A CA certificate is invalid. Either it is not a CA or its extensions are not consistent with the supplied purpose.
400 26025 The basicConstraints pathlength parameter has been exceeded.
400 26026 The supplied certificate cannot be used for the specified purpose.
400 26027 The root CA is not marked as trusted for the specified purpose.
400 26028 The root CA is marked to reject the specified purpose.
400 26029 The current candidate issuer certificate was rejected because its subject name did not match the issuer name of the current certificate. Only displayed when the -issuer_checks option is set.
400 26030 The current candidate issuer certificate was rejected because its subject key identifier was present and did not match the authority key identifier current certificate. Only displayed when the -issuer_checks option is set.
400 26031 The current candidate issuer certificate was rejected because its issuer name and serial number was present and did not match the authority key identifier of the current certificate. Only displayed when the -issuer_checks option is set.
400 26032 The current candidate issuer certificate was rejected because its keyUsage extension does not permit certificate signing.
400 26033 An application specific error. Unused.
400 26034 An error occurred during certificate verification.
400 26035 Not found memberNo OR certificateName. Please check your input parameter.
400 26036 Not found memberNo OR certificateName OR privateKey OR publicKeyCertificate. Please check your input parameter.
400 26037 Certificate is being used in another loadBalancer.
400 26038 The certificate name required for SSL/HTTPS. Please check your input parameter.
400 26042 Proxy protocol can be set only with TCP, SSL protocols.

  • 요청

    ${LOADBALANCER_API_URL}?action=createLoadBalancerInstance
    &loadBalancerRuleList.1.l7HealthCheckPath=%2Fl7check.html
    &loadBalancerRuleList.1.loadBalancerPort=80
    &loadBalancerRuleList.1.protocolTypeCode=HTTPS
    &loadBalancerRuleList.1.serverPort=80
    &loadBalancerRuleList.2.loadBalancerPort=81
    &loadBalancerRuleList.2.protocolTypeCode=TCP
    &loadBalancerRuleList.2.serverPort=81
    &AUTHPARAMS
    
  • 응답

    <createLoadBalancerInstanceResponse>
      <requestId>752505be-d8c6-420a-872f-52f4a4b69872</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <loadBalancerInstanceList>
        <loadBalancerInstance>
          <loadBalancerInstanceNo>68017</loadBalancerInstanceNo>
          <virtualIp/>
          <loadBalancerName>loadb-7f87189e14fa43f</loadBalancerName>
          <loadBalancerAlgorithmType>
            <code>RR</code>
            <codeName>Round Robin</codeName>
          </loadBalancerAlgorithmType>
          <loadBalancerDescription/>
          <createDate>2014-02-18T21:03:26+0900</createDate>
          <domainName>slb-68017.sl2.ncloud.com</domainName>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <loadBalancerInstanceStatusName>creating</loadBalancerInstanceStatusName>
          <loadBalancerInstanceStatus>
            <code>INIT</code>
            <codeName>NET INIT state</codeName>
          </loadBalancerInstanceStatus>
          <loadBalancerInstanceOperation>
            <code>USE</code>
            <codeName>NET USE OP</codeName>
          </loadBalancerInstanceOperation>
          <networkUsageType>
            <code>PBLIP</code>
            <codeName>Public</codeName>
          </networkUsageType>
          <loadBalancerRuleList>
            <loadBalancerRule>
              <protocolType>
                <code>HTTPS</code>
                <codeName>http</codeName>
              </protocolType>
              <loadBalancerPort>80</loadBalancerPort>
              <serverPort>80</serverPort>
              <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
              <certificateName>my-ssl</certificateName>
            </loadBalancerRule>
            <loadBalancerRule>
              <protocolType>
                <code>TCP</code>
                <codeName>tcp</codeName>
              </protocolType>
              <loadBalancerPort>81</loadBalancerPort>
              <serverPort>81</serverPort>
              <l7HealthCheckPath/>
              <certificateName/>
            </loadBalancerRule>
          </loadBalancerRuleList>
          <loadBalancedServerInstanceList/>
        </loadBalancerInstance>
      </loadBalancerInstanceList>
    </createLoadBalancerInstanceResponse>
    

changeLoadBalancerInstanceConfiguration

API명

로드밸런서 인스턴스 설정 변경

설명

로드밸런서 인스턴스의 설정값을 변경합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
loadBalancerInstanceNo 로드밸런서 인스턴스 번호 String Yes
loadBalancerAlgorithmTypeCode 로드밸런서 알고리즘 구분 코드 String Min : 1,
Max : 5
Yes
loadBalancerDescription 로드밸런서 설명 String Min : 1,
Max : 1000
No
loadBalancerRuleList.N.protocolTypeCode 로드밸런서 룰 리스트.N.프로토콜 구분 코드 String Min : 1,
Max : 5
Yes
loadBalancerRuleList.N.loadBalancerPort 로드밸런서 룰 리스트.N.로드밸런서 포트 Integer Min : 1,
Max : 65534
Yes
loadBalancerRuleList.N.serverPort 로드밸런서 룰 리스트.N.서버 포트 Integer Min : 1,
Max : 65534
Yes
loadBalancerRuleList.N.l7HealthCheckPath 로드밸런서 룰 리스트.N.헬스 체크 경로 String Min : 1,
Max : 600
Conditional
loadBalancerRuleList.N.certificateName 로드밸런서 룰 리스트.N.인증서명 String Min : 1,
Max : 300
Conditional
  • loadBalancerInstanceNo
    설정을 변경할 로드밸런서 인스턴스 번호
    getLoadBalacerInstanceList 액션을 통해서 인스턴스 번호를 알 수 있습니다.

  • loadBalancerAlgorithmTypeCode
    로드밸런서 알고리즘 구분 코드
    입력 가능한 알고리즘은 다음과 같습니다.

    • ROUND ROBIN (RR), LEAST_CONNECTION (LC)
  • loadBalancerDescription
    수정할 로드밸런서 설명

  • loadBalancerRuleList.N.protocolTypeCode
    로드밸런서 룰의 프로토콜 구분 코드
    입력 가능한 프로토콜 구분 코드는 다음과 같습니다.

    • HTTP | TCP
  • loadBalancerRuleList.N.loadBalancerPort
    로드밸런서 룰의 로드밸런서 포트

  • loadBalancerRuleList.N.serverPort
    로드밸런서 룰의 서버 포트

  • loadBalancerRuleList.N.l7HealthCheckPath
    로드밸런서 룰의 헬스 체크 경로
    loadBalancerRuleList.N.protocolTypeCode 값이 HTTP인 경우에는 필수 항목입니다.

  • loadBalancerRuleList.N.certificateName
    로드밸런서 룰의 SSL 공인인증서
    loadBalancerRuleList.N.protocloTypeCode 값이 SSL/HTTPS인 경우에는 필수 항목입니다.

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private String loadBalancerName;
private String loadBalancerName;
private CommonCode loadBalancerAlgorithmType;
private String loadBalancerDescription;
private Date createDate;
private String domainName;
private CommonCode internetLineType;
private CommonCode networkUsageType;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private List loadBalancerRuleList;
private List loadBalancedServerInstanceList;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 23011 We are sorry that {0} cannot be used for load balancer ports since the ports are in use for load balancer management.
400 24063 The number of load balancer settings has been exceeded.
400 24064 The range of usable {0} port is from 1 to 66534.
400 24065 {0} Duplicated port number. Port number : {1}
400 24066 When setting load balancer, Health Check route must be configured to HTTP protocol.
400 24099 When setting load balancer, Health Check route must be configured to HTTP or HTTPS protocol.
400 24109 The input parameter instance number is invalid
400 24123 The input parameter load balancer instance number is invalid.
400 24130 The input parameter load balancing algorithm is invalid.
400 24131 The field {0} in the load balancer rule parameter is invalid.
400 24132 The field healthCheckPath in the load balancer rule parameter is invalid. If the protocol is HTTP, it is required. it must start with slash('/') and contain no blank.
400 24133 The field healthCheckPath in the load balancer rule parameter is invalid. If the protocol is NOT HTTP, it must not be specified.
400 24134 The number of input parameter load balancer rules is the minimum of 1, maximum of 5.
400 25027 You may not change since (other) user is operating the target load balance.
400 25050 (Other)Unable to operate load balancer since use is manipulating the applying server.
400 26002 The issuer certificate of a looked up certificate could not be found. This normally means the list of trusted certificates is not complete.
400 26003 The CRL of a certificate could not be found.
400 26004 The certificate signature could not be decrypted. This means that the actual signature value could not be determined rather than it not matching the expected value, this is only meaningful for RSA keys.
400 26005 The CRL signature could not be decrypted: this means that the actual signature value could not be determined rather than it not matching the expected value. Unused.
400 26006 The public key in the certificate SubjectPublicKeyInfo could not be read.
400 26007 The signature of the certificate is invalid.
400 26008 The signature of the certificate is invalid.
400 26009 The certificate is not yet valid: the notBefore date is after the current time.
400 26010 The certificate has expired: that is the notAfter date is before the current time.
400 26011 The CRL is not yet valid.
400 26012 The CRL has expired.
400 26013 The certificate notBefore field contains an invalid time.
400 26014 The certificate notAfter field contains an invalid time.
400 26015 The CRL lastUpdate field contains an invalid time.
400 26016 The CRL nextUpdate field contains an invalid time.
400 26017 An error occurred trying to allocate memory. This should never happen.
400 26018 The passed certificate is self signed and the same certificate cannot be found in the list of trusted certificates.
400 26019 The certificate chain could be built up using the untrusted certificates but the root could not be found locally.
400 26020 The issuer certificate could not be found: this occurs if the issuer certificate of an untrusted certificate cannot be found.
400 26021 No signatures could be verified because the chain contains only one certificate and it is not self signed.
400 26022 The certificate chain length is greater than the supplied maximum depth. Unused.
400 26023 The certificate has been revoked.
400 26024 A CA certificate is invalid. Either it is not a CA or its extensions are not consistent with the supplied purpose.
400 26025 The basicConstraints pathlength parameter has been exceeded.
400 26026 The supplied certificate cannot be used for the specified purpose.
400 26027 The root CA is not marked as trusted for the specified purpose.
400 26028 The root CA is marked to reject the specified purpose.
400 26029 The current candidate issuer certificate was rejected because its subject name did not match the issuer name of the current certificate. Only displayed when the -issuer_checks option is set.
400 26030 The current candidate issuer certificate was rejected because its subject key identifier was present and did not match the authority key identifier current certificate. Only displayed when the -issuer_checks option is set.
400 26031 The current candidate issuer certificate was rejected because its issuer name and serial number was present and did not match the authority key identifier of the current certificate. Only displayed when the -issuer_checks option is set.
400 26032 The current candidate issuer certificate was rejected because its keyUsage extension does not permit certificate signing.
400 26033 An application specific error. Unused.
400 26034 An error occurred during certificate verification.
400 26035 Not found memberNo OR certificateName. Please check your input parameter.
400 26036 Not found memberNo OR certificateName OR privateKey OR publicKeyCertificate. Please check your input parameter.
400 26037 Certificate is being used in another loadBalancer.
400 26038 The certificate name required for SSL/HTTPS. Please check your input parameter.
400 26042 Proxy protocol can be set only with TCP, SSL protocols.

  • 요청

    ${LOADBALANCER_API_URL}?action=changeLoadBalancerInstanceConfiguration
    &loadBalancerAlgorithmTypeCode=RR
    &loadBalancerInstanceNo=68017
    &loadBalancerRuleList.1.l7HealthCheckPath=%2Fl7check.html
    &loadBalancerRuleList.1.loadBalancerPort=88
    &loadBalancerRuleList.1.protocolTypeCode=HTTP
    &loadBalancerRuleList.1.serverPort=88
    &AUTHPARAMS
    
  • 응답

    <changeLoadBalancerInstanceConfigurationResponse>
    <requestId>be2f23ba-e042-4793-9aa7-23d8fbf702bd</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <loadBalancerInstanceList>
      <loadBalancerInstance>
        <loadBalancerInstanceNo>68017</loadBalancerInstanceNo>
        <virtualIp/>
        <loadBalancerName>loadb-7f87189e14fa43f</loadBalancerName>
        <loadBalancerAlgorithmType>
          <code>RR</code>
          <codeName>Round Robin</codeName>
        </loadBalancerAlgorithmType>
        <loadBalancerDescription/>
        <createDate>2014-02-18T21:03:26+0900</createDate>
        <domainName>slb-68017.sl2.ncloud.com</domainName>
        <internetLineType>
          <code>PUBLC</code>
          <codeName>Public</codeName>
        </internetLineType>
        <loadBalancerInstanceStatusName>changing</loadBalancerInstanceStatusName>
        <loadBalancerInstanceStatus>
          <code>USED</code>
          <codeName>NET USED state</codeName>
        </loadBalancerInstanceStatus>
        <loadBalancerInstanceOperation>
          <code>CHANG</code>
          <codeName>NET CHANGE OP</codeName>
        </loadBalancerInstanceOperation>
        <networkUsageType>
          <code>PBLIP</code>
          <codeName>Public</codeName>
        </networkUsageType>
        <loadBalancerRuleList>
          <loadBalancerRule>
            <protocolType>
              <code>HTTP</code>
              <codeName>http</codeName>
            </protocolType>
            <loadBalancerPort>88</loadBalancerPort>
            <serverPort>88</serverPort>
            <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
            <certificateName/>
          </loadBalancerRule>
        </loadBalancerRuleList>
        <loadBalancedServerInstanceList/>
      </loadBalancerInstance>
    </loadBalancerInstanceList>
    </changeLoadBalancerInstanceConfigurationResponse>
    

getLoadBalancedServerInstanceList

API명

로드밸런서에 바인드된 서버 인스턴스 리스트 조회

설명

로드밸런서에 바인드된 서버 인스턴스 리스트를 조회합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
loadBalancerInstanceNo 로드밸런서 인스턴스 번호 String Yes
  • loadBalancerInstanceNo
    바인드 대상이 되는 로드밸런서 인스턴스 번호
    getLoadBalancerInstanceList 액션을 통해 인스턴스 번호를 알 수 있습니다.

응답 데이터 타입

  • ServerInstanceList 타입
ServerInstanceList extends CommonResponse
private Integer totalRows;
private List serverInstanceList = new ArrayList();
ServerInstance
private String serverInstanceNo;
private String serverName;
private String serverDescription;
private Integer cpuCount;
private Long memorySize;
private Long baseBlockStorageSize;
private CommonCode platformType;
private String loginKeyName;
private Boolean isFeeChargingMonitoring;
private String publicIp;
private String privateIp;
private String serverImageName;
private CommonCode serverInstanceStatus;
private CommonCode serverInstanceOperation;
private String serverInstanceStatusName;
private Date createDate;
private Date uptime;
private String serverImageProductCode;
private String serverProductCode;
private Boolean isProtectServerTermination;
private String portForwardingPublicIp;
private Integer portForwardingExternalPort;
private Integer portForwardingInternalPort;
private Zone zone;
private CommonCode baseBlockStorageDiskType;
private CommonCode internetLineType;
private String userData;
List accessControlGroupList

오류

  • 요청

    ${LOADBALANCER_API_URL}?action=getLoadBalancedServerInstanceList
    &loadBalancerInstanceNo=67668&
    &AUTHPARAMS
    
  • 응답

    <getLoadBalancedServerInstanceListResponse>
      <requestId>b0f63f6c-7ec6-4bbe-a29a-61d6804b875b</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <serverInstanceList>
        <serverInstance>
          <serverInstanceNo>67953</serverInstanceNo>
          <serverName>myserver</serverName>
          <serverDescription/>
          <cpuCount>2</cpuCount>
          <memorySize>4294967296</memorySize>
          <baseBlockStorageSize>53687091200</baseBlockStorageSize>
          <platformType>
            <code>LNX32</code>
            <codeName>Linux 32 Bit</codeName>
          </platformType>
          <loginKeyName>hkey-0217</loginKeyName>
          <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
          <publicIp/>
          <privateIp>10.101.5.105</privateIp>
          <serverImageName>centos-6.3-32</serverImageName>
          <serverInstanceStatus>
            <code>NSTOP</code>
            <codeName>Server normal stopped state</codeName>
          </serverInstanceStatus>
          <serverInstanceOperation>
            <code>NULL</code>
            <codeName>Server NULL OP</codeName>
          </serverInstanceOperation>
          <serverInstanceStatusName>stopped</serverInstanceStatusName>
          <createDate>2014-02-17T18:04:49+0900</createDate>
          <uptime>2014-02-18T14:58:26+0900</uptime>
          <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
          <serverProductCode>SPSVRSTAND000043</serverProductCode>
          <isProtectServerTermination>false</isProtectServerTermination>
          <portForwardingPublicIp/>
          <zone>
            <zoneNo>3</zoneNo>
            <zoneName>zone3</zoneName>
            <zoneDescription>nang zone2</zoneDescription>
          </zone>
          <baseBlockStorageDiskType>
            <code>LOCAL</code>
            <codeName>Local storage</codeName>
          </baseBlockStorageDiskType>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <userData/>
          <accessControlGroupList>
            <accessControlGroup>
              <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
              <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
              <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
              <isDefault>true</isDefault>
              <createDate>2013-12-03T10:37:39+0900</createDate>
            </accessControlGroup>
          </accessControlGroupList>
        </serverInstance>
      </serverInstanceList>
    </getLoadBalancedServerInstanceListResponse>
    

changeLoadBalancedServerInstances

API명

로드밸런서에 바인드된 서버 인스턴스 변경

설명

로드밸런서에 바인드된 서버 인스턴스를 변경합니다. 기존 바인드된 정보를 무시하고 새로 바인드하는 기능입니다. 바인드/언바인드할 서버 인스턴스가 많은 경우 사용합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
loadBalancerInstanceNo 로드밸런서 인스턴스 번호 String Yes
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String 중복 불가 Yes
  • loadBalancerInstanceNo
    변경할 로드밸런서 인스턴스 번호

  • serverInstanceNoList.N
    로드밸런서에 바인드할 서버 인스턴스 번호 리스트

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private String loadBalancerName;
private String loadBalancerName;
private CommonCode loadBalancerAlgorithmType;
private String loadBalancerDescription;
private Date createDate;
private String domainName;
private CommonCode internetLineType;
private CommonCode networkUsageType;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private List loadBalancerRuleList;
private List loadBalancedServerInstanceList;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 24091 No IP address is assigned to the server instance (no. {0}).
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 24123 The input parameter load balancer instance number is invalid.
400 25027 You may not change since (other) user is operating the target load balancer.
400 25050 (Other)Unable to operate load balancer since use is manipulating the applying server.

  • 요청

    ${LOADBALANCER_API_URL}?action=changeLoadBalancedServerInstances
    &loadBalancerInstanceNo=68017
    &serverInstanceNoList.1=67953
    &AUTHPARAMS
    
  • 응답

    <changeLoadBalancedServerInstancesResponse>
      <requestId>4a4e4ef0-d125-4760-ab69-4afec00bd19f</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <loadBalancerInstanceList>
        <loadBalancerInstance>
          <loadBalancerInstanceNo>68017</loadBalancerInstanceNo>
          <virtualIp/>
          <loadBalancerName>loadb-7f87189e14fa43f</loadBalancerName>
          <loadBalancerAlgorithmType>
            <code>RR</code>
            <codeName>Round Robin</codeName>
          </loadBalancerAlgorithmType>
          <loadBalancerDescription/>
          <createDate>2014-02-18T21:03:26+0900</createDate>
          <domainName>slb-68017.sl2.ncloud.com</domainName>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <loadBalancerInstanceStatusName>changing</loadBalancerInstanceStatusName>
          <loadBalancerInstanceStatus>
            <code>USED</code>
            <codeName>NET USED state</codeName>
          </loadBalancerInstanceStatus>
          <loadBalancerInstanceOperation>
            <code>CHANG</code>
            <codeName>NET CHANGE OP</codeName>
          </loadBalancerInstanceOperation>
          <networkUsageType>
            <code>PBLIP</code>
            <codeName>Public</codeName>
          </networkUsageType>
          <loadBalancerRuleList>
            <loadBalancerRule>
              <protocolType>
                <code>HTTP</code>
                <codeName>http</codeName>
              </protocolType>
              <loadBalancerPort>88</loadBalancerPort>
              <serverPort>88</serverPort>
              <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
              <certificateName/>
            </loadBalancerRule>
          </loadBalancerRuleList>
          <loadBalancedServerInstanceList>
            <loadBalancedServerInstance>
              <serverInstance>
                <serverInstanceNo>67953</serverInstanceNo>
                <serverName>myserver</serverName>
                <serverDescription/>
                <cpuCount>2</cpuCount>
                <memorySize>4294967296</memorySize>
                <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                <platformType>
                  <code>LNX32</code>
                  <codeName>Linux 32 Bit</codeName>
                </platformType>
                <loginKeyName>hkey-0217</loginKeyName>
                <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                <publicIp/>
                <privateIp>10.101.5.105</privateIp>
                <serverImageName>centos-6.3-32</serverImageName>
                <serverInstanceStatus>
                  <code>NSTOP</code>
                  <codeName>Server normal stopped state</codeName>
                </serverInstanceStatus>
                <serverInstanceOperation>
                  <code>NULL</code>
                  <codeName>Server NULL OP</codeName>
                </serverInstanceOperation>
                <serverInstanceStatusName>stopped</serverInstanceStatusName>
                <createDate>2014-02-17T18:04:49+0900</createDate>
                <uptime>2014-02-18T14:58:26+0900</uptime>
                <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
                <serverProductCode>SPSVRSTAND000043</serverProductCode>
                <isProtectServerTermination>false</isProtectServerTermination>
                <portForwardingPublicIp/>
                <zone>
                  <zoneNo>3</zoneNo>
                  <zoneName>zone3</zoneName>
                  <zoneDescription>nang zone2</zoneDescription>
                </zone>
                <baseBlockStorageDiskType>
                  <code>LOCAL</code>
                  <codeName>Local storage</codeName>
                </baseBlockStorageDiskType>
                <userData/>
                <accessControlGroupList>
                  <accessControlGroup>
                    <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                    <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                    <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                    <isDefault>true</isDefault>
                    <createDate>2013-12-03T10:37:39+0900</createDate>
                  </accessControlGroup>
                </accessControlGroupList>
              </serverInstance>
              <serverHealthCheckStatusList>
                <serverHealthCheckStatus>
                  <serverPort>88</serverPort>
                  <serverStatus>false</serverStatus>
                </serverHealthCheckStatus>
              </serverHealthCheckStatusList>
            </loadBalancedServerInstance>
          </loadBalancedServerInstanceList>
        </loadBalancerInstance>
      </loadBalancerInstanceList>
    </changeLoadBalancedServerInstancesResponse>
    

addServerInstancesToLoadBalancer

API명

로드밸런서에 서버 인스턴스를 추가(바인드)

설명

로드밸런서에 서버 인스턴스를 추가(바인드)합니다. 기존 바인드된 서버 인스턴스에 추가로 서버 인스턴스를 바인드하는 기능입니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
loadBalancerInstanceNo 로드밸런서 인스턴스 번호 String Yes
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String 중복 불가 Yes
  • loadBalancerInstanceNo
    바인드 대상이 되는 로드밸런서 인스턴스 번호

  • serverInstanceNoList.N
    로드밸런서에 추가(바인드)할 서버 인스턴스 번호 리스트

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private String loadBalancerName;
private String loadBalancerName;
private CommonCode loadBalancerAlgorithmType;
private String loadBalancerDescription;
private Date createDate;
private String domainName;
private CommonCode internetLineType;
private CommonCode networkUsageType;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private List loadBalancerRuleList;
private List loadBalancedServerInstanceList;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 24091 No IP address is assigned to the server instance (no. {0}).
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 24123 The input parameter load balancer instance number is invalid.
400 24135 The server instance number {0} passed as input parameter has been already added to the load balancer.
400 25027 You may not change since (other) user is operating the target load balance.
400 25050 (Other)Unable to operate load balancer since use is manipulating the applying server.

  • 요청

    ${LOADBALANCER_API_URL}?action=changeLoadBalancedServerInstances
    &loadBalancerInstanceNo=68017
    &serverInstanceNoList.1=67953
    &AUTHPARAMS
    
  • 응답

    <addServerInstancesToLoadBalancerResponse>
      <requestId>745c17cb-4526-4308-b7c0-1ff478251cfd</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <loadBalancerInstanceList>
        <loadBalancerInstance>
          <loadBalancerInstanceNo>68017</loadBalancerInstanceNo>
          <virtualIp/>
          <loadBalancerName>loadb-7f87189e14fa43f</loadBalancerName>
          <loadBalancerAlgorithmType>
            <code>RR</code>
            <codeName>Round Robin</codeName>
          </loadBalancerAlgorithmType>
          <loadBalancerDescription/>
          <createDate>2014-02-18T21:03:26+0900</createDate>
          <domainName>slb-68017.sl2.ncloud.com</domainName>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <loadBalancerInstanceStatusName>changing</loadBalancerInstanceStatusName>
          <loadBalancerInstanceStatus>
            <code>USED</code>
            <codeName>NET USED state</codeName>
          </loadBalancerInstanceStatus>
          <loadBalancerInstanceOperation>
            <code>CHANG</code>
            <codeName>NET CHANGE OP</codeName>
          </loadBalancerInstanceOperation>
          <networkUsageType>
            <code>PBLIP</code>
            <codeName>Public</codeName>
          </networkUsageType>
          <loadBalancerRuleList>
            <loadBalancerRule>
              <protocolType>
                <code>HTTP</code>
                <codeName>http</codeName>
              </protocolType>
              <loadBalancerPort>88</loadBalancerPort>
              <serverPort>88</serverPort>
              <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
              <certificateName/>
            </loadBalancerRule>
          </loadBalancerRuleList>
          <loadBalancedServerInstanceList>
            <loadBalancedServerInstance>
              <serverInstance>
                <serverInstanceNo>67943</serverInstanceNo>
                <serverName>svr-7f86d867d343949</serverName>
                <serverDescription>Auto scaling group 'asg-0212' 소속의 자동 생성된 서버</serverDescription>
                <cpuCount>2</cpuCount>
                <memorySize>4294967296</memorySize>
                <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                <platformType>
                  <code>LNX32</code>
                  <codeName>Linux 32 Bit</codeName>
                </platformType>
                <loginKeyName>yh-nang-test</loginKeyName>
                <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                <publicIp/>
                <privateIp>10.101.5.109</privateIp>
                <serverImageName>centos-5.7-32-cnc1</serverImageName>
                <serverInstanceStatus>
                  <code>RUN</code>
                  <codeName>Server run state</codeName>
                </serverInstanceStatus>
                <serverInstanceOperation>
                  <code>NULL</code>
                  <codeName>Server NULL OP</codeName>
                </serverInstanceOperation>
                <serverInstanceStatusName>running</serverInstanceStatusName>
                <createDate>2014-02-17T13:30:28+0900</createDate>
                <uptime>2014-02-17T13:37:30+0900</uptime>
                <serverImageProductCode>SPSW0LINUX000009</serverImageProductCode>
                <serverProductCode>SPSVRSTAND000043</serverProductCode>
                <isProtectServerTermination>false</isProtectServerTermination>
                <portForwardingPublicIp/>
                <zone>
                  <zoneNo>3</zoneNo>
                  <zoneName>zone3</zoneName>
                  <zoneDescription>nang zone2</zoneDescription>
                </zone>
                <baseBlockStorageDiskType>
                  <code>LOCAL</code>
                  <codeName>Local storage</codeName>
                </baseBlockStorageDiskType>
                <internetLineType>
                  <code>PUBLC</code>
                  <codeName>Public</codeName>
                </internetLineType>
                <userData/>
                <accessControlGroupList>
                  <accessControlGroup>
                    <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                    <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                    <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                    <isDefault>true</isDefault>
                    <createDate>2013-12-03T10:37:39+0900</createDate>
                  </accessControlGroup>
                </accessControlGroupList>
              </serverInstance>
              <serverHealthCheckStatusList>
                <serverHealthCheckStatus>
                  <serverPort>88</serverPort>
                  <serverStatus>false</serverStatus>
                </serverHealthCheckStatus>
              </serverHealthCheckStatusList>
            </loadBalancedServerInstance>
            <loadBalancedServerInstance>
              <serverInstance>
                <serverInstanceNo>67953</serverInstanceNo>
                <serverName>myserver</serverName>
                <serverDescription/>
                <cpuCount>2</cpuCount>
                <memorySize>4294967296</memorySize>
                <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                <platformType>
                  <code>LNX32</code>
                  <codeName>Linux 32 Bit</codeName>
                </platformType>
                <loginKeyName>hkey-0217</loginKeyName>
                <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                <publicIp/>
                <privateIp>10.101.5.105</privateIp>
                <serverImageName>centos-6.3-32</serverImageName>
                <serverInstanceStatus>
                  <code>NSTOP</code>
                  <codeName>Server normal stopped state</codeName>
                </serverInstanceStatus>
                <serverInstanceOperation>
                  <code>NULL</code>
                  <codeName>Server NULL OP</codeName>
                </serverInstanceOperation>
                <serverInstanceStatusName>stopped</serverInstanceStatusName>
                <createDate>2014-02-17T18:04:49+0900</createDate>
                <uptime>2014-02-18T14:58:26+0900</uptime>
                <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
                <serverProductCode>SPSVRSTAND000043</serverProductCode>
                <isProtectServerTermination>false</isProtectServerTermination>
                <portForwardingPublicIp/>
                <zone>
                  <zoneNo>3</zoneNo>
                  <zoneName>zone3</zoneName>
                  <zoneDescription>nang zone2</zoneDescription>
                </zone>
                <baseBlockStorageDiskType>
                  <code>LOCAL</code>
                  <codeName>Local storage</codeName>
                </baseBlockStorageDiskType>
                <internetLineType>
                  <code>PUBLC</code>
                  <codeName>Public</codeName>
                </internetLineType>
                <userData/>
                <accessControlGroupList>
                  <accessControlGroup>
                    <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                    <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                    <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                    <isDefault>true</isDefault>
                    <createDate>2013-12-03T10:37:39+0900</createDate>
                  </accessControlGroup>
                </accessControlGroupList>
              </serverInstance>
              <serverHealthCheckStatusList>
                <serverHealthCheckStatus>
                  <serverPort>88</serverPort>
                  <serverStatus>false</serverStatus>
                </serverHealthCheckStatus>
              </serverHealthCheckStatusList>
            </loadBalancedServerInstance>
          </loadBalancedServerInstanceList>
        </loadBalancerInstance>
      </loadBalancerInstanceList>
    </addServerInstancesToLoadBalancerResponse>
    

deleteServerInstancesFromLoadBalancer

API명

로드밸런서에 서버 인스턴스를 삭제(언바인드)

설명

로드밸런서에 서버 인스턴스를 삭제(언바인드)합니다. 입력된 서버 인스턴스 번호에 해당하는 서버만 삭제(언바인드)하는 기능입니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
loadBalancerInstanceNo 로드밸런서 인스턴스 번호 String Yes
serverInstanceNoList.N 서버 인스턴스 번호 리스트 String 중복 불가 Yes
  • loadBalancerInstanceNo
    대상이 되는 로드밸런서 인스턴스 번호

  • serverInstanceNoList.N
    로드밸런서에 추가(바인드)할 서버 인스턴스 번호 리스트

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private String loadBalancerName;
private String loadBalancerName;
private CommonCode loadBalancerAlgorithmType;
private String loadBalancerDescription;
private Date createDate;
private String domainName;
private CommonCode internetLineType;
private CommonCode networkUsageType;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private List loadBalancerRuleList;
private List loadBalancedServerInstanceList;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 24091 No IP address is assigned to the server instance (no. {0}).
400 24109 The input parameter instance number is invalid
400 24120 The input parameter server instance number is invalid.
400 24123 The input parameter load balancer instance number is invalid.
400 24136 The server instance number {0} passed as input parameter has been already deleted from the load balancer.
400 25027 You may not change since (other) user is operating the target load balance.
400 25050 (Other)Unable to operate load balancer since use is manipulating the applying server.

  • 요청

    ${LOADBALANCER_API_URL}?action=deleteServerInstancesFromLoadBalancer
    &loadBalancerInstanceNo=68017
    &serverInstanceNoList.1=67920
    &AUTHPARAMS
    
  • 응답

    <deleteServerInstancesFromLoadBalancerResponse>
      <requestId>8fcc7d14-c662-4dba-b5a3-ff0797487de4</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <loadBalancerInstanceList>
        <loadBalancerInstance>
          <loadBalancerInstanceNo>68017</loadBalancerInstanceNo>
          <virtualIp/>
          <loadBalancerName>loadb-7f87189e14fa43f</loadBalancerName>
          <loadBalancerAlgorithmType>
            <code>RR</code>
            <codeName>Round Robin</codeName>
          </loadBalancerAlgorithmType>
          <loadBalancerDescription/>
          <createDate>2014-02-18T21:03:26+0900</createDate>
          <domainName>slb-68017.sl2.ncloud.com</domainName>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <loadBalancerInstanceStatusName>changing</loadBalancerInstanceStatusName>
          <loadBalancerInstanceStatus>
            <code>USED</code>
            <codeName>NET USED state</codeName>
          </loadBalancerInstanceStatus>
          <loadBalancerInstanceOperation>
            <code>CHANG</code>
            <codeName>NET CHANGE OP</codeName>
          </loadBalancerInstanceOperation>
          <networkUsageType>
            <code>PBLIP</code>
            <codeName>Public</codeName>
          </networkUsageType>
          <loadBalancerRuleList>
            <loadBalancerRule>
              <protocolType>
                <code>HTTP</code>
                <codeName>http</codeName>
              </protocolType>
              <loadBalancerPort>88</loadBalancerPort>
              <serverPort>88</serverPort>
              <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
              <certificateName/>
            </loadBalancerRule>
          </loadBalancerRuleList>
          <loadBalancedServerInstanceList>
            <loadBalancedServerInstance>
              <serverInstance>
                <serverInstanceNo>67953</serverInstanceNo>
                <serverName>myserver</serverName>
                <serverDescription/>
                <cpuCount>2</cpuCount>
                <memorySize>4294967296</memorySize>
                <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                <platformType>
                  <code>LNX32</code>
                  <codeName>Linux 32 Bit</codeName>
                </platformType>
                <loginKeyName>hkey-0217</loginKeyName>
                <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                <publicIp/>
                <privateIp>10.101.5.105</privateIp>
                <serverImageName>centos-6.3-32</serverImageName>
                <serverInstanceStatus>
                  <code>NSTOP</code>
                  <codeName>Server normal stopped state</codeName>
                </serverInstanceStatus>
                <serverInstanceOperation>
                  <code>NULL</code>
                  <codeName>Server NULL OP</codeName>
                </serverInstanceOperation>
                <serverInstanceStatusName>stopped</serverInstanceStatusName>
                <createDate>2014-02-17T18:04:49+0900</createDate>
                <uptime>2014-02-18T14:58:26+0900</uptime>
                <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
                <serverProductCode>SPSVRSTAND000043</serverProductCode>
                <isProtectServerTermination>false</isProtectServerTermination>
                <portForwardingPublicIp/>
                <zone>
                  <zoneNo>3</zoneNo>
                  <zoneName>zone3</zoneName>
                  <zoneDescription>nang zone2</zoneDescription>
                </zone>
                <baseBlockStorageDiskType>
                  <code>LOCAL</code>
                  <codeName>Local storage</codeName>
                </baseBlockStorageDiskType>
                <internetLineType>
                  <code>PUBLC</code>
                  <codeName>Public</codeName>
                </internetLineType>
                <userData/>
                <accessControlGroupList>
                  <accessControlGroup>
                    <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                    <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                    <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                    <isDefault>true</isDefault>
                    <createDate>2013-12-03T10:37:39+0900</createDate>
                  </accessControlGroup>
                </accessControlGroupList>
              </serverInstance>
              <serverHealthCheckStatusList>
                <serverHealthCheckStatus>
                  <serverPort>88</serverPort>
                  <serverStatus>false</serverStatus>
                </serverHealthCheckStatus>
              </serverHealthCheckStatusList>
            </loadBalancedServerInstance>
          </loadBalancedServerInstanceList>
        </loadBalancerInstance>
      </loadBalancerInstanceList>
    </deleteServerInstancesFromLoadBalancerResponse>
    

deleteLoadBalancerInstances

API명

로드밸런서 인스턴스 삭제

설명

로드밸런서 인스턴스를 삭제합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
loadBalancerInstanceNoList.N 로드밸런서 인스턴스 번호 리스트 String 중복 불가 Yes
  • loadBalancerInstanceNoList.N
    삭제할 로드밸런서 인스턴스 번호 리스트
    getLoadBalancerInstanceList 액션을 통해서 획득할 수 있습니다.

응답 데이터 타입

  • LoadBalancerInstanceList 타입
LoadBalancerInstanceList extends CommonResponse
private Integer totalRows;
private List loadBalancerInstanceList = new ArrayList();
LoadBalancerInstance
private String loadBalancerInstanceNo;
private String loadBalancerName;
private String loadBalancerName;
private CommonCode loadBalancerAlgorithmType;
private String loadBalancerDescription;
private Date createDate;
private String domainName;
private CommonCode internetLineType;
private CommonCode networkUsageType;
private CommonCode loadBalancerInstanceStatus;
private CommonCode loadBalancerInstanceOperation;
private String loadBalancerInstanceStatusName;
private List loadBalancerRuleList;
private List loadBalancedServerInstanceList;

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 10713 Not found contract information. Please check your input parameter.
400 24109 The input parameter instance number is invalid
400 24123 The input parameter load balancer instance number is invalid.
400 25026 You may not delete since (other) user is operating the target load balance.
400 25050 (Other)Unable to operate load balancer since use is manipulating the applying server.

  • 요청

    ${LOADBALANCER_API_URL}?action=deleteLoadBalancerInstances
    &loadBalancerInstanceNoList.1=68017
    &AUTHPARAMS
    
  • 응답

    <deleteLoadBalancerInstancesResponse>
      <requestId>e191af19-2504-4688-b0fa-9fd8e2bdd4e8</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
      <totalRows>1</totalRows>
      <loadBalancerInstanceList>
        <loadBalancerInstance>
          <loadBalancerInstanceNo>68017</loadBalancerInstanceNo>
          <virtualIp/>
          <loadBalancerName>loadb-7f87189e14fa43f</loadBalancerName>
          <loadBalancerAlgorithmType>
            <code>RR</code>
            <codeName>Round Robin</codeName>
          </loadBalancerAlgorithmType>
          <loadBalancerDescription/>
          <createDate>2014-02-18T21:03:26+0900</createDate>
          <domainName>slb-68017.sl2.ncloud.com</domainName>
          <internetLineType>
            <code>PUBLC</code>
            <codeName>Public</codeName>
          </internetLineType>
          <loadBalancerInstanceStatusName>terminating</loadBalancerInstanceStatusName>
          <loadBalancerInstanceStatus>
            <code>USED</code>
            <codeName>NET USED state</codeName>
          </loadBalancerInstanceStatus>
          <loadBalancerInstanceOperation>
            <code>TERMT</code>
            <codeName>NET TERMINATED OP</codeName>
          </loadBalancerInstanceOperation>
          <networkUsageType>
            <code>PBLIP</code>
            <codeName>Public</codeName>
          </networkUsageType>
          <loadBalancerRuleList>
            <loadBalancerRule>
              <protocolType>
                <code>HTTP</code>
                <codeName>http</codeName>
              </protocolType>
              <loadBalancerPort>88</loadBalancerPort>
              <serverPort>88</serverPort>
              <l7HealthCheckPath>/l7check.html</l7HealthCheckPath>
              <certificateName/>
            </loadBalancerRule>
          </loadBalancerRuleList>
          <loadBalancedServerInstanceList>
            <loadBalancedServerInstance>
              <serverInstance>
                <serverInstanceNo>67953</serverInstanceNo>
                <serverName>myserver</serverName>
                <serverDescription/>
                <cpuCount>2</cpuCount>
                <memorySize>4294967296</memorySize>
                <baseBlockStorageSize>53687091200</baseBlockStorageSize>
                <platformType>
                  <code>LNX32</code>
                  <codeName>Linux 32 Bit</codeName>
                </platformType>
                <loginKeyName>hkey-0217</loginKeyName>
                <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
                <publicIp/>
                <privateIp>10.101.5.105</privateIp>
                <serverImageName>centos-6.3-32</serverImageName>
                <serverInstanceStatus>
                  <code>NSTOP</code>
                  <codeName>Server normal stopped state</codeName>
                </serverInstanceStatus>
                <serverInstanceOperation>
                  <code>NULL</code>
                  <codeName>Server NULL OP</codeName>
                </serverInstanceOperation>
                <serverInstanceStatusName>stopped</serverInstanceStatusName>
                <createDate>2014-02-17T18:04:49+0900</createDate>
                <uptime>2014-02-18T14:58:26+0900</uptime>
                <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
                <serverProductCode>SPSVRSTAND000043</serverProductCode>
                <isProtectServerTermination>false</isProtectServerTermination>
                <portForwardingPublicIp/>
                <zone>
                  <zoneNo>3</zoneNo>
                  <zoneName>zone3</zoneName>
                  <zoneDescription>nang zone2</zoneDescription>
                </zone>
                <baseBlockStorageDiskType>
                  <code>LOCAL</code>
                  <codeName>Local storage</codeName>
                </baseBlockStorageDiskType>
                <internetLineType>
                  <code>PUBLC</code>
                  <codeName>Public</codeName>
                </internetLineType>
                <userData/>
                <accessControlGroupList>
                  <accessControlGroup>
                    <accessControlGroupConfigurationNo>1038</accessControlGroupConfigurationNo>
                    <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
                    <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
                    <isDefault>true</isDefault>
                    <createDate>2013-12-03T10:37:39+0900</createDate>
                  </accessControlGroup>
                </accessControlGroupList>
              </serverInstance>
              <serverHealthCheckStatusList>
                <serverHealthCheckStatus>
                  <serverPort>88</serverPort>
                  <serverStatus>false</serverStatus>
                </serverHealthCheckStatus>
              </serverHealthCheckStatusList>
            </loadBalancedServerInstance>
          </loadBalancedServerInstanceList>
        </loadBalancerInstance>
      </loadBalancerInstanceList>
    </deleteLoadBalancerInstancesResponse>
    

getLoadBalancerSslCertificateList

API명

인증서 조회

설명

로드밸런서에서 사용하는 SSL 인증서를 조회합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
certificateName SSL 인증서명 String 중복 불가 No
  • certificateName
    조회 대상 로드밸런서 인증서명
    certificateName이 없는 경우 본인 소유의 전체 sslCertificateList를 조회합니다.

응답 데이터 타입

  • SslCertificateList 타입
SslCertificateList extends CommonResponse
private Integer totalRows;
private List sslCertificateList = new ArrayList();
SslCertificate
private String certificateName;
private String privateKey;
private String publicKeyCertificate;
private String certificateChain

오류

  • 요청

    ${LOADBALANCER_API_URL}?action=getLoadBalancerSslCertificateList
    &certificateName=my-s니
    &AUTHPARAMS
    
  • 응답

    <getLoadBalancerSslCertificateListResponse>
    <requestId>e191af19-2504-4688-b0fa-9fd8e2bdd4e8</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <sslCertificateList>
    <sslCertificate>
    <certificateName>my-ssl</certificateName>
    <privateKey> -----BEGIN RSA PRIVATE KEY-----
    MIICXQIBAAKBgQDVCm3rCfYeQDQW1yzWIofJtRc3wD6fft4Vm/EhFAFg77tPzCUr
    GwMEAdJ0a6mM8bTJdNAsLgS2ArqcNhwDwt/o7Vwo6Jo8faYDJzz6CFyBMXr2IRfq
    irT3ffoCq+3tL9rwQ9llP5+L+Po/k1BfaJd5Z+mTn8UG5T8Npaj4UQOYuwIDAQAB
    AoGBAIxATnbC2xW1PNWgmPLsTqq7HmrklBWahwiA3jDho7q2eIEjK4ECSmzz6iIc
    0sVoRpWt4nKDZTSR/VpjwPO08oSIywUFyh+ExL5YZ/TmMKiIurOWnQujUZTLah3y
    rfeFrCAkMLKhLMT3oreKCooIw4LEy5zDQ4PlqAX5T4icBp45AkEA+NM1GVM4N12w
    QpkWYsT3tplF5V72A81l+QUhkol/fajk/kyqcVZqE401sosab62qoHaJqIa1rb9y
    VsHYlqO5xQJBANsvETMHu/tONYoQVu75UookH6sJZ98lXvLGIJOm9BdvQscK/sfP
    VD7MQg7BLMSSIyzTmNnFKp/Z3nSW2zX3sH8CQQCECcf+lVuafbvfy07GwNDWc8VU
    byzLXb6EA0YKda5Sp0JE87fqhrmpgGCDSy+PHbASkHSCGmHkPlhVU240mdMlAkBo
    JUEi4jXr/wlphMIJ4uXZRbjWaC221eb7rDCmd9nbmL4+HXdaMaVyAVQR9q/y5w1X
    q2MhdpH+SmNtOpEGX565AkAw0iyekCbB/4QES2D49uy6glJ/0+8PGK4yT76yBBmS
    QZGpOT95XbJhHWLo+S6VT6kyeBLd4cgityGrsMRFZkA1
    -----END RSA PRIVATE KEY----- </ privateKey >
    <publicKeyCertificate> -----BEGIN CERTIFICATE-----
    MIICazCCAdQCCQDqqtCSgqvb9TANBgkqhkiG9w0BAQUFADB6MQswCQYDVQQGEwJL
    UjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEMMAoGA1UEChMDTkJQ
    MQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkqhkiG9w0BCQEWEGZh
    c3QwMkBuYXZlci5jb20wHhcNMTQwMzE4MDU0NTQxWhcNMTUwMzE4MDU0NTQxWjB6
    MQswCQYDVQQGEwJLUjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEM
    MAoGA1UEChMDTkJQMQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkq
    hkiG9w0BCQEWEGZhc3QwMkBuYXZlci5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0A
    MIGJAoGBANUKbesJ9h5ANBbXLNYih8m1FzfAPp9+3hWb8SEUAWDvu0/MJSsbAwQB
    0nRrqYzxtMl00CwuBLYCupw2HAPC3+jtXCjomjx9pgMnPPoIXIExevYhF+qKtPd9
    +gKr7e0v2vBD2WU/n4v4+j+TUF9ol3ln6ZOfxQblPw2lqPhRA5i7AgMBAAEwDQYJ
    KoZIhvcNAQEFBQADgYEAhbcSYDrEnBKuEepa35FQBlLMTVA+2RocfRZPdXV0s3i5
    5iwH/6S23Gy/nKkEXJSGhUst5HjgRJqhvHyfM2uXY8zeq0oVhGu0C3iaE49Q0Vdp
    i1pMe+14UFKW8iohI8ZU2eUL5tm0VdNtV8JPF/sagh4LLyPzrf65PwOIbtSttcY=
    -----END CERTIFICATE----- </publicKeyCertificate><certificateChain></ certificateChain>
    </sslCertificate>
    </sslCertificateList>
    </getLoadBalancerSslCertificateListResponse>
    

addLoadBalancerSslCertificate

API명

인증서 추가

설명

로드밸런서에서 사용하는 SSL 인증서를 추가합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
certificateName 인증서명 String 중복 불가 Yes
privateKey 비밀키 String 중복 불가 Yes
publicKeyCertificate 공개키 인증서 String 중복 불가 Yes
certificateChain chainca String 중복 불가 Optional
  • certificateName
    추가할 인증서명

  • privateKey
    인증서 비밀키

  • publicKeyCertificate
    공개키 인증서

  • certificateChain
    chainca 인증서(인증서 발급 시 chainca를 같이 발급받은 경우 필수)

응답 데이터 타입

  • SslCertificateList 타입
SslCertificateList extends CommonResponse
private Integer totalRows;
private List sslCertificateList = new ArrayList();
SslCertificate
private String certificateName;
private String privateKey;
private String publicKeyCertificate;
private String certificateChain

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 26036 Not found certificateName OR privateKey OR publicKeyCertificate Please check your input parameter.
400 26041 The certificate name already existent.

  • 요청

    ${LOADBALANCER_API_URL}?action=addLoadBalancerSslCertificate
    &certificateName=my-ssl-2
    &privateKey=-----BEGIN RSA PRIVATE KEY-----
    MIICXQIBAAKBgQDVCm3rCfYeQDQW1yzWIofJtRc3wD6fft4Vm/EhFAFg77tPzCUr
    GwMEAdJ0a6mM8bTJdNAsLgS2ArqcNhwDwt/o7Vwo6Jo8faYDJzz6CFyBMXr2IRfq
    irT3ffoCq+3tL9rwQ9llP5+L+Po/k1BfaJd5Z+mTn8UG5T8Npaj4UQOYuwIDAQAB
    AoGBAIxATnbC2xW1PNWgmPLsTqq7HmrklBWahwiA3jDho7q2eIEjK4ECSmzz6iIc
    0sVoRpWt4nKDZTSR/VpjwPO08oSIywUFyh+ExL5YZ/TmMKiIurOWnQujUZTLah3y
    rfeFrCAkMLKhLMT3oreKCooIw4LEy5zDQ4PlqAX5T4icBp45AkEA+NM1GVM4N12w
    QpkWYsT3tplF5V72A81l+QUhkol/fajk/kyqcVZqE401sosab62qoHaJqIa1rb9y
    VsHYlqO5xQJBANsvETMHu/tONYoQVu75UookH6sJZ98lXvLGIJOm9BdvQscK/sfP
    VD7MQg7BLMSSIyzTmNnFKp/Z3nSW2zX3sH8CQQCECcf+lVuafbvfy07GwNDWc8VU
    byzLXb6EA0YKda5Sp0JE87fqhrmpgGCDSy+PHbASkHSCGmHkPlhVU240mdMlAkBo
    JUEi4jXr/wlphMIJ4uXZRbjWaC221eb7rDCmd9nbmL4+HXdaMaVyAVQR9q/y5w1X
    q2MhdpH+SmNtOpEGX565AkAw0iyekCbB/4QES2D49uy6glJ/0+8PGK4yT76yBBmS
    QZGpOT95XbJhHWLo+S6VT6kyeBLd4cgityGrsMRFZkA1
    -----END RSA PRIVATE KEY-----
    &publicKeyCertificate=-----BEGIN CERTIFICATE-----
    MIICazCCAdQCCQDqqtCSgqvb9TANBgkqhkiG9w0BAQUFADB6MQswCQYDVQQGEwJL
    UjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEMMAoGA1UEChMDTkJQ
    MQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkqhkiG9w0BCQEWEGZh
    c3QwMkBuYXZlci5jb20wHhcNMTQwMzE4MDU0NTQxWhcNMTUwMzE4MDU0NTQxWjB6
    MQswCQYDVQQGEwJLUjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEM
    MAoGA1UEChMDTkJQMQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkq
    hkiG9w0BCQEWEGZhc3QwMkBuYXZlci5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0A
    MIGJAoGBANUKbesJ9h5ANBbXLNYih8m1FzfAPp9+3hWb8SEUAWDvu0/MJSsbAwQB
    0nRrqYzxtMl00CwuBLYCupw2HAPC3+jtXCjomjx9pgMnPPoIXIExevYhF+qKtPd9
    +gKr7e0v2vBD2WU/n4v4+j+TUF9ol3ln6ZOfxQblPw2lqPhRA5i7AgMBAAEwDQYJ
    KoZIhvcNAQEFBQADgYEAhbcSYDrEnBKuEepa35FQBlLMTVA+2RocfRZPdXV0s3i5
    5iwH/6S23Gy/nKkEXJSGhUst5HjgRJqhvHyfM2uXY8zeq0oVhGu0C3iaE49Q0Vdp
    i1pMe+14UFKW8iohI8ZU2eUL5tm0VdNtV8JPF/sagh4LLyPzrf65PwOIbtSttcY=
    -----END CERTIFICATE-----
    &certificateChain=
    &AUTHPARAMS
    
  • 응답

    <addLoadBalancerSslCertificateResponse>
    <requestId>e191af19-2504-4688-b0fa-9fd8e2bdd4e8</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>2</totalRows>
    <sslCertificateList>
    <sslCertificate>
    <certificateName>my-ssl</certificateName>
    <privateKey> -----BEGIN RSA PRIVATE KEY-----
    MIICXQIBAAKBgQDVCm3rCfYeQDQW1yzWIofJtRc3wD6fft4Vm/EhFAFg77tPzCUr
    GwMEAdJ0a6mM8bTJdNAsLgS2ArqcNhwDwt/o7Vwo6Jo8faYDJzz6CFyBMXr2IRfq
    irT3ffoCq+3tL9rwQ9llP5+L+Po/k1BfaJd5Z+mTn8UG5T8Npaj4UQOYuwIDAQAB
    AoGBAIxATnbC2xW1PNWgmPLsTqq7HmrklBWahwiA3jDho7q2eIEjK4ECSmzz6iIc
    0sVoRpWt4nKDZTSR/VpjwPO08oSIywUFyh+ExL5YZ/TmMKiIurOWnQujUZTLah3y
    rfeFrCAkMLKhLMT3oreKCooIw4LEy5zDQ4PlqAX5T4icBp45AkEA+NM1GVM4N12w
    QpkWYsT3tplF5V72A81l+QUhkol/fajk/kyqcVZqE401sosab62qoHaJqIa1rb9y
    VsHYlqO5xQJBANsvETMHu/tONYoQVu75UookH6sJZ98lXvLGIJOm9BdvQscK/sfP
    VD7MQg7BLMSSIyzTmNnFKp/Z3nSW2zX3sH8CQQCECcf+lVuafbvfy07GwNDWc8VU
    byzLXb6EA0YKda5Sp0JE87fqhrmpgGCDSy+PHbASkHSCGmHkPlhVU240mdMlAkBo
    JUEi4jXr/wlphMIJ4uXZRbjWaC221eb7rDCmd9nbmL4+HXdaMaVyAVQR9q/y5w1X
    q2MhdpH+SmNtOpEGX565AkAw0iyekCbB/4QES2D49uy6glJ/0+8PGK4yT76yBBmS
    QZGpOT95XbJhHWLo+S6VT6kyeBLd4cgityGrsMRFZkA1
    -----END RSA PRIVATE KEY----- </ privateKey >
    <publicKeyCertificate> -----BEGIN CERTIFICATE-----
    MIICazCCAdQCCQDqqtCSgqvb9TANBgkqhkiG9w0BAQUFADB6MQswCQYDVQQGEwJL
    UjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEMMAoGA1UEChMDTkJQ
    MQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkqhkiG9w0BCQEWEGZh
    c3QwMkBuYXZlci5jb20wHhcNMTQwMzE4MDU0NTQxWhcNMTUwMzE4MDU0NTQxWjB6
    MQswCQYDVQQGEwJLUjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEM
    MAoGA1UEChMDTkJQMQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkq
    hkiG9w0BCQEWEGZhc3QwMkBuYXZlci5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0A
    MIGJAoGBANUKbesJ9h5ANBbXLNYih8m1FzfAPp9+3hWb8SEUAWDvu0/MJSsbAwQB
    0nRrqYzxtMl00CwuBLYCupw2HAPC3+jtXCjomjx9pgMnPPoIXIExevYhF+qKtPd9
    +gKr7e0v2vBD2WU/n4v4+j+TUF9ol3ln6ZOfxQblPw2lqPhRA5i7AgMBAAEwDQYJ
    KoZIhvcNAQEFBQADgYEAhbcSYDrEnBKuEepa35FQBlLMTVA+2RocfRZPdXV0s3i5
    5iwH/6S23Gy/nKkEXJSGhUst5HjgRJqhvHyfM2uXY8zeq0oVhGu0C3iaE49Q0Vdp
    i1pMe+14UFKW8iohI8ZU2eUL5tm0VdNtV8JPF/sagh4LLyPzrf65PwOIbtSttcY=
    -----END CERTIFICATE----- </publicKeyCertificate>
    </sslCertificate>
    <sslCertificate>
    <certificateName>my-ssl-2</certificateName>
    <privateKey> -----BEGIN RSA PRIVATE KEY-----
    MIICXQIBAAKBgQDVCm3rCfYeQDQW1yzWIofJtRc3wD6fft4Vm/EhFAFg77tPzCUr
    GwMEAdJ0a6mM8bTJdNAsLgS2ArqcNhwDwt/o7Vwo6Jo8faYDJzz6CFyBMXr2IRfq
    irT3ffoCq+3tL9rwQ9llP5+L+Po/k1BfaJd5Z+mTn8UG5T8Npaj4UQOYuwIDAQAB
    AoGBAIxATnbC2xW1PNWgmPLsTqq7HmrklBWahwiA3jDho7q2eIEjK4ECSmzz6iIc
    0sVoRpWt4nKDZTSR/VpjwPO08oSIywUFyh+ExL5YZ/TmMKiIurOWnQujUZTLah3y
    rfeFrCAkMLKhLMT3oreKCooIw4LEy5zDQ4PlqAX5T4icBp45AkEA+NM1GVM4N12w
    QpkWYsT3tplF5V72A81l+QUhkol/fajk/kyqcVZqE401sosab62qoHaJqIa1rb9y
    VsHYlqO5xQJBANsvETMHu/tONYoQVu75UookH6sJZ98lXvLGIJOm9BdvQscK/sfP
    VD7MQg7BLMSSIyzTmNnFKp/Z3nSW2zX3sH8CQQCECcf+lVuafbvfy07GwNDWc8VU
    byzLXb6EA0YKda5Sp0JE87fqhrmpgGCDSy+PHbASkHSCGmHkPlhVU240mdMlAkBo
    JUEi4jXr/wlphMIJ4uXZRbjWaC221eb7rDCmd9nbmL4+HXdaMaVyAVQR9q/y5w1X
    q2MhdpH+SmNtOpEGX565AkAw0iyekCbB/4QES2D49uy6glJ/0+8PGK4yT76yBBmS
    QZGpOT95XbJhHWLo+S6VT6kyeBLd4cgityGrsMRFZkA1
    -----END RSA PRIVATE KEY----- </ privateKey >
    <publicKeyCertificate> -----BEGIN CERTIFICATE-----
    MIICazCCAdQCCQDqqtCSgqvb9TANBgkqhkiG9w0BAQUFADB6MQswCQYDVQQGEwJL
    UjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEMMAoGA1UEChMDTkJQ
    MQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkqhkiG9w0BCQEWEGZh
    c3QwMkBuYXZlci5jb20wHhcNMTQwMzE4MDU0NTQxWhcNMTUwMzE4MDU0NTQxWjB6
    MQswCQYDVQQGEwJLUjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEM
    MAoGA1UEChMDTkJQMQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkq
    hkiG9w0BCQEWEGZhc3QwMkBuYXZlci5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0A
    MIGJAoGBANUKbesJ9h5ANBbXLNYih8m1FzfAPp9+3hWb8SEUAWDvu0/MJSsbAwQB
    0nRrqYzxtMl00CwuBLYCupw2HAPC3+jtXCjomjx9pgMnPPoIXIExevYhF+qKtPd9
    +gKr7e0v2vBD2WU/n4v4+j+TUF9ol3ln6ZOfxQblPw2lqPhRA5i7AgMBAAEwDQYJ
    KoZIhvcNAQEFBQADgYEAhbcSYDrEnBKuEepa35FQBlLMTVA+2RocfRZPdXV0s3i5
    5iwH/6S23Gy/nKkEXJSGhUst5HjgRJqhvHyfM2uXY8zeq0oVhGu0C3iaE49Q0Vdp
    i1pMe+14UFKW8iohI8ZU2eUL5tm0VdNtV8JPF/sagh4LLyPzrf65PwOIbtSttcY=
    -----END CERTIFICATE----- </publicKeyCertificate><certificateChain></ certificateChain>
    </sslCertificate>
    </sslCertificateList>
    </addLoadBalancerSslCertificateResponse>
    

deleteLoadBalancerSslCertificate

API명

인증서 삭제

설명

로드밸런서에서 사용하는 SSL 인증서를 삭제합니다.

요청 파라미터

파라미터명 간략 설명 타입 제약 필수 여부
certificateName 인증서명 String 중복 불가 Yes
  • certificateName
    삭제 대상 인증서명
    getLoadBalanceSslCertificateList 액션을 통해서 획득할 수 있습니다.

응답 데이터 타입

  • SslCertificateList 타입
SslCertificateList extends CommonResponse
private Integer totalRows;
private List sslCertificateList = new ArrayList();
SslCertificate
private String certificateName;
private String privateKey;
private String publicKeyCertificate;
private String certificateChain

오류

HTTP 응답 코드 반환 코드 반환 메시지
400 26035 There is no input parameters memberNo or certificateName.
400 26037 It is in use by another load balancer to certificate of deletion requested. Please delete to a load balancer is being used or after you change the certificate you are using.

  • 요청

    ${LOADBALANCER_API_URL}?action=deleteLoadBalancerSslCertificate
    &certificateName=my-ssl-2
    &AUTHPARAMS
    
  • 응답

    <getLoadBalancerSslCertificateListResponse>
    <requestId>e191af19-2504-4688-b0fa-9fd8e2bdd4e8</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <sslCertificateList>
    <sslCertificate>
    <certificateName>my-ssl</certificateName>
    <privateKey> -----BEGIN RSA PRIVATE KEY-----
    MIICXQIBAAKBgQDVCm3rCfYeQDQW1yzWIofJtRc3wD6fft4Vm/EhFAFg77tPzCUr
    GwMEAdJ0a6mM8bTJdNAsLgS2ArqcNhwDwt/o7Vwo6Jo8faYDJzz6CFyBMXr2IRfq
    irT3ffoCq+3tL9rwQ9llP5+L+Po/k1BfaJd5Z+mTn8UG5T8Npaj4UQOYuwIDAQAB
    AoGBAIxATnbC2xW1PNWgmPLsTqq7HmrklBWahwiA3jDho7q2eIEjK4ECSmzz6iIc
    0sVoRpWt4nKDZTSR/VpjwPO08oSIywUFyh+ExL5YZ/TmMKiIurOWnQujUZTLah3y
    rfeFrCAkMLKhLMT3oreKCooIw4LEy5zDQ4PlqAX5T4icBp45AkEA+NM1GVM4N12w
    QpkWYsT3tplF5V72A81l+QUhkol/fajk/kyqcVZqE401sosab62qoHaJqIa1rb9y
    VsHYlqO5xQJBANsvETMHu/tONYoQVu75UookH6sJZ98lXvLGIJOm9BdvQscK/sfP
    VD7MQg7BLMSSIyzTmNnFKp/Z3nSW2zX3sH8CQQCECcf+lVuafbvfy07GwNDWc8VU
    byzLXb6EA0YKda5Sp0JE87fqhrmpgGCDSy+PHbASkHSCGmHkPlhVU240mdMlAkBo
    JUEi4jXr/wlphMIJ4uXZRbjWaC221eb7rDCmd9nbmL4+HXdaMaVyAVQR9q/y5w1X
    q2MhdpH+SmNtOpEGX565AkAw0iyekCbB/4QES2D49uy6glJ/0+8PGK4yT76yBBmS
    QZGpOT95XbJhHWLo+S6VT6kyeBLd4cgityGrsMRFZkA1
    -----END RSA PRIVATE KEY----- </ privateKey >
    <publicKeyCertificate> -----BEGIN CERTIFICATE-----
    MIICazCCAdQCCQDqqtCSgqvb9TANBgkqhkiG9w0BAQUFADB6MQswCQYDVQQGEwJL
    UjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEMMAoGA1UEChMDTkJQ
    MQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkqhkiG9w0BCQEWEGZh
    c3QwMkBuYXZlci5jb20wHhcNMTQwMzE4MDU0NTQxWhcNMTUwMzE4MDU0NTQxWjB6
    MQswCQYDVQQGEwJLUjEPMA0GA1UECBMGZmFzdDAyMQ4wDAYDVQQHEwVTZW91bDEM
    MAoGA1UEChMDTkJQMQwwCgYDVQQLEwNSTkQxDTALBgNVBAMTBHRlc3QxHzAdBgkq
    hkiG9w0BCQEWEGZhc3QwMkBuYXZlci5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0A
    MIGJAoGBANUKbesJ9h5ANBbXLNYih8m1FzfAPp9+3hWb8SEUAWDvu0/MJSsbAwQB
    0nRrqYzxtMl00CwuBLYCupw2HAPC3+jtXCjomjx9pgMnPPoIXIExevYhF+qKtPd9
    +gKr7e0v2vBD2WU/n4v4+j+TUF9ol3ln6ZOfxQblPw2lqPhRA5i7AgMBAAEwDQYJ
    KoZIhvcNAQEFBQADgYEAhbcSYDrEnBKuEepa35FQBlLMTVA+2RocfRZPdXV0s3i5
    5iwH/6S23Gy/nKkEXJSGhUst5HjgRJqhvHyfM2uXY8zeq0oVhGu0C3iaE49Q0Vdp
    i1pMe+14UFKW8iohI8ZU2eUL5tm0VdNtV8JPF/sagh4LLyPzrf65PwOIbtSttcY=
    -----END CERTIFICATE----- </publicKeyCertificate><certificateChain></ certificateChain>
    </sslCertificate>
    </sslCertificateList>
    </getLoadBalancerSslCertificateListResponse>
    

연관 정보 바로가기

다음 가이드에서 연관 정보를 확인할 수 있습니다.

""에 대한 건이 검색되었습니다.

    ""에 대한 검색 결과가 없습니다.

    처리중...