createBlockStorageInstance

VPC 환경에서 이용 가능합니다.

개요

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

요청

요청 파라미터

파라미터명	필수 여부	타입	제약 사항	설명
regionCode	No	String		- 리전 코드 블록 스토리지 인스턴가 생성될 리전(Region) 결정 가능 regionCode는 getRegionList 액션을 통해 획득 가능 Default : getRegionList 조회 결과의 첫 번째 리전을 선택
zoneCode	Conditional	String	-	- ZONE 코드 블록 스토리지 인스턴스가 생성될 존(zone) 결정 가능 zoneCode는 getCodeList 액션을 통해 획득 가능(KVM 스토리지인 경우 필수)
blockStorageName	No	String	Min : 3, Max : 30 영어, 숫자, "-"의 특수문자만 허용하며 영어로 시작해야 함 영어 또는 숫자로 끝나야 함	- 블록 스토리지 이름 Default : NAVER Cloud Platform가 자동으로 부여함
blockStorageDiskDetailTypeCode	No	String	-	- 블록 스토리지 디스크 상세 유형 코드 생성할 블록 스토리지 디스크 상세 유형 결정 가능 XEN 블록 스토리지만 유효 Options : SSD \| HDD Default : SSD
blockStorageVolumeTypeCode	Conditional	String	-	- 블록 스토리지 볼륨타입 코드 생성할 블록 스토리지 볼륨타입 결정 가능 blockStorageVolumeTypeCode는 getBlockStorageVolumeTypeList 액션을 통해 획득 가능 KVM 블록 스토리지는 필수 Options : SSD \| HDD \| FB1 \| CB1
serverInstanceNo	Conditional	String	-	- 서버 인스턴스 번호 처음 블록 스토리지 생성시 반드시 서버에 할당되어야 함 serverInstanceNo는 getServerInstanceList 액션을 통해 획득 가능 XEN 블록 스토리지인 경우 필수 KVM 블록 스토리지는 생성과 동시에 서버에 할당하는 것이 지원되지 않으므로 serverInstanceNo가 없어야 함
blockStorageSnapshotInstanceNo	No	String		- 블록 스토리지 스냅샷 인스턴스 번호 직접 생성한 스냅샷으로부터 블록 스토리지를 생성시 입력함 blockStorageSnapshotInstanceNo는 getBlockStorageSnapshotInstanceList 액션을 통해 획득 가능
blockStorageSize	Conditional	Integer	- XEN 블록 스토리지 Min : 10, Max : 2000 GB - KVM 블록 스토리지 Min : 10, Max : 16380 GB 10GB 단위 입력	- 블록 스토리지 사이즈 생성할 블록 스토리지 사이즈 결정 가능 XEN 블록 스토리지 스냅샷을 이용하여 생성하는 경우 자동으로 결정됨 KVM 블록 스토리지 스냅샷을 이용하여 생성하는 경우에는 스냅샷 사이즈보다 크거나 같아야합니다. 볼륨 타입별 사이즈 제약사항은 사용자 가이드를 참고 Compute > Server > VPC > Server 사용 > Server > Block Storage > Block Storage 개요 > Block Storage 개요
blockStorageDescription	No	String	Min : 0, Max : 1000 Bytes	생성할 블록 스토리지에 대한 설명
isReturnProtection	No	Boolean		- 반납 보호 여부 반납 보호 여부 설정 가능 Options : true \| false Default : false
responseFormatType	No	String		- 응답 결과의 포맷 타입 Options : xml \| json Default : xml

응답

응답 데이터 타입

BlockStorageInstanceList 타입

BlockStorageInstanceList extends CommonResponse
private Integer totalRows;
private List blockStorageInstanceList = new ArrayList<>();

BlockStorageInstance
private String blockStorageInstanceNo;
private String serverInstanceNo;
private String blockStorageName;
private CommonCode blockStorageType;
private Long blockStorageSize;
private String deviceName;
private String blockStorageProductCode;
private CommonCode blockStorageInstanceStatus;
private CommonCode blockStorageInstanceOperation;
private String blockStorageInstanceStatusName;
private Date createDate;
private String blockStorageDescription;
private CommonCode blockStorageDiskType;
private CommonCode blockStorageDiskDetailType;
private Integer maxIopsThroughput;
private Boolean isEncryptedVolume;
private String zoneCode;
private String regionCode;
private Boolean isReturnProtection;

예시

요청 예시

ncloud vserver createBlockStorageInstance --regionCode KR --blockStorageName test-*** --blockStorageDiskDetailTypeCode SSD --serverInstanceNo ***4299 --blockStorageSize 50 --isReturnProtection false

응답 예시

<createBlockStorageInstanceResponse>
  <requestId>89254a11-97e3-41d6-9ed2-e9249ebcec7a</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <blockStorageInstanceList>
    <blockStorageInstance>
      <blockStorageInstanceNo>***7746</blockStorageInstanceNo>
      <serverInstanceNo>***4299</serverInstanceNo>
      <blockStorageName>test-***</blockStorageName>
      <blockStorageType>
        <code>SVRBS</code>
        <codeName>Server BS</codeName>
      </blockStorageType>
      <blockStorageSize>53687091200</blockStorageSize>
      <deviceName></deviceName>
      <blockStorageProductCode>SPBSTBSTAD000006</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>2020-08-24T22:25:35+0900</createDate>
      <blockStorageDescription></blockStorageDescription>
      <blockStorageDiskType>
        <code>NET</code>
        <codeName>Network Storage</codeName>
      </blockStorageDiskType>
      <blockStorageDiskDetailType>
        <code>SSD</code>
        <codeName>SSD</codeName>
      </blockStorageDiskDetailType>
      <maxIopsThroughput>4000</maxIopsThroughput>
      <isEncryptedVolume>false</isEncryptedVolume>
      <zoneCode>KR-1</zoneCode>
      <regionCode>KR</regionCode>
      <isReturnProtection>false</isReturnProtection>
    </blockStorageInstance>
  </blockStorageInstanceList>
</createBlockStorageInstanceResponse>