createServerImageFromSnapshot

印刷する
共有
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

VPC環境で利用できます。

概要

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

注意

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

リクエスト

リクエストパラメータ

パラメータ名	要否	タイプ	制約事項	説明
regionCode	No	String	-	- リージョンコードサーバイメージリストを照会するリージョン(Region)を決定できる regionCodeは、getRegionListアクションを通じて取得可能 Default: getRegionList照会結果の最初のリージョンを選択
serverImageName	Yes	String	Min : 3, Max : 30 アルファベット、数字、特殊文字の「-」のみ入力可能で、先頭文字はアルファベットにする末尾文字はアルファベットまたは数字にする	- サーバイメージ名
serverImageDescription	No	String	Min : 0, Max : 1000 Bytes	- 作成するサーバイメージの説明
blockStorageList.N.order	Yes	Integer	Min : 0, Max : 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	-	- ストレージタイプ作成するストレージタイプを決定基本ストレージは変更不可。 Options : CB1 \| FB1 ストレージスナップショットインスタンス番号(snapshotInstanceNo)とストレージタイプ(blockStorageVolumeTypeCode)のいずれかを必ず入力
blockStorageList.N.emptyBlockStorage	Conditional	Boolean	-	- 新規ストレージ作成の有無スナップショットからストレージを作成することなく、新規ストレージを作成します。基本ストレージは変更不可。 Options : true \| false falseの場合、ストレージスナップショットインスタンス番号(snapshotInstanceNo)を必須入力
responseFormatType	No	String	-	- レスポンス結果のフォーマットタイプ Options : xml \| json Default : 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 List<BlockStorageMapping> blockStorageMappingList;

例

リクエスト例

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>
      <productCode>SW.VSVR.OS.LNX64.CNTOS.0703.B050</productCode>
      <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/>
    </serverImage>
  </serverImageList>
</getServerImageListResponse>

この記事は役に立ちましたか?

What's Next

createServerImage

概要
リクエスト
レスポンス
例