Overview
Creating a block storage instance
Description
Create a block storage instance.
Request Parameters
| Parameter Name | Requiredness | Type | Limitation | Description |
|---|---|---|---|---|
| blockStorageName | No | String | Min : 3, Max : 30 | Block storage name to create> Default : Ncloud configures it by itself. |
| blockStorageSize | Yes | String | Min : 10, Max : 2000 | Enter a block storage size to ceate. You can enter by the unit of GB. Up to 2000GB you can enter. |
| blockStorageDescription | No | String | Min : 10, Max : 1000 | Block storage descriptions |
| serverInstanceNo | Yes | String | Server instance No. to attach It is required and you can get a server instance No. by calling getServerInstanceList. |
|
| diskDetailTypeCode | No | String | Min : 1, Max : 5 | You can choose a disk detail type code of HDD and SSD. Default : HDD |
Response Data Type
- BlockStorageInstanceList type
| BlockStorageInstanceList extends CommonResponse |
|---|
| private Integer totalRows; |
| private List |
| BlockStorageInstance |
|---|
| private String blockStorageInstanceNo; |
| private String serverInstanceNo; |
| private String serverName; |
| private CommonCode blockStorageType; |
| private String blockStorageName; |
| private Long blockStorageSize; |
| private String deviceName; |
| private String blockStorageProductCode; |
| private CommonCode blockStorageInstanceStatus; |
| private CommonCode blockStorageInstanceOperation; |
| private String blockStorageInstanceStatusName; |
| private Date createDate; |
| private String blockStorageInstanceDescription; |
| private CommonCode diskTypeCode; |
| private CommonCode diskType; |
| private CommonCode diskDetailType; |
| private Integer maxIopsThroughput; |
Examples
Request
ncloud server createBlockStorageInstance --blockStorageSize 100 --serverInstanceNo 397255 --diskDetailTypeCode SSD
Response
{
"createBlockStorageInstanceResponse": {
"requestId": "4b829bad-fba8-411d-9a21-0264a5854014",
"returnCode": "0",
"returnMessage": "success",
"totalRows": 1,
"blockStorageInstanceList": [
{
"blockStorageInstanceNo": "397260",
"serverInstanceNo": "397255",
"serverName": "ncloud-mktest",
"blockStorageType": {
"code": "SVRBS",
"codeName": "Server BS"
},
"blockStorageName": "bst-a3e9783e47c71f3",
"blockStorageSize": 107374182400,
"deviceName": "",
"blockStorageProductCode": "SPBSTBSTAD000006",
"blockStorageInstanceStatus": {
"code": "INIT",
"codeName": "Block Storage INIT State"
},
"blockStorageInstanceOperation": {
"code": "NULL",
"codeName": "Block Storage NULL OP"
},
"blockStorageInstanceStatusName": "initialized",
"createDate": "2018-02-23T14:00:55+0900",
"blockStorageInstanceDescription": "",
"diskType": {
"code": "NET",
"codeName": "Network Storage"
},
"diskDetailType": {
"code": "SSD",
"codeName": "SSD"
},
"zone": {
"zoneNo": "2",
"zoneName": "KR-1",
"zoneCode": "KR-1",
"zoneDescription": "KR-1 zone",
"regionNo": "1"
}
}
]
}
}
<?xml version="1.0" encoding="UTF-8" ?>
<createBlockStorageInstanceResponse>
<requestId>4b829bad-fba8-411d-9a21-0264a5854014</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<blockStorageInstanceList>
<blockStorageInstanceNo>397260</blockStorageInstanceNo>
<serverInstanceNo>397255</serverInstanceNo>
<serverName>ncloud-mktest</serverName>
<blockStorageType>
<code>SVRBS</code>
<codeName>Server BS</codeName>
</blockStorageType>
<blockStorageName>bst-a3e9783e47c71f3</blockStorageName>
<blockStorageSize>107374182400</blockStorageSize>
<deviceName></deviceName>
<blockStorageProductCode>SPBSTBSTAD000006</blockStorageProductCode>
<blockStorageInstanceStatus>
<code>INIT</code>
<codeName>Block Storage INIT State</codeName>
</blockStorageInstanceStatus>
<blockStorageInstanceOperation>
<code>NULL</code>
<codeName>Block Storage NULL OP</codeName>
</blockStorageInstanceOperation>
<blockStorageInstanceStatusName>initialized</blockStorageInstanceStatusName>
<createDate>2018-02-23T14:00:55+0900</createDate>
<blockStorageInstanceDescription></blockStorageInstanceDescription>
<diskType>
<code>NET</code>
<codeName>Network Storage</codeName>
</diskType>
<diskDetailType>
<code>SSD</code>
<codeName>SSD</codeName>
</diskDetailType>
<zone>
<zoneNo>2</zoneNo>
<zoneName>KR-1</zoneName>
<zoneCode>KR-1</zoneCode>
<zoneDescription>KR-1 zone</zoneDescription>
<regionNo>1</regionNo>
</zone>
</blockStorageInstanceList>
</createBlockStorageInstanceResponse>