createBlockStorageInstance

Prev Next

개요

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

요청

요청 파라미터

파라미터 명 필수 여부 타입 제약사항 설명
blockStorageName No String Min : 3, Max : 30 - 생성할 블록 스토리지명
Default : NAVER Cloud Platform 에서 기본값으로 할당
blockStorageSize Yes Long Min : 10, Max : 2000 - 생성할 블록 스토리지 사이즈
필수항목이며, 10GB 단위로 입력이 가능하고 최대 2000GB 까지만 입력 가능
blockStorageDescription No String Min : 1, Max : 1000 생성할 블록 스토리지에 대한 설명
serverInstanceNo Yes String - Attach할 서버 인스턴스 번호
getServerInstanceList 액션을 통해 서버 인스턴스 번호 획득 가능
diskDetailTypeCode Yes String - 디스크유형 상세코드
Options : HDD | SSD
Default : HDD
responseFormatType No String - 응답 결과의 포맷 타입
Options : xml | json
Default : xml

응답

응답 바디

예시

요청 예시

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

응답 예시

<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>평촌 zone</zoneDescription>
        <regionNo>1</regionNo>
      </zone>
    </blockStorageInstance>
  </blockStorageInstanceList>
</createBlockStorageInstanceResponse>

에러 코드

아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해주세요

HTTP Response Code 리턴 코드 리턴 메시지
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.