createBlockStorageInstance

Prev Next

Overview

Create a block storage instance.

Request

Request parameters

Parameter name Required Type Restrictions Description
blockStorageName No String Min: 3, Max: 30 - Name of block storage to create
Default: assigned as default value in NAVER Cloud Platform
blockStorageSize Yes Long Min: 10, Max: 2000 - Size of block storage to create
Required field; can be entered in 10 GB increments up to 2000 GB
blockStorageDescription No String Min: 1, Max: 1000 Description of the block storage to be created
serverInstanceNo Yes String - Number of server instance to attach
Server instance number can be obtained through the getServerInstanceList action.
diskDetailTypeCode Yes String - Disk type detailed code
Options: HDD | SSD
Default: HDD
responseFormatType No String - Format type of the response result
Options: xml | json
Default: xml

Response

Response body

Examples

Request example

GET {SERVER_API_URL}/createBlockStorageInstance
?blockStorageSize=10
&serverInstanceNo=1021003
&diskDetailTypeCode=HDD

Response example

<createBlockStorageInstanceResponse>
  <requestId>1c844a3f-6149-4223-bcfc-b2fc6294dd17</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageInstanceList>
    <blockStorageInstance>
      <blockStorageInstanceNo>1089090</blockStorageInstanceNo>
      <serverInstanceNo>1021003</serverInstanceNo>
      <serverName>s1669aa4e78c</serverName>
      <blockStorageType>
        <code>SVRBS</code>
        <codeName>Server BS</codeName>
      </blockStorageType>
      <blockStorageName>bst167588711f2</blockStorageName>
      <blockStorageSize>10737418240</blockStorageSize>
      <deviceName></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>2018-11-28T13:15:06+0900</createDate>
      <blockStorageInstanceDescription></blockStorageInstanceDescription>
      <diskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </diskType>
      <diskDetailType>
        <code>HDD</code>
        <codeName>HDD</codeName>
      </diskDetailType>
      <zone>
        <zoneNo>3</zoneNo>
        <zoneName>KR-2</zoneName>
        <zoneCode>KR-2</zoneCode>
        <zoneDescription>Pyeongchon zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </blockStorageInstance>
  </blockStorageInstanceList>
</createBlockStorageInstanceResponse>

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 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 10723 Additional storage is not available for Micro Server.
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 25005 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.