changeServerInstanceSpec

Prev Next

Overview

Change the specifications of a server instance (VM).

Request

Request parameters

Parameter name Required Type Restrictions Description
serverInstanceNo Yes String - The number of server instance whose specification will be changed
Servers in operation can't be changed.
serverInstanceNo can be obtained through the getServerInstanceList action.
serverProductCode Yes String Min: 1, Max: 20 - Product code for server specifications
serverProductCode can be obtained through the getServerProductList action.
responseFormatType No String - Response result's format type
Options: xml | json
Default: xml

Response

Response body

Examples

Request example

GET {SERVER_API_URL}/changeServerInstanceSpec
?serverInstanceNo=1088217
&serverProductCode=SPSVRSTAND000005

Response example

<changeServerInstanceSpecResponse>
  <requestId>b059fc08-fb8d-40a0-b28b-b0093549f96f</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <serverInstanceList>
    <serverInstance>
      <serverInstanceNo>1088217</serverInstanceNo>
      <serverName>s167545541a3</serverName>
      <serverDescription></serverDescription>
      <cpuCount>2</cpuCount>
      <memorySize>4294967296</memorySize>
      <baseBlockStorageSize>53687091200</baseBlockStorageSize>
      <platformType>
        <code>LNX32</code>
        <codeName>Linux 32 Bit</codeName>
      </platformType>
      <loginKeyName>penguin</loginKeyName>
      <isFeeChargingMonitoring>false</isFeeChargingMonitoring>
      <publicIp></publicIp>
      <privateIp>10.41.83.168</privateIp>
      <serverImageName>centos-6.3-32</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>2018-11-27T17:42:13+0900</createDate>
      <uptime>2018-11-27T17:46:02+0900</uptime>
      <serverImageProductCode>SPSW0LINUX000032</serverImageProductCode>
      <serverProductCode>SPSVRSTAND000004</serverProductCode>
      <isProtectServerTermination>false</isProtectServerTermination>
      <portForwardingPublicIp>106.10.51.90</portForwardingPublicIp>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>Pyeongchon zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
      <region>
        <regionNo>1</regionNo>
        <regionCode>KR</regionCode>
        <regionName>Korea</regionName>
      </region>
      <baseBlockStorageDiskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </baseBlockStorageDiskType>
      <baseBlockStorageDiskDetailType>
        <code>HDD</code>
        <codeName>HDD</codeName>
      </baseBlockStorageDiskDetailType>
      <serverInstanceType>
        <code>STAND</code>
        <codeName>Standard</codeName>
      </serverInstanceType>
      <userData></userData>
      <initScriptNo></initScriptNo>
      <accessControlGroupList>
        <accessControlGroup>
          <accessControlGroupConfigurationNo>39995</accessControlGroupConfigurationNo>
          <accessControlGroupName>ncloud-default-acg</accessControlGroupName>
          <accessControlGroupDescription>Default AccessControlGroup</accessControlGroupDescription>
          <isDefault>true</isDefault>
          <createDate>2018-04-09T11:12:54+0900</createDate>
        </accessControlGroup>
      </accessControlGroupList>
      <instanceTagList/>
    </serverInstance>
  </serverInstanceList>
</changeServerInstanceSpecResponse>

Errors

Errors that may occur while using this action are listed below. For more information about common errors, see NAVER Cloud Platform API.

HTTP Response Code Return code Return message
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.