createBlockStorageInstance
- Print
- PDF
createBlockStorageInstance
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Available in VPC
Overview
Creates block storage instances.
Requests
Request parameters
| Parameter name | Requirement status | Type | Restrictions | Description |
|---|---|---|---|---|
| regionCode | No | String | - Region code Decides the Region in which the block storage instance will be created regionCode can be obtained through the getRegionList action Default: select the first Region shown in the getRegionList search results | |
| zoneCode | Conditional | String | - ZONE code Decides the zone in which the block storage instance will be created zoneCode can be obtained through the getZoneList action - Required for KVM block storage | |
| blockStorageName | No | String | Min : 3, Max : 30 Only English letters, numbers, and the special character "-" can be used. It must start with an English letter It must end with an English letter or number | - Name of block storage Default: NAVER Cloud Platform automatically assigns it |
| blockStorageDiskDetailTypeCode | No | String | - Detailed type code of the block storage disk Decides the detailed type for the block storage disk to be created Valid only for XEN block storage Options : SSD | HDD Default : SSD | |
| blockStorageVolumeTypeCode | Conditional | String | - Block storage volume type code Decides the volume type of the block storage to be created blockStorageVolumeTypeCode can be obtained through the getBlockStorageVolumeTypeList action - Required for KVM block storage Options : SSD | HDD | FB1 | CB1 | |
| serverInstanceNo | Conditional | String | - Server instance number It must be assigned to the server when creating the first block storage serverInstanceNo can be obtained through the getServerInstanceList action - Required for XEN block storage KVM block storage does not support assignment along with the creation, so there should be no serverInstanceNo | |
| blockStorageSnapshotInstanceNo | No | String | - Block storage snapshot instance number Entered when creating a block storage from a manually created snapshot blockStorageSnapshotInstanceNo can be obtained through the getBlockStorageSnapshotInstanceList action | |
| blockStorageSize | Conditional | Integer | - XEN block storage Min : 10, Max : 2000 GB - KVM block storage Min : 10, Max : 16380 GB Enter in 10 GB units | - Block storage size Decides the size of the block storage to be created It is automatically determined when creating it using a XEN block storage snapshot It must be equal to or greater than the size of the snapshot when creating it using a XEN block storage snapshot. For more information on the restrictions for the size by volume type, see the user guide Compute > Server > VPC > Using Server > Server > Block Storage > Block Storage overview > Block Storage overview |
| blockStorageDescription | No | String | Min : 0, Max : 1000 Bytes | Description of a block storage to be created |
| isReturnProtection | No | Boolean | - Server termination protection status Termination protection status can be set Options : true | false Default : false | |
| responseFormatType | No | String | - Format type of responses Options : xml | json Default : xml |
Responses
Response bodies
Examples
Request examples
GET {API_URL}/createBlockStorageInstance
?regionCode=KR
&blockStorageName=test-***
&blockStorageDiskDetailTypeCode=SSD
&serverInstanceNo=***4299
&blockStorageSize=50
&isReturnProtection=false
Response examples
<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>
Was this article helpful?