createServerImageFromSnapshot

Prev Next

VPC環境で利用できます。

概要

スナップショットを使用してマイサーバイメージを作成します。

注意

KVMのスナップショットのみサポートしています。

リクエスト

リクエストパラメータ

パラメータ名 必須の有無 タイプ 制限事項 説明
regionCode No String - - リージョンコード
サーバイメージリスト照会対象のリージョン(Region)
regionCodeはgetRegionListアクションを通じて取得可能
デフォルト: getRegionList照会結果の最初のリージョンを選択
serverImageName Yes String 最小: 3、最大: 30
英数字、記号の「-」のみ入力可能で、先頭文字は英字のみ使用
末尾文字は英字または数字のみ使用
- サーバイメージの名前
serverImageDescription No String 最小: 0, 最大: 1000 Bytes - 作成するサーバイメージの説明
blockStorageList.N.order Yes Integer 最小: 0, 最大: 20 - ストレージの順序
作成するサーバイメージに割り当てられるストレージの順序を決定
基本ストレージが必ず1つ存在
基本ストレージに設定するには0を入力
ストレージは最大21個まで割り当て可能
blockStorageList.N.snapshotInstanceNo Yes String - - ストレージスナップショットインスタンス番号
サーバイメージ作成対象のスナップショットインスタンスを決定
snapshotInstanceNoはgetBlockStorageSnapshotInstanceListアクションを通じて取得可能
blockStorageList.N.blockStorageSize Conditional Integer - - ストレージ容量(GB)
作成するストレージ容量(GB)を決定
スナップショットを指定した場合は、スナップショットサイズ以上にします。
ボリュームタイプ別サイズ制限はユーザーガイドを参照
Compute > Server > VPC > Serverを使用する > Server > Block Storage > Block Storageの概要 > Block Storageの概要
blockStorageList.N.blockStorageVolumeTypeCode Conditional String - - ストレージタイプ
作成するストレージタイプを決定
基本ストレージは変更不可。
オプション: CB1 | FB1
ストレージスナップショットインスタンス番号(snapshotInstanceNo)とストレージタイプ(blockStorageVolumeTypeCode)のうち、どちらか1つは必ず入力
blockStorageList.N.emptyBlockStorage Conditional Boolean - - 新規ストレージ作成かどうか
スナップショットからストレージを作成せずに新規ストレージを作成します。
基本ストレージは変更不可。
オプション: true | false
falseの場合、ストレージスナップショットインスタンス番号(snapshotInstanceNo)は必ず入力
responseFormatType No String - - レスポンス結果の形式タイプ
オプション: xml | json
デフォルト: xml

レスポンス

レスポンスデータタイプ

  • ServerImageListタイプ
ServerImageList extends CommonResponse
private Integer totalRows;
private List<ServerImage> serverImageList = new ArrayList<>();
ServerImage
private String serverImageNo;
private String serverImageName;
private String serverImageDescription;
private CommonCode serverImageType;
private CommonCode hypervisorType;
private CommonCode cpuArchitectureType;
private CommonCode osCategoryType;
private CommonCode osType;
private String serverImageStatusName;
private CommonCode serverImageStatus;
private CommonCode serverImageOperation;
private String serverImageProductCode;
private Date createDate;
private CommonCode shareStatus;
private SharedLoginIdList sharedLoginIdList;
private String platformCategoryCode;
private List<BlockStorageMapping> blockStorageMappingList;
BlockStorageMapping
private Integer order;
private String blockStorageSnapshotInstanceNo;
private String blockStorageSnapshotName;
private Long blockStorageSize;
private String blockStorageName;
private CommonCode blockStorageVolumeType;
private Long iops;
private Long throughput;
private Boolean isEncryptedVolume;

リクエスト例

ncloud vserver createServerImageFromSnapshot --regionCode KR --serverImageName test-***

レスポンス例

<getServerImageListResponse>
  <requestId></requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <serverImageList>
    <serverImage>
      <serverImageNo>***5847</serverImageNo>
      <serverImageName>test-***</serverImageName>
      <serverImageDescription></serverImageDescription>
      <serverImageType>
        <code>NCP</code>
        <codeName>NCP Server Image</codeName>
      </serverImageType>
      <hypervisorType>
        <code>XEN</code>
        <codeName>XEN</codeName>
      </hypervisorType>
      <cpuArchitectureType>
        <code>X86_64</code>
        <codeName>x86 64bit</codeName>
      </cpuArchitectureType>
      <osCategoryType>
        <code>LINUX</code>
        <codeName>LINUX</codeName>
      </osCategoryType>
      <osType>
        <code>CENTOS</code>
        <codeName>CENTOS</codeName>
      </osType>
      <serverImageProductCode>SW.VSVR.OS.LNX64.CNTOS.0703.B050</serverImageProductCode>
      <serverImageStatus>
        <code>CREAT</code>
        <codeName>Server created state</codeName>
      </serverImageStatus>
      <serverImageOperation>
        <code>NULL</code>
        <codeName>NULL OP</codeName>
      </serverImageOperation>
      <serverImageStatusName>created</serverImageStatusName>
      <createDate>2020-08-24T10:34:27+0900</createDate>
      <blockStorageMappingList>
        <blockStorageMapping>
          <order>0</order>
          <blockStorageSize>53687091200</blockStorageSize>
          <blockStorageVolumeType>
            <code>HDD</code>
            <codeName>HDD</codeName>
          </blockStorageVolumeType>
          <isEncryptedVolume>false</isEncryptedVolume>
        </blockStorageMapping>
      </blockStorageMappingList>
      <shareStatus>
        <code>NULL</code>
        <codeName>NSI Share NULL State</codeName>
      </shareStatus>
      <sharedLoginIdList/>
      <platformCategoryCode>OS</platformCategoryCode>  
    </serverImage>
  </serverImageList>
</getServerImageListResponse>