createBlockStorageInstance

Prev Next

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>