createServerImage
    • PDF

    createServerImage

    • PDF

    記事の要約

    VPC環境で利用できます。

    概要

    マイサーバイメージを作成します。

    リクエスト

    リクエストパラメータ

    パラメータ名要否タイプ制約事項説明
    regionCodeNoString-- リージョンコード
    サーバイメージリストを照会するリージョン(Region)を決定できる
    regionCodeは、getRegionListアクションを通じて取得可能
    Default: getRegionList照会結果の最初のリージョンを選択
    serverInstanceNoYesString-- ソースサーバーのインスタンス番号
    serverImageNameYesStringMin : 3, Max : 30
    アルファベット、数字、特殊文字の「-」のみ入力可能で、先頭文字はアルファベットにする
    末尾文字はアルファベットまたは数字にする
    - サーバイメージ名
    serverImageDescriptionNoStringMin : 0, Max : 1000 Bytes- 作成するサーバイメージの説明
    blockStorageList.N.orderYesIntegerMin : 0, Max : 20- ブロックストレージの手順
    作成するサーバイメージに割り当てられるストレージの手順を決定する
    基本ストレージが必ず1つ存在
    基本ストレージに設定するには0を入力
    ストレージは最大21個まで割り当て可能
    blockStorageList.N.snapshotInstanceNoYesString-- ストレージスナップショットインスタンス番号
    サーバイメージを作成する対象となるスナップショットインスタンスの決定
    snapshotInstanceNoは、getBlockStorageSnapshotInstanceListアクションを通じて取得可能
    blockStorageList.N.blockStorageSizeConditionalInteger-- ストレージサイズ(GB)
    作成するストレージサイズ(GB)を決定
    スナップショットを指定した場合は、スナップショットサイズより大きいか、同じでなければなりません。
    ボリュームタイプによるサイズの制約事項はユーザーガイドを参照
    Compute > Server > VPC > Serverの使用する > Server > Block Storage > Block Storageの概要 > Block Storageの概要
    blockStorageList.N.blockStorageVolumeTypeCodeConditionalString-- ストレージタイプ
    作成するストレージタイプを決定
    基本ストレージは変更不可。
    Options : CB1 | FB1
    ストレージスナップショットインスタンス番号(snapshotInstanceNo)とストレージタイプ(blockStorageVolumeTypeCode)のいずれかを必ず入力
    blockStorageList.N.noBlockStorageConditionalBoolean-- ストレージ除外の有無
    ストレージを除外するかどうかを決定
    基本ストレージは変更不可。
    Options : true | false
    falseの場合、ストレージスナップショットインスタンス番号(snapshotInstanceNo)を必須入力
    blockStorageList.N.emptyBlockStorageConditionalBoolean-- 新規ストレージ作成の有無
    スナップショットからストレージを作成することなく、新規ストレージを作成します。
    基本ストレージは変更不可。
    Options : true | false
    falseの場合、ストレージスナップショットインスタンス番号(snapshotInstanceNo)を必須入力
    responseFormatTypeNoString-- レスポンス結果のフォーマットタイプ
    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 createServerImage --regionCode KR --serverInstanceNo 1234 --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>
    

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

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.