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クラウドプラットフォームが自動で付与 |
| 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>
この記事は役に立ちましたか?