createBlockStorageInstance
- 인쇄
- PDF
createBlockStorageInstance
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
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<BlockStorageInstance> 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>
이 문서가 도움이 되었습니까?